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.
/openapi/v2/empresas/{empresaId}/dc-etoken, 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. Las cadenas de enumeración no distinguen mayúsculas de minúsculas.
Parámetros de ruta
empresaId* | string | Identificador de la empresa emisora |
* Campo obligatorio
Cuerpo de la petición
id* | string | Identificador de la solicitud |
ambiente* | string | Ambiente |
dataEmissao | string | Fecha de emisión |
*obligatorio para empresa Marketplace | object | Remitente |
* | object | Destinatario |
* | array | Ítems declarados |
* | object | Transporte |
| array | Autorizados a descargar el XML |
informacoesAdicionais | string | Observación del marketplace |
informacoesAdicionaisFisco | string | Observación al fisco |
informacoesAdicionaisEmitente | string | Observación del emisor |
| array | Observaciones del marketplace |
* Campo obligatorio
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
El tipo de emisión de DC-e definido en el registro de la empresa decide cómo se rellena remetente. Marketplace emite en nombre de un vendedor; OwnIssuer emite en nombre propio; Carrier aún no puede emitir y devuelve 10019013.
Marketplace emitiendo por un vendedor
El vendedor va en remetente con documento y dirección; el CNPJ de la clave sigue siendo el de la empresa Marketplace.
"remetente": {"tipoPessoa": "F", "nome": "JOAO DA SILVA", "cpfCnpj": "12345678909", "telefone": "41999990000","endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "RUA XV DE NOVEMBRO", "numero": "100", "bairro": "CENTRO", "cep": "80020310" }}
* | object | Remitente |
* Campo obligatorio
Empresa emitiendo en nombre propio
No envíe remetente: el remitente y la dirección de origen vienen del registro de la empresa. Si envía remetente.cpfCnpj, debe ser el CNPJ de la propia empresa, si no 10019019.
{"id": "DCe-000012334","ambiente": "Homologacao","destinatario": {"tipoPessoa": "F", "nome": "MARIA OLIVEIRA", "cpfCnpj": "11144477735","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA", "cep": "01310100" }},"itens": [ { "descricao": "CARTEIRA", "ncm": "42023100", "quantidade": 1, "valorUnitario": 40.00 } ],"transporte": { "modalidade": "PorContaPropria" }}
modalidade es obligatoria. cnpjTransportadora solo tiene sentido con PorEmpresaTransportadora.
Correo o medios propios
"transporte": { "modalidade": "PelosCorreios" }
* | object | Transporte |
* Campo obligatorio
Transportista contratado
"transporte": { "modalidade": "PorEmpresaTransportadora", "cnpjTransportadora": "14422279000106" }
* | object | Transporte |
* Campo obligatorio
El total de cada línea es cantidad × precio unitario, redondeado a 2 decimales; el total del documento es la suma de las líneas. Ambos los calcula la plataforma y no van en la solicitud. Los campos de texto se sanean (se quitan acentos, los caracteres de control se cambian por espacio, los espacios se colapsan) antes de validar la longitud.
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 y 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.
ambienteAmbiente de emisión
| Valores | Significado |
|---|---|
| Homologacao | Ambiente de prueba de la SEFAZ; el documento no tiene validez |
| Producao | Ambiente oficial |
remetente.tipoPessoaTipo de persona
También vale para destinatario.tipoPessoa.
| Valores | Significado |
|---|---|
| F | Persona física; cpfCnpj de 11 dígitos |
| J | Persona jurídica; cpfCnpj de 14 dígitos |
transporte.modalidadeModalidad de transporte
| Valores | Significado |
|---|---|
| PelosCorreios | Enviado por el correo |
| PorContaPropria | Llevado por medios propios del remitente |
| PorEmpresaTransportadora | Llevado por una transportista; informe cnpjTransportadora |
| Código | HTTP | |
|---|---|---|
| 10003000 | 404 | empresaId no encontrado. |
| 10019012 | 400 | Empresa no configurada para DC-e (falta tipoEmitente / serie del modelo 99 / sitio del Marketplace). Envíe emissaoDCe en el registro o en una actualización con id. |
| 10019010 | 400 | ambiente distinto del entorno actual de la empresa (por ejemplo Producao enviado antes de que operaciones cambie la empresa a producción). Envíe para el entorno actual de la empresa. |
| 10019014 | 400 | Empresa Marketplace sin remetente. Informe el remitente. |
| 10019015 | 400 | remetente.endereco ausente. Informe la dirección del remitente. |
| 10019016 | 400 | Remitente brasileño sin cpfCnpj. Informe el documento del remitente. |
| 10019004 | 400 | La empresa no puede emitir (no aprobada / certificado no listo). Espere la aprobación / vincule el certificado. |
| 10019017 | 400 | Destinatario brasileño sin cpfCnpj. Informe el documento del destinatario. |
| 10019011 | 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. |