Skip to main content

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.

​
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.
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.

​
🇧🇷 Brasil (BR)

​
Pessoa - CPF

Documento: CPF (Cadastro de Pessoas Físicas) Dígitos aceitos: 9, 10 ou 11 dígitos 
✅ 12345678901    (11 dígitos)
✅ 1234567890     (10 dígitos)
✅ 123456789      (9 dígitos)
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
Posso enviar apenas números sem pontos ou hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.
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.

​
Empresa - CNPJ

Documento: CNPJ (Cadastro Nacional da Pessoa Jurídica) Dígitos aceitos: 13 ou 14 dígitos 
✅ 12345678000190  (14 dígitos)
✅ 1234567000190   (13 dígitos)
Formato de normalização:
  • 14 dígitos → XX.XXX.XXX/XXXX-XX
  • 13 dígitos → X.XXX.XXX/XXXX-XX
Posso enviar apenas números sem pontos, barras ou hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇦🇷 Argentina (AR)

​
Pessoa - DNI/CUIL

​
DNI (Documento Nacional de Identidad)

Dígitos aceitos: 8 dígitos 
✅ 12345678       (8 dígitos)
Formato de normalização: 8 dígitos → XX.XXX.XXX

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

Dígitos aceitos: 11 dígitos 
✅ 20123456789    (11 dígitos)
Formato de normalização: 11 dígitos → XX-XXXXXXXX-X
Posso enviar apenas números sem pontos ou hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
Empresa - CUIT

Documento: CUIT (Clave Única de Identificación Tributaria) Dígitos aceitos: 11 dígitos 
✅ 30123456789    (11 dígitos)
Formato de normalização: 11 dígitos → XX-XXXXXXXX-X
Posso enviar apenas números sem hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇲🇽 México (MX)

​
Pessoa - RFC Pessoa Física

Documento: RFC (Registro Federal de Contribuyentes) Caracteres aceitos: 13 caracteres alfanuméricos
Estrutura do Formato
✅ 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)
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.

​
Empresa - RFC Pessoa Moral

Documento: RFC (Registro Federal de Contribuyentes) Caracteres aceitos: 12 caracteres alfanuméricos
Estrutura do Formato
✅ 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)
Posso enviar apenas números sem letras?❌ NÃO - O RFC requer letras E números no formato específico.

​
🇨🇱 Chile (CL)

​
Pessoa - RUT

Documento: RUT (Rol Único Tributario) Dígitos aceitos: 7-8 dígitos + 1 dígito verificador 
✅ 12345678K     (8 dígitos + verificador)
✅ 1234567K      (7 dígitos + verificador)
✅ 123456789     (8 dígitos + verificador numérico)
Formato de normalização:
  • 8 dígitos → XX.XXX.XXX-X
  • 7 dígitos → X.XXX.XXX-X
Importante: O dígito verificador pode ser um número (0-9) ou a letra K (maiúscula ou minúscula).
Posso enviar apenas números sem pontos ou hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
Empresa - RUT Empresa

Documento: RUT (Rol Único Tributario) Dígitos aceitos: 8-9 dígitos + 1 dígito verificador 
✅ 123456789K    (9 dígitos + verificador)
✅ 12345678K     (8 dígitos + verificador)
Formato de normalização:
  • 8 dígitos → XX.XXX.XXX-X
  • 7 dígitos → X.XXX.XXX-X
Posso enviar apenas números sem pontos ou hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇨🇴 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) 
✅ 1234567890    (10 dígitos)
✅ 123456789     (9 dígitos)
✅ 12345678      (8 dígitos)
✅ 1234567       (7 dígitos)
✅ 123456        (6 dígitos)
Sem formato especial - As identificações pessoais colombianas não têm um padrão de formato padrão.
Posso enviar apenas números?✅ SIM - O sistema aceita números puros sem formato especial.

​
Empresa - NIT

Documento: NIT (Número de Identificación Tributaria) Dígitos aceitos: 9 dígitos + 1 dígito verificador (10 total) 
✅ 1234567890    (10 dígitos - 9 + verificador)
Formato de normalização: 10 dígitos → XXXXXXXXX-X
Posso enviar apenas números sem hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇵🇪 Peru (PE)

​
Pessoa - DNI

Documento: DNI (Documento Nacional de Identidad) Dígitos aceitos: 8 dígitos (comprimento fixo) 
✅ 12345678      (8 dígitos)
Sem formato especial - O DNI peruano não usa pontos, hífens ou outros caracteres de formatação.
Posso enviar apenas números?✅ SIM - Apenas números, sem formato especial necessário.

​
Empresa - RUC

Documento: RUC (Registro Único de Contribuyentes) Dígitos aceitos: 11 dígitos (comprimento fixo) 
✅ 20123456789   (11 dígitos)
Nota de formato: Os primeiros 2 dígitos indicam o tipo de contribuinte:
  • 20 = Empresas (Personas Jurídicas)
  • 10 = Pessoas naturais com atividade empresarial
Posso enviar apenas números?✅ SIM - Apenas números, sem formato especial necessário.

​
🇺🇾 Uruguai (UY)

​
Pessoa - CI

Documento: CI (Cédula de Identidad) Dígitos aceitos: 7-8 dígitos 
✅ 12345678      (8 dígitos)
✅ 1234567       (7 dígitos)
Sem formato especial - A CI uruguaia não usa caracteres de formatação.
Posso enviar apenas números?✅ SIM - Apenas números, sem formato especial necessário.

​
Empresa - RUT

Documento: RUT (Registro Único Tributario) Dígitos aceitos: 12 dígitos (comprimento fixo) 
✅ 212345670018  (12 dígitos)
Sem formato especial - O RUT uruguaio não usa caracteres de formatação.
Posso enviar apenas números?✅ SIM - Apenas números, sem formato especial necessário.

​
🇵🇾 Paraguai (PY)

​
Pessoa - CI

Documento: CI (Cédula de Identidad) Dígitos aceitos: 6-8 dígitos 
✅ 12345678      (8 dígitos)
✅ 1234567       (7 dígitos)
✅ 123456        (6 dígitos)
Sem formato especial - A CI paraguaia não usa caracteres de formatação.
Posso enviar apenas números?✅ SIM - Apenas números, sem formato especial necessário.

​
Empresa - RUC

Documento: RUC (Registro Único de Contribuyentes) Dígitos aceitos: 6-8 dígitos + 1 dígito verificador 
✅ 123456789     (8 dígitos + verificador)
✅ 12345678      (7 dígitos + verificador)
Formato de normalização: Com verificador → XXXXXX-X (mínimo 6 dígitos)
Posso enviar apenas números sem hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇺🇸 Estados Unidos (US)

​
Empresa - EIN

Documento: EIN (Employer Identification Number) Dígitos aceitos: 9 dígitos (comprimento fixo) 
✅ 123456789     (9 dígitos)
Formato de normalização: 9 dígitos → XX-XXXXXXX
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.
Posso enviar apenas números sem hífens?✅ SIM - O sistema aceita números puros e os formata automaticamente.

​
🇻🇪 Venezuela (VE)

​
Empresa - RIF

Documento: RIF (Registro de Información Fiscal) Caracteres aceitos: 1 letra + 9 dígitos (10 total) 
✅ J123456789    (J/G/V/E/P + 9 dígitos)
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)
Posso enviar apenas a letra e números sem hífens?✅ SIM - O sistema aceita o formato sem hífens e o formata automaticamente.
Importante: A letra é obrigatória. Você não pode enviar apenas números para o RIF venezuelano.

​
📊 Tabela Resumo Completa

PaísEntidadeDocumentoDígitos/FormatoApenas númerosCom formato
🇧🇷 BRPessoaCPF9-11 dígitos✅✅ pontos e hífens
🇧🇷 BREmpresaCNPJ13-14 dígitos✅✅ pontos, barra, hífens
🇦🇷 ARPessoaDNI8 dígitos✅✅ pontos
🇦🇷 ARPessoaCUIL11 dígitos✅✅ hífens
🇦🇷 AREmpresaCUIT11 dígitos✅✅ hífens
🇲🇽 MXPessoaRFC PF13 alfanuméricos❌❌ Alfanumérico obrigatório
🇲🇽 MXEmpresaRFC PM12 alfanuméricos❌❌ Alfanumérico obrigatório
🇨🇱 CLPessoaRUT7-8 + K✅✅ pontos e hífen
🇨🇱 CLEmpresaRUT8-9 + K✅✅ pontos e hífen
🇨🇴 COPessoaCC/NIT6-10 dígitos✅-
🇨🇴 COEmpresaNIT9 + 1 dígitos✅✅ hífen
🇵🇪 PEPessoaDNI8 dígitos✅-
🇵🇪 PEEmpresaRUC11 dígitos✅-
🇺🇾 UYPessoaCI7-8 dígitos✅-
🇺🇾 UYEmpresaRUT12 dígitos✅-
🇵🇾 PYPessoaCI6-8 dígitos✅-
🇵🇾 PYEmpresaRUC6-8 + 1 dígito✅✅ hífen
🇺🇸 USEmpresaEIN9 dígitos✅✅ hífen
🇻🇪 VEEmpresaRIF1 letra + 9 dígitos✅✅ hífens
Legenda:
  • ✅ = Formato aceito
  • ❌ = Formato não aceito
  • - = Sem formato especial

​
❓ Perguntas Frequentes

✅ 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
✅ 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
✅ 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
❌ 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:
{
  "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)"
    }
  }
}
✅ 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
⚠️ 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ísesPor 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.
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…

​
💡 Exemplos por Caso de Uso

​
Criar uma Pessoa no Brasil

{
  "type": "person",
  "name": "João Silva",
  "taxId": "123.456.789-01",
  "countryCode": "BR"
}
// ✅ Sistema normaliza para: 123.456.789-01

​
Criar uma Empresa no Brasil

{
  "type": "company",
  "name": "Exemplo Ltda",
  "taxId": "12.345.678/0001-90",
  "countryCode": "BR"
}
// ✅ Sistema normaliza para: 12.345.678/0001-90

​
Criar uma Empresa na Argentina

{
  "type": "company",
  "name": "Ejemplo SA",
  "taxId": "30-12345678-9",
  "countryCode": "AR"
}
// ✅ Sistema normaliza para: 30-12345678-9

​
Criar uma Pessoa no México

{
  "type": "person",
  "name": "García Ochoa Carlos Gerardo",
  "taxId": "GOCG850101A12",
  "countryCode": "MX"
}
// ✅ O RFC deve incluir letras

​
Criar uma Pessoa no Chile

{
  "type": "person",
  "name": "María González",
  "taxId": "12.345.678-K",
  "countryCode": "CL"
}
// ✅ Sistema normaliza para: 12.345.678-K

​
🔍 Melhores Práticas

Sempre Forneça o Código do País

Sempre inclua o campo countryCode ao criar entidades. Isso permite que o sistema aplique as regras de validação corretas para esse país.

Envie Dados Limpos

Embora o sistema limpe os caracteres de formatação, enviar dados limpos reduz o tempo de processamento e possíveis erros.

Trate Erros de Validação

Implemente tratamento adequado de erros para erros de validação de Tax ID. A resposta de erro inclui detalhes úteis sobre o formato esperado.

Teste Antes da Produção

Teste suas entradas de Tax ID no ambiente sandbox antes de ir para produção, especialmente para países com requisitos de formato rigorosos.
Última atualização: 28 de janeiro de 2026 • Versão: 5.0Mudanç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