Atendimento

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

PlanoNotas/mêsNota adicionalEmitentes ativosAPIWebhooks
Essencial100R$ 0,121nãonão
Profissional500R$ 0,103simsim
Escala4.000R$ 0,09ilimitadossimsim

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) responde 403 recurso-nao-incluido-no-plano com "recurso": "API", e não é possível criar credenciais. O painel continua funcionando.
  • Webhooks: /conta/webhook exige o recurso WEBHOOK (o DELETE continua 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 POST com a mesma Idempotency-Key nã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.

Nesta página