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.

DELETE/openapi/v2/empresas/{empresaId}/dc-e/{dceId}

Requiere las cabeceras de firma token, 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 110111 (nSeqEvento=1) 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 cuerpo es opcional: { "motivo": "..." } con 15-255 caracteres tras el saneamiento; cuando se omite, se usa el texto fijo Cancelamento solicitado pelo emitente por erro de preenchimento.. El DC-e oficial solo tiene cancelación: no hay carta de corrección ni inutilización de numeración.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador devuelto por Registrar empresa.
Ejemplo: 1934811222334455
dceIdstringobligatorio
El id enviado en la emisión.
Ejemplo: DCe-000012333

Cuerpo de la petición

motivostringopcional
Motivo de la cancelación, 15-255 caracteres tras el saneamiento (10019043 si queda por debajo de 15). Cuando se omite, se usa Cancelamento solicitado pelo emitente por erro de preenchimento..
Ejemplo: Cancelamento solicitado pelo emitente por erro de preenchimento.

Respuestas

200

Cancelación aceptada; sin cuerpo de respuesta. El documento pasa a CancelamentoPendente; el veredicto de la SEFAZ llega por el webhook.

Sin cuerpo de respuesta

Errores

Código	HTTP
DCe0001	404	`dceId` no encontrado, no pertenece a la empresa, o el documento aún no se ha materializado (todavía `Pendente`, sin chave). 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 (Manual DC-e). 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.

Firma del DELETE con cuerpo

Un DELETE sin cuerpo firma con la cadena vacía como body; un DELETE 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.

Restricciones y resultado

El documento debe estar Autorizada (10019040) y dentro de 24 horas tras la autorización (10019041), contadas desde el momento de la autorización.
Solo se acepta una cancelación por documento: llamadas adicionales durante la cancelación / tras la cancelación devuelven 10019042 / 10019040.
Un motivo con menos de 15 caracteres tras el saneamiento devuelve 10019043; un documento aún no materializado (todavía Pendente, sin chave) devuelve 404 DCe0001.
Resultado: dce.canceled con dceStatus=Cancelada (dceDataAutorizacao es el momento del registro de la cancelación y dceNumeroProtocolo el protocolo del evento; el DACE se re-renderiza con la marca de agua CANCELADA), o dce.cancel_rejected con dceStatus=CancelamentoNegado (el documento permanece Autorizada, la consulta trae el motivo en motivoStatus, y puede enviarse de nuevo un DELETE corregido). Cargas de los eventos en DC-e.