# Dados Cadastrais

O serviço de Dados Cadastrais retorna informações essenciais sobre a empresa consultada, incluindo dados básicos, e-mails, endereços e telefones.

- **Identificador:** `empresas/dados-cadastrais`
- **Categoria:** Dados cadastrais
- **Audiência:** PJ
- **Endpoint:** `POST /api/v1/{tenant}/empresas/dados-cadastrais`
- **Preço de tabela:** R$ 0,240 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/empresas/dados-cadastrais

## Quando usar

Descrição

O serviço de Dados Cadastrais fornece diversas informações sobre a empresa consultada, frequentemente usadas em processos de cadastro em diferentes plataformas e serviços.

Além dos dados básicos, como nome e status de atividade, são fornecidos dados adicionais, incluindo e-mails, endereços e telefones.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CNPJ da empresa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `BasicData.TaxIdNumber` | texto |
| `BasicData.OfficialName` | texto |
| `BasicData.TradeName` | texto |
| `BasicData.FoundedDate` | data |
| `BasicData.IsHeadquarter` | booleano |
| `BasicData.TaxIdStatus` | texto |
| `BasicData.TaxIdStatusDate` | data |
| `BasicData.Activities[].IsMain` | booleano |
| `BasicData.Activities[].Code` | texto |
| `BasicData.Activities[].Activity` | texto |
| `BasicData.LegalNature.Code` | texto |
| `BasicData.LegalNature.Activity` | texto |
| `BasicData.AdditionalOutputData.Capital` | texto |
| `BasicData.AdditionalOutputData.CapitalRS` | texto |
| `Emails.Primary.EmailAddress` | texto |
| `Emails.Primary.Domain` | texto |
| `Emails.Primary.UserName` | texto |
| `Emails.Primary.Type` | texto |
| `Emails.Primary.LastUpdateDate` | data |
| `Addresses.Primary.Typology` | texto |
| `Addresses.Primary.Title` | texto |
| `Addresses.Primary.AddressMain` | texto |
| `Addresses.Primary.Number` | texto |
| `Addresses.Primary.Complement` | texto |
| `Addresses.Primary.Neighborhood` | texto |
| `Addresses.Primary.ZipCode` | texto |
| `Addresses.Primary.City` | texto |
| `Addresses.Primary.State` | texto |
| `Addresses.Primary.Country` | texto |
| `Addresses.Primary.Type` | texto |
| `Addresses.Primary.ComplementType` | texto |
| `Addresses.Primary.LastUpdateDate` | data |
| `Addresses.Secondary.Typology` | texto |
| `Addresses.Secondary.Title` | texto |
| `Addresses.Secondary.AddressMain` | texto |
| `Addresses.Secondary.Number` | texto |
| `Addresses.Secondary.Complement` | texto |
| `Addresses.Secondary.Neighborhood` | texto |
| `Addresses.Secondary.ZipCode` | texto |
| `Addresses.Secondary.City` | texto |
| `Addresses.Secondary.State` | texto |
| `Addresses.Secondary.Country` | texto |
| `Addresses.Secondary.Type` | texto |
| `Addresses.Secondary.ComplementType` | texto |
| `Addresses.Secondary.LastUpdateDate` | data |
| `Phones.Primary.Number` | texto |
| `Phones.Primary.AreaCode` | texto |
| `Phones.Primary.CountryCode` | texto |
| `Phones.Primary.Complement` | texto |
| `Phones.Primary.Type` | texto |
| `Phones.Primary.PhoneNumberOfEntities` | número |
| `Phones.Primary.LastUpdateDate` | data |
| `Phones.Secondary.Number` | texto |
| `Phones.Secondary.AreaCode` | texto |
| `Phones.Secondary.CountryCode` | texto |
| `Phones.Secondary.Complement` | texto |
| `Phones.Secondary.Type` | texto |
| `Phones.Secondary.PhoneNumberOfEntities` | número |
| `Phones.Secondary.LastUpdateDate` | data |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Dados Cadastrais",
  "query_slug": "dados-cadastrais",
  "data": {
    "BasicData": {
      "TaxIdNumber": "texto",
      "OfficialName": "texto",
      "TradeName": "texto",
      "FoundedDate": "2026-01-01",
      "IsHeadquarter": false,
      "TaxIdStatus": "texto",
      "TaxIdStatusDate": "2026-01-01",
      "Activities": [
        {
          "IsMain": false,
          "Code": "texto",
          "Activity": "texto"
        }
      ],
      "LegalNature": {
        "Code": "texto",
        "Activity": "texto"
      },
      "AdditionalOutputData": {
        "Capital": "texto",
        "CapitalRS": "texto"
      }
    },
    "Emails": {
      "Primary": {
        "EmailAddress": "texto",
        "Domain": "texto",
        "UserName": "texto",
        "Type": "texto",
        "LastUpdateDate": "2026-01-01"
      }
    },
    "Addresses": {
      "Primary": {
        "Typology": "texto",
        "Title": "texto",
        "AddressMain": "texto",
        "Number": "texto",
        "Complement": "texto",
        "Neighborhood": "texto",
        "ZipCode": "texto",
        "City": "texto",
        "State": "texto",
        "Country": "texto",
        "Type": "texto",
        "ComplementType": "texto",
        "LastUpdateDate": "2026-01-01"
      },
      "Secondary": {
        "Typology": "texto",
        "Title": "texto",
        "AddressMain": "texto",
        "Number": "texto",
        "Complement": "texto",
        "Neighborhood": "texto",
        "ZipCode": "texto",
        "City": "texto",
        "State": "texto",
        "Country": "texto",
        "Type": "texto",
        "ComplementType": "texto",
        "LastUpdateDate": "2026-01-01"
      }
    },
    "Phones": {
      "Primary": {
        "Number": "texto",
        "AreaCode": "texto",
        "CountryCode": "texto",
        "Complement": "texto",
        "Type": "texto",
        "PhoneNumberOfEntities": 0,
        "LastUpdateDate": "2026-01-01"
      },
      "Secondary": {
        "Number": "texto",
        "AreaCode": "texto",
        "CountryCode": "texto",
        "Complement": "texto",
        "Type": "texto",
        "PhoneNumberOfEntities": 0,
        "LastUpdateDate": "2026-01-01"
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.240"
}
```