NFC-e

Cancelar NFC-e

Cancela una NFC-e autorizada hasta 30 minutos después de la autorización; asíncrono.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Solo para una nota Autorizada, hasta 30 minutos después de la autorización y antes de que la mercadería salga de la tienda; algunos estados dan menos tiempo. Pasado el plazo la SEFAZ ya no lo acepta y la NFC-e no tiene cancelación extemporánea: en la mayoría de los estados la corrección es emitir una NF-e. La NFC-e no tiene carta de corrección; una nota errónea solo se corrige cancelando dentro del plazo y emitiendo otra.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa emisora
`nfceId*`	string	Identificador de la NFC-e

* Campo obligatorio

Cuerpo de la petición

justificativa

string

Motivo de la cancelación

* Campo obligatorio

200

Aceptado; sin cuerpo. El resultado llega por webhook y aparece en la consulta.

Sin cuerpo de respuesta

Registrado en la SEFAZ: la nota pasa a Cancelada y llega el webhook nfce.canceled. Rechazado por la SEFAZ: la nota sigue válida, llega nfce.cancel_rejected y la consulta muestra el motivo en motivoStatus. Las cargas están en Webhooks.

Código	HTTP
10022006	404	`nfceId` no encontrado en esta empresa.
10003000	404	`empresaId` no encontrado.
10022008	400	El estado no lo permite: la nota no está `Autorizada`, o ya hay una cancelación en curso.
10022007	400	Plazo de cancelación vencido.
10001001	400	`justificativa` fuera 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 ruta

Cuerpo de la petición

Respuestas

Resultado

Errores5 ítems