Skip to main content

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.

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). 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
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
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
Formato de normalização: 8 dígitos → XX.XXX.XXX

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

Dígitos aceitos: 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
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
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
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
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
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)
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)
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)
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)
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
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)
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
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
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)
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)
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

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:
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:
Exemplo para CUIT da Argentina:
❌ 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:
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:
⚠️ Parcial - O sistema valida:Validação de formato: Verifica se o Tax ID tem a quantidade correta de dígitos e estruturaValidaçã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


Criar uma Empresa no Brasil


Criar uma Empresa na Argentina


Criar uma Pessoa no México


Criar uma Pessoa no Chile


🔍 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