NFC-e

Cancel NFC-e

Cancels an authorized NFC-e within 30 minutes after authorization; asynchronous.

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

Requires the token, timestamp and sign signature headers, see Authentication.

Only for an Autorizada invoice, within 30 minutes after authorization and before the goods leave the shop; some states allow less. After the deadline SEFAZ no longer accepts it and NFC-e has no late cancellation: in most states the fix is to issue an NF-e. NFC-e has no correction letter; a wrong invoice can only be fixed by cancelling within the deadline and issuing another.

Path parameters

`empresaId*`	string	Issuing company identifier
`nfceId*`	string	NFC-e identifier

* Required field

Request body

justificativa

string

Cancellation reason

* Required field

200

Accepted; no body. The result arrives by webhook and shows in the query.

No response body

Registered at SEFAZ: the invoice becomes Cancelada and the nfce.canceled webhook arrives. Rejected by SEFAZ: the invoice stays valid, nfce.cancel_rejected arrives and the query shows the reason in motivoStatus. Payloads are in Webhooks.

Code	HTTP
10022006	404	`nfceId` not found for this company.
10003000	404	`empresaId` not found.
10022008	400	Status does not allow it: the invoice is not `Autorizada`, or a cancellation is already in progress.
10022007	400	Cancellation deadline passed.
10001001	400	`justificativa` outside 15 to 255 characters.

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"

Cancel NFC-e

Parameters

Path parameters

Request body

Responses

Outcome

Errors5 items