Overview
Código de integração:ar_gueno_holder_intelligence_service
Este serviço marketplace do Gu1 consulta o corpus interno de titulares (CUIT/CUIL Argentina, 11 dígitos) para:
- Verificar pertencimento ao corpus processado
- Totais atuais de contas CBU e CVU
- Janelas contratuais (
w_1d…w_180d) - Métricas incrementais custom com lookback calendário (1–180 dias)
Path base
Parâmetro de path: CUIT
Todas as rotas/cuits/:cuit/... exigem 11 dígitos, sem hífens.
Endpoints
| Endpoint | Cobrança | Descrição |
|---|---|---|
| Health | Não | Disponibilidade e frescor do corpus |
| Exists | Não | Pertencimento (found) |
| Accounts count | Por request se priced | Totais CBU/CVU |
| Windows | Por request se priced | Janelas w_1d–w_180d |
| Metrics | Por request se priced | Métricas com lookback custom |
Códigos de erro comuns
| Código | HTTP | Significado |
|---|---|---|
CUIT_NOT_FOUND | 404 | CUIT ausente do corpus |
SERVICE_UNAVAILABLE | 503 | Backend indisponível |
INSUFFICIENT_BALANCE | 402 | Créditos ou pack esgotados |
INVALID_WINDOW | 400 | Query window inválida |
INVALID_LOOKBACK | 400 | Query lookback inválida (1–180) |
INVALID_DATE | 400 | Query date inválida |
INCOMPLETE_WINDOW | 422 | Janela incremental incompleta |
NO_INCREMENTAL_STATE | 422 | Sem estado incremental |
INTERNAL_ERROR | 500 | Erro interno |
Motor de regras
Paths comoservices.holder_intelligence.cbu_quantity e originEntityData.services.holder_intelligence.metrics.*. Ver Condições de regras.
Em regras transacionais, a data de referência padrão é transactedAt (calendário AR). Configure holderIntelligenceLookbackDays (1–180) em cada condição de métricas.