Planos e limites
O que cada plano libera, como as notas são contadas e como consultar o consumo e as faturas.
A sua conta tem um plano. Ele define a franquia de notas por mês, o valor de cada nota além dela, quantos
emitentes podem ficar ativos e se a conta usa a API e os webhooks. O plano atual vem em
GET /conta:
{
"id": "6f1c2a9e-3b7d-4c1e-9a2f-5d8e7b6c4a10",
"nome": "Sua Empresa",
"produtos": ["NFE", "NFSE"],
"ativo": true,
"plano": {
"codigo": "PROFISSIONAL",
"nome": "Profissional",
"valorMensal": "149.90",
"notasIncluidas": 500,
"valorNotaAdicional": "0.1000",
"maxEmitentes": 3,
"recursos": ["API", "WEBHOOK"]
}
}maxEmitentes nulo significa emitentes ilimitados.
O que cada plano libera
| Plano | Notas/mês | Nota adicional | Emitentes ativos | API | Webhooks |
|---|---|---|---|---|---|
| Essencial | 100 | R$ 0,12 | 1 | não | não |
| Profissional | 500 | R$ 0,10 | 3 | sim | sim |
| Escala | 4.000 | R$ 0,09 | ilimitados | sim | sim |
Para trocar de plano, fale com o Atendimento. A troca vale na hora para as travas abaixo.
Travas
- API: integrar um sistema exige o recurso
API. Com um plano sem ele, toda chamada com token de integração (client credentials) responde403 recurso-nao-incluido-no-planocom"recurso": "API", e não é possível criar credenciais. O painel continua funcionando. - Webhooks:
/conta/webhookexige o recursoWEBHOOK(oDELETEcontinua liberado). Se o plano perder o recurso, a conta para de receber eventos. - Emitentes: cadastrar ou reativar um emitente acima do limite responde
422 limite-emitentes-do-plano. Só os emitentes ativos ocupam vaga; desative um para liberar. - Notas: a franquia não bloqueia a emissão. Cada nota além dela é cobrada como nota adicional.
Como as notas são contadas
- Conta a nota autorizada em produção, no mês (horário de Brasília) em que foi autorizada. NFS-e, NF-e e NFC-e somam na mesma franquia.
- Nota cancelada depois de autorizada continua contando: ela foi emitida.
- Homologação, nota rejeitada e nota denegada não contam. Teste à vontade em homologação.
- Repetir o
POSTcom a mesmaIdempotency-Keynão gera outra nota, então também não conta de novo.
Consumo do mês
GET /conta/uso mostra o consumo do mês corrente, ou de outro mês com
?competencia=AAAA-MM:
{
"competencia": "2026-11",
"plano": "PROFISSIONAL",
"notasIncluidas": 500,
"notasUsadas": 532,
"notasExcedentes": 32,
"valorNotaAdicional": "0.1000",
"valorExcedenteEstimado": "3.20",
"porProduto": { "NFE": 120, "NFSE": 412 }
}O excedente é uma estimativa com o plano atual: o valor final sai na fatura.
Faturas
A fatura de cada mês é fechada no início do mês seguinte, com o plano vigente no fechamento:
valorTotal = valorMensal + notasExcedentes × valorNotaAdicional. GET /conta/faturas
lista as faturas fechadas, da mais recente para a mais antiga.