Event Sales Provenance

Totales del evento, cobertura y frescura por bloque (#22)

Cabecera única de la vista de ventas del evento. eventTotals sale de la misma tabla, población, fechas y moneda que sales-provenance/summary: con iguales filtros, las dos cifras son idénticas. Importes: bruto informado por el origen, en céntimos de su moneda; el neto no se calcula (netAmountStatus: NOT_PROVIDED). Las monedas nunca se suman. Cada bloque declara su naturaleza (MEASURED, PROVIDER_REPORTED, NEVENT_CAPTURED, MIXED, NONE) y la frescura no es completitud.

freshness.warehouseBuiltAt es la construcción del almacén de la que dependen las cifras. providerSync.FEVER (solo en eventos de Fever) es el estado de la sincronización con el proveedor, leído en cada petición y separado del almacén. Se resuelve el ámbito antes que la cardinalidad y falla cerrado:

  • UNAVAILABLE (SYNC_SOURCE_OUT_OF_SCOPE, SYNC_SOURCE_AMBIGUOUS, SYNC_SOURCE_UNKNOWN, SYNC_SOURCE_UNREGISTERED o SYNC_EVIDENCE_MISSING) no lleva fechas ni contadores. Solo fechan las ejecuciones COMPLETED con evidencia fever-sync-evidence-v1, searchComplete y lossless.
  • LOAD_ERROR (SYNC_STATE_READ_ERROR) indica que MongoDB no respondió.
  • Con AVAILABLE, requestedUntil es «pedido hasta» (nunca «completo»), completeness vale siempre false y pendingRetriesKnownForEvent es un mínimo.
get/events/{eventId}/overview

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/events/{eventId}/overview
  • Auth: HTTP bearer

Path parameters

eventIdstring required

Evento; debe pertenecer al ámbito del JWT (si no, 404)

Query parameters

fromstring date required

Primer día (local de tz) de la fecha de compra, inclusivo

tostring date required

Último día (local de tz), inclusivo: el límite es el inicio del día siguiente, exclusivo

tzstring

Zona IANA. Si el cambio de hora salta la medianoche, el día empieza en su primer instante existente

currencystring

ISO 4217 (p. ej. EUR) o NONE para compras sin moneda. Sin él: un bloque por moneda, nunca sumadas

population'SETTLED_SALES' | 'REFUNDED_FULL' | 'REFUNDED_UNREPRESENTABLE' | 'ALL_REPORTED'

Siempre compras activas y nunca registros de audiencia. SETTLED_SALES = liquidadas; REFUNDED_FULL = Fever totalmente cancelada o DICE con todas sus entradas devueltas; REFUNDED_UNREPRESENTABLE = otro REFUNDED (importe devuelto desconocido); ALL_REPORTED = las anteriores más estados no reconocidos, con desglose por estado. En ALL_REPORTED el bruto incluye el bruto informado de las compras reembolsadas por completo: no es ingreso cobrado

Response

Resumen del evento

Changes

No recorded changes to this operation across all 1 revision of this API.