Ingresos programáticos
Última actualización:
Lo que aprenderás
- Cómo se forma el corte mensual y cuándo se congela.
- Ejes de estado: conciliación y contabilidad.
- Flujo de factura, pago, ajuste y disputa.
- Lectura de la tabla de transacciones y del cuadre con Proof of Play.
Antes de empezar
- Rol
- Superadministrador · Administrador · Gerente · Finanzas
- Permiso
- billing.read
Ruta: /analytics/programmatic-revenue; detalle del corte en
/analytics/programmatic-revenue/{periodId} (Resumen · Transacciones · Factura y pago). Lectura:
billing.read. Factura y disputa: billing.write (finance, super_admin).
Alcance: sólo ingresos programáticos (SSP → publisher). La venta directa no pasa por este libro.
- SistemaPeriodo abiertolíneas = liquidaciones del mes local del play
- cierre de mesSistemaConciliadotodas las líneas conciliadas con su reproducción
- ready_to_invoiceUsuarioFacturael publisher sube PDF; subtotal = neto del corte (±0,01 USD)
- ShareflowRevisiónacepta o devuelve con nota
- invoiced_pending_paymentShareflowPagoparcial o total, con retenciones
Formación del corte
Sección titulada «Formación del corte»- Un periodo = un mes en la zona horaria del publisher (
Organization.Timezone). El periodo guarda su zona y sus límites UTC. - Pertenencia por
DevicePlayRecord.PlayedAt, no por la fecha de procesamiento. - Una liquidación pertenece a un único corte.
- Al enviar la factura el corte se congela. Liquidaciones posteriores entran como ajuste.
Ejes de estado
Sección titulada «Ejes de estado»| Eje | Estados |
|---|---|
| Conciliación | open → pending_reconciliation → reconciled → closed; attention con diferencias |
| Contabilidad | not_ready → ready_to_invoice → invoiced_pending_payment → partial_payment → paid; además correction_required, adjusted, payment_reversed, disputed |
Factura
Sección titulada «Factura»| Regla | Detalle |
|---|---|
| Subtotal | neto del corte; el IVA del publisher va encima |
| Moneda | USD. Chile admite CLP: GET periods/{id}/invoice-quote convierte con la tasa oficial guardada al fin del día de la factura |
| Devuelta | conserva la nota; se reenvía corregida |
| Documento | PDF (%PDF-), ≤ 15 MB, SHA-256, almacenamiento privado, descarga autenticada |
El saldo se calcula siempre en USD (PayableUsd). Un pago en la moneda de la factura se aplica a
la tasa congelada en la factura.
Pagos, ajustes y disputas
Sección titulada «Pagos, ajustes y disputas»| Evento | Efecto |
|---|---|
| Pago parcial | partial_payment; no se puede pagar más que el saldo |
| Pago reversado | el pago se conserva y deja de contar; estado payment_reversed |
| Ajuste | liquidación posterior al congelado; un corte paid pasa a adjusted |
| Disputa | cualquiera de las partes, con motivo, sobre un corte cerrado. Bloquea factura y pago. La resuelve Shareflow y el corte vuelve a su estado previo |
Cada transición genera un correo a usuarios con rol finance o super_admin (si no hay, a admin).
Transacciones
Sección titulada «Transacciones»- Una fila por liquidación: pantalla, ciudad, comprador, campaña, anunciante, OTS, CPM, bruto, fee, neto.
- Importes por fila a 4 decimales; totales, factura y pagos a 2.
DifferenceCause = rounding: diferencia < 0,005 entre bruto − fee y neto.- Orden y filtro (
sort,direction,differencesOnly) se aplican en servidor sobre el corte completo. - CPM del comprador = bruto ÷ OTS × 1000 (ponderado).
Cuadre con Proof of Play (SourceCheck)
Sección titulada «Cuadre con Proof of Play (SourceCheck)»El mismo mes contado desde la fuente: reproducciones con decisión por estado de verificación, verificadas sin liquidación, liquidaciones en otra moneda, OTS firmados vs liquidados, subastas ganadas vs reproducidas. Explica lo que no llegó al corte.