CAMPO DE RECORDS

Nomes normalizados como a América Latina os escreve.

Os nomes hispânicos e brasileiros levam dois sobrenomes, acentos e títulos que os parsers genéricos quebram. A Normadata faz o split, recapitaliza e dobra nomes com regras pensadas para a América Latina primeiro. O nome viaja como campo name dentro de um record em /v1/validate/records.

LATAM
cobertura
3
tokens de nome
records
endpoint
0
lookups gov
01 · PROBLEMA

MAIÚSCULAS, acentos e sobrenomes de três tokens

Os formulários da região juntam nomes em todos os estados possíveis: "JUAN CARLOS PEREZ LOPEZ" sem acentos, "perez lópez, juan" com sobrenome primeiro, ou "Juan C. Pérez" com iniciais. As ferramentas anglo-first assumem first + last e perdem informação. A Normadata aplica um split regional: nomes, sobrenome paterno, sobrenome materno; reconstrói a capitalização; preserva os acentos. O nome é validado como campo name dentro de um record.

02 · CAPACIDADES

Split, maiúsculas, acentos

Como o campo name é normalizado dentro de um record.

01

Split inteligente de nome

Três tokens vão para first + paterno + materno em locales LATAM; first + middle + last em US/CA.

name.{first,paternal,maternal}
02

Maiúsculas e acentos

MAIÚSCULAS, minúsculas e inputs sem acento recebem TitleCase e diacríticos corretos quando é determinístico.

ASCII fold + TitleCase
03

Campo de um record

O nome é enviado como campo name de um record; volta dentro de fields.name junto ao resto da entidade.

records → fields.name
04

Sem lookups

Pura normalização determinística. Não consulta registros nem confirma que a pessoa existe.

0 lookups gov
03 · COBERTURA

Cobertura sul-americana · regras LATAM-first

Os defaults de locale cobrem cada mercado sul-americano vivo. As convenções de nome seguem o country do record quando fornecido.

🇦🇷AR
Argentina
CUITCUILDNICBUCVU
🇧🇷BR
Brasil
CPFCNPJ
04 · USO

O nome, como campo de um record

Mande o nome no campo name de um record em /v1/validate/records. Volta normalizado dentro de fields.name, junto ao resto da entidade.

POST /v1/validate/records
$ curl -X POST https://api.normadata.io/v1/validate/records \
    -H "X-API-Key: nd_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5" \
    -H "Content-Type: application/json" \
    -d '{"items":[
      {"reference_id":"prov-001","country":"AR","name":"juan carlos PEREZ lopez"}
    ]}'
Resposta
{
  "results": [
    {
      "reference_id": "prov-001",
      "country":      "AR",
      "fields": {
        "name": {
          "full":     "Juan Carlos Pérez López",
          "first":    "Juan Carlos",
          "paternal": "Pérez",
          "maternal": "López"
        }
      },
      "consistency": [],
      "readiness": {
        "payment": { "status": "blocked", "reason": "tax_id is missing" },
        "billing": { "status": "blocked", "reason": "tax_id is missing" }
      }
    }
  ]
}

Pare de perder sobrenomes

Grátis durante o acesso antecipado. Mande um email e respondemos em 24 horas.