# Visão Geral

[![Run in Insomnia](https://insomnia.rest/images/run.svg)](https://insomnia.rest/run/?label=CNPJ.ws\&uri=https%3A%2F%2Fwww.cnpj.ws%2Finsomnia.json)

A API do **CNPJ.ws** fornece, de maneira simples e rápida, dados sobre empresas brasileiras através do número do CNPJ. Esses dados são obtidos junto a órgãos públicos como a SEFAZ, CADESP, Sintegra, Suframa e são organizados para permitir o máximo de informações úteis, ampliando as possibilidades de uso desses dados.

## Estrutura básica do JSON

Os dados são estruturados para trazer a maior quantidade de informações úteis, possibilitando a integração com diversos sistemas.

Tipos de dados utilizados:

| Sigla | Descrição |
| :---: | --------- |
|   A   | Array     |
|   S   | String    |
|   D   | Data      |
|   N   | Numérico  |
|   O   | Objeto    |

Abaixo está a estrutura básica retornada pela API de CNPJ:

| Campo                         | Tipo | Descrição                                    |
| ----------------------------- | :--: | -------------------------------------------- |
| cnpj\_raiz                    |   S  | Raiz do CNPJ                                 |
| razao\_social                 |   S  | Razão social da empresa                      |
| capital\_social               |   S  | Capital social                               |
| responsavel\_federativo       |   S  | Responsável federativo                       |
| criado\_em                    |   S  | Data do cadastro na base de dados do CNPJ.ws |
| atualizado\_em                |   S  | Data da última atualização das informações   |
| porte                         |   O  | Porte da empresa                             |
| natureza\_juridica            |   O  | Natureza jurídica                            |
| qualificacao\_do\_responsavel |   O  | Qualificação do responsável                  |
| socios                        |   O  | Lista de Sócios                              |
| estabelecimento               |   O  | Estabelecimento                              |
| simples                       |   O  | Dados do Simples e do MEI                    |

## Defasagem dos Dados

A defasagem máxima dos dados é de 45 dias, sendo que diariamente são feitas integrações com os Sintegras estaduais com os quais possuímos integração.

Qualquer dúvida, estamos aqui para te apoiar! Mande um e-mail para <contato@cnpj.ws>!

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=58b7deafafad\&utm_campaign=Referral_Invite\&utm_medium=Referral_Program\&utm_source=badge)