Endpoints NFS-e Tomadas & ADN Nacional
Captura no Ambiente de Dados Nacional, filtro de IBS/CBS, estatísticas e cancelamentos.
Referência técnica dos endpoints da API REST para captura de NFS-e de Serviços Tomados diretamente do Ambiente de Dados Nacional (ADN da Receita Federal), com suporte a auditoria de IBS e CBS da Reforma Tributária.
Endpoints Disponíveis
/api/nfse/receivedLista as NFS-e tomadas com suporte a busca textual, intervalo de datas e filtro de créditos IBS/CBS.
/api/nfse/received/syncForça a sincronização imediata por NSU junto ao webservice nacional do ADN.
/api/nfse/received/statsRetorna consolidação estatística de valores tomados, retenções de impostos e cancelamentos detectados.
/api/nfse/received/:idObtém o detalhamento completo da NFS-e tomada, prestador, discriminação dos serviços e impostos.
/api/nfse/received/:id/xmlFaz o download do arquivo XML da NFS-e de distribuição do padrão nacional.
/api/nfse/received/:id/danfseGera e faz o download do DANFSe (Documento Auxiliar da NFS-e) em PDF oficial com QR Code.
Parâmetros de Consulta (Query Params)
| Parâmetro | Tipo | Descrição |
|---|---|---|
| ibsCbs | string | Filtro da Reforma Tributária: "destacado" (com crédito) ou "ausente". |
| status | string | Status da nota: "AUTORIZADA", "CANCELADA" ou "SUBSTITUIDA". |
| search | string | Busca por termo na razão social, CNPJ do prestador ou discriminação. |
| from | string (ISO) | Data inicial de emissão (ex: 2026-09-01). |
| to | string (ISO) | Data final de emissão (ex: 2026-09-30). |
| page | number | Número da página (padrão: 1). |
| limit | number | Quantidade de registros por página (1 a 100, padrão: 20). |
Listando com Filtro de IBS/CBS
Requisição para auditar notas com créditos destacados da Reforma Tributária:
Resposta Estruturada
JSON completo pronto para alimentar o Contas a Pagar: