---
title: "Totales del evento, cobertura y frescura por bloque (#22)"
method: GET
path: "/events/{eventId}/overview"
tags: ["Event Sales Provenance"]
---

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

`GET /events/{eventId}/overview`

## Request

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

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.

## Path parameters

- `eventId` string, required

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `tz` string
- `currency` string
- `population` 'SETTLED_SALES' | 'REFUNDED_FULL' | 'REFUNDED_UNREPRESENTABLE' | 'ALL_REPORTED'

## Response `200`

Resumen del evento

## Other responses

- `400`: Parámetro inválido (INVALID_DATE, INVALID_RANGE, INVALID_TZ, INVALID_CURRENCY, INVALID_POPULATION, INVALID_DIMENSION, INVALID_LEVEL, INVALID_PARENT, INVALID_KEY, INVALID_PARAM, INVALID_EVENT)
- `401`: Token ausente o inválido
- `403`: Rol sin acceso (ADMIN
- `404`: El evento no existe o no pertenece al ámbito del JWT (indistinguible)
- `500`: INVARIANT_VIOLATION (el desglose no concilia; no se devuelven cifras parciales) o INTERNAL_ERROR

---

[API](https://skmtc.dev/nevent/apis/nevent-data-api.md) · [All operations](https://skmtc.dev/nevent/apis/nevent-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nevent/apis/nevent-data-api/revisions/81035d32c1c1?raw)