Pricing
This capability provides additional pricing details to many basic endpoints
Add octo/pricing
to your OCTO-Capabilities
header
This capability will indicate pricing for the requested product dynamically returning product pricing for each day or departure time.
The following endpoints will have pricing details added to them when the octo/pricing
capability is added to your requests. In general this includes:
Product pricing - as a list of products, or single product
Pricing checks - at the time of making an Availability call, we will confirm the price with you. Also handy for performing a price quote.
Booking - at the time of making a booking, our system will return pricing details for the booking.
NOTE: we will return pricingFrom
for each unit in each available currency.
Product Pricing
GET
https://api.zaui.io/octo/suppliers/:sid/products/:id
Returns the product(s) with pricing added to the units
Path Parameters
Name | Type | Description |
---|---|---|
id | number | The product ID |
sid | number | The supplier ID |
Pricing From Field Definitions
Field | Description |
| The original price for this product which will be the same or higher than the sale amount. |
| The sale price you should charge your customers. |
| The wholesale rate the supplier will charge you for this sale. |
| The currency. |
| We send back pricing in integers. This value indicates the currency precision so as to avoid rounding errors. For example, CAD = 2, USD = 2. eg. subtotal = subtotal / (10 ** |
| Any taxes included in the retail and/or net price. |
Product Object Additions
We have added the following changes to the Product object for pricing:
Field | Definition |
| The suppliers default currency. |
| Other currencies that the the supplier accepts. |
| How the supplier prices the requested product. ( |
UNIT
means pricing is based on each unit as defined in the Product Object. Examples: day tours, transportation, attractions, any price per unit or age band.
BOOKING
means pricing is the same regardless of number of units. Examples: charter bookings, group bookings, or ad-hoc pricing where it might be a fix price for the entire product.
Availability Calendar (Price Check)
POST
https://api.zaui.io/octo/suppliers/:sid/availability/calendar
Adding pricing to the availability calendar check will return a final quote before reserving the inventory for a booking.
Request Body
Name | Type | Description |
---|---|---|
currency | string | The ISO code for pricing |
Availability pricing (Price Check)
POST
https://api.zaui.io/octo/suppliers/:sid/availability/
Adding pricing to the availability check will return a final quote before reserving the inventory for a booking.
Request Body
Name | Type | Description |
---|---|---|
currency | string | The ISO code for pricing |
Use the /octo/suppliers/:id/availability/
call to perform simple price checks.
Booking and pricing
POST
https://api.zaui.io/octo/suppliers/:sid/bookings
The booking reservation call
Request Body
Name | Type | Description |
---|---|---|
currency | string | The ISO currency for pricing |
Last updated