Pular para o conteúdo principal

Emitir uma DC-e

POST 

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

Cria e transmite uma DC-e em uma única chamada.

O serviço faz tudo: numeração, assinatura com o certificado da empresa, validação contra o XSD e transmissão à SEFAZ.

Síncrono ou assíncrono​

Você enviaVocê recebe
sem o cabeçalho Prefer200 com o documento em estado terminal (autorizado, rejeitado ou recusado)
Prefer: respond-async202 com o id e o cabeçalho Location, para consultar depois

⚠️ O modo síncrono também pode responder 202: ele espera até 30 segundos pelo desfecho; se a autorização não chegar a um estado terminal nesse tempo, a resposta degrada para 202 com Location. Trate 202 como resultado possível sempre, e não só quando você pediu.

Antes de emitir​

A ordem das verificações é: contribuinte da assinatura (404), forma do pedido (400) e regras da DC-e (422), contratação (403), e por fim o ambiente contra o cadastro da empresa (422, regra B10-10). Nenhuma recusa consome numeração.

Numeração e série​

serie e number são atribuídos pelo servidor — não os envie. Eles aparecem na resposta assim que a numeração é definida.

Repetição segura​

Envie Idempotency-Key para que um reenvio (timeout de rede, retry automático) não emita um segundo documento nem consuma numeração fiscal de novo. Veja a descrição do cabeçalho.

Agrupar em lote​

Para emitir vários documentos juntos e poder reenviá-los com segurança, chame esta operação uma vez por documento, cada chamada com a sua Idempotency-Key, e o mesmo X-Batch-Id em todas. O lote volta no campo batchId da resposta, do detalhe e da listagem, onde é filtrável. A emissão em lote ($batch) agrupa, mas não oferece repetição segura.

Request​

Responses​

Emissão concluída no modo síncrono. O documento está em estado terminal — leia status para saber qual.

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.