Skip to main content
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).
Los códigos *_check y POST /integration-execution/marketplace/check fueron eliminados (2026-06-04). Usá el *_enrichment equivalente con Ejecutar enrichment. Payloads legacy de create/import que envíen *_check, checks o executeAllActiveChecks se ignoran al parsear.

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, cl, 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.

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 de organizationId que 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:cuit debe tener 11 dígitos; la respuesta incluye cbuCount y cvuCount.
El cobro por request sigue las reglas de pack de ejecuciones o créditos como otras integraciones de marketplace cuando 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 de organizationId que el resto de la API). Requiere permiso de lectura de marketplace (marketplace:read / equivalente legacy).
  • Request: POST con 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 404 con código LIST_INTEGRATION_NOT_ACTIVE (misma idea que integraciones service inactivas).
Las consultas usan la misma vía de billing de marketplace que otros lookups de listas cuando el producto tiene precio.

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

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ía ms-providers; el path incluye organizationId.
  • 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 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

Gu1 (sanciones globales)

Enriquecimientos:
  • global_gueno_sanctions_enrichment - Sanciones globales Gu1 (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, ARCA/AFIP, Gu1 (UIF/KIA/TIA/JIA), Renaper12+
Global 🌍ComplyAdvantage, Gu1 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