Skip to content

NFS-e Municipal (padrão ABRASF)

Nota Fiscal de Serviços no padrão do município (ABRASF 2.0 e variantes). Cobrimos as principais capitais e um catálogo crescente de municípios — consulte a cobertura pública em GET /api/v1/publico/nfse/cobertura?ibge={codigo}.

Para municípios no padrão nacional (LC 214/2025), use NFS-e Nacional — o roteamento por município é automático quando a empresa está configurada para o modelo nacional.

Emitir

http
POST /api/v1/nfse
Authorization: Bearer {token}
Content-Type: application/json
Idempotency-Key: fatura-2026-08-117
json
{
  "rps": { "serie": "RPS" },
  "servico": {
    "codigo": "03205",
    "discriminacao": "Disponibilizacao de cupons de vale-refeicao — quinzena 16/07 a 31/07",
    "valorServicos": 10535.00,
    "aliquota": 0
  },
  "tomador": {
    "cnpj": "45678901000123",
    "razaoSocial": "CLIENTE EXEMPLO LTDA",
    "endereco": {
      "logradouro": "Rua Exemplo", "numero": "100", "bairro": "Centro",
      "codigoMunicipio": "3550308", "uf": "SP", "cep": "01001000"
    },
    "contato": { "email": "financeiro@cliente.com.br" }
  }
}
  • A numeração do RPS é automática e atômica — não envie número.
  • O código de serviço é o do cadastro municipal do prestador (ex.: São Paulo usa o código do CCM — 5 dígitos).
  • Alíquota 0 é válida para optante do Simples com ISS recolhido no DAS.
  • A resposta traz o número da NFS-e e o código de verificação atribuídos pela prefeitura.

Extração de itens por IA (opcional)

Recebeu a demanda por e-mail? POST /api/v1/nfse/parse-cupons extrai quantidade × valor + tomador de um texto colado, com conferência automática contra o total declarado no próprio e-mail.

Cancelar

http
POST /api/v1/nfse/{id}/cancelar

O prazo e as regras de cancelamento são do município (São Paulo aceita cancelamento pela API; outros exigem processo administrativo após prazo curto).

Consultas

  • GET /api/v1/nfse/{id} — situação e dados completos
  • GET /api/v1/nfse/{id}/danfse — PDF da nota
  • GET /api/v1/publico/nfse/cobertura?busca=nome — cobertura por município

Referência completa

Todos os campos e validações no Swagger interativo.

Emissão ilimitada em todos os planos.