DC-e
Cancelar DC-e
Solicita la cancelación de un DC-e autorizado (hasta 24 horas después de la autorización); asíncrono, resultado vía webhook.
/openapi/v2/empresas/{empresaId}/dc-e/{dceId}/cancelartoken, timestamp y sign, vea Autenticación.La aceptación devuelve HTTP 200 sin cuerpo, el documento pasa a CancelamentoPendente y la plataforma registra el evento de cancelación 110111 en la SEFAZ de forma asíncrona. El resultado llega por el webhook dce.canceled (Cancelada) o dce.cancel_rejected (CancelamentoNegado), y también puede consultarse por la consulta. El DC-e oficial solo tiene cancelación: no hay carta de corrección ni inutilización de numeración.
Parámetros de ruta
empresaId* | string | Identificador de la empresa emisora |
dceId* | string | Identificador del documento |
* Campo obligatorio
Cuerpo de la petición
motivo | string | Motivo de la cancelación |
* Campo obligatorio
CancelamentoPendente; el veredicto de la SEFAZ llega por el webhook.Sin cuerpo de respuesta
Un POST sin cuerpo firma con la cadena vacía como body; un POST con cuerpo (cancelación con motivo) firma el JSON bruto con CR/LF eliminados, exactamente como los endpoints JSON. Si envía { "motivo": ... }, incluya ese mismo texto en la firma. Vea Autenticación.
El documento debe estar Autorizada (10019040) y dentro de 24 horas tras la autorización (10019041); solo se acepta una cancelación por documento (10019042). El veredicto de la SEFAZ llega por uno de los dos webhooks siguientes; las cargas completas están en DC-e.
Cancelación registrada: dce.canceled
dceStatus es Cancelada; dceDataAutorizacao es el momento del registro de la cancelación y dceNumeroProtocolo el protocolo del evento. El DACE pasa a llevar la marca de agua CANCELADA.
{ "tipo": "DC-e", "empresaId": "1934811222334455", "dceId": "DCe-000012333", "dceStatus": "Cancelada", "dceMotivoStatus": null,"dceChaveAcesso": "4126...", "dceDataAutorizacao": "2026-09-06T15:00:00Z", "dceNumeroProtocolo": "141260000000099" }
Cancelación rechazada: dce.cancel_rejected
dceStatus es CancelamentoNegado y dceMotivoStatus trae el código y la descripción de la SEFAZ. El documento permanece Autorizada, la consulta muestra el motivo en motivoStatus, y puede enviarse de nuevo una cancelación corregida.
{ "tipo": "DC-e", "empresaId": "1934811222334455", "dceId": "DCe-000012333", "dceStatus": "CancelamentoNegado","dceMotivoStatus": "594 - Rejeicao: O numero de sequencia do evento informado e maior que o permitido","dceChaveAcesso": "4126...", "dceDataAutorizacao": null, "dceNumeroProtocolo": "141260000000001" }
| Código | HTTP | |
|---|---|---|
| 10019002 | 404 | dceId no encontrado, no pertenece a la empresa, o el documento aún no fue numerado (todavía Pendente, sin clave). Cancele documentos Pendente solo después de la autorización. |
| 10019003 | 404 | dceId no encontrado, no pertenece a la empresa, o el documento aún no fue numerado (todavía Pendente, sin clave). Cancele documentos Pendente solo después de la autorización. |
| 10003000 | 404 | empresaId no encontrado. |
| 10019040 | 400 | El estado no permite la cancelación: el documento debe estar Autorizada (los documentos ya cancelados también devuelven este código). |
| 10019041 | 400 | Ventana de 24 horas tras la autorización excedida. El documento solo puede mantenerse. |
| 10019042 | 400 | Cancelación ya aceptada para este documento (en curso). Solo se acepta una cancelación por documento. |
| 10019043 | 400 | motivo inválido: menos de 15 caracteres tras el saneamiento. |