Pular para o conteúdo
TenzanNFEDocs

Getting Started

Introdução

Visão geral da API de emissão de documentos fiscais.

A API SaaS Core permite emitir e gerenciar documentos fiscais eletrônicos — NF-e, NFC-e, CT-e, MDF-e, NFCom, DC-e e NFS-e — através de uma única interface REST, sem que você precise lidar com certificado digital, geração de XML ou comunicação direta com a SEFAZ.

Como funciona

Seção intitulada “Como funciona”

Quando um documento é enviado para emissão (POST /v1/nfe/emit), ele passa por duas etapas:

  1. Validação síncrona — se faltar um campo obrigatório ou o formato dos dados estiver incorreto, a API responde imediatamente com um erro (4xx) e o documento não é enfileirado.
  2. Processamento assíncrono — se os dados forem aceitos, o documento entra numa fila e é assinado e enviado para a SEFAZ em segundo plano. A API responde 202 Accepted com um invoiceId, mas isso não significa que o documento já foi autorizado.

Para saber se um documento foi autorizado, rejeitado ou segue pendente, faça uma consulta (GET /v1/nfe/{id}) — normalmente via polling a cada poucos segundos até o status mudar de PENDENTE.

Emissão, cancelamento e carta de correção seguem esse fluxo assíncrono. Os demais eventos (ator interessado, insucesso na entrega, e-CONF, eventos de MDF-e, inutilização, consulta de status) são síncronos: a resposta HTTP já traz o resultado retornado pela SEFAZ.

Próximos passos

Seção intitulada “Próximos passos”