Notas fiscais de serviço por API, para todos os seus clientes.
Linksig Notas emite NFS-e no Sistema Nacional (Sefin Nacional) de forma assíncrona, idempotente e validada contra o XSD oficial antes de chegar na Sefin. O resultado chega por webhook.
O que a API faz
Emissão assíncrona
Responde 202 na hora; um worker numera, assina e transmite a DPS para a Sefin.
Sem nota duplicada
Idempotency-Key obrigatória e consulta da DPS antes de qualquer retransmissão.
Validação no XSD oficial
Erros de formato e regras do Anexo I voltam antes de enfileirar, apontando o campo.
Leiaute completo
Exportação, obra, evento, deduções, intermediário, substituição, PIS/COFINS e IBS/CBS.
Multitenant
Clientes isolados, planos com limite por minuto, cota mensal e emitentes.
Certificado A1 protegido
PFX criptografado em repouso, usado só pelos workers e descartado após cada envio.
Webhooks assinados
Eventos nfse.autorizada, nfse.rejeitada, nfse.cancelada, nfse.cancelamento_rejeitado, nfse.substituida e os da NFC-e, com HMAC-SHA256 e re-tentativas.
Alerta de certificado
Webhook certificado.vencendo 30, 15, 7 e 1 dia antes e certificado.vencido depois do vencimento.
Como funciona
- CadastreA Linksig cadastra a sua empresa, o emitente e o certificado A1.
- Emita
POST /api/v1/nfsecom a Idempotency-Key. A API valida e responde 202. - RecebaWebhook
nfse.autorizadacom a chave de acesso, ou consulte a nota.
Tipos de nota
NFS-e Padrão Nacional (serviços, ISS municipal), emitida pelo prestador, e NFC-e em piloto na Paraíba (veja abaixo). Não emite NF-e nem CT-e. Regimes: não optante, MEI e ME/EPP.
| Operação | Como enviar | API + XSD | Sefin |
|---|---|---|---|
| Serviço tributável | tributacao_issqn: 1 | ✅ | ⏳ |
| ISS retido pelo tomador | iss_retido: true | ✅ | ⏳ |
| ISS retido pelo intermediário | retido_por: intermediario | ✅ | ⏳ |
| Imunidade | tributacao_issqn: 2 | ✅ | ⏳ |
| Não incidência | tributacao_issqn: 4 | ✅ | ⏳ |
| Exportação de serviço | tributacao_issqn: 3 + comercio_exterior | ✅ | ⏳ |
| Serviço prestado no exterior | servico.codigo_pais_prestacao | ✅ | ⏳ |
| Tomador ou intermediário estrangeiro | nif / motivo_sem_nif | ✅ | ⏳ |
| Obra | servico.obra | ✅ | ⏳ |
| Atividade de evento | servico.evento | ✅ | ⏳ |
| Deduções e reduções | deducoes | ✅ | ⏳ |
| Exigibilidade suspensa | tributacao.exigibilidade_suspensa | ✅ | ⏳ |
| Benefício municipal | tributacao.beneficio_municipal | ✅ | ⏳ |
| PIS/COFINS e retenções federais | tributacao.pis_cofins / retencoes | ✅ | ⏳ |
| IBS/CBS (Reforma Tributária) | ibscbs | ✅ | ⏳ |
| Substituição de nota | substituicao | ✅ | ⏳ |
| Cancelamento | POST /nfse/{id}/cancelamento | ✅ | ⏳ |
| DANFSe (PDF, NT 008/2026) | GET /nfse/{id}/danfse | ✅ | ⏳ |
✅ implementado e validado no XSD oficial · ⏳ aguardando homologação na Sefin. Fora do escopo: emissão pelo tomador ou intermediário e manifestação da NFS-e.
NFC-e: venda no balcão
Resposta na hora
O caixa recebe a nota autorizada, com QR Code e cupom em PDF de 80mm, numa única chamada.
SEFAZ fora? Vende igual
A API emite em contingência automaticamente e transmite quando a SEFAZ volta, em até 24 horas.
Simples e MEI
Lojas, lanchonetes e restaurantes da Paraíba (autorizador SVRS).
Cancelamento
Até 30 minutos da autorização; 168 horas para nota de contingência, contadas da autorização após a transmissão.
Alertas de ação manual
Webhooks nfce.substituicao_recusada e nfce.contingencia_prazo_esgotado avisam quando uma nota precisa de atenção.
Onde dá para emitir
NFS-e é municipal: quem define é o município do prestador, não o estado.
de 5.571 municípios (51,6%) aceitam emissão pela API para qualquer regime.
aderiram ao padrão nacional mas mantêm emissor próprio (ex.: João Pessoa): pela API, MEI e, a partir de 1º/11/2026, Simples Nacional. 28 ainda não aderiram.
ME/EPP do Simples Nacional passam a emitir pelo Emissor Nacional em qualquer município (Resolução CGSN nº 191/2026). MEI já emite em todos.
capitais aceitam emissão pela API para qualquer regime.
Capitais com emissor nacional
1200401
Manaus AM · 1302603
Vitória ES · 3205309
São Luís MA · 2111300
Belo Horizonte MG · 3106200
Recife PE · 2611606
Curitiba PR · 4106902
Rio de Janeiro RJ · 3304557
Natal RN · 2408102
Boa Vista RR · 1400100
Porto Alegre RS · 4314902
Florianópolis SC · 4205407
São Paulo SP · 3550308
Capitais que aderiram com emissor próprio (pela API: MEI e, a partir de 1º/11/2026, Simples)
2704302
Macapá AP · 1600303
Salvador BA · 2927408
Fortaleza CE · 2304400
Brasília DF · 5300108
Goiânia GO · 5208707
Campo Grande MS · 5002704
Cuiabá MT · 5103403
Belém PA · 1501402
João Pessoa PB · 2507507
Teresina PI · 2211001
Porto Velho RO · 1100205
Aracaju SE · 2800308
Palmas TO · 1721000
Meu município aceita?
Municípios com emissor nacional por UF
| UF | Municípios | Com emissor nacional | % |
|---|---|---|---|
| AC | 22 | 11 | 50% |
| AL | 102 | 68 | 66% |
| AM | 62 | 36 | 58% |
| AP | 16 | 11 | 68% |
| BA | 417 | 139 | 33% |
| CE | 184 | 65 | 35% |
| DF | 1 | 0 | 0% |
| ES | 78 | 29 | 37% |
| GO | 246 | 111 | 45% |
| MA | 217 | 88 | 40% |
| MG | 853 | 482 | 56% |
| MS | 79 | 51 | 64% |
| MT | 142 | 63 | 44% |
| PA | 144 | 113 | 78% |
| PB | 223 | 71 | 31% |
| PE | 185 | 66 | 35% |
| PI | 224 | 107 | 47% |
| PR | 399 | 195 | 48% |
| RJ | 92 | 49 | 53% |
| RN | 167 | 76 | 45% |
| RO | 52 | 19 | 36% |
| RR | 15 | 9 | 60% |
| RS | 497 | 302 | 60% |
| SC | 295 | 203 | 68% |
| SE | 75 | 37 | 49% |
| SP | 645 | 421 | 65% |
| TO | 139 | 53 | 38% |
Dados da planilha oficial de adesões de 28/09/2026 (atualizada até 14/09/2026). A adesão muda com frequência: confira o painel oficial. Lista completa: nfse-municipios.csv.
Primeira chamada
curl -X POST https://notas.linksig.com.br/api/v1/nfse \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: pedido-1001" \
-H "Content-Type: application/json" -H "Accept: application/json" \
-d '{
"emitente_id": 1,
"competencia": "2026-10-17",
"servico": { "codigo_tributacao_nacional": "010101", "descricao": "Desenvolvimento de software",
"codigo_municipio_prestacao": "3550308", "valor": 1500 },
"tributacao": { "iss_retido": false, "aliquota_iss": 2,
"total_tributos": { "tipo": "percentual", "federal": 13.45, "estadual": 0, "municipal": 2 } },
"tomador": { "documento": "00000000000191", "nome": "Cliente Exemplo S.A." }
}'
Links
Fontes
- Documentação técnica atual — Portal NFS-e (gov.br)
- Esquemas XSD v1.01 (20260209) — base da DPS e da validação
- Anexo I — Leiaute e regras de negócio DPS/NFS-e v1.01
- Reforma Tributária (IBS/CBS) — Portal NFS-e
- Monitoramento das Adesões à NFS-e e planilha de municípios aderentes
- API de Localidades do IBGE — códigos dos municípios