Overview
Código de integración: ar_gueno_holder_intelligence_service
Este servicio marketplace de Gu1 consulta el corpus interno de titulares (CUIT/CUIL Argentina, 11 dígitos) para:
- Verificar pertenencia al corpus procesado
- Totales actuales de cuentas CBU y CVU
- Ventanas contractuales (
w_1d … w_180d) con deltas y varianza
- Métricas incrementales custom con lookback calendario (1–180 días), % cambio y aceleración
Gu1 actúa como proxy; los integradores no llaman holder-score directamente.
Contexto regulatorio: alineado a Com. «A» 8298 BCRA (totalizadores / AML-CFT). La activación puede depender de elegibilidad de la org.
Path base
https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service
Parámetro de path: CUIT
Todas las rutas /cuits/:cuit/... exigen 11 dígitos exactos, sin guiones.
Endpoints
| Endpoint | Cobro | Descripción |
|---|
| Health | No | Disponibilidad y frescura del corpus |
| Exists | No | Pertenencia (found true/false) |
| Accounts count | Por request si priced | Totales CBU/CVU + metadata |
| Windows | Por request si priced | Ventanas w_1d–w_180d |
| Metrics | Por request si priced | Métricas con lookback custom |
Códigos de error comunes
| Código | HTTP | Significado |
|---|
CUIT_NOT_FOUND | 404 | CUIT ausente del corpus (rutas de pago) |
SERVICE_UNAVAILABLE | 503 | Backend de titulares caído o no configurado |
INSUFFICIENT_BALANCE | 402 | Créditos o pack agotados |
INVALID_WINDOW | 400 | Query window inválido |
INVALID_LOOKBACK | 400 | Query lookback inválido (1–180) |
INVALID_DATE | 400 | Query date inválido (YYYY-MM-DD) |
INCOMPLETE_WINDOW | 422 | Ventana incremental incompleta |
NO_INCREMENTAL_STATE | 422 | Sin estado incremental para el CUIT |
INTERNAL_ERROR | 500 | Error interno |
Motor de reglas
Paths de condición, por ejemplo:
services.holder_intelligence.cbu_quantityoriginEntityData.services.holder_intelligence.metrics.cbu_acceleration
Lista completa en Condiciones de reglas.
En reglas transaccionales, las métricas usan por defecto la fecha calendario AR de transactedAt. Configurá holderIntelligenceLookbackDays (1–180) en cada condición de métricas.
Relacionado
