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

# Servicios Marketplace — Overview

> APIs HTTP con alcance de organización para integraciones marketplace tipo service en Gu1 — productos on-demand con cobro por request cuando tienen precio.

## ¿Qué son los servicios marketplace?

Los **servicios marketplace** (`integration_type = service`) son productos del catálogo que exponen **endpoints HTTP dedicados** en el contexto de tu organización. A diferencia de los enrichments (que enriquecen el perfil de una entidad), los servicios responden **consultas puntuales** que invocás desde tu integración u orquestación.

Gu1 actúa como **proxy multi-tenant**: autenticás con la misma API key o sesión que el resto de la plataforma; Gu1 resuelve `organizationId`, verifica que el producto esté **activo para tu org**, aplica billing cuando corresponde y devuelve un envelope JSON normalizado.

## Path base

Todos los servicios comparten este prefijo:

```
GET https://api.gu1.ai/api/integration-services/{integrationCode}/...
```

Reemplazá `{integrationCode}` por el código de catálogo (por ejemplo `ar_gueno_holder_intelligence_service`).

## Autenticación

Igual que el resto de la API Gu1:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Las llamadas desde el dashboard con sesión también están soportadas para la consola; los integradores suelen usar API keys.

## Activación

La organización debe **habilitar** la integración en Marketplace (mismo flujo que enrichments y listas). Si no está activa, las rutas de pago pueden devolver errores de billing o configuración como en otros productos marketplace.

## Envelope de respuesta

Éxito:

```json theme={null}
{
  "success": true,
  "data": { }
}
```

Error:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Mensaje legible"
  }
}
```

Algunos endpoints (por ejemplo métricas con ventana incremental incompleta) pueden incluir un `data` parcial junto con `success: false` y HTTP `422`.

## Cobro

* **Endpoints gratuitos** (health, exists) no consumen pack ni créditos.
* **Endpoints cobrables** facturan **una unidad por request exitoso** cuando `base_price_cents > 0`, con el mismo modelo de pack/créditos que enrichments.
* Errores de validación (`400`) o CUIT ausente (`404`) en general no se cobran; indisponibilidad upstream (`503`) tampoco.

## Auditoría

Cada llamada se registra para la org (operation key, HTTP status, error code si aplica). El CUIT del path **nunca** se persiste en claro en metadata de auditoría.

## Motor de reglas

Varios servicios exponen campos bajo `services.{serviceKey}.*` en [Condiciones de reglas](/es/api-reference/rules/conditions). Cuando una regla referencia esos paths, Gu1 puede **hidratar** el servicio durante la ejecución (distinto de la llamada HTTP directa). Ver el overview de cada servicio.

## Servicios disponibles

<CardGroup cols={2}>
  <Card title="Inteligencia de Titulares CBU/CVU" icon="building-columns" href="/es/api-reference/services/ar-gueno-holder-intelligence/overview">
    Totales CBU/CVU por CUIT (Argentina), ventanas contractuales y métricas incrementales custom (Com. A 8298 BCRA).
  </Card>
</CardGroup>

## Documentación relacionada

* [Códigos de integración](/es/api-reference/integrations/provider-codes) — catálogo completo (enrichments, servicios, listas)
* [Overview de enrichment](/es/api-reference/enrichment/overview)
* [Autenticación](/es/api-reference/authentication)