Atualização dos dados
Escolha entre cache e consulta com tolerância de atualização.
As consultas individuais de CNPJ e Simples Nacional permitem controlar a tolerância de atualização com toleranceDays. O parâmetro é opcional e aceita valores inteiros de 0 a 45.
| Configuração | Comportamento |
|---|---|
Sem toleranceDays | Consulta em cache, sem exigir uma atualização em tempo real. O serviço pode complementar ou atualizar sua base usando o cache do provedor. |
toleranceDays=30 | Usa o dado local se estiver dentro da tolerância. Se estiver mais antigo ou ausente, solicita uma busca externa. |
toleranceDays=0 | Solicita tolerância zero de atualização. Um dado local fora dessa tolerância exige busca externa. |
curl 'https://api.nextapi.com.br/v1/cnpj/SEU_CNPJ?toleranceDays=30' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Accept: application/json'Para Simples Nacional, use o mesmo parâmetro em /v1/cnpj/SEU_CNPJ/simples?toleranceDays=30.
Permissão e custo
Quando o resultado vem do cache, a consulta custa 1 crédito. Quando é necessária uma busca em tempo real, o custo é 15 créditos e a operação exige permissão e saldo suficiente. Planos pagos ou créditos avulsos podem habilitar essa modalidade; confira limits.canLiveSearch em /v1/credits.
Informar uma tolerância não torna o custo fixo em 1 crédito. Dimensione sua integração considerando que uma consulta fora da tolerância pode consumir 15 créditos.
Latência e indisponibilidade
Uma busca externa pode levar mais tempo que uma leitura em cache e depende da disponibilidade do provedor. Defina timeouts adequados e trate falhas sem apresentar dados antigos como se tivessem sido atualizados naquele momento.
Use o campo dataAtualizacao, quando disponível, para informar a data do dado. Campos nulos representam ausência de informação; não os converta automaticamente em respostas negativas.