> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cnpj-api.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrar da ReceitaWS

> Como migrar sua integração da ReceitaWS para a API de Consulta CNPJ

# Migrando da ReceitaWS

A migração da ReceitaWS é simples. O endpoint `/cnpj/{cnpj}` suporta o parâmetro `formato=receitaws`, que retorna a resposta no mesmo formato que a API da ReceitaWS.

## Passo 1: Altere a URL base

```diff theme={null}
- https://receitaws.com.br/v1/cnpj/12345678000195
+ https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws
```

## Passo 2: Adicione autenticação

Adicione o parâmetro `token` na URL ou o header `Authorization: Bearer {token}`.

## Passo 3: Teste

A resposta terá o mesmo formato que a ReceitaWS. Nenhuma alteração no parsing é necessária.

## Diferenças

| Aspecto        | ReceitaWS       | Esta API                      |
| -------------- | --------------- | ----------------------------- |
| Autenticação   | Varia por plano | Token via URL ou header       |
| Rate limit     | Varia por plano | 5 req/min (gratuito)          |
| Dados extras   | Apenas cadastro | Cadastro + logos + Simples    |
| Formato nativo | Próprio         | Próprio (com compatibilidade) |

## Quando remover o parâmetro `formato`

Recomendamos que, após validar a migração, você remova o parâmetro `formato=receitaws` e adapte seu código ao formato nativo desta API. O formato nativo oferece mais campos e dados estruturados.