Métricas custom por CUIT
Referência API
Métricas custom por CUIT
Métricas incrementais CBU e CVU para um CUIT Argentina com lookback calendário 1–180 (ou preset window) — cobrança por request quando precificado.
GET
Métricas custom por CUIT
Overview
Retorna métricas densificadas de um lookback calendário: deltas, % de mudança, aceleração (quando há histórico suficiente) e completeness. Uma request cobrável por chamada bem-sucedida quando precificado. Informelookback (inteiro 1–180) ou um preset window (w_1d … w_180d). Se ambos forem enviados, lookback prevalece.
Janela
lookback=4&date=2026-07-14 → 2026-07-11 … 2026-07-14. O date está incluído.
Dias quietos podem não persistir upstream; em HTTP 200 a série já vem densa (forward-fill: totais anteriores + delta diário 0). Série plana com delta 0 = sem movimento, não “sem dado”. Avalie limiares só se complete === true.
Query
Pelo menos um delookback ou window é obrigatório.
integer
Dias calendário (1–180). Opcional se houver
window.string
Preset de lookback → dias:
string
Opcional. Fim inclusive (
YYYY-MM-DD).Sucesso (HTTP 200)
Aliases de estoque:cbuCount,cvuCount,totalAccounts— último dia densificado (windowEnd/referenceDate)cbuCountAtStart,cvuCountAtStart— primeiro dia densificado (windowStart)
data.metrics: deltas por canal e totais (totalDelta = CBU+CVU, totalPctChange sobre estoque total no início — null se start total = 0), aceleração só se accelerationAvailable. Também totalAccountsStart / totalAccountsEnd. daily[] (quando presente) tem exatamente lookbackDays linhas densas.
Como ler: não trate null em % nem HTTP 422 como “mudança 0”. Faça gate com data.complete === true.
Janela incompleta (HTTP 422)
Não foi possível densificar pelo menos um dia (falta piso, dia nãocomplete no corpus, ou sem estado incremental). Não aplicar limiares — é “dado não pronto”, não score 0.
Outros erros
Exemplo
Regras
UseholderIntelligenceLookbackDays na condição. Não é necessário adicionar metrics.complete == true: uma janela incompleta expõe as métricas como null, e o motor as avalia como non-match. Para aceleração, adicione metrics.acceleration_available == true. Em regras transacionais, data padrão: transactedAt (calendário AR).
Campos de totais: services.holder_intelligence.metrics.total_delta, total_pct_change, total_acceleration. Ver Condições de regras.