[async] This operation allows Mews to push a group of reservations or bookings to the Channel Manager.
The operation supports creations, modifications, and partial or complete cancellations. Confirmation is done asynchronously.
[ChannelManagerApiAddress]/processGroup
{
"clientToken": "[Channel manager client token]",
"connectionToken": "[Token of a concrete connection]",
"messageId": "66511e1d-2405-4e49-914b-b0c800d802c9",
"responseUrl": "https://api.mews-demo.com/api/channelManager/v1/processGroupConfirmation",
"channelId": "EXP-123456",
"channelManagerId": "123456",
"availabilityBlockCode": "Channel-manager-Wedding123",
"availabilityBlockConfirmationNumber": "Mews-Wedding123",
"comments": [
"Approximate arrival: 16:30.",
"Guest request a room with ocean view."
],
"currencyCode": "EUR",
"customer": {
"address": {
"addressLine1": "Some street 123",
"addressLine2": "Some other detail",
"city": "Some city",
"country": "US",
"latitude": 30,
"longitude": 20,
"region": "Some region",
"zip": "123 45"
},
"email": "[email protected]",
"firstName": "John",
"lastName": "Smith",
"title": "Mister",
"nationalityCode": "US",
"languageCode": "en-US",
"telephone": "1-3526-88918",
"loyaltyCode": "PG60972345",
"loyaltyInfo": {
"membershipId": "PG60972345",
"programCode": "BWR",
"tierCode": "Gold"
}
},
"sources": [
{
"code": 1,
"name": "Expedia",
"type" : 0,
"isPrimary" true
},
{
"code": 2,
"name": "ChoiceCRS",
"type" : 0,
"isPrimary" false
}
],
"company": {
"id": "MEWS",
"name": "Mews Systems, s.r.o.",
"contact": {
"email": "[email protected]",
"phone": "+420 775 684 983",
"address": {
"zip": "110 00",
"city": "Prague",
"country": "Czech Republic",
"addressLine1": "586 Ulice Test",
"addressLine2": "Patro 2"
}
}
},
"travelAgency": {
"iata": "65553",
"name": "Best Travel Agency, s.r.o",
"contact": {
"email": "[email protected]",
"phone": "+420 775 775 775",
"address": {
"zip": "132 45",
"addressLine1": "Some other street 123",
"addressLine2": "Some other detail",
"city": "Some other city",
"country": "US"
}
}
},
"reservations": [
{
"guestCounts": [
{
"code": "Adult",
"count": 1
}
],
"code": "01",
"extras": [
{
"code": "1",
"count": 1,
"amount": {
"net": 16.2,
"gross": 20
},
"from": "2021-05-06",
"to": "2021-05-07",
"pricing": 3
}
],
"from": "2020-05-05",
"guests": [
{
"address": {
"addressLine1": "Some other street 123",
"addressLine2": "Some other detail",
"city": "Some other city",
"country": "US",
"latitude": 30,
"longitude": 20,
"region": "Some other region",
"zip": "123 45"
},
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Smith",
"title": "Misses",
"nationalityCode": "US",
"languageCode": "en-US",
"telephone": "1-369-81891"
}
],
"amounts": [
{
"net": 81,
"gross": 100
},
{
"net": 97.2,
"gross": 120
},
],
"ratePlanCode": "FF",
"spaceTypeCode": "SGL",
"state": 1,
"to": "2020-05-07",
"totalAmount": {
"gross": 260,
"net": 208
}
},
{
"guestCounts": [
{
"code": "Adult",
"count": 2
}
],
"code": "02",
"from": "2020-05-06",
"amounts": [
{
"net": 81,
"gross": 100
},
{
"net": 97.2,
"gross": 120
},
{
"net": 97.2,
"gross": 120
}
],
"ratePlanCode": "NR",
"spaceTypeCode": "DBL",
"state": 2,
"timeState": 1,
"to": "2020-05-09",
"totalAmount": {
"net": 275.4,
"gross": 340
}
},
{
"guestCounts": [
{
"code": "Adult",
"count": 2
}
],
"code": "03",
"from": "2020-05-06",
"ratePlanCode": "FF",
"spaceTypeCode": "DBL",
"state": 3,
"to": "2020-05-09"
},
"paymentCardData": {
"identifier": "12345678-1011-1213-1415-161718192021"
"expireDate": "1222",
"holderName": "John Smith",
"obfuscatedNumber": "41111*******1111",
"type": 1
}
],
"totalAmount": {
"net": 486,
"gross": 600
}
}| Property | Type | Contract | Description |
|---|---|---|---|
clientToken |
string |
required (always) | Client token of the channel manager. |
connectionToken |
string |
required (always) | Token of a concrete connection. |
messageId |
string |
required | Unique identification of the message. Used for asynchronous confirmations |
responseUrl |
string |
required (always) | Url which should be used for asynchronous confirmation. |
channelId |
string |
optional | Unique identification of the booking in the channel (i.e. OTA). Sent always once provided by channel manager. |
channelManagerId |
string |
optional | Unique identification of the booking in the channel manager. Sent always once provided by channel manager. |
availabilityBlockCode |
string |
optional | Unique identification of the availability block in the channel manager. |
availabilityBlockConfirmationNumber |
string |
optional | Unique identification of the availability block in the Mews. |
currencyCode |
string |
required (exc. Cancellation) | ISO-4217 three-letter currency code of all prices within the booking. |
totalAmount |
Amount object |
required (exc. Cancellation) | Total amount of the whole booking. |
customer |
Customer object |
required (exc. Cancellation) | Represents the main booker. Does not necessarily mean that the person arrives to the property. |
sources |
Source collection |
optional | Represents the sources for the booking. |
company |
Company object |
optional | Represents the company associated with the booking. |
travelAgency |
Travel Agency object |
optional | Represents the travel agency associated with the booking. |
reservations |
Reservation collection |
optional | Each reservation within the booking. If the value is null or an empty collection, this implies that the whole group will be cancelled. |
comments |
string collection |
optional | Represents any comments related to the booking. |
This method is used when Mews confirms a booking sent via Process group. It is used to send confirmation of success as well as confirmation of failure.
[ChannelManagerApiAddress]/confirmGroup
{
"clientToken": "[Mews Client token]",
"connectionToken": "[Token of a concrete connection]",
"relatedMessageId": "MyWeddingMessage789456123",
"channelManagerId": "123456",
"reservations": [
{
"code": "01",
"confirmationNumber": "PMS-001"
}
]
}{
"clientToken": "[Mews Client token]",
"connectionToken": "[Token of a concrete connection]",
"relatedMessageId": "MyWeddingMessage789456123",
"channelManagerId": "123456",
"error": {
"code": 4,
"message": "There is no space type with mapping code 'ST'."
}
}| Property | Type | Contract | Description |
|---|---|---|---|
clientToken |
string |
required | Client token of the channel manager. |
connectionToken |
string |
required | Connection token of a property connection. |
relatedMessageId |
string |
required | Id of message which requests relates to. |
channelManagerId |
string |
required | Channel Manager booking reference. |
error |
Error |
optional | In case of processing failure, this provides a description of the error. |
reservations |
Reservation Confirmation collection |
optional | Confirmation details for each individual reservation in the group. |
| Property | Type | Contract | Description |
|---|---|---|---|
code |
string |
required | Unique reference code for the individual reservation. |
confirmationNumber |
string |
required | Mews confirmation number for the individual reservation. |
Simple response is expected to determine whether the update was accepted or not.