# Atualização dos dados

> Escolha entre cache e consulta com tolerância de atualização.

Fonte: https://www.nextapi.com.br/docs/atualizacao-dos-dados

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. |

```bash
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.