Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt

Use this file to discover all available pages before exploring further.

Para ejecutar un enriquecimiento de marketplace sin entidad persistida (sujeto en memoria + solo auditoría headless), consultá Ejecutar sin entidad (y los endpoints de listado y detalle en la misma referencia API).

Resumen

Los códigos de proveedores se utilizan al configurar integraciones automáticas durante la creación de entidades. Esta referencia lista códigos de enriquecimiento (*_enrichment). Los códigos legacy *_check pueden seguir existiendo en payloads antiguos de la API pero no se documentan aquí y no se recomiendan para integraciones nuevas.

Catálogo de campos en normalized_enrichment

En Puntos de datos provistos, los nombres corresponden al JSON consolidado de normalized_enrichment (persona o empresa): campos raíz, arreglos consolidados (p. ej. sanctions, addresses) y campos *Summary cuando aplica.
Fuente en código: packages/integrations/src/normalization/normalized-field-providers.ts (NORMALIZED_FIELD_PROVIDERS, getFieldsProvidedBy). Para listar todos los valores de ValidProviderCodesEnum con sus campos mapeados (o lista vacía si no aplica), ejecutá:
npm run docs:provider-normalized-fields
Para salida JSON: npx tsx scripts/docs/provider-normalized-fields-report.ts --json.

Formato del Código de Proveedor

Los códigos de proveedor siguen esta convención de nomenclatura:
{país}_{proveedor}_{tipo_verificación}_{tipo_integración}
  • país: Código ISO 3166-1 alfa-2 (ej: br, ar, mx) o global
  • proveedor: Nombre del proveedor de datos (ej: bdc, amldd, complyadvantage)
  • tipo_verificación: Tipo de datos que se recuperan (ej: kyc, pep, sanctions)
  • tipo_integración: Preferí enrichment para trabajo nuevo (*_enrichment).

Tipos de integración

Enrichments (enriquecimientos)

Enriquecimiento de datos que devuelve información detallada para completar perfiles de entidades. Esta página documenta solo códigos de enriquecimiento.

Códigos de Proveedores Disponibles

Brasil (BR)

BDC (Big Data Corp)

Enriquecimientos:
  • br_bdc_basic_data_enrichment - Datos básicos de persona
  • br_bdc_basic_data_company_enrichment - Datos básicos de empresa
  • br_bdc_related_persons_enrichment - Datos de personas relacionadas
  • br_bdc_judicial_processes_enrichment - Registros judiciales completos
  • br_bdc_judicial_processes_shareholders_enrichment - Procesos judiciales de accionistas
  • br_bdc_financial_data_enrichment - Datos de perfil financiero
  • br_bdc_addresses_extended_enrichment - Historial completo de direcciones
  • br_bdc_emails_extended_enrichment - Verificación e historial de email
  • br_bdc_phones_extended_enrichment - Verificación e historial de teléfono
  • br_bdc_related_companies_enrichment - Datos de empresas relacionadas
  • br_bdc_lawsuits_enrichment - Información detallada de demandas
  • br_bdc_kyc_person_enrichment - Datos KYC completos de persona
  • br_bdc_kyc_business_enrichment - Datos KYC completos de empresa
  • br_bdc_negative_media_enrichment - Artículos de medios negativos
  • br_bdc_negative_media_company_enrichment - Medios negativos para empresas (CNPJ)
  • br_bdc_revenue_estimate_enrichment - Estimaciones y tendencias de ingresos
  • br_bdc_shareholders_enrichment - Estructura completa de accionistas
  • br_bdc_reputation_reviews_enrichment - Puntuaciones de reputación y reseñas
Estas claves son los principales campos de empresa que aporta este enriquecimiento (ver providersExpectedFields en código). Puede que no figuren todas en getFieldsProvidedBy hasta mapearlas en normalized-field-providers.
  • br_bdc_protestos_enrichment - Registros detallados de protestos
Resumen principal persona/empresa sobre protestos (formas esperadas en código). El mapeo consolidado en normalized-field-providers puede ser parcial.
  • br_bdc_faturamento_presumido_enrichment - Análisis de facturación presunta
Indicadores de empresa de facturación / actividad (campos esperados en código). Misma salvedad que otros BDC respecto de getFieldsProvidedBy.

JusBrasil

Enriquecimientos:
  • br_jusbrasil_criminal_lawsuits_enrichment - Detalles de demandas penales
  • br_jusbrasil_civil_lawsuits_enrichment - Detalles de demandas civiles
  • br_jusbrasil_labor_lawsuits_enrichment - Detalles de demandas laborales
  • br_jusbrasil_public_ministry_enrichment - Registros del ministerio público
  • br_jusbrasil_arrest_warrants_enrichment - Detalles de órdenes de arresto
  • br_jusbrasil_irregular_employer_enrichment - Registros de empleador irregular

AMLDD (Anti-Money Laundering Due Diligence)

Enriquecimientos:
  • br_amldd_esg_enrichment - Datos de cumplimiento ESG
  • br_amldd_lri_enrichment - Registros detallados de LRI
  • br_amldd_pep_enrichment - Perfiles completos de PEP
  • br_amldd_mtlsn_complete_enrichment - Datos completos de MTLSN
  • br_amldd_mtlsn_simple_enrichment - Datos simplificados de MTLSN
  • br_amldd_mtlsn_with_internal_enrichment - MTLSN con datos internos

CPF/CNPJ

Enriquecimientos:
  • br_cpfcnpj_complete_person_enrichment - Datos completos de CPF
  • br_cpfcnpj_complete_person_9_enrichment - Variante CPF (flujo alternativo / 9 dígitos)
  • br_cpfcnpj_complete_company_enrichment - Datos completos de CNPJ

BrasilAPI

Enriquecimientos:
  • br_brasilapi_company_enrichment - Datos de empresa

Argentina (AR)

BCRA (Banco Central de la República Argentina)

Enriquecimientos:
  • ar_bcra_deudas_enrichment - Registros completos de deudas
  • ar_bcra_historicas_enrichment - Registros financieros históricos
  • ar_bcra_cheques_rechazados_enrichment - Detalles de cheques rechazados

Nosis

Enriquecimientos:
  • ar_nosis_extended_verification_enrichment - Datos de verificación extendida

REPET (Registro Público de Empleadores con Sanciones Laborales)

Enriquecimientos:
  • ar_repet_person_enrichment - Datos de sanciones laborales de persona
  • ar_repet_entity_enrichment - Datos de sanciones laborales de entidad

Renaper

Enriquecimientos:
  • ar_renaper_validate_dni_enrichment - Validación de DNI (flujo de identidad)
Los códigos ar_renaper_validate_dni_* no figuran hoy en normalized-field-providers (getFieldsProvidedBy devuelve lista vacía). Cubren validación / sesión más que campos consolidados en este catálogo.
  • ar_renaper_data_enrichment - Datos de Renaper

Global

ComplyAdvantage

Enriquecimientos:
  • global_complyadvantage_company_search_enrichment - Datos de sanciones de empresa
  • global_complyadvantage_person_search_enrichment - Datos de sanciones de persona
  • global_complyadvantage_sanctions_enrichment - Registros completos de sanciones
  • global_complyadvantage_pep_enrichment - Perfiles globales de PEP

Gueno (sanciones globales)

Enriquecimientos:
  • global_gueno_sanctions_enrichment - Sanciones globales Gueno (incl. monitoreo / watchlist si está habilitado)

Ejemplos de Uso

Ejecutar Integraciones Específicas

{
  "autoExecuteIntegrations": {
    "enrichments": [
      "br_bdc_basic_data_enrichment",
      "br_bdc_shareholders_enrichment",
      "br_amldd_pep_enrichment",
      "global_complyadvantage_sanctions_enrichment"
    ]
  }
}

Ejecutar Todas las Integraciones Activas

{
  "autoExecuteIntegrations": {
    "executeAllActiveEnrichments": true
  }
}

Integración Selectiva para Accionistas

{
  "autoExecuteIntegrationsShareholders": {
    "enrichments": {
      "company": ["br_bdc_basic_data_enrichment", "br_bdc_kyc_business_enrichment"],
      "person": ["br_cpfcnpj_complete_person_enrichment", "br_amldd_pep_enrichment"]
    }
  }
}

Cobertura de Proveedores por País

PaísProveedoresEnriquecimientos (documentados)
Brasil 🇧🇷BDC, JusBrasil, AMLDD, CPF/CNPJ, BrasilAPI40+
Argentina 🇦🇷BCRA, Nosis, REPET, Renaper7+
Global 🌍ComplyAdvantage, Gueno sanciones6

Mejores prácticas

  1. Preferir enriquecimientos: Usá los códigos *_enrichment listados aquí para la configuración de ejecución.
  2. Usar executeAllActiveEnrichments: Dejá que la plataforma determine qué integraciones ejecutar según tu configuración.
  3. Ser específico con accionistas: Usá integración selectiva para accionistas para controlar costos.
  4. Combinar proveedores: Mezclá distintos proveedores para una cobertura integral.
  5. Considerar costos: Algunos proveedores son más pesados que otros; acotá lo que necesitás.

Documentación Relacionada