Integrar emissão automática de notas fiscais eletrônicas (NF-e, NFS-e e NFC-e) no seu produto não precisa exigir contratos empresariais caros ou aprovações manuais burocráticas. Se você está criando um SaaS, um e-commerce, uma software house ou um projeto via Vibe Coding (Cursor, Lovable, v0), você pode começar hoje mesmo utilizando uma API fiscal gratuita.
Neste guia direto ao ponto, você verá como configurar a API da Notaas para emitir até 50 notas fiscais gratuitas por mês em produção real e testes ilimitados em Sandbox, com suporte a webhooks assinados, certificados digitais A1 em nuvem e geração automática de PDF e XML.
🎁 O que o Plano Gratuito da Notaas Realmente Inclui?
Diferente de soluções legadas que oferecem apenas "períodos de teste de 14 dias", o plano Free da Notaas é vitalício e oferece acesso aos recursos de engenharia da plataforma:
- 50 Notas Fiscais/Mês Gratuitas: Válidas para emissão em produção com valor fiscal real (NFS-e de serviços, NF-e de produtos e NFC-e).
- Ambiente de Sandbox Imediato: Emita centenas de notas de teste sem consumir seus créditos e sem gerar obrigações tributárias.
- 1 CNPJ Emissor Completo: Configuração direta de certificado digital A1 (.pfx / .p12).
- Webhooks com Assinatura HMAC-SHA256: Notificações automáticas no seu backend assim que a SEFAZ ou prefeitura autorizar a nota.
- Download Instantâneo de PDF e XML: URLs seguras na CDN global para entregar a DANFE/DANFSe para o seu cliente final.
- Sem Cartão de Crédito: Cadastro em menos de 1 minuto sem pegadinhas.
🧩 Casos de Uso Mais Comuns de uma API Fiscal Gratuita
Na prática, o plano gratuito é o primeiro degrau para validar a automação fiscal antes de escalar. Os cenários que mais vemos em produção são:
- Marketplaces e e-commerces: emissão de NF-e a cada venda concluída, disparada pelo evento de pagamento confirmado.
- Plataformas de serviços e SaaS por assinatura: emissão de NFS-e a cada ciclo de cobrança recorrente.
- Pontos de venda físicos e checkout rápido: emissão de cupom fiscal com a API NFC-e (Modelo 65), com autorização em menos de 1,5s, geração de QR Code v2 e contingência offline para picos de venda no varejo.
Em todos eles, os webhooks devolvem o status da nota em tempo real, o que simplifica a conciliação fiscal e elimina a digitação manual.
✅ Como Escolher uma API de Nota Fiscal Gratuita
Antes de integrar, compare os fornecedores por critérios objetivos:
- Produção real ou só sandbox: muitas APIs "gratuitas" liberam apenas testes. Verifique se as notas do plano free têm valor fiscal.
- Limite mensal adequado ao seu estágio: 50 notas/mês por CNPJ cobrem a validação de um MVP e os primeiros clientes.
- Tipos de nota no mesmo contrato: emitir NFS-e, NF-e e a API NFC-e sob o mesmo contrato evita uma segunda integração quando o produto expandir do online para o ponto de venda físico.
- Webhooks desde o plano gratuito: sem eles, você acaba fazendo polling para descobrir se a nota foi autorizada.
- Documentação clara e caminho de upgrade: entenda o modelo gratuito vs. pago antes de colocar em produção para evitar surpresas.
⚡ Passo a Passo: Sua Primeira Nota em 3 Minutos
Passo 1: Obtenha sua Chave de API
- Acesse o painel da plataforma: platform.notaas.com.br/sign-up.
- Crie sua conta com e-mail e senha.
- No painel de controle, vá em Configurações ➔ Chaves de API e copie sua chave de testes:
sk_test_....
Passo 2: Faça uma Emissão de Teste via cURL
Abra o seu terminal e execute a chamada abaixo:
curl -X POST https://platform.notaas.com.br/api/v1/emitir \
-H "Content-Type: application/json" \
-H "X-API-Key: sk_test_sua_chave_aqui" \
-d '{
"tipo": "nfse",
"ambiente": "sandbox",
"referencia": "fatura_001",
"prestador": {
"cnpj": "00000000000191"
},
"tomador": {
"cpfCnpj": "12345678909",
"razaoSocial": "Cliente Exemplo de Teste Ltda",
"email": "dev@exemplo.com.br"
},
"servico": {
"discriminacao": "Assinatura mensal de software SaaS",
"codigoTributacaoMunicipio": "010701",
"valorServicos": 99.00,
"aliquota": 2.0
}
}'
Resposta Imediata da Notaas:
{
"id": "nfse_test_8a7b9c0d",
"status": "processing",
"tipo": "nfse",
"referencia": "fatura_001",
"createdAt": "2026-09-04T21:42:00.000Z",
"mensagem": "Nota recebida com sucesso e enfileirada no Sandbox."
}
💻 Integração em TypeScript / Node.js (Next.js & Express)
Para projetos modernos em TypeScript, a integração pode ser feita em um único arquivo de serviço:
// lib/notaas.ts
export interface EmissaoNFSeParams {
referencia: string;
tomadorCpfCnpj: string;
tomadorNome: string;
tomadorEmail: string;
descricaoServico: string;
valor: number;
aliquota?: number;
}
export async function emitirNotaFiscal(params: EmissaoNFSeParams) {
const payload = {
tipo: "nfse",
ambiente: process.env.NODE_ENV === "production" ? "producao" : "sandbox",
referencia: params.referencia,
prestador: {
cnpj: process.env.NOTAAS_CNPJ_PRESTADOR!,
},
tomador: {
cpfCnpj: params.tomadorCpfCnpj,
razaoSocial: params.tomadorNome,
email: params.tomadorEmail,
},
servico: {
discriminacao: params.descricaoServico,
codigoTributacaoMunicipio: process.env.NOTAAS_COD_SERVICO || "010701",
valorServicos: params.valor,
aliquota: params.aliquota || 2.0,
},
};
const response = await fetch("https://platform.notaas.com.br/api/v1/emitir", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": process.env.NOTAAS_API_KEY!,
},
body: JSON.stringify(payload),
});
if (!response.ok) {
const errorData = await response.json();
throw new Error(`Erro na emissão fiscal (${response.status}): ${JSON.stringify(errorData)}`);
}
return response.json();
}
🐍 Integração em Python (FastAPI / Django)
import os
import requests
def emitir_nota_fiscal_servico(referencia: str, cliente_cpf_cnpj: str, cliente_nome: str, valor: float):
url = "https://platform.notaas.com.br/api/v1/emitir"
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("NOTAAS_API_KEY")
}
payload = {
"tipo": "nfse",
"ambiente": "producao",
"referencia": referencia,
"prestador": {"cnpj": os.getenv("EMPRESA_CNPJ")},
"tomador": {
"cpfCnpj": cliente_cpf_cnpj,
"razaoSocial": cliente_nome
},
"servico": {
"discriminacao": "Serviço de Tecnologia e Automação",
"codigoTributacaoMunicipio": "010701",
"valorServicos": valor,
"aliquota": 2.0
}
}
response = requests.post(url, json=payload, headers=headers, timeout=10)
response.raise_for_status()
return response.json()
🔔 Recebendo o Status via Webhook HMAC
Como a autorização de notas fiscais junto a prefeituras e SEFAZ é assíncrona, a Notaas dispara um evento POST para a URL de webhook que você cadastrou nas configurações.
Exemplo de Rota no Next.js App Router (app/api/webhooks/notaas/route.ts):
import { NextRequest, NextResponse } from "next/server";
import crypto from "crypto";
export async function POST(req: NextRequest) {
const signature = req.headers.get("x-notaas-signature");
const rawBody = await req.text();
const secret = process.env.NOTAAS_WEBHOOK_SECRET!;
// 1. Validar autenticidade criptográfica
const expectedHash = crypto
.createHmac("sha256", secret)
.update(rawBody)
.digest("hex");
if (!signature || !crypto.timingSafeEqual(Buffer.from(expectedHash), Buffer.from(signature))) {
return NextResponse.json({ error: "Assinatura inválida" }, { status: 401 });
}
const event = JSON.parse(rawBody);
// 2. Tratar evento de nota autorizada
if (event.event === "nfse.issued") {
console.log(`Nota emitida com sucesso! Número: ${event.data.numero}`);
console.log(`Link do PDF: ${event.data.pdfUrl}`);
console.log(`Link do XML: ${event.data.xmlUrl}`);
// Atualize o status do pedido no seu banco de dados
}
return NextResponse.json({ received: true });
}
❓ Perguntas Frequentes (FAQ)
1. Preciso cadastrar cartão de crédito para usar o plano gratuito?
Não. O cadastro não exige cartão de crédito nem dados bancários. Você recebe 50 notas por mês e pode testar à vontade.
2. O que acontece se eu ultrapassar as 50 notas no mês?
A API retornará um erro amigável informando que o limite mensal de créditos gratuitos foi atingido. Seus dados e configurações permanecem intactos. Para emitir volumes maiores, basta fazer um upgrade para o plano Dev (500 notas) ou SaaS Pro (2.000 notas) com um clique.
3. A Notaas cobre meu município?
Sim. A Notaas integra o ecossistema nacional completo: padrão NFS-e Nacional (SNNFSE) e todos os grandes motores municipais como Barueri, DSF, GINFES, BETHA, IPM e SpeedGov.
4. É seguro usar uma API gratuita para emitir nota fiscal?
Sim, desde que a plataforma use HTTPS, autenticação por chave de API, webhooks assinados (HMAC-SHA256) e armazenamento protegido do certificado digital A1. Avalie esses pontos na documentação antes de integrar ao seu sistema.
5. Quanto custa integrar uma API de nota fiscal?
Dentro do limite do plano gratuito, a integração não tem custo de licença: você investe apenas o tempo de desenvolvimento. O pagamento só começa quando o volume mensal ultrapassar as 50 notas por CNPJ e você optar por um plano maior.
📚 Referências Oficiais & Guias Técnicos:
- 🌐 API de Nota Fiscal: Motor unificado para emissão e gestão de NFS-e, NF-e e NFC-e via REST API.
- ⚡ API NFS-e Nacional: Guia prático de integração técnica com o padrão nacional da Receita Federal.
- 📦 API NF-e (Modelo 55): Emissão simplificada de nota fiscal de produto com DANFE em PDF.
- 🛒 API NFC-e (Modelo 65): Automação de cupom fiscal para varejo e PDV com QR Code v2.
- 📄 DANFSe v2.0 em PDF: Geração local de DANFSe e conformidade com a NT-008 sem o visualizador do ADN.
- ⚖️ Comparativo de APIs Fiscais: Análise comparativa entre Notaas, Nuvem Fiscal, Focus NFe e TecnoSpeed.
🚀 Comece Agora no Sandbox
Pronto para automatizar as notas fiscais do seu app? Crie sua conta gratuita em menos de 1 minuto:
👉 Criar Conta Gratuita na Notaas (50 Notas/Mês)
👉 Acessar a Documentação Técnica Oficial