Skip to main content

​
¿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: 
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: 
{
  "success": true,
  "data": { }
}
Error: 
{
  "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. 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

Inteligencia de Titulares CBU/CVU

Totales CBU/CVU por CUIT (Argentina), ventanas contractuales y métricas incrementales custom (Com. A 8298 BCRA).

​
Documentación relacionada