AN × ADN — SEFAZ e SEFIN na recepção
A recepção automática consome dois ambientes nacionais distintos, conforme o tipo de documento. Eles diferem em protocolo, autenticação e na forma de consultar e baixar os arquivos.
| Aspecto | AN (SEFAZ) — NF-e / CT-e | ADN (SEFIN) — NFS-e |
|---|---|---|
| Órgão | SEFAZ — Ambiente Nacional | SEFIN — Ambiente de Distribuição Nacional |
| Documentos | NF-e (55), CT-e (57) | NFS-e padrão nacional (56) |
| Protocolo de origem | SOAP (NFeDistribuicaoDFe) | REST |
| Certificado digital | A1 obrigatório | Certificado da empresa via mTLS |
| Paginação | Simples (pageIndex/pageCount); OData ($skiptoken) só no endpoint ProductInvoices | Simples (pageIndex/pageCount) |
| Download de XML/PDF | 302 redirect para URL assinada (HMAC-SHA256, ~30 min) | 302 redirect para URL assinada (PDF pode dar 202 se em geração) |
| Manifestação | Assíncrona (202 Pending) | Assíncrona (POST .../manifestations → 202 Pending) |
Ambiente da SEFAZ ≠ ambiente da NFE.io
O switch entre produção e homologação da SEFAZ é feito por configuração (campo environmentSEFAZ), não trocando de host — veja Autenticação. O host da API da NFE.io é o mesmo nos dois casos.
Implicações práticas
- A captura de NF-e/CT-e depende de um certificado A1 válido; sua expiração interrompe o polling (a empresa pode ser desativada).
- A captura de NFS-e também usa o certificado da empresa via mTLS no ADN — sem certificado válido, a captura é desativada (
deactivationReasonde certificado). Veja Certificado digital. - O
$skiptoken(cursor por NSU) existe no endpoint ODataProductInvoices; a listagem de documentos usa paginação simples (pageIndex/pageCount) nos dois lados.