Reservations
Process group
[async
] Use this operation to push a group of reservations or bookings to Mews. The operation is called Process Group because it supports multiple options for processing on multiple groups of reservations. As well as creating new reservations in Mews, you can modify existing reservations and make cancellations, all using the same endpoint. Mews will process the requests and confirm back the reservations asynchronously.
Rules to followThere are certain rules that need to be followed in order for Mews to process the group correctly:
It is required to send multiple related reservations in one group as part of one message.
The whole group is uniquely identified by
channelManagerId
in Mews and in the channel manager extranet.Each reservation should have a unique code within the group. The same code for the reservation should be provided in any following modification message.
Each reservation in the group can have different
start
,end
,spaceTypeCode
,ratePlanCode
.Group total cost
group.totalAmount
is the sum of allreservation.totalAmount
objects in the group, which is the sum of all night amounts and total amounts of allextras
of thereservation
.
If for any reason the sum of the
reservation.totalAmount
objects is different, Mews will automatically distribute the missing/additional amount to the nights, so thegroup.totalAmount
is achieved.Reservation
group
amounts should be eithergross
ornet
. Either bothgross
andnet
amounts, or one of them should be sent.When modifying some reservations from a multi-reservation group, the whole group definition with all other unchanged reservations needs to be sent, i.e. Mews doesn't process diffs.
When cancelling a reservation from a multi-reservation group, all remaining reservations need to be present in the group definition as well.
There are two ways to cancel a reservation from a multi-reservation group:
If the
reservation.state
is set to Reservation States.Cancelled
.If the reservation is not included in the group definition message.
When cancelling a whole group, the
reservations
collection can be empty of all reservations provided as cancelled (as per case 1 above).
Request
Demo Environment:
https://sandbox.pci-proxy.com/v1/push/0426f19b66715a93
Production Environment:
https://api.pci-proxy.com/v1/push/b2721c9a0351d553
The example shows a valid group definition with two space reservations plus cancellation of a third space reservation. The first reservation
definition shows all details, the second reservation
definition shows the minimal required details for creation / modification of a reservation
. The third reservation
definition shows the partial cancellation - cancelling the third space reservation.
Customer
Loyalty Info
Title
Mister
Misses
Miss
Company
Travel Agency
Contact
Payment card
Payment Card Types
Source
Source Types
Reservation
Codes: It is required that
code
remains the same within each booking modification message and partial modification message. If this can't be achieved because the channel doesn't provide it, simple generation of codes "01", "02", ... will suffice as long as those codes are generated in the same way for each message regarding that one booking.
Guest Count
Age Category Code
Infant
Child
Teenager
Adult
SeniorCitizen
Reservation States
Extra
Extra product cost
The total cost of the extra product should be sent in
amount
.
amount
can include onlygross
, onlynet
, or bothgross
andnet
.
from
andto
can define any interval within the reservation dates, but they cannot be the same date. For example, if a reservation is from 2025-10-12 to 2025-10-15, then the extrafrom
andto
cannot be specified as 2025-10-12 to 2025-10-12.
Negative amounts
The cost for an extra product can be negative, i.e. less than zero.
If a reservation night price is negative, the reservation will fail.
If extra product costs are negative, their value will be deducted from the reservation night price.
As long as the resulting reservation price (after deducting the cost of the extra products) is positive, all is well.
If the resulting reservation price (after deducting the cost of the extra products) is negative, the reservation will still pass and be processed, however this can create complications for the property and they may have to re-price it.
It is recommended to send extras per room or space, because it is less likely that the resulting reservation price will fall below zero.
Amount
Extra Pricing Types
Response
Synchronous simple response will determine whether the reservations or bookings were accepted for processing or not. Confirmation will be sent asynchronously using the Confirm booking operation.
Confirm group confirmation
Request
[PlatformAddress]/api/channelManager/v1/processGroupConfirmation
Reservation Confirmation
Response
Synchronous simple response is expected.
Last updated