Pular para o conteúdo principal

Emitir DC-e em lote

POST 

/v1/subscriptions/:subscriptionId/taxpayers/:taxpayerId/contentdeclarations/$batch

Recebe uma lista de declarações de um mesmo contribuinte e aceita cada uma independentemente.

Passadas as verificações do lote inteiro (contribuinte, cabeçalhos e contratação), a resposta é 200, com um resultado por item, na mesma ordem do array de entrada — cada resultado traz em index a posição do documento no array enviado. Correlacione por index.

Todos os itens compartilham o mesmo batchId: o valor do cabeçalho X-Batch-Id exatamente como você enviou, ou, sem o cabeçalho, um GUID com hífens gerado pelo servidor.

⚠️ O lote é sempre assíncrono. Cada item aceito volta com status: 202; nenhum item traz o documento pronto. Acompanhe cada id por GET {id}.

⚠️ Numeração e ordem de autorização não seguem a ordem de entrada. Série, número e autorização acontecem de forma assíncrona e em paralelo. Se você precisa de numeração sequencial na ordem do seu sistema, envie um POST por vez e espere o anterior.

Sem repetição segura​

🔴 Esta operação recusa Idempotency-Key com 400, e nada é criado. A recusa é de propósito: uma chave só não protege vários documentos, e aceitá-la sem avaliar faria um reenvio depois de um timeout emitir o lote inteiro de novo — com você acreditando estar protegido.

Reenviar o mesmo lote emite os documentos de novo. Se o seu processo reenvia (timeout, retry automático), use a emissão unitária: uma chamada por documento, cada uma com a sua Idempotency-Key e o mesmo X-Batch-Id. O agrupamento é o mesmo, e o reenvio devolve os documentos já criados em vez de emitir outros.

Request​

Responses​

Lote processado, um resultado por item, na ordem do array enviado. Cada item traz o código de status que a mesma requisição teria recebido sozinha: 202 quando aceita, 400 ou 422 quando recusada — inclusive o 422 da regra B10-10, conferida item a item. Os detalhes da recusa não vêm no lote: para lê-los, envie o item recusado pela emissão unitária.

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.