---
title: "Cancelamento de Movimentos"
method: POST
path: "/CancelaMovimento"
tags: ["Serviços Especialistas"]
---

# Cancelamento de Movimentos

`POST /CancelaMovimento`

<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"
            }
        }
    }

## Response `201`

Cancelamento de pedidos realizada com sucesso!

## Other responses

- `400` — Requisição inválida
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)