Cancelar NFS-e

POST /api/NFSeEmissao/emissaoCancelamento

O endpoint de emissão de cancelamento NFS-e permite que sejam enviados pedidos de Cancelamento, conforme layouts de Cancelamento NDD.

O layout da string de “Conteudo” deve seguir o layout padrão conforme documentação fornecida layout único de cancelamento NDD.

A seguir, link para layout de Cancelamento: Layout Único de Cancelamento NFS-e

O endpoint de Cancelar NFS-e está disponível para prefeituras que possuem cancelamento online. Para prefeituras que não possuem tal funcionalidade, o cancelamento deve ser realizado via Portal da Plataforma.

Exemplo de Requisição:

CODE

{ 

  "Header": { 

    "CNPJEmpresa": "99999999999999", 

    "TipoEnvio": 1 

  }, 

  "Body": { 

    "Conteudo": "{\"InfPedidoCancelamento\":{\"@Versao\":\"4.00\",\"@Id\":\"Canc_Id\",\"Numero\":\"202200000000001\",\"Cnpj\":\"99999999999999\",\"InscricaoMunicipal\":\"123456789\",\"CodigoMunicipio\":\"5107602\",\"CodigoCancelamento\":\"2\",\"DadosComplementaresCancelamento\":[]}}", 

    "InscricaoMunicipal": "123456789" 

  } 

}

Exemplo de Retorno:

CODE

{ 

    "tipoRetorno": 11, 

    "processamento": { 

        "message": "Documento enviado para processamento", 

        "protocolo": "5ceaefd3-6464-46ca-8582-d7d761854737" 

    } 

}

Observação

Este método também permite o cancelamento interno de documentos, para cenários onde a Prefeitura não disponibiliza meio de comunicação para o cancelamento de NFS-e.

Neste contexto, o cliente deverá fazer o cancelamento manual diretamente no portal da Prefeitura, pois o cancelamento interno apenas atualiza o status no portal da plataforma fiscal.

Para o cancelamento interno basta incluir a informação "Cancelamento Interno" na tag /Cancelamento/DadosCancelamento/TipoCancelamento.

Exemplo de requisição:

CODE

{
  "header": {
    "cnpjEmpresa": "99999999999999",
    "tipoEnvio": 1
  },
  "body": {
    "conteudo": "{\"InfPedidoCancelamento\":{\"@Versao\":\"4.00\",\"@Id\":\"Canc_Id\",\"Numero\":\"202400000763830\",\"Cnpj\":\"99999999999999\",\"InscricaoMunicipal\":\"123456789\",\"CodigoMunicipio\":\"1234567\",\"CodigoCancelamento\":\"2\",\"DadosComplementaresCancelamento\": {\n      \"TipoCancelamento\": \"Cancelamento Interno\"\n    }\n  }\n}",
    "inscricaoMunicipal": "123456789"
  }
}