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

POST /api/v1/nfse
Authorization: Bearer {token}
Content-Type: application/json
Idempotency-Key: fatura-2026-08-117

{
  "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

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

Sincronizar com a prefeitura

O banco do NFeRápido só conhece o que foi transmitido por ele. Nota emitida direto no portal da prefeitura, ou cancelada lá, não apareceria na listagem — e a numeração do cliente ficaria com buracos que o app não vê. A sincronização consulta a prefeitura e espelha o período:

• importa as NFS-e que só existem lá (série sentinela PREF, fonte = portal);
• marca como canceladas as notas nossas que foram canceladas no portal;
• recupera a autorização de nota nossa cuja resposta se perdeu (vínculo por RPS);
• reporta divergência de valor — nunca reescreve o valor de uma nota que o app transmitiu (o DANFSe é a via daquela declaração).

GET  /api/v1/nfse/sincronizar/suporte        → { disponivel, suportado, prefeitura, motivo }
POST /api/v1/nfse/sincronizar  { "de": "2026-09-01", "ate": "2026-09-30" }

Resposta: { prefeitura, operacao, na_prefeitura, importadas, atualizadas, inalteradas, canceladas_agora, vinculadas, divergencias[], falhas[] }. Sem de/ate o período é os últimos 30 dias; janela máxima de 366 dias.

Fonte	Quem usa	Operação consultada	Observações
São Paulo capital	empresa da capital no modelo municipal	ConsultaNFeEmitidas	imediata; traz também nota cancelada no período; ValorTotalRecebido é o total
São José dos Campos	empresa de SJC no modelo municipal	ConsultarNfseServicoPrestado (ABRASF)	imediata; nota cancelada vem com Rps/Status=2; a data do cancelamento é confirmada por ConsultarNfsePorRps
Ambiente de Dados Nacional (ADN)	qualquer outro município e o modelo nacional	distribuição de DF-e por NSU (/contribuintes/DFe)	universal: o ADN distribui ao emitente as próprias NFS-e — inclusive as emitidas em sistema municipal — e os eventos de cancelamento. Replicação com atraso (horas a dias); não exige Inscrição Municipal

Pré-requisitos: empresa em produção com certificado A1 (as fontes municipais também exigem a Inscrição Municipal). O botão Sincronizar com a prefeitura na listagem de NFS-e chama a mesma rota com o filtro de período da tela; GET /nfse/sincronizar/suporte diz qual fonte atende a empresa e por quê.

Pelo ADN, nota cancelada só aparece cancelada quando o evento chega; a sincronização nunca "descancela" uma nota que o app já tem como cancelada — a diferença é reportada em divergencias. Se o município não compartilhar as notas com o Ambiente Nacional, a resposta vem com aviso explicando.

Referência completa

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