1. Inicio
  2. Documentos
  3. NS NFSe
  4. NFSe – Teresina
  5. Cancelamento

Cancelamento

Através deste endpoint, é possível cancelar uma NFS-e autorizada no município de Teresina – PI enviando o conteúdo no respectivo layout em JSON ou XML.

URL

Homologação: POST https://nfseapi.ns.eti.br/v1/teresina/cancelar

Header

No cabeçalho da requisição poderão ser informados os campos abaixo, conforme ocorrência.

CampoOcorrênciaDescrição
X-AUTH-TOKEN1-1Token de acesso da Software House
tpAmb1-1Tipo do ambiente: 1-Produção; 2-Homologação
Content-Type1-1Indica o formato dos dados enviados: JSON: application/json; XML: application/xml ou text/xml
Dados de Entrada
CampoOcorrênciaDescriçãoTipoTamanhoObservações
CNPJ1-1CNPJ do emitente da NFS-eString14
IM1-1Inscrição municipal ligada ao CNPJString1-15
cMun1-1Código do município para o cancelamentoString7
codigo1-1Código do cancelamentoInteiro1-4Chave da NFSe recebida na Consulta de Status de Processamento
nNF0-1Número da NFS-e a ser canceladaInteiro1-9Retornado na Consulta Status de Processamento
tpAmb1-1Tipo do ambiente: 1-Produção; 2-HomologaçãoInteiro1Pode ser informado no Header
Exemplo de requisição
Requisição de cancelamento de NFS-e
curl -X POST 
    \-H "Content-Type: application/xml" 
    \-H "X-AUTH-TOKEN: SEU_TOKEN" 
    \-H "tpAmb:2" 
    \-d '{"CNPJ": "99999999999999","IM": "000000","nNF": "79","cMun": "4304606","codigo": "2","tpAmb": "2"}'
https://nfseapihml.ns.eti.br/v1/teresina/cancelar
Exemplo de cancelamento em XML
<CancelarNfseEnvio>
    <Pedido>
        <InfPedidoCancelamento>
            <IdentificacaoNfse>
                <Numero>1533</Numero>     
                <Cnpj>07485055000269</Cnpj>           
                <InscricaoMunicipal>333336</InscricaoMunicipal>
                <CodigoMunicipio>1219</CodigoMunicipio>
            </IdentificacaoNfse>
            <CodigoCancelamento>176268a6ea83ce4d50e1f44385521022de8b90e3</CodigoCancelamento>
            <MotivoCancelamentoNfse>Teste de Cancelamento de nota</MotivoCancelamentoNfse>
        </InfPedidoCancelamento>
    </Pedido>
</CancelarNfseEnvio>
Exemplo de cancelamento em JSON
{
    "CNPJ": "99999999999999",
    "IM": "000000",
    "nNF": "79",
    "cMun": "4304606",
    "codigo": "176268a6ea83ce4d50e1f44385521022de8b90e3",
    "tpAmb": "2"
}
Dados retornados
CampoDescriçãoPaiObservação
statusCódigo de status do processamento da NS
motivoDescrição literal do status de processamento da NS
retEventoObjeto contendo o retorno do eventoApenas em status = 200
cStatCódigo de status do processamento da NFS-e na PrefeituraretEvento
xMotivoDescrição literal do status de processamento na PrefeituraretEventoQuando cStat diferente de 100, contem a mensagem de erro retornada pela Prefeitura
idEventoIdentificação do EventoretEventoSomente em cStat = 100
xmlXML de distribuição da NFS-eretEventoSomente em cStat = 100
erroObjeto contendo o erro ocorridoApenas em status != 200
cStatCódigo de status do processamentoerro
xMotivoDescrição literal do status de processamentoerro
Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "Documento já processado anteriormente e autorizado",
    "retEvento": {
        "cStat": "135",
        "xMotivo": "Cancelamento Homologado na Prefeitura",
        "idEvento": "CAN_79",
        "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?...."
    }
}

Retorno com erro

{
    "status": -2,
    "motivo": "Nao foi possivel vincular o evento a NFSe",
    "erro": {
        "cStat": 898,
        "xMotivo": "Documento Original não localizado, ou não autorizado, para emissão do cancelamento"
    }
}

Como podemos ajudar?