Aller au contenu

Pace — rythme quotidien de constitution de l'on-the-books forward (P3-C)

GET
/v1/reporting/pace
curl --request GET \
--url 'https://example.com/v1/reporting/pace?windowDays=14&targetToDate=2026-08-15&targetFromDate=2026-07-15&establishmentId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
--header 'X-API-Key: <X-API-Key>'

Pour chaque jour de snapshot dans la fenêtre glissante [businessDate − windowDays + 1, businessDate] (businessDate résolue serveur, ADR-00D78), additionne le net room-nights (confirmed − cancelled) des réservations dont l’arrivée tombe dans l’horizon forward [targetFromDate, targetToDate]. Un jour de snapshot sans mouvement n’apparaît pas dans le tableau (pas de zero-fill).

windowDays
required

Fenêtre glissante de constitution en jours (1-90)

string
/^\d{1,3}$/
Example
14
targetToDate
required
string format: date
Example
2026-08-15
targetFromDate
required
string format: date
Example
2026-07-15
establishmentId
required
string format: uuid

Rythme de constitution de l’on-the-books forward

Media type application/json
object
data
required
object
establishmentId
required
string format: uuid
targetFromDate
required
string format: date
targetToDate
required
string format: date
asOfDate
required

BusinessDate serveur-autoritaire, origine de la fenêtre de constitution (ADR-00D78)

string format: date
windowDays
required
integer
pace
required
Array<object>
object
snapshotDate
required
string format: date
confirmedRoomNights
required
integer
cancelledRoomNights
required
integer
netRoomNights
required

Confirmed − cancelled (peut être négatif)

integer
totalConfirmedRoomNights
required
integer
totalCancelledRoomNights
required
integer
totalNetRoomNights
required

Somme des net room-nights sur la fenêtre (peut être négatif)

integer
Example generated
{
"data": {
"establishmentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"targetFromDate": "2026-04-15",
"targetToDate": "2026-04-15",
"asOfDate": "2026-04-15",
"windowDays": 1,
"pace": [
{
"snapshotDate": "2026-04-15",
"confirmedRoomNights": 1,
"cancelledRoomNights": 1,
"netRoomNights": 1
}
],
"totalConfirmedRoomNights": 1,
"totalCancelledRoomNights": 1,
"totalNetRoomNights": 1
}
}

Non authentifié

Media type application/json
object
code
required

Code machine de l’erreur

string
message
required

Message lisible

string
origin

Origine domaine de l’erreur (optionnel)

object
boundedContext
string
module
string
status
required
integer
traceId
required

Identifiant de corrélation pour le support

string
Example
{
"code": "RESERVATION_NOT_FOUND",
"message": "Réservation introuvable",
"status": 404
}

Permission refusée ou périmètre non vérifiable

Media type application/json
object
code
required

Code machine de l’erreur

string
message
required

Message lisible

string
origin

Origine domaine de l’erreur (optionnel)

object
boundedContext
string
module
string
status
required
integer
traceId
required

Identifiant de corrélation pour le support

string
Example
{
"code": "RESERVATION_NOT_FOUND",
"message": "Réservation introuvable",
"status": 404
}