NFC-e

Cancelar por sustitución

Cancela la NFC-e normal que quedó duplicada con una NFC-e de contingencia offline de la misma venta.

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

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

Caso típico: la nota normal se envió, la SEFAZ no respondió y la caja emitió una nota offline; después las dos quedaron válidas. Este endpoint cancela la nota normal identificada por nfceId y apunta a la nota offline que la sustituye. La plataforma ya resuelve sola la mayoría de estos casos cuando la SEFAZ vuelve; use este endpoint para casos especiales. Plazo: 168 horas después de la autorización.

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

`chaveAcessoSubstituta*`	string	Clave de la nota sustituta
`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.
10022004	400	La nota de `nfceId` no es normal, o la clave sustituta no es una NFC-e offline de la misma empresa.
10022007	400	Plazo de 168 horas vencido.
10001001	400	Validación de campo; `mensagem` indica el campo.

APP_SECRET='<APP_SECRET>'

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

TIMESTAMP=$(date +%s)

BODY='{

"chaveAcessoSubstituta": "35261111222333000181650010000001249123456790",

"justificativa": "Venda registrada em contingencia off-line"

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 por sustitución

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Resultado

Errores6 ítems