NFS-e Nacional (DPS)

Endpoints para envio de Declaração de Prestação de Serviços (DPS) e consulta da NFS-e Nacional processada pelo Ambiente de Dados Nacional (ADN) da Receita Federal.

---

POST Emitir DPS / NFS-e Nacional

Submete a DPS assinada com certificado A1 diretamente ao portal do ADN.

POST /v1/invoices/nfse

Requisição

cURL

curl --request POST \
  --url http://localhost:3333/v1/invoices/nfse \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: fylee_live_...' \
  --header 'Idempotency-Key: fatura_servico_2026_10' \
  --data '{
    "codigoTributacaoNacional": "010701",
    "discriminacao": "Prestação de serviços de consultoria em desenvolvimento de software e infraestrutura de TI.",
    "tomador": {
      "cnpjCpf": "98765432000100",
      "razaoSocial": "EMPRESA CONTRATANTE LTDA",
      "email": "financeiro@contratante.com.br",
      "endereco": {
        "logradouro": "Av Rio Branco",
        "numero": "156",
        "bairro": "Centro",
        "codigoMunicipio": "3304557",
        "municipio": "Rio de Janeiro",
        "uf": "RJ",
        "cep": "20040003"
      }
    },
    "valores": {
      "valorServicos": 3500.00,
      "aliquotaIss": 2.5,
      "issRetido": false
    }
  }'

Exemplo de Resposta (201 Created)

{
  "id": "nfse_88291039",
  "status": "AUTORIZADA",
  "numeroNfse": 20260000001,
  "chaveAcessoNacional": "35261011222333000181000000000000000000001234567890",
  "valorServicos": 3500.00,
  "pdfUrl": "http://localhost:3333/v1/invoices/nfse_88291039/danfse"
}