Toda mensalidade é um serviço prestado
Licença ou acesso a software é serviço tributado pelo ISS. Cada cobrança paga, seja assinatura, plano anual ou upgrade, gera a obrigação de emitir uma NFS-e.
Para quem vende software
Criou um SaaS, talvez com ajuda de IA, e os primeiros clientes já estão pagando? Assinatura de software é prestação de serviço, e a prefeitura espera uma NFS-e para cada cobrança recebida. A SelfNotas emite a nota sozinha quando o pagamento é confirmado.
6 meses grátis no plano Essencial para quem está começando: até 500 notas por mês, sem pagar nada nesse período. Ver o plano
Muita gente coloca o SaaS no ar, liga o checkout e só lembra da nota fiscal quando o contador pergunta. Até lá, o problema já está acumulado.
Licença ou acesso a software é serviço tributado pelo ISS. Cada cobrança paga, seja assinatura, plano anual ou upgrade, gera a obrigação de emitir uma NFS-e.
Bancos, maquininhas e intermediadores de pagamento informam as movimentações ao Fisco. Faturamento sem nota é justamente o que aparece num cruzamento de dados com a Receita.
As prefeituras multam serviço prestado sem nota, e os valores variam de cidade para cidade. Emitir tudo de uma vez no fim do mês dá trabalho e não apaga o atraso.
Empresas precisam da NFS-e para lançar a despesa. Sem nota, a venda B2B trava no financeiro do cliente, ou nem acontece.
A NFS-e passa a trazer os campos de IBS e CBS. A SelfNotas já monta esses grupos no XML do Padrão Nacional, então você não precisa reescrever a integração.
Com 20 clientes dá para entrar no portal da prefeitura. Com 500 assinaturas renovando em dias diferentes, não dá. A nota precisa sair junto com o pagamento.
Conteúdo informativo. Regras de ISS, código de serviço e alíquota variam por município: confirme o enquadramento do seu SaaS com o seu contador.
Você já recebe um webhook quando o pagamento é aprovado no Stripe, Asaas, Mercado Pago, Pagar.me ou no gateway que usar. É ali que a nota sai.
POST /v1/nfse/emitir usando o id do pagamento como id do RPS.app.post("/webhooks/pagamento", async (req, res) => {
const pagamento = req.body; // evento "pagamento aprovado" do seu gateway
const r = await fetch("https://api.selfnotas.com.br/v1/nfse/emitir", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.SELFNOTAS_TOKEN}`,
"x-company-id": process.env.SELFNOTAS_COMPANY_ID,
"Content-Type": "application/json",
},
body: JSON.stringify({
rps: [{
id: pagamento.id, // webhook repetido devolve a mesma nota
tomador: {
cpf_cnpj: pagamento.cliente.documento,
razao_social: pagamento.cliente.nome,
email: pagamento.cliente.email,
},
servico: {
valor_servicos: pagamento.valor,
discriminacao: `Assinatura ${pagamento.plano}`,
item_lista_servico: "1.05", // confirme com o seu contador
aliquota: 2, // alíquota de ISS do seu município
},
}],
}),
});
const { data } = await r.json();
const nota = data?.notas?.[0];
if (nota) await enviarEmail(pagamento.cliente.email, nota.pdf_nfse);
res.sendStatus(200);
});
Se você usa Claude Code, Codex ou Cursor no projeto, copie o prompt ao lado. Ele aponta para o nosso guia para agentes, que explica autenticação, payload, erros e os cuidados para não emitir nota de verdade nos testes.
selfnotas.md
Guia completo para o agente. Pode salvar como AGENTS.md ou CLAUDE.md na raiz do projeto.
selfnotas-mcp
Servidor MCP: o agente consulta notas, links de PDF e XML e os requisitos do município direto na conversa. Como instalar.
Leia https://selfnotas.com.br/ai/selfnotas.md e faça este SaaS emitir NFS-e pela SelfNotas sempre que um pagamento for aprovado.
- Ligue no webhook de pagamento aprovado do gateway que o projeto já usa.
- Use o id do pagamento como id do RPS.
- Guarde número, chave e links de PDF e XML junto do pagamento.
- Mande o link do PDF no e-mail de confirmação do cliente.
- Em estorno, cancele a nota com o motivo.
- Credenciais em SELFNOTAS_TOKEN e SELFNOTAS_COMPANY_ID.
- Nos testes, use mock. Não chame /v1/nfse/emitir de verdade.
Quem está começando não deveria pagar para emitir as primeiras notas. Por isso, nesta página, o plano Essencial sai de graça nos 6 primeiros meses.
Essencial
Para quem está começando, como quem acabou de lançar um SaaS.
Depois, R$ 124,95/mês ou R$ 1.499,40/ano em até 12x sem juros
Começar grátisSim. A emissão no Padrão Nacional é assinada com o certificado A1 (e-CNPJ) da empresa. Você envia o arquivo uma vez, no cadastro, e a SelfNotas usa em cada nota.
O MEI emite NFS-e pelo Padrão Nacional e é obrigado a emitir quando o cliente é empresa. Para pessoa física, confirme a regra atual com o seu contador.
Depende do que o seu software faz e do município. Licenciamento de software costuma cair no item 1.05 da lista de serviços, mas confirme com o contador. A rota /v1/nfse/municipio/:ibge/requisitos mostra os campos que a sua cidade exige.
Cancele a nota pela API, com POST /v1/nfse/cancelar/:id e um motivo de pelo menos 10 caracteres. O cancelamento é registrado no Sistema Nacional da NFS-e.
São mais de 2.000 municípios homologados. Procure a sua na lista de municípios. Se não estiver lá, a gente faz a homologação.
6 meses grátis, até 500 notas por mês. Crie a conta, cadastre a empresa e o certificado, e ligue o webhook.