Cancelamento de Movimentos

<h1>Regras de negócio</h1> 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.<br /> <b>OBS:</b> Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:<br />\nhttps://ajuda.sankhya.com.br/hc/pt-br/articles/360045107913-Notas-Canceladas<br /> <h3>Dependências</h3> Para realizar o cancelameno do pedido, os seguintes itens são obrigatórios:<br /> <b>1) </b>Logar no sistema utilizando o Serviço de Login descrito nesta documentação em Login; <br /> <b>2) </b>O pedido deve estar confirmado no ERP Sankhya-Om;<br /> <b>3) </b>É obrigatório informar o número único da nota<br /> <b>4) </b>É obrigatorio informar a justificativa de cancelamento</b>.<br /> <h3>Detalhes Técnicos</h3> O serviço utilizado para cancelamento de notas é o CACSP.cancelarNota que utiliza a entidade CabecalhoNota que por sua vez instancia a tabela TGFCAB.<br /> 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.<br /> Para realizar a exclusão do pedido através do Json, o campo abaixo é obrigatório:<br /><br />

• NUNOTA – Numero Único da nota;

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

<h3>Descritivo de Campos das Entidades</h3> Acesse [aqui](http://swagger.sankhya.com.br/tabelas/TGFCAB.html) o dicionário de dados da tabela <b>TGFCAB</b><br /> Acesse [aqui](http://swagger.sankhya.com.br/tabelas/TGFCAN.html) o dicionário de dados da tabela <b>TGFCAN</b><br /> <h3>Exemplo de uso:</h3> <ul> <li>URL Gateway Produção: https://api.sankhya.com.br/</li> <li>URL Gateway Sandbox: https://api.sandbox.sankhya.com.br/</li> </ul> <b>URL de chamada</b>: https://[URL_GATEWAY]/gateway/v1/mgecom/service.sbr?serviceName=CACSP.cancelarNota&outputType=json <br /> <b>Corpo de requisição</b>

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

<b>Retorno:</b><br />

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