Uma integração segura com o ADN para todas as empresas.

Status em tempo real

Última verificação: -

Distribuição DF-e por NSU ou chave

Executa uma única chamada mTLS ao serviço oficial NFeDistribuicaoDFe. Use ult_nsu para distNSU ou chave_acesso para consChNFe; nunca envie os dois juntos. O gateway não controla cursor, não faz polling, não persiste documentos e não interpreta nem descompacta o XML.

Exemplo cURL

curl -X POST "https://adn-gateway.pes2b.com/nfe/distribuicao-dfe" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_OPERACIONAL" \
  -d '{
    "empresa_codigo": "JORGEPLA_CONTABILIDADE",
    "cnpj_consulta": "10576541000116",
    "ult_nsu": "000000000000000"
  }'

Resposta sem documentos

{
  "success": true,
  "cStat": "137",
  "xMotivo": "Nenhum documento localizado",
  "ultNSU": "000000000000000",
  "maxNSU": "000000000000000",
  "documentos": []
}

Consulta por chave

{
  "empresa_codigo": "JORGEPLA_CONTABILIDADE",
  "cnpj_consulta": "10576541000116",
  "chave_acesso": "43260906016957000102550010000577441013257384"
}

Registrar evento da NF-e

Resolve o certificado A1 da empresa ou da matriz, assina o XML e envia uma única chamada síncrona ao serviço oficial NFeRecepcaoEvento. São aceitos Confirmação (210200), Ciência (210210), Desconhecimento (210220) e Operação não Realizada (210240).

Exemplo — Ciência da Operação

curl -X POST "https://adn-gateway.pes2b.com/nfe/manifestacao-destinatario" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_OPERACIONAL" \
  -d '{
    "empresa_codigo": "JORGEPLA_CONTABILIDADE",
    "cnpj_destinatario": "10576541000116",
    "chave_acesso": "43260906016957000102550010000577441013257384",
    "tipo_evento": "210210",
    "sequencia_evento": 1,
    "justificativa": null,
    "idempotency_key": "controle-opcional-do-n8n"
  }'

Para 210240, a justificativa é obrigatória e deve ter entre 15 e 255 caracteres. O cStat 135 é registrado e vinculado; o 136 é registrado sem vínculo.

Primeiros passos

URL base

https://adn-gateway.pes2b.com

Autenticação

A API operacional usa uma chave exclusiva no cabeçalho HTTP. Não envie a chave no endereço, corpo ou parâmetros da requisição.

X-API-Key: SUA_CHAVE_OPERACIONAL

Consultar documento fiscal

Consulta o ADN com o certificado A1 resolvido para a empresa. Para uma filial configurada para herdar o certificado, o gateway usa automaticamente o certificado da matriz e preserva o CNPJ consultado da filial.

Exemplo cURL

curl -X POST "https://adn-gateway.pes2b.com/adn/consultar-dfe" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_OPERACIONAL" \
  -d '{
    "empresa_codigo": "JORGEPLA_CONTABILIDADE",
    "cnpj_consulta": "10576541000116",
    "nsu": 2144
  }'

Resposta

{
  "sucesso": true,
  "empresa_codigo": "JORGEPLA_CONTABILIDADE",
  "nsu": 2144,
  "data": { "documentos": [] }
}

Campos da consulta

Configuração no n8n

Crie uma única credencial do tipo Header Auth e reutilize-a nas rotas de NFS-e e NF-e. No nó HTTP Request, selecione essa credencial e envie o corpo como JSON.

Matrizes e filiais

O cadastro permite certificado dedicado ou compartilhado. Quando uma filial está marcada para usar o certificado A1 da matriz, nenhuma cópia do arquivo precisa ser enviada para ela. A consulta e o evento continuam usando o CNPJ da filial; na manifestação, o certificado precisa pertencer ao mesmo CNPJ-base.

Respostas de erro

API administrativa

Os endpoints /admin/empresas e /admin/certificados sustentam a tela do Appsmith e usam Authorization: Bearer. Eles aparecem no Swagger para referência da equipe técnica, mas o token não deve ser compartilhado com integrações comuns.

Downloads

Segurança

• Certificados e senhas ficam criptografados no banco; a API nunca os devolve.
• A chave operacional é armazenada no servidor somente como hash SHA-256.
• Use uma credencial do n8n, nunca texto fixo dentro do workflow.
• Ao suspeitar de exposição, solicite rotação imediata da chave.
• O endpoint público /health não revela segredos.