Preços e cobrança
Quanto custa cada consulta, as faixas mensais e o que não é cobrado.
Você paga por consulta. Há duas formas de pagar: saldo avulso na carteira ou uma faixa mensal.
Avulso
Cada consulta custa R$ 0,12, debitada da carteira pré-paga da sua empresa. Você coloca saldo na carteira do app, em https://app.toreva.com.br/carteira. A recarga mínima é de R$ 10.
Faixas mensais
| Plano | Preço por mês | Consultas inclusas |
|---|---|---|
| API 1 mil | R$ 49 | 1.000 |
| API 5 mil | R$ 149 | 5.000 |
| API 20 mil | R$ 399 | 20.000 |
- A franquia renova no dia 1º de cada mês. Consultas que sobram não passam para o mês seguinte.
- O que passar da franquia sai do saldo da carteira, a R$ 0,12 por consulta.
- Para trocar de faixa, cancele a atual; a nova pode ser assinada quando o período terminar. Até lá, o que passar da franquia sai do saldo a R$ 0,12 por consulta.
Você gera as chaves, acompanha o consumo e assina a faixa mensal na tela API do app, em https://app.toreva.com.br/desenvolvedor.
Conta da plataforma completa (Plano Base): o preço por consulta e a franquia mensal aparecem em API › Plano e preços, no app.
Uma cobrança por CNPJ a cada 24 horas
Consultar o mesmo CNPJ de novo dentro de 24 horas não gera nova cobrança. A resposta vem completa. O cabeçalho X-Toreva-Charged vem true quando a consulta contou como consulta cobrável, seja debitada do saldo, seja coberta pela franquia do mês; false quando o mesmo CNPJ é reconsultado dentro de 24 horas.
A janela é de 24 horas a partir da consulta cobrada. Reconsultar dentro dela não a estende. Por isso, repetir uma chamada depois de uma falha de rede é seguro: você não paga duas vezes pelo mesmo dado.
O que não é cobrado
- CNPJ não encontrado (
404). - CNPJ inválido (
400). - Qualquer erro. Você só paga por resposta entregue.
Sem saldo
Sem saldo e sem franquia disponível, a API responde 403 INSUFFICIENT_BALANCE antes de consultar. Nenhum dado é entregue e nada é debitado. Configure a recarga automática na carteira do app para não interromper a integração.
Nas respostas 200, o cabeçalho X-Toreva-Balance-Cents informa o saldo restante da carteira.