Monitor Fiscal (DFe)
Endpoints NFS-e Tomadas & ADN Nacional
Captura no Ambiente de Dados Nacional, filtro de IBS/CBS, estatísticas e cancelamentos.
Disponibilidade: Planos Corporate e Enterprise.
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
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Listar NFS-e Tomadas | GET /api/nfse/received | Ver Filtros & Parâmetros → |
| Sincronizar com ADN | POST /api/nfse/received/sync | Ver Sincronização → |
| Estatísticas & Retenções | GET /api/nfse/received/stats | Ver Consolidação → |
| Detalhes da NFS-e | GET /api/nfse/received/:id | Ver Discriminação & Impostos → |
| Download XML (Padrão Nacional) | GET /api/nfse/received/:id/xml | Ver Download do XML → |
| Download DANFSE (PDF) | GET /api/nfse/received/:id/danfse | Ver Download do PDF → |
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:
curl "https://api.nfer.me/api/nfse/received?ibsCbs=destacado&limit=10" \
-H "Authorization: Bearer nfer_live_..."
Resposta Estruturada
JSON completo pronto para alimentar o Contas a Pagar:
{
"total": 38,
"page": 1,
"limit": 10,
"items": [
{
"id": "nfse_rec_4021",
"chave_acesso": "35260923412981000144560010000008319100008319",
"numero": 8319,
"prestador": {
"cnpj": "23.412.981/0001-44",
"razao_social": "AWS Serviços de Nuvem Brasil"
},
"valor_servicos": 4820.50,
"ibs_cbs_destacado": true,
"status": "AUTORIZADA",
"danfse_url": "https://api.nfer.me/api/nfse/received/nfse_rec_4021/danfse"
}