Endpoints NFS-e

Emitir, consultar, obter DANFSE e cancelar NFS-e.

Endpoints REST para emitir, consultar, obter DANFSE e cancelar Notas Fiscais de Serviços no padrão nacional.

Endpoints Disponíveis

POST/v1/nfse

Emite uma nova NFS-e (cria DPS, assina com A1 e transmite à SEFIN/ADN).

GET/v1/nfse/:id

Consulta o status, chave nacional de 50 dígitos e protocolo.

GET/v1/nfse/:id/danfse

Obtém a URL pública do PDF do DANFSE com QR Code.

GET/v1/nfse/:id/xml

Baixa o XML assinado da DPS e da NFS-e autorizada.

POST/v1/nfse/:id/cancel

Cancela uma NFS-e autorizada com motivo formal perante a SEFIN.

Emitir NFS-e (POST /v1/nfse)

Envie os dados do serviço e tomador em JSON simples:

O NFER gera o XML da DPS, assina com o Certificado Digital A1 da empresa e transmite em tempo real para o Ambiente de Dados Nacional.

POST/v1/nfse

Autenticação

Envie a chave da empresa via header X-API-Key.

POST /v1/nfsejson

{
  "codigo_tributacao_nacional": "01.07.01",
  "descricao_servico": "Consultoria em arquitetura de software - Ref. Agosto/2026",
  "valor_servico": 4500.00,
  "iss_retido": false,
  "tomador": {
    "cpf_cnpj": "12345678000195",
    "razao_social": "Tech Solutions LTDA",
    "email": "financeiro@techsolutions.com.br",
    "endereco": {
      "logradouro": "Av. Brigadeiro Faria Lima",
      "numero": "2000",
      "bairro": "Itaim Bibi",
      "municipio": "São Paulo",
      "uf": "SP",
      "cep": "01451000"
    }
  }
}

Resposta de Emissão

Resposta 200 OKjson

{
  "id": "nfse_98b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "status": "authorized",
  "numero_nfse": 1420,
  "chave_acesso_50": "35260812345678000195000000000000000001420123456789",
  "data_emissao": "2026-08-22T01:50:00Z",
  "valor_total": 4500.00,
  "danfse_url": "https://api.nfer.me/v1/nfse/nfse_98b1a2c3/danfse.pdf",
  "xml_url": "https://api.nfer.me/v1/nfse/nfse_98b1a2c3/xml",
  "qr_code_url": "https://www.nfse.gov.br/consultapublica/qr?ch=35260812345678000195000000000000000001420123456789"
}

Cancelar NFS-e (POST /v1/nfse/:id/cancel)

O cancelamento da NFS-e Nacional exige um código de motivo padronizado:

Códigos de cancelamento aceitos:

1 — Erro na emissão
2 — Serviço não prestado
3 — Duplicidade da nota

POST /v1/nfse/:id/canceljson

{
  "codigo_motivo": 1,
  "justificativa": "Cancelamento por emissão incorreta de valores acordados entre as partes."
}