DC-e

Emitir DC-e

Acepta una Declaração de Conteúdo Eletrônica (modelo 99) y la autoriza de forma asíncrona en la SEFAZ.

POST/openapi/v2/empresas/{empresaId}/dc-e

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

La aceptación devuelve HTTP 200 sin cuerpo. Reenviar el mismo id: una huella idéntica del mensaje reutiliza la tarea original (idempotente), una huella distinta devuelve 10019030 y un fallo terminal anterior reabre la tarea con el nuevo mensaje. El resultado llega por la consulta o por los webhooks dce.authorized / dce.rejected (vea DC-e). La empresa debe estar aprobada, con certificado utilizable y con emissaoDCe configurado; ambiente debe coincidir con el entorno actual de la empresa (atención: el nombre del campo es ambiente, no ambienteEmissao como en la NF-e). Las cadenas de enumeración no distinguen mayúsculas de minúsculas.

Parámetros

Parámetros de ruta

empresaIdstringobligatorio
Identificador devuelto por Registrar empresa.
Ejemplo: 1934811222334455

Cuerpo de la petición

idstringobligatorio
Id del documento en el integrador (≤64), usado como variable de ruta dceId en la consulta / cancelación; clave de idempotencia.
Ejemplo: DCe-000012333
ambientestringobligatorio
Producao / Homologacao, debe coincidir con el entorno de la empresa (el nombre del campo es ambiente, no ambienteEmissao como en la NF-e). Una discrepancia devuelve DCe00004.
dataEmissaostringopcional
Fecha/hora de emisión en ISO-8601; por defecto el momento de aceptación. Con offset o Z (2026-09-08T10:00:00-03:00) se convierte tal como se indica; una hora local sin offset (2026-09-08T10:00:00) se interpreta en la zona horaria del estado de la empresa. Ventana permitida: como máximo 5 minutos hacia adelante y como máximo 30 días hacia atrás (configurable en el servidor); fuera de ella la solicitud falla con 10019048 (la SEFAZ rechaza un dhEmi futuro y el número se desperdiciaría; una fecha muy antigua arrastra el AAMM de la chave a un periodo antiguo). Se escribe en el XML dhEmi con el offset del estado de la empresa.
Ejemplo: 2026-09-06T12:00:00Z
remetenteobjectobligatorio para empresas Marketplace / Carrier
Remitente (DCe00005 cuando falta en una empresa Marketplace / Carrier); una empresa OwnIssuer puede omitirlo (la propia empresa); cuando se envía, cpfCnpj debe ser igual al CNPJ de la empresa.
destinatarioobjectobligatorio
Destinatario; cpfCnpj obligatorio (DCe00009).
itensarrayobligatorio
Mercancías declaradas, 1-999 ítems.
transporteobjectobligatorio
Datos de transporte.
autorizacaoDownloadXmlarrayopcional
CPF / CNPJ autorizados a descargar el XML, hasta 10 (10019022). No incluya el CNPJ del propio emisor (ya autorizado por defecto; el autorizador responde "CNPJ do Marketplace ja autorizado para download") y no repita un documento: ambos se rechazan en la aceptación.
informacoesAdicionaisstringopcional
Información adicional del marketplace (≤5000) → infAdic/infAdMarketplace.
informacoesAdicionaisFiscostringopcional
Información adicional para la autoridad fiscal (≤2000) → infAdic/infAdFisco.
informacoesAdicionaisEmitentestringopcional
Información complementaria del emisor (≤5000) → infAdic/infCpl.
observacoesMarketplacearrayopcional
Hasta 10 observaciones → infAdic/obsMarketplace (atributo xCampo + xTexto).

Respuestas

200

Aceptado; sin cuerpo de respuesta. El documento entra en Pendente y se numera y envía a la SEFAZ de forma asíncrona. Haga seguimiento por la consulta o el webhook.

Sin cuerpo de respuesta

Errores

Código	HTTP
10003000	404	`empresaId` no encontrado.
DCe00004	400	Empresa no configurada para DC-e (falta `tipoEmitente` / serie del modelo 99 / sitio del Marketplace), o `ambiente` distinto del entorno actual de la empresa (por ejemplo `Producao` enviado antes de que operaciones cambie la empresa a producción). Envíe `emissaoDCe` en el registro o en una actualización con `id`; envíe para el entorno actual de la empresa.
DCe00005	400	Empresa Marketplace / Carrier sin `remetente`. Informe el remitente.
DCe00006	400	`remetente.endereco` ausente. Informe la dirección del remitente.
DCe00007	400	Remitente brasileño sin `cpfCnpj`. Informe el documento del remitente.
DCe00008	400	La empresa no puede emitir (no aprobada / certificado no listo). Espere la aprobación / vincule el certificado.
DCe00009	400	Destinatario brasileño sin `cpfCnpj`. Informe el documento del destinatario.
GW001	400	Código IBGE del municipio no encontrado o inconsistente con `uf`. Verifique `cidade` / `uf`.
10019005	400	Solicitud duplicada concurrente. Reintente más tarde.
10019006	400	Demasiadas tareas pendientes para el CNPJ. Reintente más tarde.
10019007	400	Serie no resuelta (varias series habilitadas). Pida a operaciones consolidar las series.
10019013	400	Tipo de emisor `Carrier` aún no soportado en la emisión. Use una empresa Marketplace / OwnIssuer.
10019018	400	Ítem inválido (longitud del NCM, cantidad ≤ 0, precio unitario negativo). Corrija según `mensagem`.
10019019	400	Enumeración o formato inválido (`mensagem` cita el campo: `tipoPessoa`, `modalidade`, `dataEmissao`, documentos, teléfono, correo, `remetente` de emisor propio distinto de la empresa, ...). Corrija según `mensagem`.
10019020	400	CNPJ de la transportadora inválido. Corrija `cnpjTransportadora`.
10019021	400	Información adicional demasiado larga. Acorte el texto.
10019022	400	Cantidad o documento inválido en `autorizacaoDownloadXml`; incluye el CNPJ del propio emisor; documento repetido. Corrija la lista.
10019030	400	Mismo `id` con un mensaje distinto. Use un nuevo id o reenvíe el mensaje original.
10019031	400	Producción: ya existe un documento activo / autorizado para el `id`. Consulte el original.
10019048	400	`dataEmissao` fuera de la ventana permitida (más de 5 minutos hacia adelante o más de 30 días hacia atrás; `mensagem` trae los límites actuales). Use la hora actual u omita `dataEmissao`.
10001001	400	Falló la validación de campos (una entrada por campo). Corrija según `mensagem`.

Valores calculados y saneamiento

vProd = quantidade × valorUnitario (HALF_UP, 2 decimales) y vDC = Σ vProd son calculados por la plataforma y escritos en el XML. Los campos de texto se sanean (se quitan acentos, los caracteres de control se reemplazan por espacios, los espacios en blanco se colapsan) antes de validar la longitud.

Validación en la aceptación

Verificaciones realizadas en la aceptación (sin numeración, sin llamada a la SEFAZ, 400 directo): empresa apta para emitir con certificado utilizable y DC-e configurado; ambiente igual al de la empresa; longitud y dígitos verificadores de los documentos; código IBGE del municipio coherente con la UF; cep de 8 dígitos; itens no vacío con cantidad / precio unitario / NCM válidos; límites de tamaño de las listas; longitud de los textos.

Los rechazos de la SEFAZ durante la emisión no son errores HTTP: aparecen como estado Negada en la consulta y en el webhook dce.rejected. La máquina de estados completa está en DC-e.