Função CancelarNfe ( )
Abaixo seguem os parâmetros necessários para o cancelamento da NF-e. Quanto ao prazo para o cancelamento da Nota Fiscal Eletronica deve-se consultar a Secretária da Fazendo do Estado onde o CNPJ está cadastrado.
POST/CancelarNfe/
|
Campo |
Tipo |
Obrigatório |
Descrição |
|---|---|---|---|
| searchkey | Texto | Sim | Código gerado pela API ao enviar a NF-e |
| motivo | Texto | Sim | Motivo do cancelamento da NF-e, mínimo de 15(quinze) caracteres e máximo de 1000 caracteres |
Exemplo de JSon
{
"ApiKey":"xxxapikeyhashxxx",
"Cnpj":"00.000.000/0000-00",
"Dados":{
"searchkey":"xxxhashkeyxxx",
"motivo":"A NOTA FOI EMITIDA COM VALOR ERRADO"
}
}
Retornos e Erros
Todos os códigos de erros com os três primeiros dígitos sendo 130 são associados a função: CancelarNfe| Código | Campo | Mensagem de retorno |
|---|---|---|
| 1301 | searchkey | É preciso informar a Searckey da nota fiscal para consulta |
| 1302 | motivo | - É preciso informar o Motivo para solicitação de cancelamento da Nota Fiscal
- Informe no mínimo 15 e no máximo 1000 caracteres para o motivo do cancelamento |
| 1303 | Retorno com erro | |
| 1304 | Retorno com sucesso | |
Retornos de JSON
| Retorno com erro de parametros |
|---|
| { "Status": "Erro", "codigo": "codigo_erro", "campo": "campo_com_erro", "descricao": "descricao_erro" } |
| Retorno com erro |
|---|
| { "status": "Erro", "codigo": "1303", "descricao": "descricao_erro" } |
| Retorno com sucesso |
|---|
| { "status": "OK", "codigo": "1304", "descricao": "Solicitação de Cancelamento Realizada com Sucesso" } |