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

# Formatos de Tax ID por País

> Guia completo de formatos de Tax ID aceitos para cada país e tipo de entidade — no modelo universal de entidades gu1 para KYC, KYB e análise de risco.

## Visão Geral

Este guia fornece informações detalhadas sobre os formatos de Tax ID aceitos pela plataforma para cada país e tipo de entidade. O sistema **normaliza automaticamente** todos os Tax IDs para o formato padrão de cada país.

<Note>
  **Importante**: Você pode enviar Tax IDs com ou sem caracteres de formatação (pontos, hífens, barras, espaços). O sistema irá limpar e normalizar automaticamente antes da validação.
</Note>

## Data de nascimento em tax IDs (regras)

Alguns identificadores fiscais embutem data de nascimento; outros não. Isso importa para os operadores de regras **`tax_id_age_*`** (derivam a idade do valor do campo e comparam com um limiar).

| País    | Formato                           | Embute data de nascimento?              | Operadores de regras                                                                                                                                                |
| ------- | --------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MX      | RFC pessoa física (13 caracteres) | Sim (segmento YYMMDD)                   | `tax_id_age_less_than`, `tax_id_age_greater_than_or_equal`, etc.                                                                                                    |
| MX      | CURP (18 caracteres)              | Sim (segmento YYMMDD)                   | Igual                                                                                                                                                               |
| MX      | RFC pessoa moral (12 caracteres)  | Data de constituição, não DOB da pessoa | Não para idade de pessoa                                                                                                                                            |
| AR      | CUIT/CUIL/DNI                     | Não (DNI é sequencial)                  | `tax_id_age_*` com `taxIdCountry: AR` — **idade estimada** por coorte DNI (média do intervalo; margem típica ±6–10 anos). Não usa `dateOfBirth` nem enriquecimento. |
| BR      | CPF                               | Não                                     | Usar `dateOfBirth` ou `age` do enriquecimento                                                                                                                       |
| CL      | RUT pessoa                        | Não                                     | Usar `dateOfBirth` ou `age` do enriquecimento                                                                                                                       |
| CO / PE | Cédula / DNI                      | Não                                     | Usar `dateOfBirth` ou `age` do enriquecimento                                                                                                                       |

Campos aplicáveis: `taxId`, `originTaxId`, `destinationTaxId`, `userEvent.taxId`, `userEvent.destinationCuit`, e paths custom como `metadata.*` quando o valor for RFC ou CURP do México.

***

## 🇧🇷 Brasil (BR)

### Pessoa - CPF

**Documento**: CPF (Cadastro de Pessoas Físicas)

**Dígitos aceitos**: **9, 10 ou 11 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678901    (11 dígitos)
  ✅ 1234567890     (10 dígitos)
  ✅ 123456789      (9 dígitos)
  ```

  ```text Com formato (pontos e hífens) theme={null}
  ✅ 123.456.789-01 (11 dígitos formatado)
  ✅ 12.345.678-90  (10 dígitos formatado)
  ✅ 1.234.567-89   (9 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**:

* 11 dígitos → `XXX.XXX.XXX-XX`
* 10 dígitos → `XX.XXX.XXX-XX`
* 9 dígitos → `X.XXX.XXX-XX`

<Tip>
  **Posso enviar apenas números sem pontos ou hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

<Warning>
  **Importante**: A partir da última atualização (janeiro 2026), o sistema agora aceita CPF com 9, 10 ou 11 dígitos. Anteriormente, apenas 10 ou 11 dígitos eram aceitos.
</Warning>

***

### Empresa - CNPJ

**Documento**: CNPJ (Cadastro Nacional da Pessoa Jurídica)

**Dígitos aceitos**: **13 ou 14 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678000190  (14 dígitos)
  ✅ 1234567000190   (13 dígitos)
  ```

  ```text Com formato (pontos, barra e hífens) theme={null}
  ✅ 12.345.678/0001-90 (14 dígitos formatado)
  ✅ 1.234.567/0001-90  (13 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**:

* 14 dígitos → `XX.XXX.XXX/XXXX-XX`
* 13 dígitos → `X.XXX.XXX/XXXX-XX`

<Tip>
  **Posso enviar apenas números sem pontos, barras ou hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇦🇷 Argentina (AR)

### Pessoa - DNI/CUIL

#### DNI (Documento Nacional de Identidad)

**Dígitos aceitos**: **8 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678       (8 dígitos)
  ```

  ```text Com formato (pontos) theme={null}
  ✅ 12.345.678     (8 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**: 8 dígitos → `XX.XXX.XXX`

***

#### CUIL (Código Único de Identificación Laboral)

**Dígitos aceitos**: **11 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 20123456789    (11 dígitos)
  ```

  ```text Com formato (hífens) theme={null}
  ✅ 20-12345678-9  (11 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**: 11 dígitos → `XX-XXXXXXXX-X`

<Tip>
  **Posso enviar apenas números sem pontos ou hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

### Empresa - CUIT

**Documento**: CUIT (Clave Única de Identificación Tributaria)

**Dígitos aceitos**: **11 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 30123456789    (11 dígitos)
  ```

  ```text Com formato (hífens) theme={null}
  ✅ 30-12345678-9  (11 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**: 11 dígitos → `XX-XXXXXXXX-X`

<Tip>
  **Posso enviar apenas números sem hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇲🇽 México (MX)

### Pessoa - RFC Pessoa Física

**Documento**: RFC (Registro Federal de Contribuyentes)

**Caracteres aceitos**: **13 caracteres alfanuméricos**

```text Estrutura do Formato theme={null}
✅ AAAA######XXX
   └─┬─┘└──┬─┘└┬┘
     │    │   └─ 3 caracteres (homoclave)
     │    └───── 6 números (data: AAMMDD)
     └────────── 4 letras (nome/sobrenomes)

Exemplo: GOCG850101A12
         └─┬─┘└──┬─┘└┬┘
           │    │   └─ A12 (homoclave)
           │    └───── 850101 (1 jan 1985)
           └────────── GOCG (García Ochoa Carlos Gerardo)
```

<Warning>
  **Posso enviar apenas números sem letras?**

  ❌ **NÃO** - O RFC requer letras E números no formato específico. Você não pode enviar apenas números.
</Warning>

***

### Empresa - RFC Pessoa Moral

**Documento**: RFC (Registro Federal de Contribuyentes)

**Caracteres aceitos**: **12 caracteres alfanuméricos**

```text Estrutura do Formato theme={null}
✅ AAA######XXX
   └┬┘└──┬─┘└┬┘
    │   │   └─ 3 caracteres (homoclave)
    │   └───── 6 números (data: AAMMDD)
    └─────────3 letras (razão social)

Exemplo: GOC850101A12
         └┬┘└──┬─┘└┬┘
          │   │   └─ A12 (homoclave)
          │   └───── 850101 (1 jan 1985)
          └─────────GOC (García Ochoa Company)
```

<Warning>
  **Posso enviar apenas números sem letras?**

  ❌ **NÃO** - O RFC requer letras E números no formato específico.
</Warning>

***

## 🇨🇱 Chile (CL)

### Pessoa - RUT

**Documento**: RUT (Rol Único Tributario)

**Dígitos aceitos**: **7-8 dígitos + 1 dígito verificador**

<CodeGroup>
  ```text Números e verificador theme={null}
  ✅ 12345678K     (8 dígitos + verificador)
  ✅ 1234567K      (7 dígitos + verificador)
  ✅ 123456789     (8 dígitos + verificador numérico)
  ```

  ```text Com formato (pontos e hífen) theme={null}
  ✅ 12.345.678-K  (8 dígitos formatado)
  ✅ 1.234.567-K   (7 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**:

* 8 dígitos → `XX.XXX.XXX-X`
* 7 dígitos → `X.XXX.XXX-X`

<Note>
  **Importante**: O dígito verificador pode ser um número (0-9) ou a letra **K** (maiúscula ou minúscula).
</Note>

<Tip>
  **Posso enviar apenas números sem pontos ou hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

### Empresa - RUT Empresa

**Documento**: RUT (Rol Único Tributario)

**Dígitos aceitos**: **8-9 dígitos + 1 dígito verificador**

<CodeGroup>
  ```text Números e verificador theme={null}
  ✅ 123456789K    (9 dígitos + verificador)
  ✅ 12345678K     (8 dígitos + verificador)
  ```

  ```text Com formato (pontos e hífen) theme={null}
  ✅ 12.345.678-9  (8 dígitos formatado)
  ✅ 1.234.567-8   (7 dígitos formatado)
  ```
</CodeGroup>

**Formato de normalização**:

* 8 dígitos → `XX.XXX.XXX-X`
* 7 dígitos → `X.XXX.XXX-X`

<Tip>
  **Posso enviar apenas números sem pontos ou hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇨🇴 Colômbia (CO)

### Pessoa - Cédula/NIT

**Documento**: Cédula de Ciudadanía ou NIT

**Dígitos aceitos**: **6-10 dígitos** (comprimento variável)

<CodeGroup>
  ```text Apenas números (todos válidos) theme={null}
  ✅ 1234567890    (10 dígitos)
  ✅ 123456789     (9 dígitos)
  ✅ 12345678      (8 dígitos)
  ✅ 1234567       (7 dígitos)
  ✅ 123456        (6 dígitos)
  ```
</CodeGroup>

<Note>
  **Sem formato especial** - As identificações pessoais colombianas não têm um padrão de formato padrão.
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - O sistema aceita números puros sem formato especial.
</Tip>

***

### Empresa - NIT

**Documento**: NIT (Número de Identificación Tributaria)

**Dígitos aceitos**: **9 dígitos + 1 dígito verificador** (10 total)

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 1234567890    (10 dígitos - 9 + verificador)
  ```

  ```text Com formato (hífen) theme={null}
  ✅ 123456789-0   (9 dígitos + verificador com hífen)
  ```
</CodeGroup>

**Formato de normalização**: 10 dígitos → `XXXXXXXXX-X`

<Tip>
  **Posso enviar apenas números sem hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇵🇪 Peru (PE)

### Pessoa - DNI

**Documento**: DNI (Documento Nacional de Identidad)

**Dígitos aceitos**: **8 dígitos** (comprimento fixo)

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678      (8 dígitos)
  ```
</CodeGroup>

<Note>
  **Sem formato especial** - O DNI peruano não usa pontos, hífens ou outros caracteres de formatação.
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - Apenas números, sem formato especial necessário.
</Tip>

***

### Empresa - RUC

**Documento**: RUC (Registro Único de Contribuyentes)

**Dígitos aceitos**: **11 dígitos** (comprimento fixo)

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 20123456789   (11 dígitos)
  ```
</CodeGroup>

<Note>
  **Nota de formato**: Os primeiros 2 dígitos indicam o tipo de contribuinte:

  * **20** = Empresas (Personas Jurídicas)
  * **10** = Pessoas naturais com atividade empresarial
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - Apenas números, sem formato especial necessário.
</Tip>

***

## 🇺🇾 Uruguai (UY)

### Pessoa - CI

**Documento**: CI (Cédula de Identidad)

**Dígitos aceitos**: **7-8 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678      (8 dígitos)
  ✅ 1234567       (7 dígitos)
  ```
</CodeGroup>

<Note>
  **Sem formato especial** - A CI uruguaia não usa caracteres de formatação.
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - Apenas números, sem formato especial necessário.
</Tip>

***

### Empresa - RUT

**Documento**: RUT (Registro Único Tributario)

**Dígitos aceitos**: **12 dígitos** (comprimento fixo)

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 212345670018  (12 dígitos)
  ```
</CodeGroup>

<Note>
  **Sem formato especial** - O RUT uruguaio não usa caracteres de formatação.
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - Apenas números, sem formato especial necessário.
</Tip>

***

## 🇵🇾 Paraguai (PY)

### Pessoa - CI

**Documento**: CI (Cédula de Identidad)

**Dígitos aceitos**: **6-8 dígitos**

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 12345678      (8 dígitos)
  ✅ 1234567       (7 dígitos)
  ✅ 123456        (6 dígitos)
  ```
</CodeGroup>

<Note>
  **Sem formato especial** - A CI paraguaia não usa caracteres de formatação.
</Note>

<Tip>
  **Posso enviar apenas números?**

  ✅ **SIM** - Apenas números, sem formato especial necessário.
</Tip>

***

### Empresa - RUC

**Documento**: RUC (Registro Único de Contribuyentes)

**Dígitos aceitos**: **6-8 dígitos + 1 dígito verificador**

<CodeGroup>
  ```text Números e verificador theme={null}
  ✅ 123456789     (8 dígitos + verificador)
  ✅ 12345678      (7 dígitos + verificador)
  ```

  ```text Com formato (hífen) theme={null}
  ✅ 12345678-9    (com hífen)
  ```
</CodeGroup>

**Formato de normalização**: Com verificador → `XXXXXX-X` (mínimo 6 dígitos)

<Tip>
  **Posso enviar apenas números sem hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇺🇸 Estados Unidos (US)

### Empresa - EIN

**Documento**: EIN (Employer Identification Number)

**Dígitos aceitos**: **9 dígitos** (comprimento fixo)

<CodeGroup>
  ```text Apenas números theme={null}
  ✅ 123456789     (9 dígitos)
  ```

  ```text Com formato (hífen) theme={null}
  ✅ 12-3456789    (com hífen)
  ```
</CodeGroup>

**Formato de normalização**: 9 dígitos → `XX-XXXXXXX`

<Note>
  **Nota de formato**: O EIN é emitido pelo IRS para entidades comerciais. Os primeiros 2 dígitos indicam o campus do IRS onde o EIN foi emitido.
</Note>

<Tip>
  **Posso enviar apenas números sem hífens?**

  ✅ **SIM** - O sistema aceita números puros e os formata automaticamente.
</Tip>

***

## 🇻🇪 Venezuela (VE)

### Empresa - RIF

**Documento**: RIF (Registro de Información Fiscal)

**Caracteres aceitos**: **1 letra + 9 dígitos** (10 total)

<CodeGroup>
  ```text Letra + números theme={null}
  ✅ J123456789    (J/G/V/E/P + 9 dígitos)
  ```

  ```text Com formato (hífens) theme={null}
  ✅ J-12345678-9  (com hífens)
  ```
</CodeGroup>

**Formato de normalização**: Letra + 9 dígitos → `X-XXXXXXXX-X`

**Letras válidas** (primeiro caractere):

* **J** = Jurídico (Entidades legais/empresas)
* **G** = Governo (Entidades governamentais)
* **V** = Venezuelano (Pessoas naturais venezuelanas)
* **E** = Estrangeiro (Pessoas estrangeiras)
* **P** = Passaporte (Passaporte)

<Tip>
  **Posso enviar apenas a letra e números sem hífens?**

  ✅ **SIM** - O sistema aceita o formato sem hífens e o formata automaticamente.
</Tip>

<Warning>
  **Importante**: A letra é **obrigatória**. Você não pode enviar apenas números para o RIF venezuelano.
</Warning>

***

## 📊 Tabela Resumo Completa

| País    | Entidade | Documento | Dígitos/Formato     | Apenas números | Com formato                |
| ------- | -------- | --------- | ------------------- | -------------- | -------------------------- |
| 🇧🇷 BR | Pessoa   | CPF       | 9-11 dígitos        | ✅              | ✅ pontos e hífens          |
| 🇧🇷 BR | Empresa  | CNPJ      | 13-14 dígitos       | ✅              | ✅ pontos, barra, hífens    |
| 🇦🇷 AR | Pessoa   | DNI       | 8 dígitos           | ✅              | ✅ pontos                   |
| 🇦🇷 AR | Pessoa   | CUIL      | 11 dígitos          | ✅              | ✅ hífens                   |
| 🇦🇷 AR | Empresa  | CUIT      | 11 dígitos          | ✅              | ✅ hífens                   |
| 🇲🇽 MX | Pessoa   | RFC PF    | 13 alfanuméricos    | ❌              | ❌ Alfanumérico obrigatório |
| 🇲🇽 MX | Empresa  | RFC PM    | 12 alfanuméricos    | ❌              | ❌ Alfanumérico obrigatório |
| 🇨🇱 CL | Pessoa   | RUT       | 7-8 + K             | ✅              | ✅ pontos e hífen           |
| 🇨🇱 CL | Empresa  | RUT       | 8-9 + K             | ✅              | ✅ pontos e hífen           |
| 🇨🇴 CO | Pessoa   | CC/NIT    | 6-10 dígitos        | ✅              | -                          |
| 🇨🇴 CO | Empresa  | NIT       | 9 + 1 dígitos       | ✅              | ✅ hífen                    |
| 🇵🇪 PE | Pessoa   | DNI       | 8 dígitos           | ✅              | -                          |
| 🇵🇪 PE | Empresa  | RUC       | 11 dígitos          | ✅              | -                          |
| 🇺🇾 UY | Pessoa   | CI        | 7-8 dígitos         | ✅              | -                          |
| 🇺🇾 UY | Empresa  | RUT       | 12 dígitos          | ✅              | -                          |
| 🇵🇾 PY | Pessoa   | CI        | 6-8 dígitos         | ✅              | -                          |
| 🇵🇾 PY | Empresa  | RUC       | 6-8 + 1 dígito      | ✅              | ✅ hífen                    |
| 🇺🇸 US | Empresa  | EIN       | 9 dígitos           | ✅              | ✅ hífen                    |
| 🇻🇪 VE | Empresa  | RIF       | 1 letra + 9 dígitos | ✅              | ✅ hífens                   |

**Legenda**:

* ✅ = Formato aceito
* ❌ = Formato não aceito
* `-` = Sem formato especial

***

## ❓ Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso enviar o taxId com pontos, hífens e outros caracteres de formatação?">
    ✅ **SIM** - O sistema limpa automaticamente todos os caracteres de formatação (pontos, hífens, barras, espaços) antes de validar.

    **Exemplos de formatos aceitos:**

    ```
    CPF do Brasil:
    ✅ 123.456.789-01
    ✅ 123-456-789-01
    ✅ 123 456 789 01
    ✅ 12345678901
    → Todos se tornam: 123.456.789-01
    ```
  </Accordion>

  <Accordion title="Posso enviar o taxId apenas com números (sem formatação)?">
    ✅ **SIM** - Para a maioria dos países (exceto México RFC e Venezuela RIF que requerem letras), você pode enviar apenas números.

    **Países de exceção (requerem letras):**

    * 🇲🇽 México: RFC requer letras + números
    * 🇻🇪 Venezuela: RIF requer 1 letra + números
  </Accordion>

  <Accordion title="O sistema normaliza automaticamente o formato?">
    ✅ **SIM** - O sistema normaliza todos os taxIds para o formato padrão do país.

    **Exemplo para CPF do Brasil:**

    ```
    Você envia:  12345678901
    Salvo como:  123.456.789-01

    Você envia:  123.456.789-01
    Salvo como:  123.456.789-01

    Você envia:  123-456-789-01
    Salvo como:  123.456.789-01
    ```

    **Exemplo para CUIT da Argentina:**

    ```
    Você envia:  30123456789
    Salvo como:  30-12345678-9

    Você envia:  30-12345678-9
    Salvo como:  30-12345678-9
    ```
  </Accordion>

  <Accordion title="O que acontece se eu enviar um formato inválido?">
    ❌ O sistema rejeitará o taxId com um erro de validação indicando:

    * O formato esperado
    * A quantidade de dígitos necessária
    * Exemplos de formatos válidos
    * O nome do documento específico do país (CPF, CNPJ, CUIT, etc.)

    **Exemplo de resposta de erro:**

    ```json theme={null}
    {
      "success": false,
      "error": {
        "code": "VALIDATION_ERROR",
        "message": "Formato de CPF inválido. Esperado 9-11 dígitos.",
        "details": {
          "field": "taxId",
          "taxIdName": "CPF",
          "providedValue": "12345",
          "expectedFormat": "9-11 dígitos (ex. 123.456.789-01 ou 12345678901)"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Posso enviar um CPF de 9 dígitos para o Brasil?">
    ✅ **SIM** - A partir da última atualização (janeiro 2026), o sistema aceita CPF com **9, 10 ou 11 dígitos**.

    **Anteriormente**: Apenas 10 ou 11 dígitos eram aceitos.

    **Agora aceito:**

    ```
    ✅ 123456789      (9 dígitos)  → 1.234.567-89
    ✅ 1234567890     (10 dígitos) → 12.345.678-90
    ✅ 12345678901    (11 dígitos) → 123.456.789-01
    ```
  </Accordion>

  <Accordion title="Os dígitos verificadores são validados?">
    ⚠️ **Parcial** - O sistema valida:

    ✅ **Validação de formato**: Verifica se o Tax ID tem a quantidade correta de dígitos e estrutura

    ❌ **Validação de soma de verificação**: O sistema NÃO valida somas de verificação matemáticas (dígitos verificadores) para a maioria dos países

    **Por quê?** A validação de soma de verificação rejeitaria IDs válidos mas incorretamente digitados. Em vez disso, o sistema depende de provedores de enriquecimento para validar a existência e validade real do documento.
  </Accordion>

  <Accordion title="E se meu país não estiver listado?">
    Para países não listados acima, o sistema aceitará Tax IDs sem validação de formato estrita. Você pode fornecer o Tax ID em qualquer formato razoável, e ele será armazenado como está sem normalização.

    **Países suportados mas não estritamente validados incluem:**

    * 🇪🇸 Espanha (NIF/CIF)
    * 🇵🇹 Portugal (NIF)
    * 🇪🇪 Estônia (Isikukood)
    * 🇧🇴 Bolívia (NIT)
    * 🇪🇨 Equador (RUC/Cédula)
    * E outros...
  </Accordion>
</AccordionGroup>

***

## 💡 Exemplos por Caso de Uso

### Criar uma Pessoa no Brasil

<CodeGroup>
  ```json Com CPF formatado theme={null}
  {
    "type": "person",
    "name": "João Silva",
    "taxId": "123.456.789-01",
    "countryCode": "BR"
  }
  // ✅ Sistema normaliza para: 123.456.789-01
  ```

  ```json Com CPF sem formato theme={null}
  {
    "type": "person",
    "name": "João Silva",
    "taxId": "12345678901",
    "countryCode": "BR"
  }
  // ✅ Sistema normaliza para: 123.456.789-01
  ```

  ```json Com CPF de 9 dígitos theme={null}
  {
    "type": "person",
    "name": "João Silva",
    "taxId": "123456789",
    "countryCode": "BR"
  }
  // ✅ Sistema normaliza para: 1.234.567-89
  ```
</CodeGroup>

***

### Criar uma Empresa no Brasil

<CodeGroup>
  ```json Com CNPJ formatado theme={null}
  {
    "type": "company",
    "name": "Exemplo Ltda",
    "taxId": "12.345.678/0001-90",
    "countryCode": "BR"
  }
  // ✅ Sistema normaliza para: 12.345.678/0001-90
  ```

  ```json Com CNPJ sem formato theme={null}
  {
    "type": "company",
    "name": "Exemplo Ltda",
    "taxId": "12345678000190",
    "countryCode": "BR"
  }
  // ✅ Sistema normaliza para: 12.345.678/0001-90
  ```
</CodeGroup>

***

### Criar uma Empresa na Argentina

<CodeGroup>
  ```json Com CUIT formatado theme={null}
  {
    "type": "company",
    "name": "Ejemplo SA",
    "taxId": "30-12345678-9",
    "countryCode": "AR"
  }
  // ✅ Sistema normaliza para: 30-12345678-9
  ```

  ```json Com CUIT sem formato theme={null}
  {
    "type": "company",
    "name": "Ejemplo SA",
    "taxId": "30123456789",
    "countryCode": "AR"
  }
  // ✅ Sistema normaliza para: 30-12345678-9
  ```
</CodeGroup>

***

### Criar uma Pessoa no México

<CodeGroup>
  ```json RFC com formato correto theme={null}
  {
    "type": "person",
    "name": "García Ochoa Carlos Gerardo",
    "taxId": "GOCG850101A12",
    "countryCode": "MX"
  }
  // ✅ O RFC deve incluir letras
  ```

  ```json ❌ INVÁLIDO - Apenas números theme={null}
  {
    "type": "person",
    "name": "García Ochoa Carlos Gerardo",
    "taxId": "850101012",
    "countryCode": "MX"
  }
  // ❌ ERRO: O RFC requer letras E números
  ```
</CodeGroup>

***

### Criar uma Pessoa no Chile

<CodeGroup>
  ```json Com RUT formatado theme={null}
  {
    "type": "person",
    "name": "María González",
    "taxId": "12.345.678-K",
    "countryCode": "CL"
  }
  // ✅ Sistema normaliza para: 12.345.678-K
  ```

  ```json Com RUT sem formato theme={null}
  {
    "type": "person",
    "name": "María González",
    "taxId": "12345678K",
    "countryCode": "CL"
  }
  // ✅ Sistema normaliza para: 12.345.678-K
  ```

  ```json Com verificador numérico theme={null}
  {
    "type": "person",
    "name": "María González",
    "taxId": "123456789",
    "countryCode": "CL"
  }
  // ✅ Sistema normaliza para: 12.345.678-9
  ```
</CodeGroup>

***

## 🔍 Melhores Práticas

<CardGroup cols={2}>
  <Card title="Sempre Forneça o Código do País" icon="flag">
    Sempre inclua o campo `countryCode` ao criar entidades. Isso permite que o sistema aplique as regras de validação corretas para esse país.
  </Card>

  <Card title="Envie Dados Limpos" icon="broom">
    Embora o sistema limpe os caracteres de formatação, enviar dados limpos reduz o tempo de processamento e possíveis erros.
  </Card>

  <Card title="Trate Erros de Validação" icon="triangle-exclamation">
    Implemente tratamento adequado de erros para erros de validação de Tax ID. A resposta de erro inclui detalhes úteis sobre o formato esperado.
  </Card>

  <Card title="Teste Antes da Produção" icon="vial">
    Teste suas entradas de Tax ID no ambiente sandbox antes de ir para produção, especialmente para países com requisitos de formato rigorosos.
  </Card>
</CardGroup>

***

<Note>
  **Última atualização**: 28 de janeiro de 2026 • **Versão**: 5.0

  **Mudanças nesta versão**:

  * ✨ Adicionado suporte para CPF de 9 dígitos no Brasil
  * 📋 Expandida a cobertura para incluir todos os países latino-americanos
  * 🔍 Adicionadas explicações detalhadas de formato e exemplos
  * ❓ Seção de FAQ aprimorada com cenários comuns
</Note>