Initial steps

Please use your staging account credentials to start certification scenarios.

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.​

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​

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.

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.

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.

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:

3. Single Date Update for Multiple Rates

Generate next updates for multiple rates:

4. Multiple Date Update for Multiple Rates

Generate next updates for multiple rates:

5. Min Stay Update

Generate next updates for multiple rates:

6. Stop Sell Update

Generate the next updates to enable StopSell for multiple rates:

7. Multiple Restrictions Update

Generate next updates for multiple rates:

8. Half-year Update

Generate next updates for half-year period:

9. Single Date Availability Update

Generate next updates for availability:

10. Multiple Date Availability Update

Generate next updates for availability:

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. Sign In Operation

Can you confirm that you use our sign in method sparingly and cache the access token for up to 24 hours. If you need to sign in to send each api call it will result in a fail since sign in operation is an expensive procedure.

13. Extra Notes

• Do you support both Min Stay Through and Arrival? If only one please specify which

• Do you not support any common restrictions? Stop Sell, CTA, CTD etc.

• Do you support multiple room types and multiple rate plans per room type?

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.