# Dados Cadastrais Básicos

O serviço de Dados Cadastrais Básicos retorna informações como CNPJ, razão social e data de fundação, obtidas de fontes oficiais.

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

## Quando usar

Descrição

O serviço de Dados Cadastrais Básicos fornece informações cadastrais essenciais, como CNPJ, razão social, nome fantasia e data de fundação, obtidas de fontes oficiais.

## 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.TaxIdCountry` | texto |
| `BasicData.OfficialName` | texto |
| `BasicData.TradeName` | texto |
| `BasicData.Aliases.UnstandardizedRFOfficialName` | texto |
| `BasicData.Aliases.UnstandardizedRFTradeName` | texto |
| `BasicData.NameUniquenessScore` | número |
| `BasicData.OfficialNameUniquenessScore` | número |
| `BasicData.TradeNameUniquenessScore` | número |
| `BasicData.FoundedDate` | data |
| `BasicData.Age` | número |
| `BasicData.IsHeadquarter` | booleano |
| `BasicData.HeadquarterState` | texto |
| `BasicData.IsConglomerate` | booleano |
| `BasicData.TaxIdStatus` | texto |
| `BasicData.TaxIdOrigin` | texto |
| `BasicData.TaxIdStatusDate` | data |
| `BasicData.TaxIdStatusRegistrationDate` | data |
| `BasicData.TaxRegime` | texto |
| `BasicData.CompanyType_ReceitaFederal` | texto |
| `BasicData.TaxRegimes.Simples` | booleano |
| `BasicData.Activities[].IsMain` | booleano |
| `BasicData.Activities[].Code` | texto |
| `BasicData.Activities[].Activity` | texto |
| `BasicData.LegalNature.Code` | texto |
| `BasicData.LegalNature.Activity` | texto |
| `BasicData.SpecialSituation` | texto |
| `BasicData.CreationDate` | data |
| `BasicData.LastUpdateDate` | data |
| `BasicData.AdditionalOutputData.Capital` | texto |
| `BasicData.AdditionalOutputData.CapitalRS` | texto |
| `BasicData.AdditionalOutputData.NIRE` | texto |
| `BasicData.AdditionalOutputData.NIRECompanySize` | texto |
| `BasicData.AdditionalOutputData.NIREHeadquartersType` | texto |
| `BasicData.AdditionalOutputData.NIREHeadquartersCapital` | texto |
| `BasicData.AdditionalOutputData.NIRELastCaptureDate` | data |
| `BasicData.AdditionalOutputData.COMEX` | texto |
| `BasicData.AdditionalOutputData.COMEXLastUpdate` | data |
| `BasicData.HistoricalData.HasChangedTradeName` | booleano |
| `BasicData.HistoricalData.HasChangedTaxRegime` | booleano |
| `BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].Value` | texto |
| `BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].StartDate` | data |
| `BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].EndDate` | 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 Básicos",
  "query_slug": "dados-cadastrais-basicos",
  "data": {
    "BasicData": {
      "TaxIdNumber": "texto",
      "TaxIdCountry": "texto",
      "AlternativeIdNumbers": {
      },
      "OfficialName": "texto",
      "TradeName": "texto",
      "Aliases": {
        "UnstandardizedRFOfficialName": "texto",
        "UnstandardizedRFTradeName": "texto"
      },
      "NameUniquenessScore": 0,
      "OfficialNameUniquenessScore": 0,
      "TradeNameUniquenessScore": 0,
      "FoundedDate": "2026-01-01",
      "Age": 0,
      "IsHeadquarter": false,
      "HeadquarterState": "texto",
      "IsConglomerate": false,
      "TaxIdStatus": "texto",
      "TaxIdOrigin": "texto",
      "TaxIdStatusDate": "2026-01-01",
      "TaxIdStatusRegistrationDate": "2026-01-01",
      "TaxRegime": "texto",
      "CompanyType_ReceitaFederal": "texto",
      "TaxRegimes": {
        "Simples": false
      },
      "Activities": [
        {
          "IsMain": false,
          "Code": "texto",
          "Activity": "texto"
        }
      ],
      "LegalNature": {
        "Code": "texto",
        "Activity": "texto"
      },
      "SpecialSituation": "texto",
      "CreationDate": "2026-01-01",
      "LastUpdateDate": "2026-01-01",
      "AdditionalOutputData": {
        "Capital": "texto",
        "CapitalRS": "texto",
        "NIRE": "texto",
        "NIRECompanySize": "texto",
        "NIREHeadquartersType": "texto",
        "NIREHeadquartersCapital": "texto",
        "NIRELastCaptureDate": "2026-01-01",
        "COMEX": "texto",
        "COMEXLastUpdate": "2026-01-01"
      },
      "HistoricalData": {
        "HasChangedTradeName": false,
        "HasChangedTaxRegime": false,
        "HistoricalDataEvolution": {
          "TaxRegime": [
            {
              "Value": "texto",
              "StartDate": "2026-01-01",
              "EndDate": "2026-01-01"
            }
          ]
        }
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.040"
}
```