Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

DACE e XML da DC-e

A DC-e tem dois artefatos de download, cada um com sua própria rota — não existe campo de URL no corpo da consulta.

Baixar a DACE (PDF)​

GET /v2/companies/{companyId}/ContentDeclarations/{id}/pdf?layout=full

DACE é o documento auxiliar da DC-e — representação visual, não o documento fiscal em si. Dois layouts:

layoutConteúdo
full (padrão)Completo
summaryResumido

Qualquer valor diferente de summary devolve o layout completo.

Em homologação, a DACE sai com a tarja "EMITIDO EM HOMOLOGAÇÃO — SEM VALOR FISCAL".

Baixar o XML autorizado​

GET /v2/companies/{companyId}/ContentDeclarations/{id}/xml

É o arquivo a guardar para fins fiscais — o XML é o documento; o PDF da DACE é só representação.

Os dois respondem com redirecionamento temporário​

302 Found
Location: https://<url-pré-assinada>

A resposta de ambos os endpoints é um 302 para uma URL temporária, válida por 5 minutos — use-a para baixar na hora, não a guarde nem a repasse. A maioria dos clientes HTTP segue o redirecionamento sozinha; se o seu não segue, leia o cabeçalho Location.

Sem accessKey/documentUrl no corpo — a única forma de obter o arquivo é por estas rotas

Diferente de outros documentos da NFE.io, a consulta de uma DC-e não traz nenhum campo de URL do PDF ou XML. Chame GET {id}/pdf ou GET {id}/xml diretamente, usando o id que você já tem.

Antes de a nota ser autorizada​

Enquanto a DC-e não é Authorized, não existe artefato para baixar — 404 em ambas as rotas. Acompanhe o status por consulta antes de tentar.

Erros​

CódigoO que significa
401Token ausente, expirado, com audiência errada, ou chave de API no lugar de JWT
403Token válido mas sem o escopo/papel da operação, ou assinatura não determinada
404Documento inexistente, ou o artefato ainda não foi gerado — a nota não está autorizada

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.