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 solo códigos de enriquecimiento (*_enrichment).
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: Para salida JSON:
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á: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: Código ISO 3166-1 alfa-2 (ej:
br,ar,cl,mx) oglobal - 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í
enrichmentpara 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.Integraciones marketplace tipo service
Las filas del catálogo con integration_type = service exponen rutas HTTP por organización (sesión o API key con tenant). La organización debe activar la integración en Marketplace como cualquier otro producto.
- Path base:
/api/integration-services/:integrationCode/...(mismo auth y contexto deorganizationIdque el resto de la API). - Ejemplo:
ar_gueno_coelsa_service— totales de CBU/CVU vinculados a un CUIT (Argentina).GET /api/integration-services/ar_gueno_coelsa_service/health— comprobación de disponibilidad del servicio.GET /api/integration-services/ar_gueno_coelsa_service/cuits/:cuit/cbu-count—:cuitdebe tener 11 dígitos; la respuesta incluyecbuCountycvuCount.
base_price_cents es mayor que cero (la fila de catálogo se siembra en gratis por defecto).
Integraciones marketplace tipo lists (listas)
Las integraciones con integration_type = lists permiten solo consultar si existe un valor en los ítems de esa lista (primary_value / search_keys). No hay endpoint HTTP tenant para descargar ni paginar el catálogo completo.
- Path base:
/api/marketplace-list-lookups/:integrationCode/lookup(mismo auth y contexto deorganizationIdque el resto de la API). Requiere permiso de lectura de marketplace (marketplace:read/ equivalente legacy). - Request:
POSTcon body JSON{ "value": "<string>" }(longitud máxima acotada en servidor). - Respuesta exitosa:
{ "success": true, "data": { "found": true | false } }— sin payloads de ítems, arrays de coincidencias ni volcados de lista. - Si la integración no está habilitada para la org: HTTP
404con códigoLIST_INTEGRATION_NOT_ACTIVE(misma idea que integracionesserviceinactivas).
Códigos de Proveedores Disponibles
Brasil (BR)
BDC (Big Data Corp)
Enriquecimientos:br_bdc_basic_data_enrichment- Datos básicos de personabr_bdc_basic_data_company_enrichment- Datos básicos de empresabr_bdc_related_persons_enrichment- Datos de personas relacionadasbr_bdc_judicial_processes_enrichment- Registros judiciales completosbr_bdc_judicial_processes_shareholders_enrichment- Procesos judiciales de accionistasbr_bdc_financial_data_enrichment- Datos de perfil financierobr_bdc_addresses_extended_enrichment- Historial completo de direccionesbr_bdc_emails_extended_enrichment- Verificación e historial de emailbr_bdc_phones_extended_enrichment- Verificación e historial de teléfonobr_bdc_related_companies_enrichment- Datos de empresas relacionadasbr_bdc_lawsuits_enrichment- Información detallada de demandasbr_bdc_kyc_person_enrichment- Datos KYC completos de personabr_bdc_kyc_business_enrichment- Datos KYC completos de empresabr_bdc_negative_media_enrichment- Artículos de medios negativosbr_bdc_negative_media_company_enrichment- Medios negativos para empresas (CNPJ)br_bdc_revenue_estimate_enrichment- Estimaciones y tendencias de ingresosbr_bdc_shareholders_enrichment- Estructura completa de accionistasbr_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 penalesbr_jusbrasil_civil_lawsuits_enrichment- Detalles de demandas civilesbr_jusbrasil_labor_lawsuits_enrichment- Detalles de demandas laboralesbr_jusbrasil_public_ministry_enrichment- Registros del ministerio públicobr_jusbrasil_arrest_warrants_enrichment- Detalles de órdenes de arrestobr_jusbrasil_irregular_employer_enrichment- Registros de empleador irregular
AMLDD (Anti-Money Laundering Due Diligence)
Enriquecimientos:br_amldd_esg_enrichment- Datos de cumplimiento ESGbr_amldd_lri_enrichment- Registros detallados de LRIbr_amldd_pep_enrichment- Perfiles completos de PEPbr_amldd_mtlsn_complete_enrichment- Datos completos de MTLSNbr_amldd_mtlsn_simple_enrichment- Datos simplificados de MTLSNbr_amldd_mtlsn_with_internal_enrichment- MTLSN con datos internos
CPF/CNPJ
Enriquecimientos:br_cpfcnpj_complete_person_enrichment- Datos completos de CPFbr_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 deudasar_bcra_historicas_enrichment- Registros financieros históricosar_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 personaar_repet_entity_enrichment- Datos de sanciones laborales de entidad
ARCA / AFIP (contribuyente)
Enriquecimientos:ar_arca_contribuyente_enrichment- Datos fiscales del contribuyente (AFIP vía ARCA: padrón A13 y constancia de inscripción por CUIT/CUIL). Complementa identidad y situación impositiva.
Gu1 (UIF, KIA, MiPyme/TIA, JIA, PIA/PEP)
Integraciones de compliance tributario / AFIP y PEP para CUIT/CUIL (orquestación marketplace + ms-providers). Enriquecimientos:-
ar_gueno_uif_enrichment- UIF: sujetos obligados e inscripción -
ar_gueno_kia_enrichment- KIA (compliance por CUIT/CUIL) -
ar_gueno_tia_enrichment- MiPyme / TIA por CUIT/CUIL
Los campos detallados del TIA (
mipymeRows, vigencias, flags de módulo) están en el mapped por proveedor y en la respuesta cruda. En normalized_enrichment consolidado para reglas/matrices se exponen taxId (sujeto de búsqueda) e isMyPyme. Al sumar claves nuevas en raíz, actualizar normalized-field-providers.ar_gueno_jia_enrichment- AFIP: contribuyentes no confiables (JIA)
Además de
taxId, las señales consolidadas van en riskFlags / riskFlagsSummary.ar_gueno_pia_enrichment- PIA: compliance PEP (CUIT/CUIL)
Las filas detalladas (
pepRows, CUIT relacionado, textos) quedan en el mapped por proveedor. En normalized_enrichment consolidado / reglas el mapper expone taxId, isPep / isCurrentPep (PEP confirmado, código 1), isPepPossible (posible PEP, código 2), pepComplianceRowCount, y riskFlags / riskFlagsSummary cuando hay coincidencias.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
Chile (CL)
BaseAPI (SII)
Enriquecimientos:-
cl_baseapi_basic_data_person_enrichment— Situación tributaria pública del SII por RUT (persona natural). Ruta KYB víams-providers; el path incluyeorganizationId. -
cl_baseapi_basic_data_company_enrichment— Misma respuesta upstream; usá el código de empresa cuando la entidad jurídica es empresa.
Las claves root
mainActivityAfipCode / mainActivityAfipDescription son nombres compartidos del modelo consolidado; en Chile reflejan código y descripción de actividad económica según SII (no AFIP Argentina).SRE (registro comercial)
Enriquecimientos:-
cl_sre_info_person_enrichment— Identidad mínima por RUT (slot persona). -
cl_sre_info_company_enrichment— Igual para empresas.
ruts.info
Enriquecimientos:-
cl_rutsinfo_info_person_enrichment— Ficha comercial (actividades, domicilios) cuando constan para el RUT. -
cl_rutsinfo_info_company_enrichment— Igual para empresas.
Global
ComplyAdvantage
Enriquecimientos:global_complyadvantage_company_search_enrichment- Datos de sanciones de empresaglobal_complyadvantage_person_search_enrichment- Datos de sanciones de personaglobal_complyadvantage_sanctions_enrichment- Registros completos de sancionesglobal_complyadvantage_pep_enrichment- Perfiles globales de PEP
Gu1 (sanciones globales)
Enriquecimientos:-
global_gueno_sanctions_enrichment- Sanciones globales Gu1 (incl. monitoreo / watchlist si está habilitado)
Ejemplos de Uso
Ejecutar Integraciones Específicas
Ejecutar Todas las Integraciones Activas
Integración Selectiva para Accionistas
Cobertura de Proveedores por País
| País | Proveedores | Enriquecimientos (documentados) |
|---|---|---|
| Brasil 🇧🇷 | BDC, JusBrasil, AMLDD, CPF/CNPJ, BrasilAPI | 40+ |
| Argentina 🇦🇷 | BCRA, Nosis, REPET, ARCA/AFIP, Gu1 (UIF/KIA/TIA/JIA), Renaper | 12+ |
| Global 🌍 | ComplyAdvantage, Gu1 sanciones | 6 |
Mejores prácticas
- Preferir enriquecimientos: Usá los códigos
*_enrichmentlistados aquí para la configuración de ejecución. - Usar
executeAllActiveEnrichments: Dejá que la plataforma determine qué integraciones ejecutar según tu configuración. - Ser específico con accionistas: Usá integración selectiva para accionistas para controlar costos.
- Combinar proveedores: Mezclá distintos proveedores para una cobertura integral.
- Considerar costos: Algunos proveedores son más pesados que otros; acotá lo que necesitás.
Documentación Relacionada
- Crear Entidad - Uso de códigos de proveedor en creación manual
- Crear Entidad Automáticamente - Uso de códigos de proveedor en creación automática
- Ejecución de Integraciones - Ejecutar integraciones en entidades existentes