FAQ técnico: API e webhook de NF-e e CT-e
· 6 min de leitura
Respostas diretas às dúvidas técnicas mais comuns de quem vai integrar API ou webhook de NF-e e CT-e.
API
O endpoint de documentos é o mesmo para NFS-e, NF-e e CT-e?
Sim. Veja como filtrar por tipo de documento em API pública para NF-e e CT-e.
Documentos recebidos e emitidos vêm marcados de alguma forma na resposta?
Sim, cada documento retornado indica o papel da empresa consultada naquela operação (emitente ou destinatária), permitindo separar os dois lados do lado de quem consome a API.
Webhook
Existe um evento por tipo de documento?
Sim: eventos próprios para NF-e recebida e CT-e recebido, além dos já existentes para NFS-e, sem afetar quem já assina só os eventos antigos.
O que fazer quando o endpoint do webhook está temporariamente fora do ar?
As tentativas de entrega são repetidas automaticamente por um período: o ponto de atenção é garantir que o processamento do lado de quem recebe seja idempotente, para lidar bem com uma eventual reentrega. Mais detalhes em erros comuns ao configurar webhook de NF-e e CT-e.
Integração
É preciso um adapter diferente por tipo de documento no ERP?
Geralmente sim, para os campos específicos de cada documento (itens de produto na NF-e, dados de transporte no CT-e), mas a estrutura comum (identificação, datas, chave de acesso) pode ser tratada de forma unificada. Mais em como integrar NF-e e CT-e ao ERP.
A referência completa de endpoints, parâmetros e payloads de webhook está na documentação da API pública da IntegroBR.