API para Emissão de DCe: O Que É a Declaração de Conteúdo Eletrônica e Como Integrar via REST

O envio de encomendas no Brasil sempre exigiu a comprovação detalhada do que está sendo transportado. Historicamente, quem não era contribuinte de ICMS ou estava dispensado da emissão de NF-e preenchia a declaração de conteúdo em papel impresso, colada manualmente com fita adesiva do lado de fora da caixa. Esse processo manual, no entanto, sempre foi fonte de gargalos operacionais severos, erros de digitação nos balcões dos Correios e retenções em postos fiscais de fronteira.

Para modernizar e digitalizar de forma definitiva esse fluxo logístico, o CONFAZ instituiu a Declaração de Conteúdo Eletrônica (DCe) — um Documento Fiscal Eletrônico (DF-e) 100% digital, validado em ambiente nacional e identificado por chave de acesso única de 44 dígitos e QR Code. Com a nova API de DCe do NFER, plataformas de e-commerce, marketplaces e operadores logísticos agora podem emitir a DCe instantaneamente via JSON.

O que é a Declaração de Conteúdo Eletrônica (DCe)?

A DCe é a versão digital e oficial da tradicional declaração de conteúdo que acompanha mercadorias e objetos postais quando a operação não está sujeita à tributação de ICMS ou quando o remetente não é obrigado a emitir Nota Fiscal Eletrônica (NF-e modelo 55 ou NFC-e modelo 65).

Quem pode ou deve emitir a DCe?

• Pessoas físicas que realizam vendas pontuais ou remessas de bens pessoais (como envio de equipamentos de trabalho, trocas, devoluções pessoais ou presentes).
• Microempreendedores Individuais (MEIs) em operações e vendas destinadas a pessoas físicas (quando a legislação dispensa a emissão de NF-e).
• Empresas que realizam movimentações internas de materiais e ferramentas de trabalho sem finalidade de comercialização.
• Plataformas de marketplace C2C (enjoei, Mercado Livre, OLX, Shopee) que intermedeiam transações entre pessoas físicas.

DCe vs NF-e vs NFC-e: Qual a diferença?

Cada documento eletrônico possui uma finalidade específica dentro do sistema logístico e tributário brasileiro. Entender a distinção é fundamental para não cometer infrações fiscais:

Por que a DCe Eletrônica Substitui a Declaração de Papel?

A declaração manual em papel apresentava falhas críticas para quem opera com escala e agilidade logística:

1. Erros de digitação e rasuras no balcão de postagem dos Correios ou transportadoras privadas (Jadlog, Loggi, Total Express, Azul Cargo).
2. Perda ou destruição do documento físico em trânsito por umidade ou atrito da embalagem.
3. Falta de rastreabilidade fiscal: transportadoras e postos fiscais não conseguiam checar previamente os dados da carga.
4. Atrasos na expedição: imprimir, cortar, preencher e colar declarações manuais adiciona minutos preciosos a cada pedido despachado no setor de packing.

Com a DCe via API do NFER, os dados do pacote são transmitidos digitalmente no ato da geração da etiqueta de envio. O operador apenas imprime a etiqueta já com o QR Code oficial da DCe acoplado ao código de barras do rastreio.

Como Funciona a Emissão de DCe via API REST NFER

A integração com a API de DCe do NFER é extremamente direta. Não há necessidade de assinar XMLs manualmente ou lidar com certificados de difícil configuração. Basta enviar uma requisição JSON com remetente, destinatário e itens declarados.

Em seu backend Node.js / TypeScript, a chamada é realizada com tipagem completa em poucas linhas:

Retorno em Tempo Real e Webhooks

Assim que a DCe é gerada, a API do NFER retorna:

• accessKey: A chave de identificação do DFe no padrão nacional de 44 dígitos.
• qrCodeUrl: Link para consulta pública e instantânea da declaração pela fiscalização.
• pdfUrl: Link direto do PDF da declaração de conteúdo formatado para impressoras térmicas (Zebra, Elgin) ou folhas A4.
• xmlUrl: O arquivo XML canônico estruturado e assinado digitalmente.

Além disso, você pode configurar Webhooks para que seu sistema de WMS ou ERP seja notificado no milissegundo em que o documento for gerado, liberando automaticamente a impressão no setor de expedição.