Regras de negócio

Para realizar o cancelamento de pedidos no ERP será necessário efetuar criação de um filtro para acessar os títulos que precisam ser cancelados e efetuar o preenchimento dos dados necessários para efetuar o cancelamento.No ERP a partir do momento que é cancelada uma nota fiscal, não é mais possível reverter este processo, sendo necessário lançar a nota fiscal novamente.

OBS: Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:
\nhttps://ajuda.sankhya.com.br/hc/pt-br/articles/360045107913-Notas-Canceladas

Dependências

Para realizar o cancelameno do pedido, os seguintes itens são obrigatórios:

1) Logar no sistema utilizando o Serviço de Login descrito nesta documentação em Login;
2) O pedido deve estar confirmado no ERP Sankhya-Om;
3) É obrigatório informar o número único da nota
4) É obrigatorio informar a justificativa de cancelamento.

Detalhes Técnicos

O serviço utilizado para cancelamento de notas é o CACSP.cancelarNota que utiliza a entidade CabecalhoNota que por sua vez instancia a tabela TGFCAB.

Para usar serviços de módulos auxiliares, como é o caso do mgecom devemos enviar um parâmetro adicional na URL, cujo nome é mgeSession e o valor será o ID adquirido no serviço de autenticação. Isso não se aplica para serviços do módulo mge, que é o principal.

Para realizar a exclusão do pedido através do Json, o campo abaixo é obrigatório:

• NUNOTA – Numero Único da nota;

A partir do momento em que a nota é cancelada, a nota é inserida na tabela TGFCAN que por sua vez é instanciada pela entidade "NotaCancelada", esta tabela é responsável por armazenar todas as notas que foram confirmadas mas por algum motivo ou divergência, foi cancelada.

Descritivo de Campos das Entidades

Acesse aqui o dicionário de dados da tabela TGFCAB
Acesse aqui o dicionário de dados da tabela TGFCAN

Exemplo de uso:

• URL Gateway Produção: https://api.sankhya.com.br/
• URL Gateway Sandbox: https://api.sandbox.sankhya.com.br/

URL de chamada: https://[URL_GATEWAY]/gateway/v1/mgecom/service.sbr?serviceName=CACSP.cancelarNota&outputType=json
Corpo de requisição

{
   "serviceName":"CACSP.cancelarNota",
   "requestBody":{
      "notasCanceladas":{
         "nunota":[
            {
               "$":"3713703"
            }
         ],
         "justificativa":"lançamento indevido",
         "validarProcessosWmsEmAndamento":"true"
      }
    }
}

Retorno:

{
    "serviceName": "CACSP.cancelarNota",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "BA6F5CEB2F1ED4B27E3E66F98C4BE084",
    "responseBody": {
        "resultadoCancelamento": {
            "totalNotasCanceladas": "1"
        }
    }
}