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

# Padrão de Dados

> Convenções de formato aplicadas a todas as respostas da API

Convenções aplicadas a todas as respostas da API. Consulte a entidade específica para detalhes de cada campo.

## Tipagens

| Tipo                | Formato                                      | Exemplo        |
| ------------------- | -------------------------------------------- | -------------- |
| **Data**            | String ISO 8601 `YYYY-MM-DD`                 | `"2020-03-15"` |
| **Mês/ano**         | String `YYYY-MM` (competência de benefícios) | `"2023-01"`    |
| **Booleano**        | `true` / `false`                             | `true`         |
| **Nulo**            | `null` — a API nunca retorna `""`            | `null`         |
| **UF**              | 2 letras maiúsculas                          | `"SP"`         |
| **Monetário (R\$)** | `number`, 2 casas decimais, sem símbolo      | `15420.50`     |
| **Percentual**      | Decimal (0–100)                              | `4.2`          |
| **Área**            | Decimal (hectares ou m²)                     | `360.00`       |
| **Score**           | Inteiro ou decimal (0–100)                   | `85`           |

## Documentos e identificadores

CPF e CNPJ sempre retornam **formatados com máscara**.

| Tipo            | Formato                                    | Dígitos  | Exemplo                       |
| --------------- | ------------------------------------------ | -------- | ----------------------------- |
| **CPF**         | `XXX.XXX.XXX-XX`                           | 11       | `"918.050.406-00"`            |
| **CNPJ**        | `XX.XXX.XXX/XXXX-XX`                       | 14       | `"33.000.167/0001-01"`        |
| **CNPJ básico** | Raiz sem máscara                           | 8        | `"33000167"`                  |
| **CEP**         | `XXXXX-XXX` ou sem máscara                 | 8        | `"20031170"`                  |
| **Número CNJ**  | `NNNNNNN-DD.YYYY.J.TT.OOOO`                | 20       | `"0001234-56.2020.8.26.0100"` |
| **Chave NF-e**  | String numérica                            | 44       | `"352103123456780001..."`     |
| **RENAVAM**     | String numérica                            | 10+      | `"1173451703"`                |
| **Placa**       | `ABC1234` (antiga) ou `ABC1D23` (Mercosul) | 7        | `"QPS0133"`                   |
| **NIRF**        | String numérica                            | variável | `"1234567"`                   |
| **OAB**         | UF + número                                | variável | `"SP123456"`                  |
| **INPI**        | `BR` + número                              | variável | `"BR102020012345"`            |
| **Chassi**      | Alfanumérico                               | 17       | `"93YRBB005KJ664188"`         |

## Telefones

Formato E.164 sem `+`, decomposto em campos. Veja detalhes em [Telefone](/entidades/telefone).

```json theme={null}
{
  "ddi": "55",
  "ddd": "31",
  "numero": "987654321",
  "numero_completo": "5531987654321",
  "estado": "MG",
  "operadora": "Vivo"
}
```

Operadoras possíveis: `Vivo` · `Claro` · `Tim` · `Oi` · `Fixo`.

## Endereços

Estrutura padrão reutilizada em Pessoa, Empresa e Propriedade. Veja detalhes em [Endereço](/entidades/endereco).

```json theme={null}
{
  "logradouro": "Avenida República do Chile",
  "numero": "65",
  "complemento": null,
  "bairro": "Centro",
  "cidade": "Rio de Janeiro",
  "uf": "RJ",
  "cep": "20031170"
}
```

## Enumerações

Valores padronizados reutilizados em múltiplas entidades.

| Campo              | Valores                                                                  | Entidades                |
| ------------------ | ------------------------------------------------------------------------ | ------------------------ |
| Tipo de documento  | `CPF` · `CNPJ` · `PF` · `PJ`                                             | Todas                    |
| Sexo               | `Masculino` · `Feminino`                                                 | Pessoa, Empresa (sócios) |
| Faixa etária       | `Menos de 18 anos` · `18 a 35 anos` · `35 a 60 anos` · `Mais de 60 anos` | Empresa (sócios)         |
| Situação empresa   | `Ativa` · `Baixada` · `Suspensa` · `Inapta` · `Nula`                     | Empresa                  |
| Porte empresa      | `Microempresa` · `Empresa de Pequeno Porte` · `Médio ou Grande porte`    | Empresa                  |
| Tipo empresa       | `Matriz` · `Filial`                                                      | Empresa                  |
| Polo processual    | `ativo` · `passivo` · `terceiro` · `interessado`                         | Processo                 |
| Uso de propriedade | `RESIDENCIAL` · `COMERCIAL` · `INDUSTRIAL` · `TERRITORIAL`               | Propriedade              |