Communication schema and elements for External partner methodology
Documentation
| Step | API | Description |
|---|---|---|
1. 2. Catalog |
||
| Catalog API | GET /v2/lodgings | This is a general Catalog API for testing purpose. Following the very same syntax, a specific url is provided for each Tour Operator, In order to provide a sorted/filtered pre-selection of the properties we allow you as Tour Operator to sell on our behalf. Note: this API answer embeds lodgingLastChange/lodging and lodgingLastChange/availabilities, which allow to identify remotely, which information you need to update in your system. |
| Catalog API | GET /v2/lodgings/catalogSummary/out/{gatewayCode} | Returns the list of open property for the specified channel |
3. 4. Property/Availability/Pricing |
||
| Property API | GET /v2/lodgings/{id} | Returns all descriptive data of specified lodging (including photos/pictures urls). |
| Availability/Pricing | GET /v2/lodgings/{id}/availabilities | Returns all available stays of specified lodging. Note: as Tour Operator, the price you have to apply is "price" + property/"mandatoryServicesPrice". |
5. 6. Check availability and pricing in real time |
||
| Easy Booking API | POST /v2/bookings/easy (evaluation) | Performing booking operation, with requestType EVALUATION (authentication required), It will simply evaluate availability and proposed pricing for the deal. Answers are real time, and deals must be confirmed quickly afterward to avoid issues on step 7. 8. Using Easy Booking API for evaluation, only lodgingId, dates and number of occupants are mandatory. |
7. 8. Booking notification |
||
| Easy Booking API | POST /v2/bookings/easy | Performing booking operation, with requestType BOOKED (authentication required), A booking will be created on Poplidays system, and such booking will be considered as formally confirmed. Answers are real time, and returns the Poplidays Booking file reference. Using Easy Booking API for booking notification, most parameters are mandatory. Note: if you provide the "referenceReseller" optional parameter, our operators will be able to work with your own uid (by phone/email/etc...), We strongly encourage you to provide us your internal reference for mutual tracking purpose. |
Quality/Preproduction environment
Poplidays provides preproduction environment for testing these API(s), allowing you: catalog retrieval, information updates, real time check and booking notification full functional testing.
Please contact us for authentication and urls, at si@poplidays.com