Ir al contenido

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.

  1. SistemaPeriodo abiertolíneas = liquidaciones del mes local del play
  2. cierre de mes
    SistemaConciliadotodas las líneas conciliadas con su reproducción
  3. ready_to_invoice
    UsuarioFacturael publisher sube PDF; subtotal = neto del corte (±0,01 USD)
  4. ShareflowRevisiónacepta o devuelve con nota
  5. invoiced_pending_payment
    ShareflowPagoparcial o total, con retenciones
Ciclo de un corte mensual.
  • 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.
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
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.

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).

  • 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).

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.