01 · GLOSSÁRIO
Glossário técnico
Definições dos termos técnicos que usamos em validação de identidade, identificadores fiscais e compliance.
- AMLAnti-Money Laundering: conjunto de leis, regulamentos e procedimentos destinados a prevenir a lavagem de dinheiro e o financiamento do terrorismo.
- API keyCredencial secreta que autentica e autoriza chamadas a uma API; age como uma senha para o serviço.
- Base62Codificação que representa dados usando 62 caracteres alfanuméricos (0-9, a-z, A-Z), sem símbolos ambíguos, adequada para URLs ou identificadores.
- BCP 47Padrão IETF para etiquetas de identificação de idiomas, como 'es', 'en', 'pt-BR'. Define como nomear idiomas de forma interoperável.
- CBUClave Bancaria Uniforme: identificador de 22 dígitos que identifica uma conta bancária na Argentina, verificado com o algoritmo módulo 10 (Luhn).
- Cédula (Venezuela)Cédula de Identidad: documento nacional de identificação na Venezuela, composto por uma letra (V/E) e até 8 dígitos.
- Check digitDígito ou caractere calculado algoritmicamente a partir dos outros dígitos de um identificador para detectar erros de digitação ou transmissão.
- Checksum algorithmAlgoritmo matemático que produz um valor de controle (checksum) a partir de um conjunto de dados, usado para verificar integridade.
- CI (Ecuador)Cédula de Identidad equatoriana: documento de 10 dígitos emitido pelo Registro Civil, com dígito verificador calculado via módulo 10.
- CLABE (México)Clave Bancaria Estandarizada: número de 18 dígitos que identifica uma conta bancária no México, padronizado pelo BANXICO, com dígito verificador por módulo 10 ponderado.
- CNPJ (Brasil)Cadastro Nacional da Pessoa Jurídica: identificador fiscal de empresas no Brasil, com 14 dígitos e duplo dígito verificador por módulo 11.
- CPF (Brasil)Cadastro de Pessoas Físicas: identificador fiscal pessoal no Brasil, com 11 dígitos e duplo dígito verificador por módulo 11.
- CUI (Peru)Código Único de Identificación: número de 8 dígitos do DNI peruano, emitido pela RENIEC.
- CUILCódigo Único de Identificación Laboral: identificador de 11 dígitos atribuído pela ANSES a trabalhadores assalariados na Argentina.
- CUIT (Argentina)Código Único de Identificación Tributaria: identificador fiscal de 11 dígitos na Argentina, emitido pela AFIP, com dígito verificador por módulo 11.
- CURP (México)Clave Única de Registro de Población: identificador nacional de 18 caracteres no México, derivado de nome, data de nascimento, sexo e estado, com dígito verificador.
- CVUClave Virtual Uniforme: identificador de 22 dígitos para contas virtuais (carteiras, fintechs) na Argentina, regulado pelo BCRA.
- DNI (Argentina)Documento Nacional de Identidad: documento oficial de identificação na Argentina emitido pelo RENAPER, com número de 7 ou 8 dígitos.
- Format validationVerificação de que um dado cumpre as regras estruturais esperadas (comprimento, caracteres, dígito verificador) sem consultar nenhum registro externo.
- Format validation vs registry lookupComparação entre validar a estrutura de um identificador (formato) e consultar a autoridade para verificar que existe (registro).
- IBANInternational Bank Account Number: padrão ISO 13616 para identificar contas bancárias internacionalmente, verificado por módulo 97.
- Identity documentDocumento oficial emitido por uma autoridade governamental que certifica a identidade de uma pessoa: RG, passaporte, carteira de identidade, etc.
- JSON envelopeEstrutura JSON comum que envolve a resposta de cada endpoint da Normadata com metadados consistentes.
- KYCKnow Your Customer: processo regulatório de verificar a identidade de clientes antes de oferecer-lhes serviços financeiros.
- Luhn (mod 10)Algoritmo de dígito verificador padronizado em ISO/IEC 7812 que usa módulo 10 sobre uma soma ponderada alternada.
- Modulo 11Algoritmo de dígito verificador que divide uma soma ponderada de dígitos por 11 e usa o resto para calcular o dígito de controle.
- Modulo 97Algoritmo de dígito verificador que divide o número por 97 e verifica que o resto seja 1; usado em IBAN e outros padrões ISO.
- NIT (Bolivia)Número de Identificación Tributaria boliviano: identificador de até 12 dígitos emitido pelo SIN, sem dígito verificador padrão.
- NIT (Colombia)Número de Identificación Tributaria colombiano: identificador de 9 dígitos + 1 verificador atribuído pela DIAN, calculado via módulo 11.
- Rate limitLimite máximo de requisições que um cliente pode fazer por unidade de tempo contra uma API; protege o serviço e previne abusos.
- Registry lookupConsulta em tempo real ao registro oficial de uma autoridade para verificar que um identificador existe, está ativo e pertence a quem o apresenta.
- REST APIEstilo arquitetural para APIs HTTP baseado em recursos, verbos padrão e respostas sem estado; o modelo mais comum para integrações modernas.
- RFC (México)Registro Federal de Contribuyentes: identificador fiscal no México emitido pelo SAT, com 13 caracteres (pessoa física) ou 12 (pessoa jurídica), baseado em estrutura e homoclave.
- RIFRegistro de Información Fiscal: identificador tributário na Venezuela composto por uma letra (J/V/E/G/P) e 9 dígitos + verificador.
- RUC (Ecuador)Registro Único de Contribuyentes equatoriano: identificador de 13 dígitos emitido pelo SRI, baseado na Cédula ou atribuído a empresas.
- RUC (Paraguay)Registro Único de Contribuyentes paraguaio: identificador de até 8 dígitos + 1 verificador atribuído pela SET, calculado via módulo 11.
- RUC (Peru)Registro Único de Contribuyentes peruano: identificador de 11 dígitos emitido pela SUNAT, com dígito verificador por módulo 11.
- RUT (Chile)Rol Único Tributario: identificador único no Chile para fins tributários e de identidade (RUN), com dígito verificador por módulo 11 que pode ser 0–9 ou K.
- Tax IDIdentificador fiscal: número único atribuído por uma autoridade tributária para identificar pessoas físicas e jurídicas no sistema tributário.
- X-API-KeyHeader HTTP que transporta a API key do cliente; na Normadata segue o formato `nd_{prefix}_{22 chars base62}`.
- X-Request-IdHeader de resposta com um identificador único por requisição; útil para correlacionar logs entre cliente e servidor ao pedir suporte.