PMS Certification Tests

Initial steps
Please use your staging account credentials to start certification scenarios. 
Please let us know the email and password for your staging account in the document
Follow Best Practices
We have prepared a list of best practices for integration with Channex Please, read this document and follow provided scenarios at your integration.
​Channex.io Best Practices Guide.​
If your app doesn't support something please just mention you do not support it and move to the next test.
Example: You don't support stop sell so ignore the test for stop sell.
Setup Mapping
For test scenario please prepare a new property for testing. This account contains:
Property Name “Test Property - (Provider Name)”
Test Currency: USD
Create two Room Types
Twin Room - 2 Occupancy
Double Room - 2 Occupancy
Create four Rate Plans combinations
Twin Room
Best Available Rate - Default rate 100
Bed & Breakfast Rate - Default rate 120
Double Room
Best Available Rate - Default rate 100
Bed & Breakfast Rate - Default Rate 120
Please, use our API to fetch ID’s for provided entities.
Property API - https://docs.channex.io/api-v.1-documentation/hotels-collection#properties-list​
Room Type API - https://docs.channex.io/api-v.1-documentation/room-types-collection#room-types-list​
Rate Plans API - https://docs.channex.io/api-v.1-documentation/rate-plans-collection#rate-plans-list​
Setup mapping between your system and Channex​
If possible can you show screenshot of your mapping screen to the test property.
Prepare your tests
Please, prepare a document with the result of your tests using the following template:
Test Case Number
List of called API endpoints
UTC Timestamps for each call in test case
id value from response payload for each call in test case
If some test case is not applicable for your integration, please let us know in the document.
You will receive a task ID in a successful response from Channex.
Execute test scenarios
1. Full Data Update (Full Sync)
We require a “Full Sync” this would simulate what happens when a Hotel goes “Live” with your integration on our Production Environment. 
Full sync means you should send 500 days of Availability, rates and restrictions for all rooms and rates on the property.
We expect the full sync to be 2 API calls:
1 x 500 days for Availability (All Rooms)
1 x 500 days Rates & restrictions (All Rates)
To make sure this is correctly sent in order to certify, the data on the “Test Property” should be similar to that of a Live Hotel with different inventory/rate/restriction values for multiple days of the year. If you are unsure of how to set this up, please let us know so we can advise further.
We don't want to see a full sync with all rooms with 1 availability and 100 USD as example. Better the availability and prices are different like a real hotel.
Once you have sent the “Full Sync”, please attach the returned id(s) generated by our side.
The ID you can find at the response from our side:1 2 3 4 5 6 7 8 9 10 11 { "data": [ { "id": "03854d5e-5234-43e9-b673-803e91bfe640", "type": "task" } ], "meta": { "message": "Success" } }
2. Single Date Update for Single Rate
Generate next updates for single rate:
Room Type
Rate Plan
Date
Value
Twin Room
Best Available Rate
22 November 2022
333$
3. Single Date Update for Multiple Rates
Generate next updates for multiple rates:
Room Type
Rate Plan
Date
Value
Twin Room
Best Available Rate
21 November 2022
333$
Double Room
Best Available Rate
25 November 2022
444$
Double Room
Bed & Breakfast
29 November 2022
456.23$
This should be 1 API call with multiple updates inside
4. Multiple Date Update for Multiple Rates
Generate next updates for multiple rates:
Room Type
Rate Plan
Date
Value
Twin Room
Best Available Rate
01 November 2022 to 10 November 2022
241$
Double Room
Best Available Rate
10 November 2022 to 16 November 2022
312.66$
Double Room
Bed & Breakfast
01 November 2022 to 20 November 2022
111$
This should be 1 API call with multiple details inside
5. Min Stay Update
Generate next updates for multiple rates:
Room Type
Rate Plan
Date
Min Stay Value
Twin Room
Best Available Rate
23 November 2022
3
Double Room
Best Available Rate
25 November 2022
2
Double Room
Bed & Breakfast
15 November 2022
5
This should be 1 API call
6. Stop Sell Update
Generate the next updates to enable StopSell for multiple rates:
Room Type
Rate Plan
Date
Stop Sell
Twin Room
Best Available Rate
14 November 2022
true
Double Room
Best Available Rate
16 November 2022
true
Double Room
Bed & Breakfast
20 November 2022
true
This should be 1 API call
7. Multiple Restrictions Update
Generate next updates for multiple rates:
Room Type
Rate Plan
Date
Restrictions
Twin Room
Best Available Rate
01 November 2022 to 10 November 2022
closed_to_arrival: true,
closed_to_departure: false,
max_stay: 4,
min_stay: 1
Twin Room
Bed & Breakfast
12 November 2022 to 16 November 2022
closed_to_arrival: false,
closed_to_departure: true,
min_stay: 6
Double Room
Best Available Rate
10 November 2022 to 16 November 2022
closed_to_arrival: true,
min_stay: 2
Double Room
Bed & Breakfast
01 November 2022 to 20 November 2022
min_stay: 10
This should be 1 API call
8. Half-year Update
Generate next updates for half-year period:
Room Type
Rate Plan
Date
Restrictions
Twin Room
Best Available Rate
01 December 2022 to 01 May 2023
rate: 432$
closed_to_arrival: false,
closed_to_departure: false,
min_stay: 2
Double Room
Best Available Rate
01 December 2022 to 01 May 2023
rate: 342$
min_stay: 3
This should be 1 API call
9. Single Date Availability Update
Generate next updates for availability:
Room Type
Date
Value
Twin Room
21 November 2022
7
Double Room
25 November 2022
0
This should be 1 API call
10. Multiple Date Availability Update
Generate next updates for availability:
Room Type
Date
Value
Twin Room
10 November 2022 - 16 November 2022
3
Double Room
17 November 2022 - 24 November 2022
4
This should be 1 API call
11. Booking receiving
Using our Booking API (https://docs.channex.io/api-v.1-documentation/bookings-collection#create-booking) create booking at Channex and receive it at your Property Management system.
Or use our booking tool to create the booking: https://booking.channex.io/​
For both you need to make a “Booking Engine” channel active on a property.
1.Get booking by using the feed API: https://docs.channex.io/api-v.1-documentation/bookings-collection#booking-revisions-feed​
2.Make sure the booking is "acknowledged" by using the ack API: https://docs.channex.io/api-v.1-documentation/bookings-collection#acknowledge-booking-revision-receiving​
3.Provide us an image about the created booking of how it looks in your system.
12. Use API Key Method
Can you confirm that you use our API Key method: https://docs.channex.io/api-v.1-documentation/api-key-access​
Sign in with email/pass will be discontinued and will be protected by 2-factor authentication.
13. Rate Limits
Please look at proposed rate limits and make sure you have a queue or limiter to not spam our API endpoints. Let us know you can work with these limits
​https://docs.channex.io/api-v.1-documentation/rate-limits-coming-soon​
Can you stay in rate limits?
14. Update Logic
We will not accept any logic that just sends full sync on a timer basis
Example: Each 5 mins you send full update of availability for all rooms for 2 years.
We require partners to only send changes to availability and prices.
Full sync is allowed once every 24h if required but please schedule this on off peak hours and try to give some seconds between each property updates if you have a lot of properties to full sync.
Do you agree to only send updated changes to Channex?
13. Extra Notes
Do you support both Min Stay Through and Arrival? If only one please specify which
Do you not support the following restrictions? Stop Sell, CTA, CTD etc. Let us know if you don't support any
Do you support multiple room types and multiple rate plans per room type?
Do you need credit card details with bookings?
Are you PCI Certified or use a PCI service like Channex PCI or PCI Booking/Tokenex?
Collect results
When you finish your tests, collect all information together in a word or excel doc and provide it to us via email: [email protected]​
In some cases we may require you to update your integration to be more efficient, if all is ok the certification should be successful and we will get back to you with the next steps for production server.

FOR PMS - Previous

Channel IFrame

Next - Guides

PMS Integration Guide

Last modified 6mo ago