> ## 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.
# Referência de Campos de Condições
> Referência completa de campos disponíveis para condições de regras por tipo de entidade e país — no motor de regras gu1 para compliance e detecção de risco.
## Visão Geral
Esta referência lista todos os campos disponíveis que podem ser usados em condições de regras. Os campos estão organizados por tipo de entidade (Pessoa, Empresa, Transação, KYC) e país (BR, AR, Global).
Esta documentação é gerada automaticamente a partir do código base. Última atualização: 2025-12-23
## Como Usar Esta Referência
1. **Encontre seu tipo de entidade**: Person, Company, Transaction, or KYC
2. **Verifique campos específicos do país**: BR (Brazil), AR (Argentina), or GLOBAL
3. **Copie o caminho do campo**: Use o caminho exato do campo em suas condições de regra
4. **Escolha um operador**: Veja a seção [Operadores Disponíveis](#operadores-disponibles)
5. **Defina o valor**: Forneça o valor para comparar
## Navegação Rápida
* [Campos de Pessoa](#campos-de-persona)
* [Campos de Empresa](#campos-de-empresa)
* [Campos de Transação](#campos-de-transacción)
* [Campos de KYC](#campos-de-kyc)
* [Campos de Accionistas](#campos-de-accionistas)
* [Operadores Disponíveis](#operadores-disponibles)
* [Exemplos de Uso](#ejemplos-de-uso)
***
## Campos de Pessoa
Campos disponibles para evaluar entidades de persona (clientes individuales).
### BR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| -------------------------------------------------------- | --------------------------------- | ----------------------------------- | ----------------- | ---------------------------------------------------------------------------------- |
| `taxId` | CPF | Text/String | Basic Information | Cadastro de Pessoas Físicas |
| `name` | Nome | Text/String | Basic Information | |
| `entityData.person.firstName` | Primeiro Nome | Text/String | Basic Information | |
| `entityData.person.lastName` | Sobrenome | Text/String | Basic Information | |
| `entityData.person.dateOfBirth` | Data de Nascimento | Date (ISO 8601 format) | Basic Information | |
| `entityData.person.email` | E-mail | Text/String | Basic Information | |
| `entityData.person.phone` | Telefone | Text/String | Basic Information | |
| `entityData.person.address` | Endereço | Text/String | Basic Information | |
| `entityData.person.occupation` | Ocupação | Text/String | Basic Information | |
| `entityData.person.gender` | Gênero | Text/String | Basic Information | |
| `entityData.person.maritalStatus` | Estado Civil | Text/String | Basic Information | |
| `entityData.person.nationality` | Nacionalidade | Text/String | Basic Information | |
| `entityData.person.income` | Renda | Number | Basic Information | |
| `entityData.person.idType` | Tipo de Documento | Text/String | Basic Information | |
| `entityData.person.idNumber` | Número de Documento | Text/String | Basic Information | |
| `entityData.person.city` | Cidade | Text/String | Basic Information | |
| `entityData.person.state` | Estado | Text/String | Basic Information | |
| `entityData.person.postalCode` | CEP | Text/String | Basic Information | Código de Endereçamento Postal |
| `entityData.person.country` | País | Text/String | Basic Information | |
| `entityData.person.alternativePhone` | Telefone Alternativo | Text/String | Basic Information | |
| `entityData.person.isPep` | É PEP (Manual) | Boolean (true/false) | Basic Information | Campo manual - prefer enrichmentData.normalized.isPep |
| `entityData.person.pepPosition` | Cargo PEP (Manual) | Text/String | Basic Information | Campo manual - prefer enrichmentData.normalized.pepPosition |
| `entityData.person.pepCountry` | País PEP (Manual) | Text/String | Basic Information | Campo manual - prefer enrichmentData.normalized.pepCountry |
| `status` | Status | Text/String | Basic Information | |
| `enrichmentData.normalized.postalCode` | CEP | Text/String | Enrichment Data | |
| `enrichmentData.normalized.taxId` | CPF | Text/String | Enrichment Data | CPF consolidado de múltiplas fontes |
| `enrichmentData.normalized.age` | Idade | Number | Enrichment Data | Idade consolidada de múltiplas fontes |
| `enrichmentData.normalized.isPep` | É ou Foi PEP | Boolean (true/false) | Enrichment Data | Indica se a pessoa é ou foi PEP alguma vez |
| `enrichmentData.normalized.isCurrentPep` | É PEP Atualmente | Boolean (true/false) | Enrichment Data | Indica se a pessoa é atualmente uma Pessoa Politicamente Exposta ativa |
| `enrichmentData.normalized.pepCountry` | País do PEP | Text/String | Enrichment Data | País onde o status PEP se aplica |
| `enrichmentData.normalized.pepPosition` | Cargo/Posição PEP | Text/String | Enrichment Data | Cargo ou posição atual/anterior como PEP |
| `enrichmentData.normalized.pepLevels` | Níveis de PEP | Array of objects | Enrichment Data | Array de níveis de PEP (ex: "1", "2", "national", "international") |
| `enrichmentData.normalized.situation` | Status de Registro (CPF) | Text/String | Enrichment Data | Status do CPF: REGULAR, IRREGULAR, etc. |
| `enrichmentData.normalized.isDeceased` | É Falecido | Boolean (true/false) | Enrichment Data | Indica se a pessoa está falecida (crítico para regras) |
| `enrichmentData.normalized.sanctioned` | Está Sancionado | Boolean (true/false) | Enrichment Data | Indica se a pessoa está atualmente em listas de sanções |
| `enrichmentData.normalized.hasAdverseMedia` | Tem Mídia Adversa | Boolean (true/false) | Enrichment Data | Indica se há menções em mídia adversa |
| `enrichmentData.normalized.adverseMediaScore` | Score de Mídia Adversa | Number | Enrichment Data | |
| `enrichmentData.normalized.criminalInvolvements` | Envolvimentos Criminais | Text/String | Enrichment Data | |
| `enrichmentData.normalized.bankruptcies` | Falências | Number | Enrichment Data | |
| `enrichmentData.normalized.confidence` | Confiança dos Dados | Number | Enrichment Data | |
| `enrichmentData.normalized.completeness` | Completude dos Dados | Number | Enrichment Data | |
| `enrichmentData.normalized.totalAssets` | Total de Ativos | Number | Enrichment Data | Valor total de ativos |
| `enrichmentData.normalized.totalLiabilities` | Total de Passivos | Number | Enrichment Data | Valor total de passivos |
| `enrichmentData.normalized.netWorth` | Patrimônio Líquido | Number | Enrichment Data | Patrimônio líquido (ativos - passivos) |
| `enrichmentData.normalized.totalElectoralDonations` | Número de Doações Eleitorais | Number | Enrichment Data | Quantidade total de doações eleitorais (legacy) |
| `enrichmentData.normalized.totalElectoralDonationAmount` | Valor Total de Doações Eleitorais | Number | Enrichment Data | Valor total doado em eleições (legacy) |
| `enrichmentData.normalized.isHistoricalElectoralDonor` | É Doador Eleitoral Histórico | Boolean (true/false) | Enrichment Data | Já foi doador eleitoral no passado (legacy) |
| `enrichmentData.normalized.totalActiveEmails` | Total de E-mails Ativos | Number | Enrichment Data | Número de e-mails ativos |
| `enrichmentData.normalized.incomeRange` | Faixa de Renda | Text/String | Enrichment Data | Faixa de renda estimada em salários mínimos (ex: "ACIMA DE 20 SM") |
| `enrichmentData.normalized.totalAssetsCategory` | Categoria de Ativos Totais | Text/String | Enrichment Data | Categoria de ativos totais (ex: "ACIMA DE 5MM") |
| `enrichmentData.normalized.motherName` | Nome da Mãe | Text/String | Enrichment Data | Nome completo da mãe |
| `enrichmentData.normalized.fatherName` | Nome do Pai | Text/String | Enrichment Data | Nome completo do pai |
| `enrichmentData.normalized.socialSecurityNumber` | Número de Segurança Social | Text/String | Enrichment Data | NIS/PIS/PASEP |
| `enrichmentData.normalized.deathYear` | Ano de Falecimento | Number | Enrichment Data | Ano em que a pessoa faleceu |
| `enrichmentData.normalized.maritalStatusData` | Dados de Estado Civil | Nested object | Enrichment Data | Informações sobre estado civil |
| `enrichmentData.normalized.sanctionDetails` | Detalhes de Sanções | Array of objects | Enrichment Data | Registros detalhados de sanções |
| `enrichmentData.normalized.sanctionOrigins` | Origens de Sanções | Array of objects | Enrichment Data | Países de origem das sanções |
| `enrichmentData.normalized.sanctionPrograms` | Programas de Sanções | Array of objects | Enrichment Data | Nomes dos programas de sanções |
| `enrichmentData.normalized.sanctionAccusations` | Acusações em Sanções | Array of objects | Enrichment Data | Acusações específicas |
| `enrichmentData.normalized.paymentBehavior` | Comportamento de Pagamento | Nested object | Enrichment Data | Indicadores de comportamento de pagamento |
| `enrichmentData.normalized.financialRiskLevel` | Nível de Risco Financeiro | Text/String | Enrichment Data | Nível geral de risco financeiro |
| `enrichmentData.normalized.lastFinancialUpdate` | Última Atualização Financeira | Text/String | Enrichment Data | Data da última atualização financeira |
| `enrichmentData.normalized.numberOfBranches` | Número de Filiais | Number | Enrichment Data | Quantidade de filiais ou subsidiárias |
| `enrichmentData.normalized.documentsSummary` | Resumo de Documentos | Nested object (5 nested fields) | Enrichment Data | Estatísticas agregadas sobre documentos |
| `enrichmentData.normalized.documents` | Documentos | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os documentos |
| `enrichmentData.normalized.addressesSummary` | Resumo de Endereços | Nested object (2 nested fields) | Enrichment Data | Estatísticas agregadas sobre endereços |
| `enrichmentData.normalized.addresses` | Endereços | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os endereços |
| `enrichmentData.normalized.emailsSummary` | Resumo de E-mails | Nested object (2 nested fields) | Enrichment Data | Estatísticas agregadas sobre e-mails |
| `enrichmentData.normalized.emails` | E-mails | Array of objects (5 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os e-mails |
| `enrichmentData.normalized.phonesSummary` | Resumo de Telefones | Nested object (2 nested fields) | Enrichment Data | Estatísticas agregadas sobre telefones |
| `enrichmentData.normalized.phones` | Telefones | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os telefones |
| `enrichmentData.normalized.sanctionsSummary` | Resumo de Sanções | Nested object (2 nested fields) | Enrichment Data | Estatísticas agregadas sobre sanções |
| `enrichmentData.normalized.legalProceedingsSummary` | Resumo de Processos Legais | Nested object (32 nested fields) | Enrichment Data | Estatísticas agregadas sobre processos legais |
| `enrichmentData.normalized.legalProceedings` | Processos Judiciais | Array of objects (27 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os processos judiciais |
| `enrichmentData.normalized.riskFlags` | Bandeiras de Risco | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as bandeiras de risco |
| `enrichmentData.normalized.riskFlagsSummary` | Resumo de Bandeiras de Risco | Nested object (4 nested fields) | Enrichment Data | Estatísticas agregadas sobre bandeiras de risco |
| `enrichmentData.normalized.violations` | Violações Consolidadas | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes) |
| `enrichmentData.normalized.violationsSummary` | Resumo de Violações | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre violações |
| `enrichmentData.normalized.mediaMentions` | Menções em Mídia | Array of objects (13 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as menções em mídia consolidadas |
| `enrichmentData.normalized.mediaSummary` | Resumo de Mídia | Nested object (15 nested fields) | Enrichment Data | Estatísticas agregadas sobre menções na mídia |
| `enrichmentData.normalized.sanctions` | Sanções Consolidadas | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as sanções consolidadas |
| `enrichmentData.normalized.demographics` | Demografia | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os dados demográficos |
| `enrichmentData.normalized.demographicsSummary` | Resumo Demográfico | Nested object (9 nested fields) | Enrichment Data | Estatísticas agregadas sobre dados demográficos |
| `enrichmentData.normalized.occupations` | Ocupações | Array of objects (11 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os dados de ocupação |
| `enrichmentData.normalized.occupationsSummary` | Resumo de Ocupações | Nested object (5 nested fields) | Enrichment Data | Estatísticas agregadas sobre ocupações profissionais |
| `enrichmentData.normalized.electoralActivitySummary` | Resumo de Atividade Eleitoral | Nested object (11 nested fields) | Enrichment Data | Estatísticas agregadas sobre doações eleitorais |
| `enrichmentData.normalized.electoralActivity` | Doações Eleitorais por Ano | Array of objects (6 nested fields) | Enrichment Data | Buscar doações eleitorais específicas por ano |
| `enrichmentData.normalized.taxReturnsSummary` | Resumo de Declarações de IR | Nested object (6 nested fields) | Enrichment Data | Estatísticas agregadas sobre declarações de imposto de renda |
| `enrichmentData.normalized.taxReturns` | Declarações de Imposto | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as declarações de imposto |
| `enrichmentData.normalized.relationships` | Relacionamentos | Array of objects (11 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os relacionamentos |
| `enrichmentData.normalized.relationshipsSummary` | Resumo de Relacionamentos | Nested object (12 nested fields) | Enrichment Data | Estatísticas agregadas sobre relacionamentos |
| `enrichmentData.normalized.aliases` | Nomes Alternativos | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os nomes alternativos |
| `kyc.status` | Status KYC | Text/String | KYC Verification | Status da validação KYC (KYC provider) |
| `kyc.biometricResult` | Resultado Biométrico | Nested object (3 nested fields) | KYC Verification | Resultados de face match e liveness (KYC provider) |
| `kyc.documentsVerified` | Documentos Verificados | Array of objects (3 nested fields) | KYC Verification | Lista de documentos verificados no KYC |
| `kyc.riskAssessment` | Avaliação de Risco KYC | Nested object (2 nested fields) | KYC Verification | Avaliação de risco realizada pelo KYC |
| `kyc.extractedData` | Dados Extraídos do Documento | Nested object (7 nested fields) | KYC Verification | Dados extraídos do documento de identidade |
| `kyc.verifiedAt` | Data de Verificação KYC | Date (ISO 8601 format) | KYC Verification | Data em que o KYC foi verificado/aprovado |
| `kyc.isCurrent` | É Validação Atual | Boolean (true/false) | KYC Verification | Indica se é a validação KYC ativa/atual |
| `kyc.provider` | Provedor KYC | Text/String | KYC Verification | Nome do provedor que realizou o KYC (ex: KYC provider) |
### AR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| -------------------------------------------------------------------------- | --------------------------------- | ----------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `taxId` | CUIL/CUIT | Text/String | Basic Information | |
| `name` | Nombre - Info. Basica | Text/String | Basic Information | |
| `entityData.person.firstName` | Nombre - Detalles | Text/String | Basic Information | |
| `entityData.person.lastName` | Apellido | Text/String | Basic Information | |
| `entityData.person.dateOfBirth` | Fecha de Nacimiento | Date (ISO 8601 format) | Basic Information | |
| `entityData.person.email` | Email | Text/String | Basic Information | |
| `entityData.person.phone` | Teléfono | Text/String | Basic Information | |
| `entityData.person.address` | Dirección | Text/String | Basic Information | |
| `entityData.person.occupation` | Ocupación | Text/String | Basic Information | |
| `entityData.person.gender` | Género | Text/String | Basic Information | |
| `entityData.person.maritalStatus` | Estado Civil | Text/String | Basic Information | |
| `entityData.person.nationality` | Nacionalidad | Text/String | Basic Information | |
| `entityData.person.income` | Ingresos | Number | Basic Information | |
| `entityData.person.idType` | Tipo de Documento | Text/String | Basic Information | |
| `entityData.person.idNumber` | Número de Documento | Text/String | Basic Information | |
| `entityData.person.city` | Ciudad | Text/String | Basic Information | |
| `entityData.person.state` | Provincia | Text/String | Basic Information | |
| `entityData.person.postalCode` | Código Postal | Text/String | Basic Information | |
| `entityData.person.country` | País | Text/String | Basic Information | |
| `entityData.person.alternativePhone` | Teléfono Alternativo | Text/String | Basic Information | |
| `entityData.person.isPep` | Es PEP (Manual) | Boolean (true/false) | Basic Information | Campo manual - preferir enrichmentData.normalized.isPep |
| `entityData.person.pepPosition` | Cargo PEP (Manual) | Text/String | Basic Information | Campo manual - preferir enrichmentData.normalized.pepPosition |
| `entityData.person.pepCountry` | País PEP (Manual) | Text/String | Basic Information | Campo manual - preferir enrichmentData.normalized.pepCountry |
| `status` | Estado | Text/String | Basic Information | |
| `enrichmentData.normalized.documents` | Documentos | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los documentos |
| `enrichmentData.normalized.documentsSummary.totalDocuments` | Total de Documentos | Number | Enrichment Data | Número total de documentos |
| `enrichmentData.normalized.documentsSummary.confirmedDocuments` | Documentos Confirmados | Number | Enrichment Data | Documentos confirmados por múltiples fuentes |
| `enrichmentData.normalized.documentsSummary.mainDocument` | Documento Principal | Text/String | Enrichment Data | Documento principal formateado |
| `enrichmentData.normalized.documentsSummary.hasMultipleDocuments` | Posee Múltiples Documentos | Boolean (true/false) | Enrichment Data | Indica si hay más de un documento |
| `enrichmentData.normalized.documentsSummary.hasExpiredDocuments` | Posee Documentos Expirados | Boolean (true/false) | Enrichment Data | Indica si hay documentos vencidos |
| `enrichmentData.normalized.riskFlags` | Banderas de Riesgo | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las banderas de riesgo |
| `enrichmentData.normalized.riskFlagsSummary.totalFlags` | Total de Banderas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.activeFlags` | Banderas Activas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasPepFlags` | Tiene Banderas PEP | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasSanctionFlags` | Tiene Banderas de Sanción | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.demographics` | Demografía | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los datos demográficos |
| `enrichmentData.normalized.demographicsSummary.hasDemographicData` | Tiene Datos Demográficos | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.demographicsSummary.hasConflicts` | Tiene Conflictos | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.demographicsSummary.consensusAge` | Edad Consenso | Number | Enrichment Data | |
| `enrichmentData.normalized.occupations` | Ocupaciones | Array of objects (11 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los datos de ocupación |
| `enrichmentData.normalized.occupationsSummary.totalOccupations` | Total de Ocupaciones | Number | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.hasCurrentOccupation` | Tiene Ocupación Actual | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.currentOccupation` | Ocupación Actual | Text/String | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.currentEmployer` | Empleador Actual | Text/String | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.hasIncomeData` | Tiene Datos de Ingreso | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.adverseMediaScore` | Score de Medios Adversos | Number | Enrichment Data | |
| `enrichmentData.normalized.criminalInvolvements` | Involucramientos Criminales | Text/String | Enrichment Data | |
| `enrichmentData.normalized.bankruptcies` | Quiebras | Number | Enrichment Data | |
| `enrichmentData.normalized.confidence` | Confianza de Datos | Number | Enrichment Data | |
| `enrichmentData.normalized.completeness` | Completitud de Datos | Number | Enrichment Data | |
| `enrichmentData.normalized.totalDebt` | Deuda Total | Number | Enrichment Data | Deuda total en sistema financiero (BCRA Deudas) - en root |
| `enrichmentData.normalized.worstCreditSituation` | Peor Situación Crediticia | Number | Enrichment Data | Peor situación crediticia: 1=Normal, 2=En Observación, 3=Con Problemas, 4=Alto Riesgo, 5=Irrecuperable (BCRA) - en root |
| `enrichmentData.normalized.debtorStatus` | Estado Deudor | Text/String | Enrichment Data | Estado como deudor: NORMAL, EN\_OBSERVACION, CON\_PROBLEMAS, ALTO\_RIESGO, IRRECUPERABLE (BCRA) - en root |
| `enrichmentData.normalized.monthlyIncome` | Ingreso Mensual | Number | Enrichment Data | Ingreso mensual estimado - Nosis |
| `enrichmentData.normalized.pepScore` | Score de Riesgo PEP | Number | Enrichment Data | Score de riesgo PEP (0-100, donde 100 = alto riesgo) |
| `enrichmentData.normalized.riskScore` | Score de Riesgo General | Number | Enrichment Data | Score general de riesgo (0-100, donde 100 = alto riesgo) |
| `enrichmentData.normalized.laborViolations` | Infracciones Laborales | Boolean (true/false) | Enrichment Data | Tiene infracciones laborales registradas - RePET |
| `enrichmentData.normalized.vehicleCount` | Cantidad de Vehículos | Number | Enrichment Data | Número de vehículos registrados - Nosis |
| `enrichmentData.normalized.propertyCount` | Cantidad de Propiedades | Number | Enrichment Data | Número de propiedades inmobiliarias - Nosis |
| `enrichmentData.normalized.fullName` | Nombre Completo | Text/String | Enrichment Data | Nombre completo de la persona (Nosis) - en root |
| `enrichmentData.normalized.firstName` | Nombre | Text/String | Enrichment Data | Nombre de la persona (Nosis) - en root |
| `enrichmentData.normalized.lastName` | Apellido | Text/String | Enrichment Data | Apellido de la persona (Nosis) - en root |
| `enrichmentData.normalized.taxId` | CUIL/CUIT | Text/String | Enrichment Data | CUIL o CUIT de la persona (Nosis) - en root |
| `enrichmentData.normalized.idNumber` | DNI | Text/String | Enrichment Data | Número de DNI (Nosis) - en root |
| `enrichmentData.normalized.idType` | Tipo de Documento | Text/String | Enrichment Data | Tipo de documento de identidad (Nosis) - en root |
| `enrichmentData.normalized.dateOfBirth` | Fecha de Nacimiento | Date (ISO 8601 format) | Enrichment Data | Fecha de nacimiento (Nosis) - en root |
| `enrichmentData.normalized.age` | Edad | Number | Enrichment Data | Edad de la persona (Nosis) - en root |
| `enrichmentData.normalized.gender` | Género | Text/String | Enrichment Data | Género (male/female/unknown) (Nosis) - en root |
| `enrichmentData.normalized.isDeceased` | Es Fallecido | Boolean (true/false) | Enrichment Data | Indica si la persona está fallecida (Nosis) - en root |
| `enrichmentData.normalized.country` | País | Text/String | Enrichment Data | País (AR) (Nosis) - en root |
| `enrichmentData.normalized.nationality` | Nacionalidad | Text/String | Enrichment Data | Nacionalidad de la persona (REPET) - en root |
| `enrichmentData.normalized.isMonotributo` | Es Monotributista | Boolean (true/false) | Enrichment Data | Pessoa registrada en régimen de monotributo (AFIP) - Nosis - en root |
| `enrichmentData.normalized.isAutonomous` | Es Autónomo | Boolean (true/false) | Enrichment Data | Inscripto como trabajador autónomo - Nosis - en root |
| `enrichmentData.normalized.isEmployee` | Es Empleado | Boolean (true/false) | Enrichment Data | Pessoa tiene empleo en relación de dependencia - Nosis - en root |
| `enrichmentData.normalized.isEmployer` | Es Empleador | Boolean (true/false) | Enrichment Data | Pessoa es empleador con trabajadores a cargo - Nosis - en root |
| `enrichmentData.normalized.isRetired` | Es Jubilado | Boolean (true/false) | Enrichment Data | Pessoa recibe jubilación o pensión - Nosis - en root |
| `enrichmentData.normalized.afipSeniority` | Antigüedad AFIP | Number | Enrichment Data | Antigüedad de inscripción en AFIP en meses - Nosis - en root |
| `enrichmentData.normalized.isIvaRegistered` | Inscripto en IVA | Boolean (true/false) | Enrichment Data | Inscripto en IVA - Nosis - en root |
| `enrichmentData.normalized.isIncomeTaxRegistered` | Inscripto en Ganancias | Boolean (true/false) | Enrichment Data | Inscripto en Impuesto a las Ganancias - Nosis - en root |
| `enrichmentData.normalized.afipRegistrationDate` | Fecha de Inscripción AFIP | Date (ISO 8601 format) | Enrichment Data | Fecha más antigua de inscripción en AFIP - Nosis - en root |
| `enrichmentData.normalized.employmentSeniority` | Antigüedad Laboral | Number | Enrichment Data | Antigüedad laboral en meses - Nosis - en root |
| `enrichmentData.normalized.wasEmployedLast12Months` | Empleado Últimos 12 Meses | Boolean (true/false) | Enrichment Data | Tuvo empleo en los últimos 12 meses - Nosis - en root |
| `enrichmentData.normalized.isPep` | Es o Fue PEP | Boolean (true/false) | Enrichment Data | Es o fue Pessoa Políticamente Expuesta - Nosis - en root |
| `enrichmentData.normalized.isCurrentPep` | Es PEP Actual | Boolean (true/false) | Enrichment Data | Es actualmente PEP - Nosis - en root |
| `enrichmentData.normalized.isAMLObligatedSubject` | Es Sujeto Obligado AML | Boolean (true/false) | Enrichment Data | Es sujeto obligado por normativa AML/CFT - Nosis - en root |
| `enrichmentData.normalized.laftHomonymsCount` | Cantidad de Homónimos LAFT | Number | Enrichment Data | Cantidad de homónimos en listas LAFT - Nosis - en root |
| `enrichmentData.normalized.isMemberOfCompany` | Es Miembro de Sociedad | Boolean (true/false) | Enrichment Data | Es integrante/socio de sociedad - Nosis - en root |
| `enrichmentData.normalized.addresses` | Direcciones | Array of objects (9 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las direcciones |
| `enrichmentData.normalized.addressesSummary.totalAddresses` | Total de Direcciones | Number | Enrichment Data | |
| `enrichmentData.normalized.addressesSummary.confirmedAddresses` | Direcciones Confirmadas | Number | Enrichment Data | |
| `enrichmentData.normalized.aliases` | Alias/Nombres Alternativos | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los nombres alternativos |
| `enrichmentData.normalized.aliasesSummary` | Resumen de Aliases | Nested object (4 nested fields) | Enrichment Data | Estadísticas agregadas sobre nombres alternativos |
| `enrichmentData.normalized.emails` | Emails | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los emails |
| `enrichmentData.normalized.emailsSummary.totalEmails` | Total de Emails | Number | Enrichment Data | |
| `enrichmentData.normalized.emailsSummary.validatedEmails` | Emails Validados | Number | Enrichment Data | |
| `enrichmentData.normalized.phones` | Teléfonos | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los teléfonos |
| `enrichmentData.normalized.phonesSummary.totalPhones` | Total de Teléfonos | Number | Enrichment Data | |
| `enrichmentData.normalized.phonesSummary.activePhones` | Teléfonos Activos | Number | Enrichment Data | |
| `enrichmentData.normalized.sanctioned` | Sancionado | Boolean (true/false) | Enrichment Data | Pessoa aparece en listas de sanciones (RePET Argentina) |
| `enrichmentData.normalized.sanctions` | Sanciones Consolidadas | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las sanciones consolidadas |
| `enrichmentData.normalized.sanctionsSummary` | Resumen de Sanciones | Nested object (4 nested fields) | Enrichment Data | Estadísticas agregadas sobre listas de sanciones |
| `enrichmentData.normalized.terrorismRegistryMatch` | Registro de Terrorismo | Boolean (true/false) | Enrichment Data | Pessoa aparece en registro de terrorismo (RePET) |
| `enrichmentData.normalized.terrorismRegistryActive` | Registro de Terrorismo Activo | Boolean (true/false) | Enrichment Data | Registro de terrorismo está actualmente activo (RePET) |
| `enrichmentData.normalized.legalProceedings` | Procesos Judiciales | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los procesos judiciales |
| `enrichmentData.normalized.legalProceedingsSummary.totalProceedings` | Total de Procesos | Number | Enrichment Data | |
| `enrichmentData.normalized.legalProceedingsSummary.hasActiveCriminalCases` | Tiene Casos Criminales Activos | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.terrorismRegistryMatch` | Coincidencia Registro Terrorismo | Boolean (true/false) | Enrichment Data | Pessoa figura en registros de terrorismo |
| `enrichmentData.normalized.terrorismRegistryActive` | Registro Terrorismo Activo | Boolean (true/false) | Enrichment Data | Registro de terrorismo está activo |
| `enrichmentData.normalized.terrorismRiskLevel` | Nivel Riesgo Terrorismo | Text/String | Enrichment Data | Nivel de riesgo de terrorismo (CRITICAL, HIGH, MEDIUM, LOW) |
| `enrichmentData.normalized.totalCurrentDebt` | Deuda Total Actual | Number | Enrichment Data | Deuda total en el período actual |
| `enrichmentData.normalized.averageMonthlyDebt` | Deuda Mensual Promedio | Number | Enrichment Data | Promedio de deuda mensual |
| `enrichmentData.normalized.totalHistoricalDebt` | Deuda Histórica Total | Number | Enrichment Data | Suma total de deudas históricas |
| `enrichmentData.normalized.worstHistoricalSituation` | Peor Situación Histórica | Number | Enrichment Data | Peor situación crediticia histórica (0-6) |
| `enrichmentData.normalized.totalFinancialEntities` | Total Entidades Financieras | Number | Enrichment Data | Cantidad de entidades financieras con las que opera |
| `enrichmentData.normalized.hasActiveRevisions` | Tiene Revisiones Activas | Boolean (true/false) | Enrichment Data | Tiene revisiones crediticias activas |
| `enrichmentData.normalized.hasActiveLegalProcesses` | Tiene Procesos Judiciales Activos | Boolean (true/false) | Enrichment Data | Tiene procesos judiciales activos relacionados con deudas |
| `enrichmentData.normalized.periodsAnalyzed` | Períodos Analizados | Number | Enrichment Data | Cantidad de períodos mensuales analizados |
| `kyc.status` | Status KYC | Text/String | KYC Verification | Status da validação KYC (KYC provider) |
| `kyc.biometricResult` | Resultado Biométrico | Nested object (3 nested fields) | KYC Verification | Resultados de face match e liveness (KYC provider) |
| `kyc.documentsVerified` | Documentos Verificados | Array of objects (3 nested fields) | KYC Verification | Lista de documentos verificados no KYC |
| `kyc.riskAssessment` | Avaliação de Risco KYC | Nested object (2 nested fields) | KYC Verification | Avaliação de risco realizada pelo KYC |
| `kyc.extractedData` | Dados Extraídos do Documento | Nested object (7 nested fields) | KYC Verification | Dados extraídos do documento de identidade |
| `kyc.verifiedAt` | Data de Verificação KYC | Date (ISO 8601 format) | KYC Verification | Data em que o KYC foi verificado/aprovado |
| `kyc.isCurrent` | É Validação Atual | Boolean (true/false) | KYC Verification | Indica se é a validação KYC ativa/atual |
| `kyc.provider` | Provedor KYC | Text/String | KYC Verification | Nome do provedor que realizou o KYC (ex: KYC provider) |
### Global Fields
| Field Path | Label | Type | Category | Description |
| ------------------------------------------------------------------- | ---------------------------- | ----------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enrichmentData.normalized.riskFlags` | Banderas de Riesgo | Array of objects (11 nested fields) | Enrichment Data | Banderas de riesgo consolidadas (PEP, Sanciones). Solo se consolidan automáticamente si hay 1 hit relevante. |
| `enrichmentData.normalized.riskFlagsSummary.totalFlags` | Total de Banderas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.activeFlags` | Banderas Activas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasPepFlags` | Tiene Banderas PEP | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasSanctionFlags` | Tiene Banderas de Sanción | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.isPep` | Es PEP | Boolean (true/false) | Enrichment Data | Pessoa Políticamente Expuesta (actual o histórico) |
| `enrichmentData.normalized.isCurrentPep` | Es PEP Actual | Boolean (true/false) | Enrichment Data | Actualmente ejerce cargo político |
| `enrichmentData.normalized.pepCountry` | País PEP | Text/String | Enrichment Data | País onde exerce/exerceu o cargo político |
| `enrichmentData.normalized.pepLevels` | Níveis PEP | Array (string\[]) | Enrichment Data | Array de níveis/tipos PEP na raiz de normalized (ex: \["1","2"], \["national","local"]). **Não usar** enrichmentData.normalized.pepLevel na raiz (não existe); para nível singular por bandeira usar riskFlags.\$.details.pepLevel |
| `enrichmentData.normalized.sanctioned` | Sancionado | Boolean (true/false) | Enrichment Data | Aparece en listas de sanciones internacionales |
| `enrichmentData.normalized.adverseMedia` | Medios Adversos | Boolean (true/false) | Enrichment Data | Tiene menciones en medios adversos |
| `enrichmentData.normalized.dateOfBirth` | Fecha de Nacimiento | Date (ISO 8601 format) | Enrichment Data | Fecha de nacimiento consolidada (ComplyAdvantage) |
| `enrichmentData.normalized.country` | País | Text/String | Enrichment Data | País de la persona (ComplyAdvantage) |
| `enrichmentData.normalized.sanctions` | Sanciones | Array of objects (8 nested fields) | Enrichment Data | Listas de sanciones donde aparece la persona |
| `enrichmentData.normalized.mediaMentions` | Menciones en Medios | Array of objects (8 nested fields) | Enrichment Data | Menciones en medios adversos |
| `enrichmentData.normalized.demographics` | Demografía | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los datos demográficos |
| `enrichmentData.normalized.demographicsSummary.hasDemographicData` | Tiene Datos Demográficos | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.demographicsSummary.hasConflicts` | Tiene Conflictos | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.demographicsSummary.consensusAge` | Edad Consenso | Number | Enrichment Data | |
| `enrichmentData.normalized.occupations` | Ocupaciones | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los datos de ocupación |
| `enrichmentData.normalized.occupationsSummary.totalOccupations` | Total de Ocupaciones | Number | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.hasCurrentOccupation` | Tiene Ocupación Actual | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.currentOccupation` | Ocupación Actual | Text/String | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.currentEmployer` | Empleador Actual | Text/String | Enrichment Data | |
| `enrichmentData.normalized.occupationsSummary.hasIncomeData` | Tiene Datos de Ingreso | Boolean (true/false) | Enrichment Data | |
| `kyc.status` | Status KYC | Text/String | KYC Verification | Status da validação KYC (KYC provider) |
| `kyc.biometricResult` | Resultado Biométrico | Nested object (3 nested fields) | KYC Verification | Resultados de face match e liveness (KYC provider) |
| `kyc.documentsVerified` | Documentos Verificados | Array of objects (3 nested fields) | KYC Verification | Lista de documentos verificados no KYC |
| `kyc.riskAssessment` | Avaliação de Risco KYC | Nested object (2 nested fields) | KYC Verification | Avaliação de risco realizada pelo KYC |
| `kyc.extractedData` | Dados Extraídos do Documento | Nested object (7 nested fields) | KYC Verification | Dados extraídos do documento de identidade |
| `kyc.verifiedAt` | Data de Verificação KYC | Date (ISO 8601 format) | KYC Verification | Data em que o KYC foi verificado/aprovado |
| `kyc.isCurrent` | É Validação Atual | Boolean (true/false) | KYC Verification | Indica se é a validação KYC ativa/atual |
| `kyc.provider` | Provedor KYC | Text/String | KYC Verification | Nome do provedor que realizou o KYC (ex: KYC provider) |
## Estruturas de Campos Aninhados
Alguns campos contêm estruturas aninhadas (arrays ou objetos) com múltiplos subcampos:
### `enrichmentData.normalized.documentsSummary` - Resumo de Documentos
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | --------------------------- | -------------------- | ------------------------------------------- |
| `totalDocuments` | Total de Documentos | Number | Número total de documentos |
| `confirmedDocuments` | Documentos Confirmados | Number | Documentos confirmados por múltiplas fontes |
| `mainDocument` | Documento Principal | Text/String | Documento principal formatado |
| `hasMultipleDocuments` | Possui Múltiplos Documentos | Boolean (true/false) | Indica se há mais de um documento |
| `hasExpiredDocuments` | Possui Documentos Expirados | Boolean (true/false) | Indica se há documentos vencidos |
### `enrichmentData.normalized.documents` - Documentos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------- | -------------------- | ------------------------------------ |
| `value` | Número | Text/String | Número do documento (ex: "33660120") |
| `type` | Tipo | Text/String | Tipo de documento |
| `classification` | Classificação | Text/String | Classificação do documento |
| `active` | Ativo | Boolean (true/false) | Documento está ativo |
| `isExpired` | Expirado | Boolean (true/false) | Documento está expirado |
| `issuingCountry` | País Emissor | Text/String | Código ISO do país (ex: "BR", "US") |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.documents.$.value",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.addressesSummary` - Resumo de Endereços
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre endereços
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------- | --------------------- | ------ | ------------------------------------------ |
| `totalAddresses` | Total de Endereços | Number | Número total de endereços |
| `confirmedAddresses` | Endereços Confirmados | Number | Endereços confirmados por múltiplas fontes |
### `enrichmentData.normalized.addresses` - Endereços
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os endereços
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------- | ----------------- | -------------------- | ----------- |
| `fullAddress` | Endereço Completo | Text/String | |
| `city` | Cidade | Text/String | |
| `state` | Estado | Text/String | |
| `country` | País | Text/String | |
| `postalCode` | CEP | Text/String | |
| `type` | Tipo | Text/String | |
| `isActive` | Ativo | Boolean (true/false) | |
| `isCurrent` | Atual | Boolean (true/false) | |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.addresses.$.fullAddress",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.emailsSummary` - Resumo de E-mails
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre e-mails
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------------- | ----------------- | ------ | ----------------------- |
| `totalEmails` | Total de E-mails | Number | Número total de e-mails |
| `validatedEmails` | E-mails Validados | Number | E-mails validados |
### `enrichmentData.normalized.emails` - E-mails
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os e-mails
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------- | ------------------ | -------------------- | ----------- |
| `address` | Endereço de E-mail | Text/String | |
| `domain` | Domínio | Text/String | |
| `type` | Tipo | Text/String | |
| `isValidated` | Validado | Boolean (true/false) | |
| `isActive` | Ativo | Boolean (true/false) | |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.emails.$.address",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.phonesSummary` - Resumo de Telefones
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre telefones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------- | ------------------ | ------ | ------------------------- |
| `totalPhones` | Total de Telefones | Number | Número total de telefones |
| `activePhones` | Telefones Ativos | Number | Telefones ativos |
### `enrichmentData.normalized.phones` - Telefones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os telefones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ------------------ | -------------------- | ----------- |
| `number` | Número Completo | Text/String | |
| `normalizedNumber` | Número Normalizado | Text/String | |
| `countryCode` | Código do País | Text/String | |
| `areaCode` | DDD | Text/String | |
| `type` | Tipo | Text/String | |
| `isActive` | Ativo | Boolean (true/false) | |
| `currentCarrier` | Operadora Atual | Text/String | |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.phones.$.number",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctionsSummary` - Resumo de Sanções
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre sanções
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | -------------------------- | ------ | --------------------------------------- |
| `totalLists` | Total de Listas de Sanções | Number | Número total de listas |
| `confirmedLists` | Listas Confirmadas | Number | Listas confirmadas por múltiplas fontes |
### `enrichmentData.normalized.legalProceedingsSummary` - Resumo de Processos Legais
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre processos legais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------------------- | -------------------------------------- | ---------------------- | ----------------------------------------------------------- |
| `totalProceedings` | Total de Processos | Number | Número total de processos |
| `hasActiveCriminalCases` | Tem Processos Criminais Ativos | Boolean (true/false) | Indica se há processos criminais ativos |
| `hasArrestWarrant` | Tem Mandado de Prisão | Boolean (true/false) | Indica se há mandado de prisão |
| `byType.criminal` | Processos Criminais | Number | Número de processos criminais |
| `byType.civil` | Processos Cíveis | Number | Número de processos cíveis |
| `byType.labor` | Processos Trabalhistas | Number | Número de processos trabalhistas |
| `byType.public_ministry` | Processos do Ministério Público | Number | Número de investigações/processos do MP |
| `byType.arrest_warrant` | Mandados de Prisão | Number | Número de mandados de prisão |
| `byStatus.active` | Processos Ativos | Number | Número de processos ativos |
| `byStatus.closed` | Processos Encerrados | Number | Número de processos encerrados |
| `bySeverity.high` | Processos de Alta Severidade | Number | Número de processos de alta severidade |
| `bySeverity.critical` | Processos de Severidade Crítica | Number | Número de processos críticos |
| `hasLaborViolations` | Tem Violações Trabalhistas | Boolean (true/false) | Indica se há violações trabalhistas |
| `hasPublicMinistryInvestigation` | Tem Investigação do Ministério Público | Boolean (true/false) | Indica se há investigação do MP |
| `underSecrecy` | Processos em Segredo de Justiça | Number | Número de processos sob sigilo |
| `urgent` | Processos Urgentes | Number | Número de processos urgentes |
| `totalValue` | Valor Total dos Processos | Number | Valor monetário total |
| `totalClaimAmount` | Valor Total das Causas | Number | Soma total dos valores de todas as causas (em centavos) |
| `averageClaimAmount` | Valor Médio das Causas | Number | Valor médio das causas (em centavos) |
| `activeProcessosCount` | Processos Ativos (Total) | Number | Número total de processos com status ativo |
| `mostRecentUpdate` | Atualização Mais Recente | Date (ISO 8601 format) | Data da atualização mais recente entre todos os processos |
| `oldestCaseYear` | Ano do Processo Mais Antigo | Text/String | Ano do processo mais antigo |
| `multiSourceConfirmationRate` | Taxa de Confirmação Multi-Fonte | Number | Porcentagem de processos confirmados por múltiplas fontes |
| `byRole.asAuthor` | Como Autor | Number | Número de processos como autor/requerente |
| `byRole.asDefendant` | Como Réu | Number | Número de processos como réu/requerido |
| `byRole.asOther` | Outro Papel | Number | Número de processos em outro papel |
| `byRole.unknown` | Papel Desconhecido | Number | Número de processos com papel desconhecido |
| `averageLawsuitAge` | Idade Média dos Processos (dias) | Number | Idade média de todos os processos em dias |
| `totalUpdates` | Total de Atualizações | Number | Soma total de atualizações/movimentos em todos os processos |
| `proceedingsWithJudge` | Processos com Juiz Identificado | Number | Quantidade de processos com juiz identificado |
| `recentActivityCount` | Processos com Atividade Recente | Number | Processos com atividade nos últimos 30 dias |
| `oldProceedingsCount` | Processos Antigos | Number | Número de processos com mais de 2 anos (>730 dias) |
### `enrichmentData.normalized.legalProceedings` - Processos Judiciais
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os processos judiciais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `caseNumber` | Número do Processo | Text/String | Número do processo |
| `subject` | Assunto | Text/String | Assunto do processo |
| `type` | Tipo | Text/String | Tipo de processo |
| `status` | Status | Text/String | Status do processo |
| `statusDetail` | Status Detalhado (Brasil) | Text/String | Status original do processo antes da normalização (DISTRIBUIDO, ATIVO, EM\_ANDAMENTO, ENCERRADO, ARQUIVADO, CONDENADO, ABSOLVIDO, etc.) |
| `role` | Papel da Pessoa | Text/String | Papel da pessoa no processo |
| `court` | Tribunal/Vara | Text/String | Tribunal ou vara |
| `tribunal` | Tribunal | Text/String | Nome do tribunal (ex: TJSP, TJRJ) |
| `comarca` | Comarca | Text/String | Comarca do processo |
| `state` | Estado | Text/String | Estado (UF) do processo (ex: SP, RJ, PR) |
| `judge` | Juiz | Text/String | Nome do juiz responsável |
| `courtDistrict` | Foro/Distrito | Text/String | Foro ou distrito judicial |
| `courtLevel` | Instância | Text/String | Instância do tribunal |
| `judgingBody` | Órgão Julgador | Text/String | Órgão julgador ou câmara |
| `severity` | Severidade | Text/String | Nível de severidade do processo |
| `filingDate` | Data de Entrada | Date (ISO 8601 format) | Data de entrada do processo |
| `filingYear` | Ano de Entrada | Text/String | Ano de distribuição do processo |
| `lastUpdate` | Última Atualização | Date (ISO 8601 format) | Data da última atualização |
| `lastMovementDate` | Último Movimento | Date (ISO 8601 format) | Data do último movimento processual |
| `noticeDate` | Data de Notificação | Date (ISO 8601 format) | Data de notificação |
| `closeDate` | Data de Encerramento | Date (ISO 8601 format) | Data de encerramento do processo |
| `amount` | Valor | Number | Valor da causa (em centavos) |
| `lawsuitAge` | Idade do Processo (dias) | Number | Idade do processo em dias |
| `numberOfUpdates` | Número de Atualizações | Number | Quantidade de atualizações/movimentos |
| `numberOfParties` | Número de Partes | Number | Quantidade de partes envolvidas |
| `confidence` | Confiança | Number | Nível de confiança dos dados (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.legalProceedings.$.caseNumber",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.riskFlags` - Bandeiras de Risco
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as bandeiras de risco
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | --------------------------------------------------- |
| `flagType` | Tipo de Bandeira | Text/String | Tipo de bandeira de risco |
| `isActive` | Está Ativo | Boolean (true/false) | Indica se a bandeira de risco está atualmente ativa |
| `details.severity` | Severidade | Text/String | Nível de severidade do risco |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (apenas para PEP) |
| `details.pepCountry` | País PEP | Text/String | País do cargo político |
| `details.pepLevel` | Nível PEP | Text/String | Nível do PEP (nacional, internacional, local) |
| `details.description` | Descrição | Text/String | Descrição detalhada da bandeira |
| `details.riskScore` | Score de Risco | Number | Score de risco (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Bandeira confirmada por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.riskFlagsSummary` - Resumo de Bandeiras de Risco
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre bandeiras de risco
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ----------------------- | -------------------- | -------------------------------- |
| `totalFlags` | Total de Bandeiras | Number | Número total de bandeiras |
| `activeFlags` | Bandeiras Ativas | Number | Bandeiras atualmente ativas |
| `hasPepFlags` | Tem Bandeiras PEP | Boolean (true/false) | Indica se há bandeiras PEP |
| `hasSanctionFlags` | Tem Bandeiras de Sanção | Boolean (true/false) | Indica se há bandeiras de sanção |
### `enrichmentData.normalized.violations` - Violações Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `id` | ID | Text/String | Identificador único da violação |
| `displayName` | Nome | Text/String | Nome formatado da violação |
| `category` | Categoria | Text/String | Categoria da violação |
| `subcategory` | Subcategoria | Text/String | Subcategoria da violação |
| `severity` | Severidade | Text/String | Nível de severidade |
| `legalClassification` | Classificação Legal | Text/String | Tipo legal da violação |
| `complianceClassification` | Classificação de Compliance | Text/String | Tipo de compliance |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Violação confirmada por 2+ fontes |
| `count` | Contagem | Number | Número de vezes reportada |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.violations.$.id",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.violationsSummary` - Resumo de Violações
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre violações
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------------------ | -------------------- | ----------------------------------- |
| `totalViolations` | Total de Violações | Number | Número total de violações |
| `hasCriminalViolations` | Tem Violações Criminais | Boolean (true/false) | Indica se há violações criminais |
| `hasESGViolations` | Tem Violações ESG | Boolean (true/false) | Indica se há violações ESG |
| `hasEnvironmentalCrimes` | Tem Crimes Ambientais | Boolean (true/false) | Indica se há crimes ambientais |
| `hasLaborViolations` | Tem Violações Trabalhistas | Boolean (true/false) | Indica se há violações trabalhistas |
| `hasFinancialCrimes` | Tem Crimes Financeiros | Boolean (true/false) | Indica se há crimes financeiros |
| `confirmedByMultipleSources` | Violações Confirmadas por Múltiplas Fontes | Number | Número de violações confirmadas |
### `enrichmentData.normalized.mediaMentions` - Menções em Mídia
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as menções em mídia consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `id` | ID | Text/String | Identificador único da menção |
| `title` | Título | Text/String | Título da menção |
| `description` | Descrição | Text/String | Descrição completa |
| `date` | Data | Text/String | Data da menção (YYYY-MM-DD) |
| `sentiment` | Sentimento | Text/String | Sentimento da menção |
| `category` | Categoria | Text/String | Categoria da menção |
| `amount` | Valor (centavos) | Number | Valor monetário em centavos |
| `currency` | Moeda | Text/String | Código da moeda (BRL, USD) |
| `entity` | Entidade | Text/String | Tribunal, agência, parceiro mencionado |
| `severity` | Severidade | Text/String | Nível de severidade |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Menção confirmada por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.mediaMentions.$.id",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.mediaSummary` - Resumo de Mídia
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre menções na mídia
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------------ | --------------------------------- | ----------- | ---------------------------------------------- |
| `totalMentions` | Total de Menções | Number | Número total de menções |
| `recentMentions` | Menções Recentes (12 meses) | Number | Menções nos últimos 12 meses |
| `highImpactMentions` | Menções de Alto Impacto | Number | Menções com valor monetário ou resultado legal |
| `sentimentScore` | Score de Sentimento (-100 a +100) | Number | Score geral de sentimento |
| `firstMentionDate` | Data da Primeira Menção | Text/String | Data da primeira menção na mídia (ISO format) |
| `latestMentionDate` | Data da Última Menção | Text/String | Data da menção mais recente (ISO format) |
| `bySentiment.positive` | Menções Positivas | Number | Número de menções com sentimento positivo |
| `bySentiment.negative` | Menções Negativas | Number | Número de menções com sentimento negativo |
| `bySentiment.neutral` | Menções Neutras | Number | Número de menções com sentimento neutro |
| `condemnationsCount` | Condenações | Number | Número de condenações |
| `investigationsCount` | Investigações | Number | Número de investigações |
| `awardsCount` | Prêmios | Number | Número de prêmios |
| `positiveCount` | Total de Menções Positivas | Number | Total de menções positivas |
| `negativeCount` | Total de Menções Negativas | Number | Total de menções negativas |
| `adverseHighImpactCount` | Mídia Adversa de Alto Impacto | Number | Menções negativas com alto impacto |
### `enrichmentData.normalized.sanctions` - Sanções Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as sanções consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
| `listName` | Nome da Lista | Text/String | Nome formatado da lista (ex: "OFAC SDN", "UN Sanctions", "Mídia"). Busca livre por texto |
| `type` | Tipo de Sanção | Text/String | Categoria da sanção para agrupamento e filtros |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Sanção confirmada por 2+ provedores |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `addedDate` | Data de Adição | Text/String | Data em que foi adicionado à lista |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.listName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.demographics` - Demografia
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os dados demográficos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `dateOfBirth` | Data de Nascimento | Text/String | Data de nascimento (ISO format) |
| `age` | Idade | Number | Idade calculada |
| `gender` | Gênero | Text/String | Gênero da pessoa |
| `nationality` | Nacionalidade | Text/String | País de nacionalidade |
| `maritalStatus` | Estado Civil | Text/String | Estado civil |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Dado confirmado por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.demographics.$.dateOfBirth",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.demographicsSummary` - Resumo Demográfico
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre dados demográficos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | ---------------------- | -------------------- | ------------------------------------------- |
| `hasDemographicData` | Tem Dados Demográficos | Boolean (true/false) | Indica se há dados demográficos |
| `hasConflicts` | Tem Conflitos | Boolean (true/false) | Indica se há conflitos entre dados |
| `hasDateOfBirth` | Tem Data de Nascimento | Boolean (true/false) | Indica se há data de nascimento |
| `hasAge` | Tem Idade | Boolean (true/false) | Indica se há idade |
| `hasGender` | Tem Gênero | Boolean (true/false) | Indica se há gênero |
| `hasNationality` | Tem Nacionalidade | Boolean (true/false) | Indica se há nacionalidade |
| `consensusAge` | Idade Consenso | Number | Idade mais confirmada |
| `consensusGender` | Gênero Consenso | Text/String | Gênero mais confirmado por múltiplas fontes |
| `consensusNationality` | Nacionalidade Consenso | Text/String | Nacionalidade mais confirmada |
### `enrichmentData.normalized.occupations` - Ocupações
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os dados de ocupação
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `occupation` | Ocupação | Text/String | Título do cargo/profissão |
| `employer` | Empregador | Text/String | Nome da empresa empregadora |
| `employerTaxId` | CNPJ do Empregador | Text/String | CNPJ da empresa |
| `income` | Renda | Number | Renda mensal |
| `incomeRange` | Faixa de Renda | Text/String | Faixa de renda |
| `currency` | Moeda | Text/String | Código da moeda (BRL, ARS, USD) |
| `isCurrent` | É Atual | Boolean (true/false) | É a ocupação atual? |
| `isPrimary` | É Primário | Boolean (true/false) | É a fonte de renda principal? |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Ocupação confirmada por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.occupations.$.occupation",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.occupationsSummary` - Resumo de Ocupações
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre ocupações profissionais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | ------------------ | -------------------- | ------------------------------------- |
| `totalOccupations` | Total de Ocupações | Number | Número total de ocupações registradas |
| `hasCurrentOccupation` | Tem Ocupação Atual | Boolean (true/false) | Indica se há ocupação atual |
| `currentOccupation` | Ocupação Atual | Text/String | Ocupação profissional atual |
| `currentEmployer` | Empregador Atual | Text/String | Nome do empregador atual |
| `hasIncomeData` | Tem Dados de Renda | Boolean (true/false) | Indica se há dados de renda |
### `enrichmentData.normalized.electoralActivitySummary` - Resumo de Atividade Eleitoral
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre doações eleitorais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------------ | ---------------------- | -------------------- | -------------------------------------- |
| `isCurrentDonor` | Doador Atual | Boolean (true/false) | Atualmente é doador eleitoral |
| `isHistoricalDonor` | Doador Histórico | Boolean (true/false) | Já foi doador eleitoral |
| `totalDonations` | Total de Doações | Number | Número total de doações individuais |
| `totalAmountDonated` | Valor Total Doado | Number | Valor total doado em todas as eleições |
| `totalYearsActive` | Anos Ativos | Number | Número de anos com doações |
| `firstDonationYear` | Primeiro Ano de Doação | Text/String | Ano da primeira doação eleitoral |
| `lastDonationYear` | Último Ano de Doação | Text/String | Ano da última doação eleitoral |
| `mostActiveYear` | Ano Mais Ativo | Text/String | Ano com mais doações |
| `averageAnnualDonations` | Média de Doações/Ano | Number | Média de doações por ano |
| `averageAnnualAmount` | Média de Valor/Ano | Number | Média de valor doado por ano |
| `hasRecentActivity` | Atividade Recente | Boolean (true/false) | Doou nos últimos 3 anos |
### `enrichmentData.normalized.electoralActivity` - Doações Eleitorais por Ano
**Tipo:** Array of objects
**Descrição:** Buscar doações eleitorais específicas por ano
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `year` | Ano | Text/String | Ano da doação eleitoral (ex: "2018") |
| `amountDonated` | Valor Doado | Number | Valor doado neste ano |
| `donationsCount` | Número de Doações | Number | Quantidade de doações neste ano |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Doação confirmada por mais de uma fonte |
| `confidence` | Confiança | Number | Score de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.electoralActivity.$.year",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.taxReturnsSummary` - Resumo de Declarações de IR
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre declarações de imposto de renda
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ------------------------ | -------------------- | -------------------------------------------- |
| `totalReturns` | Total de Declarações | Number | Número total de declarações |
| `uniqueYears` | Anos com Declaração | Number | Número de anos únicos com declarações |
| `confirmedReturns` | Declarações Confirmadas | Number | Declarações confirmadas por múltiplas fontes |
| `hasRecentReturns` | Tem Declarações Recentes | Boolean (true/false) | Possui declarações dos últimos 3 anos |
| `oldestYear` | Ano Mais Antigo | Text/String | Ano da declaração mais antiga |
| `newestYear` | Ano Mais Recente | Text/String | Ano da declaração mais recente |
### `enrichmentData.normalized.taxReturns` - Declarações de Imposto
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as declarações de imposto
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------- | --------------- | -------------------- | ------------------------------------------------- |
| `year` | Ano | Text/String | Ano da declaração (ex: "2022") |
| `status` | Status | Text/String | Status da declaração (ex: "REGULAR", "PENDENTE") |
| `bank` | Banco | Text/String | Banco onde foi feita a declaração |
| `branch` | Agência | Text/String | Agência bancária |
| `isVipBranch` | É Agência VIP | Boolean (true/false) | Indica se é agência VIP |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.taxReturns.$.year",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.relationships` - Relacionamentos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os relacionamentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `relatedEntityName` | Nome da Entidade Relacionada | Text/String | Nome da pessoa ou empresa relacionada |
| `relatedEntityTaxId` | CPF/CNPJ da Entidade | Text/String | Documento da entidade relacionada |
| `relatedEntityType` | Tipo de Entidade | Text/String | Tipo da entidade relacionada |
| `relationshipType` | Tipo de Relacionamento | Text/String | Tipo específico de relacionamento |
| `relationshipLevel` | Nível do Relacionamento | Text/String | Nível de proximidade |
| `startDate` | Data de Início | Text/String | Quando o relacionamento começou |
| `endDate` | Data de Término | Text/String | Quando o relacionamento terminou |
| `isActive` | Ativo | Boolean (true/false) | Relacionamento está ativo |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Relacionamento confirmado por 2+ provedores |
| `confidence` | Confiança | Number | Nível de confiança do relacionamento (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.relationships.$.relatedEntityName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.relationshipsSummary` - Resumo de Relacionamentos
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre relacionamentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | --------------------------------- | -------------------- | --------------------------------------------------------- |
| `totalRelationships` | Total de Relacionamentos | Number | Número total de relacionamentos únicos |
| `uniqueRelationships` | Relacionamentos Únicos | Number | Número de relacionamentos únicos |
| `confirmedRelationships` | Relacionamentos Confirmados | Number | Relacionamentos confirmados por múltiplas fontes |
| `byType.family` | Relacionamentos Familiares | Number | Número de relações familiares (mãe, pai, irmãos, cônjuge) |
| `byType.business` | Relacionamentos Comerciais | Number | Número de relações comerciais (sócios, parceiros) |
| `byType.social` | Relacionamentos Sociais | Number | Número de relações sociais (vizinhos, colegas) |
| `byType.other` | Outros Relacionamentos | Number | Outros tipos de relacionamentos |
| `byLevel.direct` | Relacionamentos Diretos | Number | Número de relações diretas |
| `byLevel.indirect` | Relacionamentos Indiretos | Number | Número de relações indiretas |
| `hasFamilyRelationships` | Possui Relacionamentos Familiares | Boolean (true/false) | Indica se há relações familiares |
| `hasBusinessRelationships` | Possui Relacionamentos Comerciais | Boolean (true/false) | Indica se há relações comerciais |
| `mostCommonRelationshipType` | Tipo de Relacionamento Mais Comum | Text/String | Tipo de relacionamento mais frequente |
### `enrichmentData.normalized.aliases` - Nomes Alternativos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os nomes alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ----------------------------------- |
| `name` | Nome | Text/String | Nome do alias |
| `originalName` | Nome Original | Text/String | Nome como aparece na fonte |
| `type` | Tipo de Alias | Text/String | Classificação do alias |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Alias confirmado por 2+ provedores |
| `usageFrequency` | Frequência de Uso | Number | Quantas vezes aparece nas fontes |
| `confidence` | Confiança | Number | Nível de confiança do alias (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.aliases.$.name",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.biometricResult` - Resultado Biométrico
**Tipo:** Object
**Descrição:** Resultados de face match e liveness (KYC provider)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------ | -------------------- | ----------------------------------------------------- |
| `faceMatchScore` | Score Face Match | Number | Score de correspondência facial (0-1, onde 0.8 = 80%) |
| `livenessScore` | Score Liveness | Number | Score de detecção de vida (0-1) |
| `passed` | Biometria Aprovada | Boolean (true/false) | Validação biométrica geral aprovada |
### `kyc.documentsVerified` - Documentos Verificados
**Tipo:** Array of objects
**Descrição:** Lista de documentos verificados no KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ------------------- | ---------------------- | --------------------------------------- |
| `type` | Tipo de Documento | Text/String | Tipo do documento apresentado |
| `verified` | Verificado | Boolean (true/false) | Documento foi verificado com sucesso |
| `verifiedAt` | Data de Verificação | Date (ISO 8601 format) | Data e hora da verificação do documento |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "kyc.documentsVerified.$.type",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.riskAssessment` - Avaliação de Risco KYC
**Tipo:** Object
**Descrição:** Avaliação de risco realizada pelo KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------- | -------------- | ----------- | ------------------------------- |
| `riskLevel` | Nível de Risco | Text/String | Classificação do nível de risco |
| `riskScore` | Score de Risco | Number | Score numérico de risco (0-100) |
### `kyc.extractedData` - Dados Extraídos do Documento
**Tipo:** Object
**Descrição:** Dados extraídos do documento de identidade
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------- | ---------------------- | ---------------------------------------- |
| `firstName` | Nome | Text/String | Primeiro nome extraído |
| `lastName` | Sobrenome | Text/String | Sobrenome extraído |
| `fullName` | Nome Completo | Text/String | Nome completo extraído |
| `dateOfBirth` | Data de Nascimento | Date (ISO 8601 format) | Data de nascimento extraída do documento |
| `documentNumber` | Número do Documento | Text/String | Número do documento extraído |
| `documentType` | Tipo do Documento | Text/String | Tipo do documento identificado |
| `nationality` | Nacionalidade | Text/String | Nacionalidade extraída |
### `enrichmentData.normalized.documents` - Documentos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------- | -------------------- | ------------------------------------- |
| `value` | Número | Text/String | Número del documento (ej: "33660120") |
| `type` | Tipo | Text/String | Tipo de documento |
| `classification` | Clasificación | Text/String | Clasificación del documento |
| `active` | Activo | Boolean (true/false) | Documento está activo |
| `isExpired` | Expirado | Boolean (true/false) | Documento está expirado |
| `issuingCountry` | País Emisor | Text/String | Código ISO del país (ej: "AR", "US") |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.documents.$.value",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.riskFlags` - Banderas de Riesgo
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las banderas de riesgo
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------------------------ |
| `flagType` | Tipo de Bandera | Text/String | Tipo de bandera de riesgo |
| `isActive` | Está Activo | Boolean (true/false) | Indica si la bandera de riesgo está actualmente activa |
| `details.severity` | Severidad | Text/String | Nivel de severidad del riesgo |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (solo para PEP) |
| `details.pepCountry` | País PEP | Text/String | País del cargo político |
| `details.pepLevel` | Nivel PEP | Text/String | Nivel del PEP (nacional, internacional, local) |
| `details.description` | Descripción | Text/String | Descripción detallada de la bandera |
| `details.riskScore` | Score de Riesgo | Number | Score de riesgo (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Bandera confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.demographics` - Demografía
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los datos demográficos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------------------------- |
| `dateOfBirth` | Fecha de Nacimiento | Text/String | Fecha de nacimiento (ISO format) |
| `age` | Edad | Number | Edad calculada |
| `gender` | Género | Text/String | Género de la persona |
| `nationality` | Nacionalidad | Text/String | País de nacionalidad |
| `maritalStatus` | Estado Civil | Text/String | Estado civil |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Dato confirmado por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.demographics.$.dateOfBirth",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.occupations` - Ocupaciones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los datos de ocupación
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------------------------- |
| `occupation` | Ocupación | Text/String | Título del cargo/profesión |
| `employer` | Empleador | Text/String | Nombre de la empresa empleadora |
| `employerTaxId` | CUIT del Empleador | Text/String | CUIT de la empresa |
| `income` | Ingreso | Number | Ingreso mensual |
| `incomeRange` | Rango de Ingreso | Text/String | Rango de ingreso |
| `currency` | Moneda | Text/String | Código de la moneda (BRL, ARS, USD) |
| `isCurrent` | Es Actual | Boolean (true/false) | Es la ocupación actual? |
| `isPrimary` | Es Primario | Boolean (true/false) | Es la fuente de ingreso principal? |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Ocupación confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.occupations.$.occupation",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.addresses` - Direcciones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las direcciones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------------------------- |
| `street` | Calle | Text/String | Nombre de la calle y número |
| `city` | Ciudad | Text/String | Ciudad |
| `state` | Provincia | Text/String | Provincia/Estado |
| `postalCode` | Código Postal | Text/String | Código postal |
| `country` | País | Text/String | País (código ISO) |
| `type` | Tipo | Text/String | Tipo de dirección |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Dirección confirmada por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.addresses.$.street",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.aliases` - Alias/Nombres Alternativos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los nombres alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------- |
| `alias` | Alias | Text/String | Nombre alternativo |
| `type` | Tipo | Text/String | Tipo de alias |
| `isCurrent` | Es Actual | Boolean (true/false) | Indica si es el nombre actual |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Alias confirmado por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Proveedores que reportaron este alias |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.aliases.$.alias",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.aliasesSummary` - Resumen de Aliases
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre nombres alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ----------------------- | -------------------- | ------------------------------------ |
| `totalAliases` | Total de Aliases | Number | Número total de nombres alternativos |
| `uniqueAliases` | Aliases Únicos | Number | Número de aliases únicos |
| `confirmedAliases` | Aliases Confirmados | Number | Aliases confirmados por 2+ fuentes |
| `hasMultipleNames` | Posee Múltiples Nombres | Boolean (true/false) | Indica si posee más de un alias |
### `enrichmentData.normalized.emails` - Emails
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los emails
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------------------------- |
| `email` | Email | Text/String | Dirección de email |
| `type` | Tipo | Text/String | Tipo de email |
| `isValidated` | Validado | Boolean (true/false) | Email ha sido validado |
| `isCorporate` | Es Corporativo | Boolean (true/false) | Es email corporativo |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Email confirmado por 2+ proveedores |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.emails.$.email",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.phones` - Teléfonos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los teléfonos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------------------------- |
| `number` | Número | Text/String | Número de teléfono |
| `type` | Tipo | Text/String | Tipo de teléfono |
| `countryCode` | Código de País | Text/String | Código de país (ej: "+54") |
| `areaCode` | Código de Área | Text/String | Código de área |
| `isActive` | Activo | Boolean (true/false) | Teléfono está activo |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Teléfono confirmado por 2+ proveedores |
| `currentCarrier` | Operadora Actual | Text/String | Operadora telefónica |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.phones.$.number",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctions` - Sanciones Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las sanciones consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ----------------------------------------------------------------------- |
| `listName` | Nombre de la Lista | Text/String | Nombre formateado de la lista (ej: "OFAC SDN", "UN Sanctions", "RePET") |
| `type` | Tipo de Sanción | Text/String | Categoría de la sanción para agrupamiento y filtros |
| `sources` | Fuentes | Text/String | Filtrar por proveedores específicos que reportaron |
| `nationality` | Nacionalidad | Text/String | Nacionalidad de la persona sancionada |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Sanción confirmada por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `addedDate` | Fecha de Adición | Text/String | Fecha en que fue añadido a la lista |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.listName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctionsSummary` - Resumen de Sanciones
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre listas de sanciones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------- | ---------------------------- | ------ | ---------------------------------------------------------- |
| `totalLists` | Total de Listas de Sanciones | Number | Número total de listas de sanciones |
| `uniqueLists` | Listas Únicas | Number | Número de listas únicas (deduplicadas) |
| `confirmedSanctions` | Sanciones Confirmadas | Number | Sanciones confirmadas por 2+ fuentes |
| `highestConfidence` | Mayor Confianza | Number | Mayor nivel de confianza entre todas las sanciones (0-100) |
### `enrichmentData.normalized.legalProceedings` - Procesos Judiciales
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los procesos judiciales
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ---------------- | ----------- | -------------------------------------------------- |
| `caseNumber` | Número de Caso | Text/String | Número de expediente |
| `type` | Tipo | Text/String | Tipo de proceso |
| `status` | Estado | Text/String | Estado del proceso |
| `court` | Tribunal/Juzgado | Text/String | Tribunal o juzgado |
| `filingDate` | Fecha de Inicio | Text/String | Fecha de inicio del proceso |
| `amount` | Monto | Number | Monto involucrado |
| `sources` | Fuentes de Datos | Text/String | Filtrar por proveedores específicos que reportaron |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.legalProceedings.$.caseNumber",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.biometricResult` - Resultado Biométrico
**Tipo:** Object
**Descrição:** Resultados de face match e liveness (KYC provider)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------ | -------------------- | ----------------------------------------------------- |
| `faceMatchScore` | Score Face Match | Number | Score de correspondência facial (0-1, onde 0.8 = 80%) |
| `livenessScore` | Score Liveness | Number | Score de detecção de vida (0-1) |
| `passed` | Biometria Aprovada | Boolean (true/false) | Validação biométrica geral aprovada |
### `kyc.documentsVerified` - Documentos Verificados
**Tipo:** Array of objects
**Descrição:** Lista de documentos verificados no KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ------------------- | ---------------------- | --------------------------------------- |
| `type` | Tipo de Documento | Text/String | Tipo do documento apresentado |
| `verified` | Verificado | Boolean (true/false) | Documento foi verificado com sucesso |
| `verifiedAt` | Data de Verificação | Date (ISO 8601 format) | Data e hora da verificação do documento |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "kyc.documentsVerified.$.type",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.riskAssessment` - Avaliação de Risco KYC
**Tipo:** Object
**Descrição:** Avaliação de risco realizada pelo KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------- | -------------- | ----------- | ------------------------------- |
| `riskLevel` | Nível de Risco | Text/String | Classificação do nível de risco |
| `riskScore` | Score de Risco | Number | Score numérico de risco (0-100) |
### `kyc.extractedData` - Dados Extraídos do Documento
**Tipo:** Object
**Descrição:** Dados extraídos do documento de identidade
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------- | ---------------------- | ---------------------------------------- |
| `firstName` | Nome | Text/String | Primeiro nome extraído |
| `lastName` | Sobrenome | Text/String | Sobrenome extraído |
| `fullName` | Nome Completo | Text/String | Nome completo extraído |
| `dateOfBirth` | Data de Nascimento | Date (ISO 8601 format) | Data de nascimento extraída do documento |
| `documentNumber` | Número do Documento | Text/String | Número do documento extraído |
| `documentType` | Tipo do Documento | Text/String | Tipo do documento identificado |
| `nationality` | Nacionalidade | Text/String | Nacionalidade extraída |
### `enrichmentData.normalized.riskFlags` - Banderas de Riesgo
**Tipo:** Array of objects
**Descrição:** Banderas de riesgo consolidadas (PEP, Sanciones). Solo se consolidan automáticamente si hay 1 hit relevante.
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------------------------ |
| `flagType` | Tipo de Bandera | Text/String | Tipo de bandera de riesgo |
| `isActive` | Está Activo | Boolean (true/false) | Indica si la bandera de riesgo está actualmente activa |
| `details.severity` | Severidad | Text/String | Nivel de severidad del riesgo |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (solo para PEP) |
| `details.pepCountry` | País PEP | Text/String | País del cargo político |
| `details.pepLevel` | Nivel PEP | Text/String | Nivel del PEP (nacional, internacional, local) |
| `details.sanctionLists` | Listas de Sanciones | Array of objects | Listas de sanciones donde aparece |
| `details.description` | Descripción | Text/String | Descripción detallada de la bandera |
| `details.riskScore` | Score de Riesgo | Number | Score de riesgo (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Bandera confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctions` - Sanciones
**Tipo:** Array of objects
**Descrição:** Listas de sanciones donde aparece la persona
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------------------- |
| `sanctionType` | Tipo de Sanción | Text/String | Tipo de sanción (ej: sanction-list, warning-list) |
| `listName` | Nombre de Lista | Text/String | Nombre formateado de la lista de sanciones |
| `program` | Programa | Text/String | Programa de sanciones (ej: OFAC, UN, EU) |
| `issuer` | Emisor | Text/String | Organización emisora de la sanción |
| `country` | País | Text/String | País relacionado con la sanción |
| `isCriticalList` | Es Lista Crítica | Boolean (true/false) | Sanción de lista crítica (OFAC, UN, etc.) |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Sanción confirmada por 2+ hits |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.sanctionType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.mediaMentions` - Menciones en Medios
**Tipo:** Array of objects
**Descrição:** Menciones en medios adversos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------ |
| `title` | Título | Text/String | Título de la noticia |
| `snippet` | Extracto | Text/String | Extracto de la noticia |
| `date` | Fecha | Text/String | Fecha de publicación |
| `url` | URL | Text/String | Enlace a la noticia |
| `category` | Categoría | Text/String | Categoría de la mención |
| `sentiment` | Sentimiento | Text/String | Sentimiento de la mención |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Mención confirmada por 2+ hits |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.mediaMentions.$.title",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.demographics` - Demografía
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los datos demográficos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | -------------------------------- |
| `dateOfBirth` | Fecha de Nacimiento | Text/String | Fecha de nacimiento (ISO format) |
| `age` | Edad | Number | Edad calculada |
| `gender` | Género | Text/String | Género de la persona |
| `nationality` | Nacionalidad | Text/String | País de nacionalidad |
| `maritalStatus` | Estado Civil | Text/String | Estado civil |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Dato confirmado por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.demographics.$.dateOfBirth",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.occupations` - Ocupaciones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los datos de ocupación
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ----------------------------------- |
| `occupation` | Ocupación | Text/String | Título del cargo/profesión |
| `employer` | Empleador | Text/String | Nombre de la empresa empleadora |
| `employerTaxId` | Tax ID del Empleador | Text/String | Tax ID de la empresa |
| `income` | Ingreso | Number | Ingreso mensual |
| `incomeRange` | Rango de Ingreso | Text/String | Rango de ingreso |
| `currency` | Moneda | Text/String | Código de la moneda (BRL, ARS, USD) |
| `isCurrent` | Es Actual | Boolean (true/false) | Es la ocupación actual? |
| `isPrimary` | Es Primario | Boolean (true/false) | Es la fuente de ingreso principal? |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Ocupación confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.occupations.$.occupation",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.biometricResult` - Resultado Biométrico
**Tipo:** Object
**Descrição:** Resultados de face match e liveness (KYC provider)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------ | -------------------- | ----------------------------------------------------- |
| `faceMatchScore` | Score Face Match | Number | Score de correspondência facial (0-1, onde 0.8 = 80%) |
| `livenessScore` | Score Liveness | Number | Score de detecção de vida (0-1) |
| `passed` | Biometria Aprovada | Boolean (true/false) | Validação biométrica geral aprovada |
### `kyc.documentsVerified` - Documentos Verificados
**Tipo:** Array of objects
**Descrição:** Lista de documentos verificados no KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ------------------- | ---------------------- | --------------------------------------- |
| `type` | Tipo de Documento | Text/String | Tipo do documento apresentado |
| `verified` | Verificado | Boolean (true/false) | Documento foi verificado com sucesso |
| `verifiedAt` | Data de Verificação | Date (ISO 8601 format) | Data e hora da verificação do documento |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "kyc.documentsVerified.$.type",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.riskAssessment` - Avaliação de Risco KYC
**Tipo:** Object
**Descrição:** Avaliação de risco realizada pelo KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------- | -------------- | ----------- | ------------------------------- |
| `riskLevel` | Nível de Risco | Text/String | Classificação do nível de risco |
| `riskScore` | Score de Risco | Number | Score numérico de risco (0-100) |
### `kyc.extractedData` - Dados Extraídos do Documento
**Tipo:** Object
**Descrição:** Dados extraídos do documento de identidade
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------- | ---------------------- | ---------------------------------------- |
| `firstName` | Nome | Text/String | Primeiro nome extraído |
| `lastName` | Sobrenome | Text/String | Sobrenome extraído |
| `fullName` | Nome Completo | Text/String | Nome completo extraído |
| `dateOfBirth` | Data de Nascimento | Date (ISO 8601 format) | Data de nascimento extraída do documento |
| `documentNumber` | Número do Documento | Text/String | Número do documento extraído |
| `documentType` | Tipo do Documento | Text/String | Tipo do documento identificado |
| `nationality` | Nacionalidade | Text/String | Nacionalidade extraída |
***
## Campos de Empresa
Campos disponibles para evaluar entidades de empresa (negocios).
### BR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| --------------------------------------------------------- | --------------------------------------- | ----------------------------------- | ----------------- | -------------------------------------------------------------------------------------- |
| `taxId` | CNPJ | Text/String | Basic Information | Cadastro Nacional da Pessoa Jurídica |
| `name` | Nome | Text/String | Basic Information | |
| `status` | Status | Text/String | Basic Information | |
| `entityData.company.legalName` | Razão Social | Text/String | Basic Information | |
| `entityData.company.tradeName` | Nome Fantasia | Text/String | Basic Information | |
| `entityData.company.incorporationDate` | Data de Constituição | Date (ISO 8601 format) | Basic Information | |
| `entityData.company.industry` | Setor | Text/String | Basic Information | |
| `entityData.company.revenue` | Receita | Number | Basic Information | |
| `entityData.company.employeeCount` | Número de Funcionários | Number | Basic Information | |
| `entityData.company.contactInfo.email` | E-mail | Text/String | Basic Information | |
| `entityData.company.contactInfo.phone` | Telefone | Text/String | Basic Information | |
| `entityData.company.websiteUrl` | Website | Text/String | Basic Information | |
| `entityData.company.companySubtype` | Subtipo de Empresa | Text/String | Basic Information | |
| `entityData.company.revenueCurrency` | Moeda da Receita | Text/String | Basic Information | |
| `entityData.company.contactInfo.alternativePhone` | Telefone Alternativo | Text/String | Basic Information | |
| `entityData.company.address` | Endereço | Text/String | Basic Information | |
| `entityData.company.city` | Cidade | Text/String | Basic Information | |
| `entityData.company.state` | Estado | Text/String | Basic Information | |
| `entityData.company.country` | País | Text/String | Basic Information | |
| `entityData.company.postalCode` | CEP | Text/String | Basic Information | Código de Endereçamento Postal |
| `enrichmentData.normalized.postalCode` | CEP | Text/String | Enrichment Data | |
| `enrichmentData.normalized.status` | Status da API | Number | Enrichment Data | Status da resposta da API (1 = sucesso, -1 = erro) |
| `enrichmentData.normalized.situation` | Situação Cadastral | Text/String | Enrichment Data | Situação cadastral (ATIVA, SUSPENSA, BAIXADA, etc.) |
| `enrichmentData.normalized.situationDate` | Data da Situação Cadastral | Date (ISO 8601 format) | Enrichment Data | Data em que a situação cadastral foi registrada |
| `enrichmentData.normalized.inicioAtividade` | Data de Início de Atividade | Date (ISO 8601 format) | Enrichment Data | Data de início das atividades da empresa |
| `enrichmentData.normalized.legalName` | Razão Social | Text/String | Enrichment Data | Razão social consolidada de múltiplas fontes |
| `enrichmentData.normalized.tradeName` | Nome Fantasia | Text/String | Enrichment Data | Nome comercial consolidado |
| `enrichmentData.normalized.taxId` | CNPJ | Text/String | Enrichment Data | CNPJ consolidado de múltiplas fontes |
| `enrichmentData.normalized.registrationNumber` | Número de Registro | Text/String | Enrichment Data | Número de registro da empresa |
| `enrichmentData.normalized.registrationCountry` | País de Registro | Text/String | Enrichment Data | País onde a empresa está registrada |
| `enrichmentData.normalized.country` | País | Text/String | Enrichment Data | Código do país |
| `enrichmentData.normalized.incorporationDate` | Data de Constituição | Date (ISO 8601 format) | Enrichment Data | Data de constituição da empresa |
| `enrichmentData.normalized.registrationUptimeMonths` | Tempo de Registro (Meses) | Number | Enrichment Data | Número de meses desde a data de constituição |
| `enrichmentData.normalized.isMEI` | É MEI | Boolean (true/false) | Enrichment Data | Indica se é Microempresário Individual |
| `enrichmentData.normalized.isSimples` | Simples Nacional | Boolean (true/false) | Enrichment Data | Indica se é optante pelo Simples Nacional |
| `enrichmentData.normalized.legalForm` | Natureza Jurídica | Text/String | Enrichment Data | Natureza jurídica da empresa (ex: Sociedade Empresária Limitada, MEI, SA) |
| `enrichmentData.normalized.size` | Porte da Empresa | Text/String | Enrichment Data | Porte da empresa segundo Receita Federal |
| `enrichmentData.normalized.revenue` | Capital Social | Number | Enrichment Data | Capital social da empresa |
| `enrichmentData.normalized.employeeCount` | Número de Funcionários | Number | Enrichment Data | Quantidade de funcionários consolidada |
| `enrichmentData.normalized.website` | Website | Text/String | Enrichment Data | URL do website da empresa |
| `enrichmentData.normalized.industry` | Indústria | Text/String | Enrichment Data | Setor de atuação |
| `enrichmentData.normalized.sanctioned` | Sancionado | Boolean (true/false) | Enrichment Data | Indica se está em lista de sanções |
| `enrichmentData.normalized.criminalRecords` | Antecedentes Criminais | Boolean (true/false) | Enrichment Data | Possui antecedentes criminais |
| `enrichmentData.normalized.adverseMedia` | Mídia Adversa | Boolean (true/false) | Enrichment Data | Possui menções negativas na mídia |
| `enrichmentData.normalized.hasESGViolations` | Violações ESG | Boolean (true/false) | Enrichment Data | Possui violações ambientais/sociais/governança |
| `enrichmentData.normalized.esgScore` | Score ESG | Number | Enrichment Data | Pontuação ESG (0-100) |
| `enrichmentData.normalized.documents` | Documentos | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os documentos |
| `enrichmentData.normalized.documentsSummary` | Resumo de Documentos | Nested object (2 nested fields) | Enrichment Data | Campos agregados sobre documentos |
| `enrichmentData.normalized.aliases` | Nomes Alternativos | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os nomes alternativos |
| `enrichmentData.normalized.aliasesSummary` | Resumo de Aliases | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre nomes alternativos |
| `enrichmentData.normalized.cnaes` | CNAEs (Atividades Econômicas) | Array of objects (7 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as atividades econômicas |
| `enrichmentData.normalized.cnaesSummary` | Resumo de CNAEs | Nested object (6 nested fields) | Enrichment Data | Estatísticas agregadas sobre atividades econômicas |
| `enrichmentData.normalized.addresses` | Endereços | Array of objects (15 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os endereços |
| `enrichmentData.normalized.addressesSummary` | Resumo de Endereços | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre endereços |
| `enrichmentData.normalized.emails` | E-mails | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os e-mails |
| `enrichmentData.normalized.emailsSummary` | Resumo de E-mails | Nested object (8 nested fields) | Enrichment Data | Estatísticas agregadas sobre e-mails |
| `enrichmentData.normalized.phones` | Telefones | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os telefones |
| `enrichmentData.normalized.phonesSummary` | Resumo de Telefones | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre telefones |
| `enrichmentData.normalized.legalProceedings` | Processos Judiciais | Array of objects (27 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os processos judiciais |
| `enrichmentData.normalized.legalProceedingsSummary` | Resumo de Processos Judiciais | Nested object (29 nested fields) | Enrichment Data | Estatísticas agregadas sobre processos judiciais |
| `enrichmentData.normalized.riskFlags` | Bandeiras de Risco | Array of objects (11 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as bandeiras de risco |
| `enrichmentData.normalized.riskFlagsSummary` | Resumo de Bandeiras de Risco | Nested object (14 nested fields) | Enrichment Data | Estatísticas agregadas sobre bandeiras de risco |
| `enrichmentData.normalized.sanctionLists` | Listas de Sanções | Array of objects | Enrichment Data | |
| `enrichmentData.normalized.sanctionsSummary` | Resumo de Sanções | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre listas de sanções |
| `enrichmentData.normalized.adverseMediaScore` | Score de Mídia Adversa | Number | Enrichment Data | |
| `enrichmentData.normalized.esgPositiveNewsCount` | Notícias Positivas (ESG) | Number | Enrichment Data | |
| `enrichmentData.normalized.esgNegativeNewsCount` | Notícias Negativas (ESG) | Number | Enrichment Data | |
| `enrichmentData.normalized.pepRelated` | Relacionado a PEP | Boolean (true/false) | Enrichment Data | Sócios ou diretores são PEPs |
| `enrichmentData.normalized.revenue` | Receita (Enriquecida) | Number | Enrichment Data | |
| `enrichmentData.normalized.confidence` | Confiança dos Dados | Number | Enrichment Data | |
| `enrichmentData.normalized.completeness` | Completude dos Dados | Number | Enrichment Data | |
| `enrichmentData.normalized.totalElectoralDonationAmount` | Valor Total de Doações Eleitorais | Number | Enrichment Data | |
| `enrichmentData.normalized.isPep` | É PEP | Boolean (true/false) | Enrichment Data | É ou foi Pessoa Exposta Politicamente |
| `enrichmentData.normalized.isCurrentPep` | PEP Ativo | Boolean (true/false) | Enrichment Data | É atualmente Pessoa Exposta Politicamente |
| `enrichmentData.normalized.pepLevels` | Níveis de PEP | Array of objects | Enrichment Data | Níveis de classificação PEP históricos |
| `enrichmentData.normalized.lastYearPEPOccurence` | Ocorrências PEP (Último Ano) | Number | Enrichment Data | Quantidade de ocorrências PEP no último ano |
| `enrichmentData.normalized.last3YearsPEPOccurence` | Ocorrências PEP (Últimos 3 Anos) | Number | Enrichment Data | Quantidade de ocorrências PEP nos últimos 3 anos |
| `enrichmentData.normalized.last5YearsPEPOccurence` | Ocorrências PEP (Últimos 5 Anos) | Number | Enrichment Data | Quantidade de ocorrências PEP nos últimos 5 anos |
| `enrichmentData.normalized.totalElectoralDonations` | Número de Doações Eleitorais | Number | Enrichment Data | Quantidade total de doações eleitorais |
| `enrichmentData.normalized.isCurrentlyElectoralDonor` | É Doador Eleitoral Ativo | Boolean (true/false) | Enrichment Data | Atualmente é doador eleitoral |
| `enrichmentData.normalized.isHistoricalElectoralDonor` | Foi Doador Eleitoral | Boolean (true/false) | Enrichment Data | Já foi doador eleitoral no passado |
| `enrichmentData.normalized.activityLevel` | Nível de Atividade | Number | Enrichment Data | Score de atividade da empresa (BDC) |
| `enrichmentData.normalized.numberOfBranches` | Número de Filiais | Number | Enrichment Data | Total de filiais/locais |
| `enrichmentData.normalized.hasActivity` | Tem Atividade Recente | Boolean (true/false) | Enrichment Data | Indica atividade comercial recente |
| `enrichmentData.normalized.incomeRange` | Faixa de Receita | Text/String | Enrichment Data | Faixa de receita estimada (ex: "ACIMA DE 500MM") |
| `enrichmentData.normalized.employeesRange` | Faixa de Funcionários | Text/String | Enrichment Data | Faixa de número de funcionários (ex: ">= 500") |
| `enrichmentData.normalized.hasActiveDomain` | Tem Domínio Ativo | Boolean (true/false) | Enrichment Data | Possui domínio de internet ativo |
| `enrichmentData.normalized.hasActiveSSL` | Tem Certificado SSL | Boolean (true/false) | Enrichment Data | Possui certificado SSL ativo |
| `enrichmentData.normalized.hasCorporateEmail` | Tem E-mail Corporativo | Boolean (true/false) | Enrichment Data | Possui e-mail corporativo |
| `enrichmentData.normalized.hasRecentAddress` | Tem Endereço Recente | Boolean (true/false) | Enrichment Data | Endereço atualizado recentemente |
| `enrichmentData.normalized.hasRecentEmail` | Tem E-mail Recente | Boolean (true/false) | Enrichment Data | E-mail atualizado recentemente |
| `enrichmentData.normalized.hasRecentPhone` | Tem Telefone Recente | Boolean (true/false) | Enrichment Data | Telefone atualizado recentemente |
| `enrichmentData.normalized.parentCompany` | Empresa Controladora | Text/String | Enrichment Data | Nome da empresa controladora (acionista majoritário corporativo) |
| `enrichmentData.normalized.shareholdersSummary` | Resumo de Sócios/Acionistas | Nested object (16 nested fields) | Enrichment Data | Estatísticas agregadas sobre estrutura societária |
| `enrichmentData.normalized.shareholders` | Sócios/Acionistas Consolidados | Array of objects (14 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos os sócios consolidados (QSA + outras fontes) |
| `enrichmentData.normalized.totalReviews` | Total de Avaliações | Number | Enrichment Data | Número total de avaliações/reclamações |
| `enrichmentData.normalized.averageRating` | Avaliação Média | Number | Enrichment Data | Score médio de avaliações (0-5) |
| `enrichmentData.normalized.positiveReviewsPercentage` | Avaliações Positivas (%) | Number | Enrichment Data | Percentual de avaliações positivas |
| `enrichmentData.normalized.negativeReviewsPercentage` | Avaliações Negativas (%) | Number | Enrichment Data | Percentual de avaliações negativas |
| `enrichmentData.normalized.hasSignificantNegativeReviews` | Tem Avaliações Negativas Significativas | Boolean (true/false) | Enrichment Data | Alto volume de avaliações negativas |
| `enrichmentData.normalized.shellCompanyLikelihood` | Probabilidade de Empresa Fantasma | Number | Enrichment Data | Score de risco de empresa fantasma (0-100) |
| `enrichmentData.normalized.violations` | Violações Consolidadas | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes) |
| `enrichmentData.normalized.violationsSummary` | Resumo de Violações | Nested object (7 nested fields) | Enrichment Data | Estatísticas agregadas sobre violações |
| `enrichmentData.normalized.mediaMentions` | Menções em Mídia | Array of objects (13 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as menções em mídia consolidadas |
| `enrichmentData.normalized.mediaSummary` | Resumo de Mídia | Nested object (12 nested fields) | Enrichment Data | Estatísticas agregadas sobre menções na mídia |
| `enrichmentData.normalized.sanctions` | Sanções Consolidadas | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas as sanções consolidadas |
### AR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| -------------------------------------------------------------------- | --------------------------------- | ----------------------------------- | ----------------- | ------------------------------------------------------------------------------ |
| `taxId` | CUIT | Text/String | Basic Information | Código Único de Identificación Tributaria |
| `name` | Nombre | Text/String | Basic Information | |
| `entityData.company.legalName` | Razón Social | Text/String | Basic Information | |
| `entityData.company.tradeName` | Nombre de Fantasía | Text/String | Basic Information | |
| `entityData.company.incorporationDate` | Fecha de Constitución | Date (ISO 8601 format) | Basic Information | |
| `entityData.company.industry` | Industria | Text/String | Basic Information | |
| `entityData.company.revenue` | Ingresos | Number | Basic Information | |
| `entityData.company.employeeCount` | Número de Empleados | Number | Basic Information | |
| `entityData.company.contactInfo.email` | Email | Text/String | Basic Information | |
| `entityData.company.contactInfo.phone` | Teléfono | Text/String | Basic Information | |
| `entityData.company.contactInfo.alternativePhone` | Teléfono Alternativo | Text/String | Basic Information | |
| `entityData.company.websiteUrl` | Sitio Web | Text/String | Basic Information | |
| `entityData.company.companySubtype` | Subtipo de Empresa | Text/String | Basic Information | |
| `entityData.company.revenueCurrency` | Moneda de Ingresos | Text/String | Basic Information | |
| `entityData.company.address` | Dirección | Text/String | Basic Information | |
| `entityData.company.city` | Ciudad | Text/String | Basic Information | |
| `entityData.company.state` | Provincia | Text/String | Basic Information | |
| `entityData.company.country` | País | Text/String | Basic Information | |
| `entityData.company.postalCode` | Código Postal | Text/String | Basic Information | |
| `status` | Estado | Text/String | Basic Information | |
| `enrichmentData.normalized.taxId` | CUIT | Text/String | Enrichment Data | CUIT consolidado de múltiples fuentes |
| `enrichmentData.normalized.legalName` | Razón Social | Text/String | Enrichment Data | Razón social consolidada de múltiples fuentes |
| `enrichmentData.normalized.fullName` | Nombre Completo | Text/String | Enrichment Data | Nombre completo consolidado |
| `enrichmentData.normalized.incorporationDate` | Fecha de Constitución | Date (ISO 8601 format) | Enrichment Data | Fecha de constitución de la empresa |
| `enrichmentData.normalized.legalProceedings` | Procesos Judiciales | Array of objects | Enrichment Data | |
| `enrichmentData.normalized.legalProceedingsSummary.totalProceedings` | Total de Procesos | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlags` | Banderas de Riesgo | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las banderas de riesgo |
| `enrichmentData.normalized.riskFlagsSummary.totalFlags` | Total de Banderas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.activeFlags` | Banderas Activas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasPepFlags` | Tiene Banderas PEP | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasSanctionFlags` | Tiene Banderas de Sanción | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.sanctioned` | Sancionado | Boolean (true/false) | Enrichment Data | Empresa aparece en listas de sanciones (RePET Argentina) |
| `enrichmentData.normalized.sanctions` | Sanciones Consolidadas | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las sanciones consolidadas |
| `enrichmentData.normalized.sanctionsSummary` | Resumen de Sanciones | Nested object (4 nested fields) | Enrichment Data | Estadísticas agregadas sobre listas de sanciones |
| `enrichmentData.normalized.totalDebt` | Deuda Total | Number | Enrichment Data | Deuda total reportada en BCRA |
| `enrichmentData.normalized.debtorStatus` | Estado Deudor | Text/String | Enrichment Data | Estado del deudor según BCRA |
| `enrichmentData.normalized.worstCreditSituation` | Peor Situación Crediticia | Number | Enrichment Data | Peor situación crediticia registrada (0-6) |
| `enrichmentData.normalized.totalCurrentDebt` | Deuda Actual Total | Number | Enrichment Data | Deuda total del período más reciente (BCRA Historicas) |
| `enrichmentData.normalized.averageMonthlyDebt` | Deuda Promedio Mensual | Number | Enrichment Data | Promedio de deuda mensual en los últimos 24 meses |
| `enrichmentData.normalized.totalHistoricalDebt` | Deuda Histórica Total | Number | Enrichment Data | Suma total de deuda en los últimos 24 meses |
| `enrichmentData.normalized.worstHistoricalSituation` | Peor Situación Histórica | Text/String | Enrichment Data | Peor estado crediticio en los últimos 24 meses (NORMAL, EN\_OBSERVACION, etc.) |
| `enrichmentData.normalized.totalFinancialEntities` | Total Entidades Financieras | Number | Enrichment Data | Número de entidades financieras con las que tiene deuda |
| `enrichmentData.normalized.hasActiveRevisions` | Tiene Revisiones Activas | Boolean (true/false) | Enrichment Data | Indica si tiene deudas en revisión actualmente |
| `enrichmentData.normalized.hasActiveLegalProcesses` | Tiene Procesos Judiciales Activos | Boolean (true/false) | Enrichment Data | Indica si tiene procesos judiciales activos por deudas |
| `enrichmentData.normalized.periodsAnalyzed` | Períodos Analizados | Number | Enrichment Data | Cantidad de períodos mensuales analizados en BCRA Historicas |
| `enrichmentData.normalized.isIvaRegistered` | Registrado en IVA | Boolean (true/false) | Enrichment Data | Inscripto en régimen de IVA |
| `enrichmentData.normalized.isIncomeTaxRegistered` | Registrado en Ganancias | Boolean (true/false) | Enrichment Data | Inscripto en Impuesto a las Ganancias |
| `enrichmentData.normalized.isAMLObligatedSubject` | Sujeto Obligado AML | Boolean (true/false) | Enrichment Data | Es sujeto obligado por UIF (Prevención de Lavado de Activos) |
| `enrichmentData.normalized.afipSeniority` | Antigüedad AFIP (años) | Number | Enrichment Data | Años de antigüedad en AFIP |
| `enrichmentData.normalized.afipRegistrationDate` | Fecha Registro AFIP | Date (ISO 8601 format) | Enrichment Data | Fecha de alta en AFIP |
| `enrichmentData.normalized.companyAge` | Antigüedad Empresa (años) | Number | Enrichment Data | Antigüedad de la empresa en años |
| `enrichmentData.normalized.legalForm` | Forma Legal | Text/String | Enrichment Data | Tipo societario (SA, SRL, etc.) |
| `enrichmentData.normalized.isEmployer` | Es Empleador | Boolean (true/false) | Enrichment Data | Figura como empleador |
| `enrichmentData.normalized.laftHomonymsCount` | Cantidad de Homónimos LAFT | Number | Enrichment Data | Cantidad de homónimos en registro de prevención de lavado |
| `enrichmentData.normalized.isPep` | Es PEP | Boolean (true/false) | Enrichment Data | Pessoa Expuesta Políticamente |
| `enrichmentData.normalized.isCurrentPep` | Es PEP Actual | Boolean (true/false) | Enrichment Data | Es PEP en ejercicio del cargo |
| `enrichmentData.normalized.pepLevels` | Niveles PEP | Array of objects | Enrichment Data | Niveles de exposición política |
| `enrichmentData.normalized.isMemberOfCompany` | Miembro de Empresa | Boolean (true/false) | Enrichment Data | Es miembro/socio de alguna empresa |
| `enrichmentData.normalized.occupations` | Actividades/Ocupaciones | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las actividades económicas |
| `enrichmentData.normalized.occupationsSummary` | Resumen de Actividades | Nested object (3 nested fields) | Enrichment Data | Estadísticas agregadas sobre actividades económicas |
| `enrichmentData.normalized.aliases` | Alias/Nombres Alternativos | Array of objects (6 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los nombres alternativos |
| `enrichmentData.normalized.aliasesSummary` | Resumen de Aliases | Nested object (4 nested fields) | Enrichment Data | Estadísticas agregadas sobre nombres alternativos |
| `enrichmentData.normalized.documents` | Documentos | Array of objects (8 nested fields) | Enrichment Data | Buscar campos específicos dentro de todos los documentos |
| `enrichmentData.normalized.documentsSummary` | Resumen de Documentos | Nested object (3 nested fields) | Enrichment Data | Estadísticas agregadas sobre documentos |
| `enrichmentData.normalized.addresses` | Direcciones | Array of objects (15 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las direcciones |
| `enrichmentData.normalized.addressesSummary` | Resumen de Direcciones | Nested object (5 nested fields) | Enrichment Data | Estadísticas agregadas sobre direcciones |
| `enrichmentData.normalized.adverseMediaScore` | Score de Medios Adversos | Number | Enrichment Data | |
| `enrichmentData.normalized.confidence` | Confianza de Datos | Number | Enrichment Data | |
| `enrichmentData.normalized.completeness` | Completitud de Datos | Number | Enrichment Data | |
### Global Fields
| Field Path | Label | Type | Category | Description |
| ------------------------------------------------------------- | ---------------------------- | ----------------------------------- | --------------- | ------------------------------------------------------------------------ |
| `enrichmentData.normalized.riskFlags` | Banderas de Riesgo | Array of objects (10 nested fields) | Enrichment Data | Buscar campos específicos dentro de todas las banderas de riesgo |
| `enrichmentData.normalized.riskFlagsSummary.totalFlags` | Total de Banderas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.activeFlags` | Banderas Activas | Number | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasPepFlags` | Tiene Banderas PEP | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.riskFlagsSummary.hasSanctionFlags` | Tiene Banderas de Sanción | Boolean (true/false) | Enrichment Data | |
| `enrichmentData.normalized.sanctioned` | Sancionado | Boolean (true/false) | Enrichment Data | Empresa aparece en listas de sanciones internacionales (ComplyAdvantage) |
| `enrichmentData.normalized.sanctionLists` | Listas de Sanciones Globales | Array of objects | Enrichment Data | Listas internacionales donde aparece la empresa |
| `enrichmentData.normalized.watchlists` | Watchlists | Array of objects | Enrichment Data | Listas de vigilancia donde está registrada |
| `enrichmentData.normalized.registrationCountry` | País de Registro | Text/String | Enrichment Data | País donde está registrada la empresa (ComplyAdvantage) |
| `enrichmentData.normalized.adverseMediaScore` | Score de Medios Adversos | Number | Enrichment Data | Severidad de menciones negativas (0-100) |
## Estruturas de Campos Aninhados
Alguns campos contêm estruturas aninhadas (arrays ou objetos) com múltiplos subcampos:
### `enrichmentData.normalized.documents` - Documentos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | --------------- | -------------------- | ------------------------------------------------- |
| `value` | Número | Text/String | Número do documento (ex: CNPJ) |
| `type` | Tipo | Text/String | Tipo de documento |
| `classification` | Classificação | Text/String | Classificação do documento |
| `active` | Ativo | Boolean (true/false) | Documento está ativo |
| `isExpired` | Expirado | Boolean (true/false) | Documento está expirado |
| `issuingCountry` | País Emissor | Text/String | Código ISO do país |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.documents.$.value",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.documentsSummary` - Resumo de Documentos
**Tipo:** Object
**Descrição:** Campos agregados sobre documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------- | ------ | -------------------------- |
| `totalDocuments` | Total de Documentos | Number | Número total de documentos |
| `branches` | Número de Filiais | Number | Quantidade de filiais |
### `enrichmentData.normalized.aliases` - Nomes Alternativos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os nomes alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `name` | Nome | Text/String | Nome do alias |
| `originalName` | Nome Original | Text/String | Nome como aparece na fonte |
| `type` | Tipo de Alias | Text/String | Classificação do alias |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Alias confirmado por 2+ provedores |
| `usageFrequency` | Frequência de Uso | Number | Quantas vezes aparece nas fontes |
| `confidence` | Confiança | Number | Nível de confiança do alias (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.aliases.$.name",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.aliasesSummary` - Resumo de Aliases
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre nomes alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------- | ---------------------- | -------------------- | --------------------------------------- |
| `totalAliases` | Total de Aliases | Number | Número total de nomes alternativos |
| `uniqueAliases` | Aliases Únicos | Number | Número de aliases únicos (deduplicated) |
| `confirmedAliases` | Aliases Confirmados | Number | Aliases confirmados por 2+ fontes |
| `hasMultipleNames` | Possui Múltiplos Nomes | Boolean (true/false) | Indica se possui mais de um alias |
| `mostCommonAlias` | Alias Mais Comum | Text/String | Nome alternativo mais frequente |
| `byType.former_name` | Nomes Anteriores | Number | Número de nomes anteriores |
| `byType.trade_name` | Nomes Comerciais | Number | Número de nomes comerciais |
### `enrichmentData.normalized.cnaes` - CNAEs (Atividades Econômicas)
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as atividades econômicas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ---------------------------------------------------------------------- |
| `code` | Código CNAE (todos) | Text/String | Código da atividade econômica (ex: 6201-5/00) - evalúa todos los CNAEs |
| `description` | Descrição (todos) | Text/String | Descrição da atividade econômica - evalúa todos los CNAEs |
| `isMain` | É Atividade Principal | Boolean (true/false) | Indica se é a atividade econômica principal |
| `isHighRisk` | É Alto Risco | Boolean (true/false) | Atividade classificada como alto risco (ex: jogos, armas, cripto) |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | CNAE confirmado por 2+ provedores |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.cnaes.$.code",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.cnaesSummary` - Resumo de CNAEs
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre atividades econômicas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | --------------------------- | -------------------- | ------------------------------------------------------------ |
| `totalCNAEs` | Total de CNAEs | Number | Número total de atividades econômicas |
| `mainCNAE.code` | Código CNAE Principal | Text/String | Código da atividade principal |
| `mainCNAE.description` | Descrição CNAE Principal | Text/String | Descrição da atividade principal |
| `secondaryCNAEsCount` | Número de CNAEs Secundários | Number | Quantidade de atividades secundárias |
| `hasHighRiskCNAEs` | Possui CNAEs de Alto Risco | Boolean (true/false) | Indica se possui atividades de alto risco |
| `highRiskCNAEs` | CNAEs de Alto Risco | Text/String | Códigos das atividades de alto risco (separados por vírgula) |
### `enrichmentData.normalized.addresses` - Endereços
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os endereços
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `streetName` | Rua (todas) | Text/String | Nome da rua - avalia todos os endereços |
| `city` | Cidade (todas) | Text/String | Cidade - avalia todos os endereços |
| `state` | Estado (todos) | Text/String | Estado/Província - avalia todos os endereços |
| `postalCode` | CEP (todos) | Text/String | Código postal - avalia todos os endereços |
| `country` | País | Text/String | País (código ISO) |
| `number` | Número | Text/String | Número do endereço |
| `neighborhood` | Bairro | Text/String | Bairro |
| `complement` | Complemento | Text/String | Complemento (apt, sala, etc) |
| `type` | Tipo | Text/String | Tipo de endereço |
| `isMainForEntity` | É Endereço Principal | Boolean (true/false) | Indica se é o endereço principal da entidade |
| `isCurrent` | É Atual | Boolean (true/false) | Indica se é o endereço atual |
| `isActive` | Está Ativo | Boolean (true/false) | Indica se o endereço está ativo |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Endereço confirmado por 2+ provedores |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.addresses.$.streetName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.addressesSummary` - Resumo de Endereços
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre endereços
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | -------------------------- | -------------------- | ------------------------------------------ |
| `totalAddresses` | Total de Endereços | Number | Número total de endereços |
| `uniqueAddresses` | Endereços Únicos | Number | Número de endereços únicos |
| `confirmedAddresses` | Endereços Confirmados | Number | Endereços confirmados por múltiplas fontes |
| `activeAddresses` | Endereços Ativos | Number | Número de endereços ativos |
| `hasMultipleAddresses` | Possui Múltiplos Endereços | Boolean (true/false) | Indica se possui mais de um endereço |
| `byType.residential` | Endereços Residenciais | Number | Número de endereços residenciais |
| `byType.commercial` | Endereços Comerciais | Number | Número de endereços comerciais |
### `enrichmentData.normalized.emails` - E-mails
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os e-mails
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `email` | E-mail | Text/String | Endereço de e-mail |
| `type` | Tipo | Text/String | Tipo de e-mail |
| `isValidated` | Validado | Boolean (true/false) | E-mail foi validado |
| `isCorporate` | É Corporativo | Boolean (true/false) | É e-mail corporativo |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | E-mail confirmado por 2+ provedores |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.emails.$.email",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.emailsSummary` - Resumo de E-mails
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre e-mails
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------- | ------------------------ | -------------------- | ---------------------------------------- |
| `totalEmails` | Total de E-mails | Number | Número total de e-mails |
| `uniqueEmails` | E-mails Únicos | Number | Número de e-mails únicos |
| `confirmedEmails` | E-mails Confirmados | Number | E-mails confirmados por múltiplas fontes |
| `activeEmails` | E-mails Ativos | Number | Número de e-mails ativos |
| `validatedEmails` | E-mails Validados | Number | E-mails que foram validados |
| `hasMultipleEmails` | Possui Múltiplos E-mails | Boolean (true/false) | Indica se possui mais de um e-mail |
| `byType.work` | E-mails de Trabalho | Number | Número de e-mails corporativos |
| `byType.personal` | E-mails Pessoais | Number | Número de e-mails pessoais |
### `enrichmentData.normalized.phones` - Telefones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os telefones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `number` | Número | Text/String | Número de telefone |
| `type` | Tipo | Text/String | Tipo de telefone |
| `countryCode` | Código de País | Text/String | Código de país |
| `areaCode` | Código de Área | Text/String | Código de área |
| `isActive` | Ativo | Boolean (true/false) | Telefone está ativo |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Telefone confirmado por 2+ provedores |
| `currentCarrier` | Operadora Atual | Text/String | Operadora telefônica |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.phones.$.number",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.phonesSummary` - Resumo de Telefones
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre telefones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------- | -------------------------- | -------------------- | ------------------------------------------ |
| `totalPhones` | Total de Telefones | Number | Número total de telefones |
| `uniquePhones` | Telefones Únicos | Number | Número de telefones únicos |
| `confirmedPhones` | Telefones Confirmados | Number | Telefones confirmados por múltiplas fontes |
| `activePhones` | Telefones Ativos | Number | Número de telefones ativos |
| `hasMultiplePhones` | Possui Múltiplos Telefones | Boolean (true/false) | Indica se possui mais de um telefone |
| `byType.mobile` | Telefones Móveis | Number | Número de telefones móveis |
| `byType.landline` | Telefones Fixos | Number | Número de telefones fixos |
### `enrichmentData.normalized.legalProceedings` - Processos Judiciais
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os processos judiciais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `caseNumber` | Número do Processo | Text/String | Número do processo |
| `type` | Tipo | Text/String | Tipo de processo |
| `subject` | Assunto | Text/String | Assunto do processo |
| `status` | Status | Text/String | Status do processo |
| `statusDetail` | Status Detalhado (Brasil) | Text/String | Status original do processo antes da normalização (DISTRIBUIDO, ATIVO, EM\_ANDAMENTO, ENCERRADO, ARQUIVADO, CONDENADO, ABSOLVIDO, etc.) |
| `role` | Papel da Entidade | Text/String | Papel da entidade no processo |
| `court` | Tribunal/Vara | Text/String | Tribunal ou vara |
| `tribunal` | Tribunal | Text/String | Nome do tribunal (ex: TJSP, TJRJ) |
| `comarca` | Comarca | Text/String | Comarca do processo |
| `state` | Estado | Text/String | Estado (UF) do processo (ex: SP, RJ, PR) |
| `judge` | Juiz | Text/String | Nome do juiz responsável |
| `courtDistrict` | Foro/Distrito | Text/String | Foro ou distrito judicial |
| `courtLevel` | Instância | Text/String | Instância do tribunal |
| `judgingBody` | Órgão Julgador | Text/String | Órgão julgador ou câmara |
| `severity` | Severidade | Text/String | Nível de severidade do processo |
| `filingDate` | Data de Entrada | Date (ISO 8601 format) | Data de entrada do processo |
| `filingYear` | Ano de Entrada | Text/String | Ano de distribuição do processo |
| `lastUpdate` | Última Atualização | Date (ISO 8601 format) | Data da última atualização |
| `lastMovementDate` | Último Movimento | Date (ISO 8601 format) | Data do último movimento processual |
| `noticeDate` | Data de Notificação | Date (ISO 8601 format) | Data de notificação |
| `closeDate` | Data de Encerramento | Date (ISO 8601 format) | Data de encerramento do processo |
| `amount` | Valor | Number | Valor da causa (em centavos) |
| `lawsuitAge` | Idade do Processo (dias) | Number | Idade do processo em dias |
| `numberOfUpdates` | Número de Atualizações | Number | Quantidade de atualizações/movimentos |
| `numberOfParties` | Número de Partes | Number | Quantidade de partes envolvidas |
| `confidence` | Confiança | Number | Nível de confiança dos dados (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.legalProceedings.$.caseNumber",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.legalProceedingsSummary` - Resumo de Processos Judiciais
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre processos judiciais
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------------------- | -------------------------------------- | ---------------------- | ------------------------------------------------------------- |
| `totalProceedings` | Total de Processos | Number | Número total de processos judiciais |
| `hasActiveCriminalCases` | Tem Processos Criminais Ativos | Boolean (true/false) | Indica se há processos criminais ativos |
| `hasArrestWarrant` | Tem Mandado de Prisão | Boolean (true/false) | Indica se há mandado de prisão |
| `byType.criminal` | Processos Criminais | Number | Número de processos criminais |
| `byType.civil` | Processos Cíveis | Number | Número de processos cíveis |
| `byType.labor` | Processos Trabalhistas | Number | Número de processos trabalhistas |
| `byStatus.active` | Processos Ativos | Number | Número de processos ativos |
| `byStatus.closed` | Processos Encerrados | Number | Número de processos encerrados |
| `bySeverity.high` | Processos de Alta Severidade | Number | Número de processos de alta severidade |
| `bySeverity.critical` | Processos de Severidade Crítica | Number | Número de processos críticos |
| `hasLaborViolations` | Tem Violações Trabalhistas | Boolean (true/false) | Indica se há violações trabalhistas (crítico para compliance) |
| `hasPublicMinistryInvestigation` | Tem Investigação do Ministério Público | Boolean (true/false) | Indica se há investigação do MP (alta severidade) |
| `byType.public_ministry` | Processos do Ministério Público | Number | Número de investigações/processos do MP |
| `byType.arrest_warrant` | Mandados de Prisão | Number | Número de mandados de prisão |
| `byRole.asAuthor` | Como Autor | Number | Número de processos como autor/requerente |
| `byRole.asDefendant` | Como Réu | Number | Número de processos como réu/requerido |
| `byRole.asOther` | Outro Papel | Number | Número de processos em outro papel |
| `byRole.unknown` | Papel Desconhecido | Number | Número de processos com papel desconhecido |
| `totalClaimAmount` | Valor Total das Causas | Number | Soma total dos valores de todas as causas (em centavos) |
| `averageClaimAmount` | Valor Médio das Causas | Number | Valor médio das causas (em centavos) |
| `activeProcessosCount` | Processos Ativos (Total) | Number | Número total de processos com status ativo |
| `mostRecentUpdate` | Atualização Mais Recente | Date (ISO 8601 format) | Data da atualização mais recente entre todos os processos |
| `oldestCaseYear` | Ano do Processo Mais Antigo | Text/String | Ano do processo mais antigo |
| `multiSourceConfirmationRate` | Taxa de Confirmação Multi-Fonte | Number | Porcentagem de processos confirmados por múltiplas fontes |
| `averageLawsuitAge` | Idade Média dos Processos (dias) | Number | Idade média de todos os processos em dias |
| `totalUpdates` | Total de Atualizações | Number | Soma total de atualizações/movimentos em todos os processos |
| `proceedingsWithJudge` | Processos com Juiz Identificado | Number | Quantidade de processos com juiz identificado |
| `recentActivityCount` | Processos com Atividade Recente | Number | Processos com atividade nos últimos 30 dias |
| `oldProceedingsCount` | Processos Antigos | Number | Número de processos com mais de 2 anos (>730 dias) |
### `enrichmentData.normalized.riskFlags` - Bandeiras de Risco
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as bandeiras de risco
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | --------------------------------------------------- |
| `flagType` | Tipo de Bandeira | Text/String | Tipo de bandeira de risco |
| `isActive` | Está Ativo | Boolean (true/false) | Indica se a bandeira de risco está atualmente ativa |
| `details.severity` | Severidade | Text/String | Nível de severidade do risco |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (apenas para PEP) |
| `details.pepCountry` | País PEP | Text/String | País do cargo político |
| `details.pepLevel` | Nível PEP | Text/String | Nível do PEP (nacional, internacional, local) |
| `details.description` | Descrição | Text/String | Descrição detalhada da bandeira |
| `details.riskScore` | Score de Risco | Number | Score de risco (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Bandeira confirmada por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos que reportaram |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.riskFlagsSummary` - Resumo de Bandeiras de Risco
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre bandeiras de risco
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------------ | --------------------------------------- | -------------------- | ------------------------------------------------------ |
| `totalFlags` | Total de Bandeiras | Number | Número total de bandeiras de risco |
| `activeFlags` | Bandeiras Ativas | Number | Número de bandeiras atualmente ativas |
| `confirmedFlags` | Bandeiras Confirmadas | Number | Bandeiras confirmadas por múltiplas fontes |
| `hasPepFlags` | Tem Bandeiras PEP | Boolean (true/false) | Indica se há bandeiras de tipo PEP |
| `hasSanctionFlags` | Tem Bandeiras de Sanção | Boolean (true/false) | Indica se há bandeiras de sanção |
| `hasAdverseMediaFlags` | Tem Bandeiras de Mídia Adversa | Boolean (true/false) | Indica se há bandeiras de mídia adversa |
| `hasCriminalRecordFlags` | Tem Bandeiras de Antecedentes Criminais | Boolean (true/false) | Indica se há bandeiras de antecedentes criminais |
| `byType.pep` | Bandeiras PEP (Contagem) | Number | Número de bandeiras de tipo PEP |
| `byType.sanction` | Bandeiras de Sanção (Contagem) | Number | Número de bandeiras de sanção |
| `byType.adverseMedia` | Bandeiras de Mídia Adversa (Contagem) | Number | Número de bandeiras de mídia adversa |
| `byType.criminalRecord` | Bandeiras de Antecedentes (Contagem) | Number | Número de bandeiras de antecedentes criminais |
| `bySeverity.high` | Bandeiras de Severidade Alta | Number | Número de bandeiras de severidade alta |
| `bySeverity.critical` | Bandeiras de Severidade Crítica | Number | Número de bandeiras de severidade crítica |
| `hasActivePepFlags` | Tem Bandeiras PEP Ativas | Boolean (true/false) | Possui bandeiras PEP atualmente ativas (vs históricas) |
### `enrichmentData.normalized.sanctionsSummary` - Resumo de Sanções
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre listas de sanções
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------------------------- | ----------------------------------- | -------------------- | ----------------------------------------------------- |
| `totalLists` | Total de Listas de Sanções | Number | Número total de listas de sanções |
| `uniqueLists` | Listas Únicas | Number | Número de listas únicas (deduplicated) |
| `confirmedLists` | Listas Confirmadas | Number | Listas confirmadas por múltiplas fontes |
| `hasInternationalSanctions` | Tem Sanções Internacionais | Boolean (true/false) | Indica se há sanções internacionais (OFAC, UN, EU) |
| `hasLaborSanctions` | Tem Sanções Trabalhistas | Boolean (true/false) | Indica se há sanções trabalhistas |
| `multiSourceConfirmationRate` | Taxa de Confirmação Multi-fonte (%) | Number | Percentual de listas confirmadas por múltiplas fontes |
| `highestSeverityList` | Lista de Maior Severidade | Text/String | Nome da lista de sanção mais severa |
### `enrichmentData.normalized.shareholdersSummary` - Resumo de Sócios/Acionistas
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre estrutura societária
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------------------ | --------------------------------------- | -------------------- | --------------------------------------- |
| `totalShareholders` | Total de Sócios/Acionistas | Number | Número total de sócios ou acionistas |
| `uniqueShareholders` | Sócios Únicos | Number | Número de sócios únicos (deduplicated) |
| `confirmedShareholders` | Sócios Confirmados | Number | Sócios confirmados por múltiplas fontes |
| `byStatus.active` | Sócios Ativos | Number | Número de sócios ativos |
| `byStatus.inactive` | Sócios Inativos | Number | Número de sócios inativos |
| `byEntityType.person` | Sócios Pessoa Física | Number | Número de sócios PF |
| `byEntityType.company` | Sócios Pessoa Jurídica | Number | Número de sócios PJ |
| `totalOwnershipMapped` | Total de Participação Mapeada (%) | Number | Soma total de participação societária |
| `hasFullOwnershipData` | Tem Estrutura Societária Completa | Boolean (true/false) | Participações somam >= 95% |
| `hasConcentratedOwnership` | Propriedade Concentrada | Boolean (true/false) | Sócio único com >50% de participação |
| `largestShareholderPercentage` | Maior Participação Societária (%) | Number | Percentual do maior acionista |
| `largestShareholderName` | Nome do Maior Acionista | Text/String | Nome do sócio com maior participação |
| `totalUBOs` | Total de Beneficiários Finais (UBOs) | Number | Sócios com participação >25% |
| `hasMajorityShareholder` | Tem Acionista Majoritário | Boolean (true/false) | Possui acionista com >= 50% |
| `confirmedByMultipleSources` | Sócios Confirmados por Múltiplas Fontes | Number | Número de sócios verificados |
| `multiSourceConfirmationRate` | Taxa de Confirmação Multi-Fonte (%) | Number | Percentual de sócios confirmados |
### `enrichmentData.normalized.shareholders` - Sócios/Acionistas Consolidados
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos os sócios consolidados (QSA + outras fontes)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | ---------------------- | ---------------------------------- |
| `name` | Nome do Sócio | Text/String | |
| `taxId` | CPF/CNPJ | Text/String | |
| `taxIdType` | Tipo de Documento | Text/String | |
| `entityType` | Tipo de Entidade | Text/String | `person` \| `company` \| `unknown` |
| `relationshipType` | Tipo de Relacionamento | Text/String | QSA, SOCIO, ADMINISTRADOR, etc. |
| `relationshipName` | Nome do Cargo/Função | Text/String | |
| `ownershipPercentage` | Participação Societária (%) | Number | |
| `isActive` | Está Ativo | Boolean (true/false) | |
| `startDate` | Data de Entrada | Date (ISO 8601 format) | |
| `endDate` | Data de Saída | Date (ISO 8601 format) | |
| `sources` | Fontes de Dados | Text/String | Filtrar por provedores específicos |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | |
| `count` | Número de Fontes | Number | |
| `confidence` | Confiança (0-100) | Number | |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.shareholders.$.name",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.violations` - Violações Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as violações consolidadas (ESG + crimes)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `id` | ID | Text/String | Identificador único da violação |
| `displayName` | Nome | Text/String | Nome formatado da violação |
| `category` | Categoria | Text/String | Categoria da violação |
| `subcategory` | Subcategoria | Text/String | Subcategoria da violação |
| `severity` | Severidade | Text/String | Nível de severidade |
| `legalClassification` | Classificação Legal | Text/String | Tipo legal da violação |
| `complianceClassification` | Classificação de Compliance | Text/String | Tipo de compliance |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Violação confirmada por 2+ fontes |
| `count` | Contagem | Number | Número de vezes reportada |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.violations.$.id",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.violationsSummary` - Resumo de Violações
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre violações
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------------------ | -------------------- | ----------------------------------- |
| `totalViolations` | Total de Violações | Number | Número total de violações |
| `hasCriminalViolations` | Tem Violações Criminais | Boolean (true/false) | Indica se há violações criminais |
| `hasESGViolations` | Tem Violações ESG | Boolean (true/false) | Indica se há violações ESG |
| `hasEnvironmentalCrimes` | Tem Crimes Ambientais | Boolean (true/false) | Indica se há crimes ambientais |
| `hasLaborViolations` | Tem Violações Trabalhistas | Boolean (true/false) | Indica se há violações trabalhistas |
| `hasFinancialCrimes` | Tem Crimes Financeiros | Boolean (true/false) | Indica se há crimes financeiros |
| `confirmedByMultipleSources` | Violações Confirmadas por Múltiplas Fontes | Number | Número de violações confirmadas |
### `enrichmentData.normalized.mediaMentions` - Menções em Mídia
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as menções em mídia consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ------------------------------------------------- |
| `id` | ID | Text/String | Identificador único da menção |
| `title` | Título | Text/String | Título da menção |
| `description` | Descrição | Text/String | Descrição completa |
| `date` | Data | Text/String | Data da menção (YYYY-MM-DD) |
| `sentiment` | Sentimento | Text/String | Sentimento da menção |
| `category` | Categoria | Text/String | Categoria da menção |
| `amount` | Valor (centavos) | Number | Valor monetário em centavos |
| `currency` | Moeda | Text/String | Código da moeda (BRL, USD) |
| `entity` | Entidade | Text/String | Tribunal, agência, parceiro mencionado |
| `severity` | Severidade | Text/String | Nível de severidade |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Menção confirmada por 2+ fontes |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.mediaMentions.$.id",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.mediaSummary` - Resumo de Mídia
**Tipo:** Object
**Descrição:** Estatísticas agregadas sobre menções na mídia
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | --------------------------------- | ----------- | ---------------------------------------------- |
| `totalMentions` | Total de Menções | Number | Número total de menções |
| `recentMentions` | Menções Recentes (12 meses) | Number | Menções nos últimos 12 meses |
| `highImpactMentions` | Menções de Alto Impacto | Number | Menções com valor monetário ou resultado legal |
| `sentimentScore` | Score de Sentimento (-100 a +100) | Number | Score geral de sentimento |
| `firstMentionDate` | Data da Primeira Menção | Text/String | Data da primeira menção na mídia (ISO format) |
| `latestMentionDate` | Data da Última Menção | Text/String | Data da menção mais recente (ISO format) |
| `bySentiment.positive` | Menções Positivas | Number | Número de menções com sentimento positivo |
| `bySentiment.negative` | Menções Negativas | Number | Número de menções com sentimento negativo |
| `bySentiment.neutral` | Menções Neutras | Number | Número de menções com sentimento neutro |
| `condemnationsCount` | Condenações | Number | Número de condenações |
| `investigationsCount` | Investigações | Number | Número de investigações |
| `awardsCount` | Prêmios | Number | Número de prêmios |
### `enrichmentData.normalized.sanctions` - Sanções Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas as sanções consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | ------------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
| `listName` | Nome da Lista | Text/String | Nome formatado da lista (ex: "OFAC SDN", "UN Sanctions", "Mídia"). Busca livre por texto |
| `type` | Tipo de Sanção | Text/String | Categoria da sanção para agrupamento e filtros |
| `sources` | Fontes | Text/String | Filtrar por provedores específicos que reportaram |
| `confirmedByMultipleSources` | Confirmado por Múltiplas Fontes | Boolean (true/false) | Sanção confirmada por 2+ provedores |
| `confidence` | Confiança | Number | Nível de confiança (0-100) |
| `addedDate` | Data de Adição | Text/String | Data em que foi adicionado à lista |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.listName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.riskFlags` - Banderas de Riesgo
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las banderas de riesgo
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------------------------ |
| `flagType` | Tipo de Bandera | Text/String | Tipo de bandera de riesgo |
| `isActive` | Está Activo | Boolean (true/false) | Indica si la bandera de riesgo está actualmente activa |
| `details.severity` | Severidad | Text/String | Nivel de severidad del riesgo |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (solo para PEP) |
| `details.pepCountry` | País PEP | Text/String | País del cargo político |
| `details.pepLevel` | Nivel PEP | Text/String | Nivel del PEP (nacional, internacional, local) |
| `details.description` | Descripción | Text/String | Descripción detallada de la bandera |
| `details.riskScore` | Score de Riesgo | Number | Score de riesgo (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Bandera confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctions` - Sanciones Consolidadas
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las sanciones consolidadas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ----------------------------------------------------------------------- |
| `listName` | Nombre de la Lista | Text/String | Nombre formateado de la lista (ej: "OFAC SDN", "UN Sanctions", "RePET") |
| `type` | Tipo de Sanción | Text/String | Categoría de la sanción para agrupamiento y filtros |
| `sources` | Fuentes | Text/String | Filtrar por proveedores específicos que reportaron |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Sanción confirmada por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `addedDate` | Fecha de Adición | Text/String | Fecha en que fue añadido a la lista |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.listName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.sanctionsSummary` - Resumen de Sanciones
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre listas de sanciones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| -------------------- | ---------------------------- | ------ | ---------------------------------------------------------- |
| `totalLists` | Total de Listas de Sanciones | Number | Número total de listas de sanciones |
| `uniqueLists` | Listas Únicas | Number | Número de listas únicas (deduplicadas) |
| `confirmedSanctions` | Sanciones Confirmadas | Number | Sanciones confirmadas por 2+ fuentes |
| `highestConfidence` | Mayor Confianza | Number | Mayor nivel de confianza entre todas las sanciones (0-100) |
### `enrichmentData.normalized.occupations` - Actividades/Ocupaciones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las actividades económicas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ---------------------- | ---------------------- | ----------------------------------------- |
| `occupation` | Ocupación | Text/String | Nombre de la actividad económica |
| `category` | Categoría | Text/String | Categoría de la actividad |
| `isMain` | Es Actividad Principal | Boolean (true/false) | Indica si es la actividad principal |
| `isCurrent` | Es Actual | Boolean (true/false) | Indica si es la actividad actual |
| `startDate` | Fecha de Inicio | Date (ISO 8601 format) | Fecha de inicio de la actividad |
| `endDate` | Fecha de Fin | Date (ISO 8601 format) | Fecha de fin de la actividad |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Proveedores que reportaron esta actividad |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.occupations.$.occupation",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.occupationsSummary` - Resumen de Actividades
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre actividades económicas
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------- | -------------------- | ----------- | ----------------------------- |
| `totalOccupations` | Total de Actividades | Number | Número total de actividades |
| `uniqueOccupations` | Actividades Únicas | Number | Número de actividades únicas |
| `mainOccupation` | Actividad Principal | Text/String | Actividad económica principal |
### `enrichmentData.normalized.aliases` - Alias/Nombres Alternativos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los nombres alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------- |
| `alias` | Alias | Text/String | Nombre alternativo |
| `type` | Tipo | Text/String | Tipo de alias |
| `isCurrent` | Es Actual | Boolean (true/false) | Indica si es el nombre actual |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Alias confirmado por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Proveedores que reportaron este alias |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.aliases.$.alias",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.aliasesSummary` - Resumen de Aliases
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre nombres alternativos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------------ | ----------------------- | -------------------- | ------------------------------------ |
| `totalAliases` | Total de Aliases | Number | Número total de nombres alternativos |
| `uniqueAliases` | Aliases Únicos | Number | Número de aliases únicos |
| `confirmedAliases` | Aliases Confirmados | Number | Aliases confirmados por 2+ fuentes |
| `hasMultipleNames` | Posee Múltiples Nombres | Boolean (true/false) | Indica si posee más de un alias |
### `enrichmentData.normalized.documents` - Documentos
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todos los documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | -------------------- | ---------------------- | ----------------------------------------- |
| `documentNumber` | Número de Documento | Text/String | Número del documento |
| `documentType` | Tipo de Documento | Text/String | Tipo de documento |
| `issuingCountry` | País Emisor | Text/String | País que emitió el documento |
| `issueDate` | Fecha de Emisión | Date (ISO 8601 format) | Fecha de emisión del documento |
| `expiryDate` | Fecha de Vencimiento | Date (ISO 8601 format) | Fecha de vencimiento del documento |
| `isActive` | Está Activo | Boolean (true/false) | Indica si el documento está activo |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Proveedores que reportaron este documento |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.documents.$.documentNumber",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.documentsSummary` - Resumen de Documentos
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre documentos
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------------- | ------------------- | ------ | ---------------------------- |
| `totalDocuments` | Total de Documentos | Number | Número total de documentos |
| `uniqueDocuments` | Documentos Únicos | Number | Número de documentos únicos |
| `activeDocuments` | Documentos Activos | Number | Número de documentos activos |
### `enrichmentData.normalized.addresses` - Direcciones
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las direcciones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ----------------------------------------- |
| `streetName` | Calle | Text/String | Nombre de la calle |
| `number` | Número | Text/String | Número del domicilio |
| `city` | Ciudad | Text/String | Ciudad |
| `state` | Provincia | Text/String | Provincia |
| `postalCode` | Código Postal | Text/String | Código postal |
| `country` | País | Text/String | País (código ISO) |
| `neighborhood` | Barrio | Text/String | Barrio |
| `complement` | Complemento | Text/String | Complemento (piso, dpto, etc) |
| `type` | Tipo | Text/String | Tipo de dirección |
| `isMainForEntity` | Es Dirección Principal | Boolean (true/false) | Indica si es la dirección principal |
| `isCurrent` | Es Actual | Boolean (true/false) | Indica si es la dirección actual |
| `isActive` | Está Activo | Boolean (true/false) | Indica si la dirección está activa |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Dirección confirmada por 2+ proveedores |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
| `sources` | Fuentes de Datos | Text/String | Proveedores que reportaron esta dirección |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.addresses.$.streetName",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `enrichmentData.normalized.addressesSummary` - Resumen de Direcciones
**Tipo:** Object
**Descrição:** Estadísticas agregadas sobre direcciones
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------- | --------------------------- | -------------------- | --------------------------------------------- |
| `totalAddresses` | Total de Direcciones | Number | Número total de direcciones |
| `uniqueAddresses` | Direcciones Únicas | Number | Número de direcciones únicas |
| `confirmedAddresses` | Direcciones Confirmadas | Number | Direcciones confirmadas por múltiples fuentes |
| `activeAddresses` | Direcciones Activas | Number | Número de direcciones activas |
| `hasMultipleAddresses` | Posee Múltiples Direcciones | Boolean (true/false) | Indica si posee más de una dirección |
### `enrichmentData.normalized.riskFlags` - Banderas de Riesgo
**Tipo:** Array of objects
**Descrição:** Buscar campos específicos dentro de todas las banderas de riesgo
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------------------- | -------------------------------- | -------------------- | ------------------------------------------------------ |
| `flagType` | Tipo de Bandera | Text/String | Tipo de bandera de riesgo |
| `isActive` | Está Activo | Boolean (true/false) | Indica si la bandera de riesgo está actualmente activa |
| `details.severity` | Severidad | Text/String | Nivel de severidad del riesgo |
| `details.pepPosition` | Cargo PEP | Text/String | Cargo político (solo para PEP) |
| `details.pepCountry` | País PEP | Text/String | País del cargo político |
| `details.pepLevel` | Nivel PEP | Text/String | Nivel del PEP (nacional, internacional, local) |
| `details.description` | Descripción | Text/String | Descripción detallada de la bandera |
| `details.riskScore` | Score de Riesgo | Number | Score de riesgo (0-100) |
| `confirmedByMultipleSources` | Confirmado por Múltiples Fuentes | Boolean (true/false) | Bandera confirmada por 2+ fuentes |
| `confidence` | Confianza | Number | Nivel de confianza (0-100) |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "enrichmentData.normalized.riskFlags.$.flagType",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
***
## Transaction Fields
Fields available for evaluating transaction data.
### Global Fields
| Field Path | Label | Type | Category | Description |
| ----------------------------------- | ------------------------------------- | ---------------------- | ------------------- | ----------------------------------------------------------------------------------------------------- |
| `externalId` | ID Externo | Text/String | Basic Information | Identificador externo de la transacción |
| `type` | Tipo de Transação | Text/String | Basic Information | Tipo: PAYMENT, TRANSFER, WITHDRAWAL, DEPOSIT, REFUND, etc. |
| `status` | Estado | Text/String | Basic Information | Estado: CREATED, PENDING, PROCESSING, APPROVED, REJECTED, HELD, FAILED, COMPLETED, CANCELLED, EXPIRED |
| `amount` | Monto | Number | Basic Information | Monto de la transacción |
| `currency` | Moneda | Text/String | Basic Information | Código ISO 4217 de moneda (USD, BRL, ARS, etc.) |
| `amountInUsd` | Monto en USD | Number | Basic Information | Monto convertido a USD |
| `transactedAt` | Fecha y Hora | Date (ISO 8601 format) | Basic Information | Timestamp de la transacción |
| `originEntityId` | ID Entidad Origen | Text/String | Basic Information | ID de la entidad que origina la transacción |
| `originExternalId` | ID Externo Origen | Text/String | Basic Information | ID externo de la entidad origen |
| `originTaxId` | Tax ID origem | Text/String | Basic Information | Raiz; terceiro critério de vinculação. Match normalizado a `entity.taxId`. |
| `originName` | Nombre Origen | Text/String | Basic Information | Nombre de la entidad origen |
| `originCountry` | País Origen | Text/String | Basic Information | País de la entidad origen |
| `destinationEntityId` | ID Entidad Destino | Text/String | Basic Information | ID de la entidad que recibe la transacción |
| `destinationExternalId` | ID Externo Destino | Text/String | Basic Information | ID externo de la entidad destino |
| `destinationTaxId` | Tax ID destino | Text/String | Basic Information | Terceiro critério; mesma lógica de `originTaxId`. |
| `destinationName` | Nombre Destino | Text/String | Basic Information | Nombre de la entidad destino |
| `destinationCountry` | País Destino | Text/String | Basic Information | País de la entidad destino |
| `paymentMethod` | Método de Pago | Text/String | Basic Information | Método de pago: CARD, PIX, BANK\_TRANSFER, WALLET, CASH, etc. |
| `paymentDetails.cardLast4` | Últimos 4 Dígitos Tarjeta | Text/String | Basic Information | Últimos 4 dígitos de tarjeta |
| `paymentDetails.cardBrand` | Marca Tarjeta | Text/String | Basic Information | Marca de tarjeta: Visa, Mastercard, etc. |
| `paymentDetails.bankName` | Banco | Text/String | Basic Information | Nombre del banco |
| `paymentDetails.accountType` | Tipo de Cuenta | Text/String | Basic Information | Tipo de cuenta: PERSONAL, BUSINESS, MERCHANT |
| `originDetails.deviceId` | ID Dispositivo (Origen) | Text/String | Basic Information | Identificador del dispositivo origen |
| `originDetails.ipAddress` | Dirección IP (Origen) | Text/String | Basic Information | Dirección IP del dispositivo origen |
| `originDetails.country` | País Dispositivo (Origen) | Text/String | Basic Information | País del dispositivo origen |
| `originDetails.city` | Ciudad (Origen) | Text/String | Basic Information | Ciudad del dispositivo origen |
| `destinationDetails.deviceId` | ID Dispositivo (Destino) | Text/String | Basic Information | Identificador del dispositivo destino |
| `destinationDetails.ipAddress` | Dirección IP (Destino) | Text/String | Basic Information | Dirección IP del dispositivo destino |
| `destinationDetails.country` | País Dispositivo (Destino) | Text/String | Basic Information | País del dispositivo destino |
| `destinationDetails.city` | Ciudad (Destino) | Text/String | Basic Information | Ciudad del dispositivo destino |
| `riskScore` | Score de Riesgo | Number | Basic Information | Score de riesgo de la transacción (0-100) |
| `flagged` | Marcada | Boolean (true/false) | Basic Information | Indica si la transacción está marcada como sospechosa |
| `description` | Descripción | Text/String | Basic Information | Descripción de la transacción |
| `category` | Categoría | Text/String | Basic Information | Categoría de la transacción |
| `exchangeRate` | Tasa de Cambio | Number | Basic Information | Tasa de cambio aplicada |
| `rateSource` | Fuente de Tasa | Text/String | Basic Information | Fuente de la tasa de cambio: ms-provider, cache-fallback, etc. |
| `historical.volume` | Volumen de Transacciones (Histórico) | Number | Historical Analysis | Suma de montos de transacciones en un período de tiempo |
| `historical.count` | Cantidad de Transacciones (Histórico) | Number | Historical Analysis | Conteo de transacciones en un período de tiempo |
| `historical.average` | Promedio de Transacciones (Histórico) | Number | Historical Analysis | Promedio de montos de transacciones en un período |
| `historical.uniqueCounterparties` | Contrapartes Únicas (Histórico) | Number | Historical Analysis | Cantidad de contrapartes únicas en un período |
| `historical.maxAmount` | Monto Máximo (Histórico) | Number | Historical Analysis | Monto máximo de transacción en un período |
| `historical.minAmount` | Monto Mínimo (Histórico) | Number | Historical Analysis | Monto mínimo de transacción en un período |
| `historical.noActivity` | Sin Actividad (Histórico) | Boolean (true/false) | Historical Analysis | Detecta si no hay actividad por un período (cuenta dormida) |
| `historical.firstOccurrence` | Primera Ocurrencia (Histórico) | Date (ISO 8601 format) | Historical Analysis | Fecha de primera vez que ocurre un patrón |
| `historical.consecutiveOccurrences` | Ocurrencias Consecutivas (Histórico) | Number | Historical Analysis | Cuenta ocurrencias consecutivas de un patrón |
| `historical.frequencyExceeds` | Frecuencia Excede (Histórico) | Boolean (true/false) | Historical Analysis | Detecta si frecuencia de transacciones excede umbral |
***
## KYC Fields
Fields available for evaluating KYC verification data.
### Global Fields
| Field Path | Label | Type | Category | Description |
| ----------------------- | ---------------------------- | ---------------------------------- | ---------------- | ------------------------------------------------------ |
| `kyc.status` | Status KYC | Text/String | KYC Verification | Status da validação KYC (KYC provider) |
| `kyc.biometricResult` | Resultado Biométrico | Nested object (3 nested fields) | KYC Verification | Resultados de face match e liveness (KYC provider) |
| `kyc.documentsVerified` | Documentos Verificados | Array of objects (3 nested fields) | KYC Verification | Lista de documentos verificados no KYC |
| `kyc.riskAssessment` | Avaliação de Risco KYC | Nested object (2 nested fields) | KYC Verification | Avaliação de risco realizada pelo KYC |
| `kyc.extractedData` | Dados Extraídos do Documento | Nested object (7 nested fields) | KYC Verification | Dados extraídos do documento de identidade |
| `kyc.verifiedAt` | Data de Verificação KYC | Date (ISO 8601 format) | KYC Verification | Data em que o KYC foi verificado/aprovado |
| `kyc.isCurrent` | É Validação Atual | Boolean (true/false) | KYC Verification | Indica se é a validação KYC ativa/atual |
| `kyc.provider` | Provedor KYC | Text/String | KYC Verification | Nome do provedor que realizou o KYC (ex: KYC provider) |
## Estruturas de Campos Aninhados
Alguns campos contêm estruturas aninhadas (arrays ou objetos) com múltiplos subcampos:
### `kyc.biometricResult` - Resultado Biométrico
**Tipo:** Object
**Descrição:** Resultados de face match e liveness (KYC provider)
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------ | -------------------- | ----------------------------------------------------- |
| `faceMatchScore` | Score Face Match | Number | Score de correspondência facial (0-1, onde 0.8 = 80%) |
| `livenessScore` | Score Liveness | Number | Score de detecção de vida (0-1) |
| `passed` | Biometria Aprovada | Boolean (true/false) | Validação biométrica geral aprovada |
### `kyc.documentsVerified` - Documentos Verificados
**Tipo:** Array of objects
**Descrição:** Lista de documentos verificados no KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ------------ | ------------------- | ---------------------- | --------------------------------------- |
| `type` | Tipo de Documento | Text/String | Tipo do documento apresentado |
| `verified` | Verificado | Boolean (true/false) | Documento foi verificado com sucesso |
| `verifiedAt` | Data de Verificação | Date (ISO 8601 format) | Data e hora da verificação do documento |
**Exemplo de Uso (Campo de Array):**
```json theme={null}
{
"field": "kyc.documentsVerified.$.type",
"operator": "eq",
"value": "example_value",
"filters": []
}
```
### `kyc.riskAssessment` - Avaliação de Risco KYC
**Tipo:** Object
**Descrição:** Avaliação de risco realizada pelo KYC
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ----------- | -------------- | ----------- | ------------------------------- |
| `riskLevel` | Nível de Risco | Text/String | Classificação do nível de risco |
| `riskScore` | Score de Risco | Number | Score numérico de risco (0-100) |
### `kyc.extractedData` - Dados Extraídos do Documento
**Tipo:** Object
**Descrição:** Dados extraídos do documento de identidade
**Subcampos Disponíveis:**
| Sub-field | Label | Type | Description |
| ---------------- | ------------------- | ---------------------- | ---------------------------------------- |
| `firstName` | Nome | Text/String | Primeiro nome extraído |
| `lastName` | Sobrenome | Text/String | Sobrenome extraído |
| `fullName` | Nome Completo | Text/String | Nome completo extraído |
| `dateOfBirth` | Data de Nascimento | Date (ISO 8601 format) | Data de nascimento extraída do documento |
| `documentNumber` | Número do Documento | Text/String | Número do documento extraído |
| `documentType` | Tipo do Documento | Text/String | Tipo do documento identificado |
| `nationality` | Nacionalidade | Text/String | Nacionalidade extraída |
***
## Shareholders Fields
Fields available for evaluating company shareholders and directors.
Shareholder fields use a special notation: `shareholders.(person|company).fieldPath`
Examples:
* `shareholders.person.enrichmentData.normalized.taxId`
* `shareholders.company.enrichmentData.normalized.revenue`
* `shareholders.person.enrichmentData.normalized.isPep`
Shareholder conditions allow you to create rules that evaluate the characteristics of a company's shareholders and directors. These are relationship-based conditions that check if ANY shareholder matches the specified criteria.
The fields listed below show what's available for **person** and **company** shareholders. To use them in conditions, prefix with `shareholders.person.` or `shareholders.company.` as shown in the examples.
### BR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| ---------- | ------- | --------------------------------- | ------------------------ | ----------- |
| `company` | Company | Nested object (106 nested fields) | Shareholders & Directors | Company |
| `person` | Person | Nested object (100 nested fields) | Shareholders & Directors | Person |
### AR - Country-Specific Fields
| Field Path | Label | Type | Category | Description |
| ---------- | ------- | --------------------------------- | ------------------------ | ----------- |
| `company` | Company | Nested object (69 nested fields) | Shareholders & Directors | Company |
| `person` | Person | Nested object (125 nested fields) | Shareholders & Directors | Person |
***
## Available Operators
### Comparison Operators
* `eq` - Equals
* `ne` - Not equals
* `gt` - Greater than
* `gte` - Greater than or equal
* `lt` - Less than
* `lte` - Less than or equal
* `in` - Value is in array
* `not_in` - Value is not in array
* `between` - Value is between two numbers (inclusive)
* `not_between` - Value is not between two numbers
* `is_null` - Field is null or undefined
* `is_not_null` - Field exists and is not null
### String Operators
* `contains` - Contains substring
* `not_contains` - Does not contain substring
* `starts_with` - Starts with substring
* `ends_with` - Ends with substring
* `regex` - Matches regular expression pattern
* `not_regex` - Does not match regular expression pattern
### Boolean Operators
* `eq:true` - Boolean field is true
* `eq:false` - Boolean field is false
### Data List Operators
* `in_datalist` - Value exists in a data list (blocklists, allowlists)
* `not_in_datalist` - Value does not exist in a data list
* `matches_datalist_pattern` - Value matches a pattern in data list
### Custom List Operators
* `in_custom_list` - Value exists in a custom list
* `not_in_custom_list` - Value does not exist in a custom list
### Date & Time Operators
* `date_between` - Date is between two dates
* `date_not_between` - Date is not between two dates
### Temporal Operators
* `within_last` - Event occurred within last N days/hours/minutes
* `between_dates` - Date is between two specific dates
* `before` - Date is before a specific date
* `after` - Date is after a specific date
* `age_in_days` - Calculate age in days
* `age_in_hours` - Calculate age in hours
* `age_in_minutes` - Calculate age in minutes
### Mathematical Operators
* `add` - Addition
* `subtract` - Subtraction
* `multiply` - Multiplication
* `divide` - Division
* `modulo` - Modulo (remainder)
* `power` - Exponentiation
* `sum` - Sum of values
* `avg` - Average of values
* `count` - Count of items
* `min` - Minimum value
* `max` - Maximum value
* `abs` - Absolute value
* `round` - Round to nearest integer
* `ceil` - Round up to nearest integer
* `floor` - Round down to nearest integer
### Geographical Operators
* `distance_from` - Calculate distance from coordinates
* `in_region` - Check if location is in region
* `country_risk_level` - Check country risk level
### Aggregation Operators
* `count_in_period` - Count occurrences in time period
* `sum_in_period` - Sum values in time period
* `velocity_change` - Calculate rate of change over time
* `frequency_pattern` - Detect frequency patterns
### Logical Operators (for combining conditions)
* `AND` - All conditions must be true
* `OR` - At least one condition must be true
* `NOT` - Inverts the condition result
* `XOR` - Exactly one condition must be true
***
## Usage Examples
### Simple Condition - Text Field
Check if a company's legal name equals a specific value:
```json theme={null}
{
"id": "cond-1",
"type": "simple",
"field": "entityData.company.legalName",
"operator": "eq",
"value": "Tech Solutions Ltda",
"filters": [],
"countryMetadata": {
"countryCode": "BR",
"confidence": 100,
"manuallySet": true,
"autoDetected": false,
"reason": "Selected from BR basic fields"
}
}
```
### Number Field with Comparison
Check if company revenue is greater than 1 million:
```json theme={null}
{
"id": "cond-2",
"type": "simple",
"field": "enrichmentData.normalized.revenue",
"operator": "gt",
"value": 1000000,
"filters": []
}
```
### Boolean Field
Check if a company is sanctioned:
```json theme={null}
{
"id": "cond-3",
"type": "simple",
"field": "enrichmentData.normalized.sanctioned",
"operator": "eq:true",
"value": true,
"filters": []
}
```
### Date Comparison
Check if incorporation date is after a specific date:
```json theme={null}
{
"id": "cond-5",
"type": "simple",
"field": "entityData.company.incorporationDate",
"operator": "gt",
"value": "2020-01-01",
"filters": []
}
```
### Data List Checking
Check if tax ID is in a blocklist:
```json theme={null}
{
"id": "cond-6",
"type": "simple",
"field": "taxId",
"operator": "in_datalist",
"value": "company_blocklist",
"filters": []
}
```
***
## Working with Arrays - The `.$.` Notation
When working with array fields, you must use the special `.$.` notation to traverse array elements and access their properties.
### Array Traversal Syntax
The `.$.` notation tells the rules engine to:
1. Iterate through each element in the array
2. Access the specified property within each element
3. Apply the condition to matching elements (optionally filtered)
**Format:** `arrayField.$.propertyName`
### Example 1: Array Field with Filters
Check if a company has active legal proceedings with amount > 100,000:
```json theme={null}
{
"id": "cond-4",
"type": "simple",
"field": "enrichmentData.normalized.legalProceedings.$.amount",
"operator": "gt",
"value": 100000,
"filters": [
{
"field": "status",
"operator": "eq",
"value": "active"
}
]
}
```
**Explanation:**
* `legalProceedings` is an array of objects
* `.$.` traverses each legal proceeding in the array
* `amount` accesses the amount property of each proceeding
* `filters` ensures we only check proceedings where `status === "active"`
### Example 2: Check Sanction Types
Check if a person has any sanction of type "TERRORIST":
```json theme={null}
{
"id": "cond-7",
"type": "simple",
"field": "enrichmentData.normalized.sanctions.$.type",
"operator": "eq",
"value": "TERRORIST",
"filters": []
}
```
**Explanation:**
* `sanctions` is an array containing all sanctions records
* `.$.` iterates through each sanction
* `type` accesses the type field of each sanction
* The condition matches if ANY sanction has type "TERRORIST"
### Example 3: Array with Multiple Filters
Check if a person has any sanction from a specific country and program:
```json theme={null}
{
"id": "cond-8",
"type": "simple",
"field": "enrichmentData.normalized.sanctions.$.origin",
"operator": "eq",
"value": "US",
"filters": [
{
"field": "program",
"operator": "eq",
"value": "OFAC"
},
{
"field": "status",
"operator": "eq",
"value": "active"
}
]
}
```
**Common Array Fields:**
* `enrichmentData.normalized.sanctions.$.type` - Sanction types
* `enrichmentData.normalized.sanctions.$.origin` - Sanction origins
* `enrichmentData.normalized.sanctions.$.program` - Sanction programs
* `enrichmentData.normalized.legalProceedings.$.amount` - Legal proceeding amounts
* `enrichmentData.normalized.legalProceedings.$.status` - Legal proceeding status
* `enrichmentData.normalized.pepLevels.$.level` - PEP level values
***
## Working with Shareholders
Shareholder fields use a special structure: `shareholders.(person|company).fieldPath`
### Shareholder Field Structure
Shareholders can be either **person** or **company** entities. To access shareholder properties, use:
**Format:** `shareholders.(person|company).fieldPath`
Where:
* `person` - For individual shareholders (uses person entity fields)
* `company` - For corporate shareholders (uses company entity fields)
* `fieldPath` - Any valid field path from the respective entity type
### Example 1: Check Shareholder Tax ID
Check if any shareholder (person) has a specific tax ID:
```json theme={null}
{
"id": "cond-10",
"type": "simple",
"field": "shareholders.person.enrichmentData.normalized.taxId",
"operator": "eq",
"value": "12345678901",
"filters": []
}
```
**Explanation:**
* `shareholders.person` - Look at person-type shareholders
* `enrichmentData.normalized.taxId` - Access their normalized tax ID
* This checks ALL person shareholders for a match
### Example 2: Check if Shareholder is PEP
Check if any shareholder (person) is a Politically Exposed Person:
```json theme={null}
{
"id": "cond-11",
"type": "simple",
"field": "shareholders.person.enrichmentData.normalized.isPep",
"operator": "eq:true",
"value": true,
"filters": []
}
```
### Example 3: Check if Shareholder is Sanctioned
Check if any shareholder (person) is sanctioned:
```json theme={null}
{
"id": "cond-12",
"type": "simple",
"field": "shareholders.person.enrichmentData.normalized.sanctioned",
"operator": "eq:true",
"value": true,
"filters": []
}
```
### Example 4: Corporate Shareholder Revenue
Check if any corporate shareholder has revenue greater than 10 million:
```json theme={null}
{
"id": "cond-13",
"type": "simple",
"field": "shareholders.company.enrichmentData.normalized.revenue",
"operator": "gt",
"value": 10000000,
"filters": []
}
```
### Example 5: Shareholder Array Fields
Check if any shareholder (person) has sanctions of a specific type:
```json theme={null}
{
"id": "cond-14",
"type": "simple",
"field": "shareholders.person.enrichmentData.normalized.sanctions.$.type",
"operator": "eq",
"value": "OFAC",
"filters": []
}
```
**Explanation:**
* `shareholders.person` - Look at person shareholders
* `enrichmentData.normalized.sanctions` - Access their sanctions array
* `.$.` - Traverse each sanction in the array
* `type` - Check the type of each sanction
### Common Shareholder Patterns
**Person Shareholders:**
* `shareholders.person.enrichmentData.normalized.taxId` - Tax ID
* `shareholders.person.enrichmentData.normalized.isPep` - PEP status
* `shareholders.person.enrichmentData.normalized.sanctioned` - Sanction status
* `shareholders.person.enrichmentData.normalized.isDeceased` - Death status
* `shareholders.person.entityData.person.firstName` - First name
* `shareholders.person.entityData.person.lastName` - Last name
**Company Shareholders:**
* `shareholders.company.enrichmentData.normalized.taxId` - Company tax ID
* `shareholders.company.enrichmentData.normalized.revenue` - Revenue
* `shareholders.company.enrichmentData.normalized.sanctioned` - Sanction status
* `shareholders.company.entityData.company.legalName` - Legal name
***
## Complex Condition with Multiple Checks
Check if a person is a PEP OR has sanctions OR has criminal records:
```json theme={null}
{
"operator": "OR",
"conditions": [
{
"id": "cond-15",
"type": "simple",
"field": "enrichmentData.normalized.isPep",
"operator": "eq:true",
"value": true,
"filters": []
},
{
"id": "cond-16",
"type": "simple",
"field": "enrichmentData.normalized.sanctioned",
"operator": "eq:true",
"value": true,
"filters": []
},
{
"id": "cond-17",
"type": "simple",
"field": "enrichmentData.normalized.criminalRecords",
"operator": "eq:true",
"value": true,
"filters": []
}
]
}
```
***
## Notes
### Country Metadata
Each condition can include country metadata to provide context about where the field comes from:
```json theme={null}
{
"countryMetadata": {
"countryCode": "BR",
"confidence": 100,
"manuallySet": true,
"autoDetected": false,
"reason": "Selected from BR enrichment fields"
}
}
```
### Array Field Syntax
When working with array fields, use the `$` symbol to indicate you're evaluating items within the array:
* `enrichmentData.normalized.sanctions.$.type` - Checks the `type` field of ANY item in the `sanctions` array
* `enrichmentData.normalized.legalProceedings.$.amount` - Checks the `amount` field of ANY item in the `legalProceedings` array
### Filters
Filters allow you to pre-filter array items before applying the main condition. They work with AND logic:
```json theme={null}
{
"field": "enrichmentData.normalized.sanctions.$.severity",
"operator": "eq",
"value": "high",
"filters": [
{
"field": "status",
"operator": "eq",
"value": "active"
},
{
"field": "type",
"operator": "in",
"value": "terrorism"
}
]
}
```
This checks if there's any active terrorism sanction with high severity.
## See Also
* [Create Rule](/pt/api-reference/rules/create) - Learn how to create rules using these fields
* [Execute Rule](/pt/api-reference/rules/execute) - Test rules against entities
* [Provider Codes](/pt/api-reference/integrations/provider-codes) - Integration provider reference