NFC-e

Cancelar NFC-e

Cancela uma NFC-e autorizada até 30 minutos após a autorização; assíncrono.

POST/openapi/v2/empresas/{empresaId}/nfce/{nfceId}/cancelar

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Só vale para nota Autorizada, até 30 minutos após a autorização e antes de a mercadoria sair da loja; alguns estados dão menos tempo. Depois do prazo a SEFAZ não aceita mais e a NFC-e não tem cancelamento extemporâneo: na maioria dos estados a correção é emitir uma NF-e. A NFC-e não tem carta de correção; nota errada só se corrige cancelando dentro do prazo e emitindo outra.

Parâmetros de caminho

`empresaId*`	string	Identificador da empresa emitente
`nfceId*`	string	Identificador da NFC-e

* Campo obrigatório

Corpo da requisição

justificativa

string

Motivo do cancelamento

* Campo obrigatório

200

Aceito; sem corpo. O resultado chega por webhook e aparece na consulta.

Sem corpo de resposta

Registrado na SEFAZ: a nota vira Cancelada e chega o webhook nfce.canceled. Recusado pela SEFAZ: a nota continua válida, chega nfce.cancel_rejected e a consulta mostra o motivo em motivoStatus. As cargas estão em Webhooks.

Código	HTTP
10022006	404	`nfceId` não encontrado nesta empresa.
10003000	404	`empresaId` não encontrado.
10022008	400	O status não permite: a nota não está `Autorizada`, ou já há um cancelamento em andamento.
10022007	400	Prazo de cancelamento expirado.
10001001	400	`justificativa` fora de 15 a 255 caracteres.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/nfce/{nfceId}/cancelar'

TIMESTAMP=$(date +%s)

BODY='{

"justificativa": "Cliente desistiu da compra no caixa"

SIGN=$(printf '%s%s%s%s' "$APP_SECRET" "$API_PATH" "$(printf '%s' "$BODY" | tr -d '\r\n')" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X POST "https://api.v2.tffiscal.com${API_PATH}" \

-H "Content-Type: application/json" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN" \

--data-binary "$BODY"

Cancelar NFC-e

Parâmetros

Parâmetros de caminho

Corpo da requisição

Respostas

Resultado

Erros5 itens