> ## 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.

# Descripción General de Enriquecimiento

> Ejecuta integraciones de enriquecimiento del marketplace para obtener datos adicionales de entidades desde proveedores externos — usando proveedores.

## ¿Qué es el Enriquecimiento?

El enriquecimiento es el proceso de mejorar los datos de entidades mediante la recopilación de información adicional de proveedores de datos externos. gu1 se integra con docenas de registros gubernamentales oficiales, burós de crédito, servicios de verificación de identidad y otras fuentes de datos confiables para proporcionar perfiles completos de entidades.

## Cómo Funciona

1. **Seleccionar Entidad**: Elige la entidad que deseas enriquecer (por ID interno o tu ID externo)
2. **Elegir Proveedores**: Selecciona uno o más códigos de integración de enriquecimiento
3. **Ejecutar**: gu1 llama a los proveedores externos en paralelo y normaliza las respuestas
4. **Resultados**: Obtén datos de enriquecimiento estandarizados, métricas de calidad y costos

## Características Clave

### Ejecución por Lotes

Ejecuta múltiples enriquecimientos en una sola llamada API para mejor rendimiento y conveniencia.

### Transparencia de Costos

Cada enriquecimiento devuelve su costo individual en centavos, y obtienes un total para el lote.

### Métricas de Calidad

Cada enriquecimiento incluye:

* **Completitud**: Cuánta de la información solicitada se encontró (0-1)
* **Confianza**: Confianza del proveedor en la precisión de los datos (0-1)

### Registro de Auditoría Automático

Todos los enriquecimientos se registran automáticamente con:

* Marca de tiempo
* Proveedor utilizado
* Campos enriquecidos
* Tiempo de ejecución
* Costo

### Integración con Motor de Reglas

Los enriquecimientos exitosos activan automáticamente el motor de reglas con el evento `enrichment_completed`, permitiéndote crear flujos de trabajo automatizados.

## Endpoints Disponibles

<Card title="Ejecutar por ID Interno" icon="database" href="/es/api-reference/enrichment/execute-by-id">
  Ejecuta enriquecimientos usando el UUID interno de la entidad en gu1
</Card>

<Card title="Ejecutar por ID Externo" icon="id-card" href="/es/api-reference/enrichment/execute-by-external-id">
  Ejecuta enriquecimientos usando tu propio identificador de entidad
</Card>

## Códigos de Integración Comunes

### Argentina

* `ar_repet_enrichment` - Datos oficiales de personas de REPET
* `ar_renaper_enrichment` - Registro nacional de identidad
* `ar_bcra_enrichment` - Datos financieros del banco central
* `ar_bcra_deudas_enrichment` - Información de deudas del banco central
* `ar_afip_enrichment` - Datos de la autoridad fiscal
* `ar_nosis_enrichment` - Reporte del buró de crédito

### Brasil

* `br_serasa_enrichment` - Datos de crédito Serasa
* `br_spc_enrichment` - Buró de crédito SPC
* `br_receita_federal_enrichment` - Datos de la receita federal
* `br_cpf_enrichment` - Validación y datos de CPF
* `br_cnpj_enrichment` - Datos de empresa CNPJ

### Global

* `global_worldcheck_enrichment` - Screening de sanciones y PEP
* `global_dowjones_enrichment` - Datos de riesgo y compliance

Consulta [Códigos de Proveedores de Integración](/es/api-reference/integrations/provider-codes) para la lista completa.

## Casos de Uso

### Onboarding KYC/KYB

Obtén datos oficiales de identidad y empresa durante el onboarding de clientes:

```javascript theme={null}
const result = await enrichEntity(customerId, [
  'ar_repet_enrichment',
  'ar_renaper_enrichment'
]);
```

### Evaluación de Crédito

Obtén datos financieros y de crédito para evaluación de riesgo:

```javascript theme={null}
const result = await enrichEntity(customerId, [
  'ar_bcra_enrichment',
  'ar_nosis_enrichment'
]);
```

### Screening de Compliance

Screening de sanciones, status PEP y medios adversos:

```javascript theme={null}
const result = await enrichEntity(entityId, [
  'global_worldcheck_enrichment',
  'global_dowjones_enrichment'
]);
```

### Monitoreo Continuo

Actualiza periódicamente los datos de entidades para monitoreo continuo:

```javascript theme={null}
// Ejecutar mensualmente
const result = await enrichEntity(entityId, [
  'ar_bcra_deudas_enrichment',
  'ar_afip_enrichment'
]);
```

## Mejores Prácticas

### 1. Agrupa Enriquecimientos Relacionados

Ejecuta enriquecimientos relacionados juntos para mejor rendimiento:

```javascript theme={null}
// Bueno - agrupa enriquecimientos relacionados
await enrichEntity(id, [
  'ar_repet_enrichment',
  'ar_renaper_enrichment',
  'ar_bcra_enrichment'
]);

// Menos óptimo - llamadas separadas
await enrichEntity(id, ['ar_repet_enrichment']);
await enrichEntity(id, ['ar_renaper_enrichment']);
await enrichEntity(id, ['ar_bcra_enrichment']);
```

### 2. Maneja Fallos Parciales

Verifica resultados individuales ya que algunos proveedores pueden fallar mientras otros tienen éxito:

```javascript theme={null}
const result = await enrichEntity(id, providers);

result.results.forEach(r => {
  if (r.success) {
    // Procesar enriquecimiento exitoso
    console.log(`✓ ${r.integrationName}`);
  } else {
    // Registrar enriquecimiento fallido
    console.warn(`✗ ${r.integrationName}: ${r.error.message}`);
  }
});
```

### 3. Rastrea Costos

Monitorea los costos de enriquecimiento para optimizar el uso de tus integraciones:

```javascript theme={null}
const result = await enrichEntity(id, providers);

console.log(`Costo total: $${result.totalCostCents / 100}`);

// Rastrea costos por proveedor
result.results.forEach(r => {
  if (r.costCents > 0) {
    console.log(`${r.integrationName}: $${r.costCents / 100}`);
  }
});
```

### 4. Usa IDs Externos para Conveniencia

Si trabajas con tus propios identificadores, usa el endpoint de ID externo:

```javascript theme={null}
// Más simple - usa tu ID
await enrichEntityByExternalId('customer_12345', providers);

// vs almacenar/buscar UUID
const uuid = await getEntityUUID('customer_12345');
await enrichEntity(uuid, providers);
```

### 5. Aprovecha las Métricas de Calidad

Usa los puntajes de completitud y confianza para evaluar la calidad de los datos:

```javascript theme={null}
result.results.forEach(r => {
  if (r.success) {
    const quality = r.result.dataQuality;

    if (quality.completeness < 0.5) {
      console.warn('Baja completitud de datos');
    }

    if (quality.confidence < 0.8) {
      console.warn('Baja confianza - se recomienda revisión manual');
    }
  }
});
```

## Manejo de Errores

Los enriquecimientos pueden fallar por varias razones:

### Entidad No Encontrada

```json theme={null}
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Entidad no encontrada"
  }
}
```

### Errores de Proveedor

Los fallos individuales de proveedores no fallan todo el lote:

```json theme={null}
{
  "success": true,
  "results": [
    {
      "success": false,
      "error": {
        "code": "NO_DATA_FOUND",
        "message": "No se encontraron datos para esta entidad"
      }
    }
  ]
}
```

### Límite de Tasa

Algunos proveedores tienen límites de tasa - los fallos incluyen información de reintento:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Límite de tasa del proveedor excedido",
    "retryAfter": 3600
  }
}
```

## Próximos Pasos

* Explora [Ejecutar por ID](/es/api-reference/enrichment/execute-by-id) para enriquecimiento basado en UUID interno
* Aprende sobre [Ejecutar por ID Externo](/es/api-reference/enrichment/execute-by-external-id) para integración simplificada
* Navega [Códigos de Proveedores](/es/api-reference/integrations/provider-codes) para ver todos los enriquecimientos disponibles
* Configura [Reglas](/es/api-reference/rules/create) para automatizar acciones después del enriquecimiento