Extras
Extras are up-sell items that can be added to unit items
To use this capability add
octo/extras to your Octo-Capabilities header.Extras are up-sell items that can be added to unit items. An example of an extra could be a "Lunch Package" or a "Fast Track Entrance".
get
https://api.ventrata.com/octo
/products/:id
Product Extras
Extra items must be purchased within a unit item, therefore a list of available extras will be contained within the unit object, like so:
1
{
2
// rest of the unit object
3
"extras": [
4
{
5
"id": "12d7eb39-da3b-4b09-ac3d-a2e55f12e4a4",
6
"internalName": "Fast Track Entrance",
7
"title": "Fast Track Entrance",
8
"description": "Skip the queue and get to the front of the line saving as much as 2 hours.",
9
"reference": "FAST-123",
10
"restrictions": {
11
"minQuantity": 1,
12
"maxQuantity": 1
13
},
14
"pricingFrom": [
15
{
16
"original": 800,
17
"retail": 600,
18
"net": 450,
19
"currency": "USD",
20
"currencyPrecision": 2,
21
"includedTaxes": []
22
}
23
]
24
}
25
]
26
}
Copied!
The example above includes the
octo/pricing and octo/content capabilities which will add the pricing and pricingFrom keys to the response. The values will be identical to the pricing fields on unit so read the documentation on the pricing capability to learn more.Field
Description
idThe ID of the extra
internalNameThe internal name of the extra
titleThe public title of the extra.
This is provided by the
octo/content capability.descriptionThe public description of the extra.
This is provided by the
octo/content capability.referenceThe internal reference/SKU
restrictions.minQuantityThe minimum quantity that can be bought of this extra per unit item.
restrictions.maxQuantityThe maximum quantity that can be bought of this extra per unit item.
If this value is 1 then it can only be bought once per unit item.
pricingFrom / pricingThese fields come from the
octo/pricing capability. Read the documentation on the pricing capability to learn what these fields mean.Extras don't require vacancies and aren't affected by availability, so any extra you see on the product can be purchased without needing to check availability.
post
https://api.ventrata.com/octo
/bookings
Booking Reservation
1
{
2
//..rest of the unit item object
3
"extraItems": [
4
{
5
"uuid": "6f5364b4-f29e-4b17-8544-679ee643a606",
6
"extraId": "12d7eb39-da3b-4b09-ac3d-a2e55f12e4a4",
7
"resellerReference": "TEST-31242"
8
}
9
]
10
}
Copied!
The
uuid and resellerReference fields are optional and you can include as many extras (even the same extra more than once - if it's allowed) to the unit item.The unit item object will contain the
extraItems array which will look like this:1
{
2
// The rest of the unit item object
3
"extraItems": [
4
{
5
"uuid": "6f5364b4-f29e-4b17-8544-679ee643a606",
6
"resellerReference": "TEST-31242",
7
"supplierReference": "G7PCF6",
8
"extraId": "12d7eb39-da3b-4b09-ac3d-a2e55f12e4a4",
9
"extra": {
10
"id": "12d7eb39-da3b-4b09-ac3d-a2e55f12e4a4",
11
"internalName": "Fast Track Entrance",
12
"title": "Fast Track Entrance",
13
"description": "Skip the queue and get to the front of the line saving as much as 2 hours.",
14
"reference": "FAST-123",
15
"restrictions": {
16
"minQuantity": 1,
17
"maxQuantity": 1
18
}
19
},
20
"pricing": {
21
"original": 800,
22
"retail": 600,
23
"net": 450,
24
"currency": "USD",
25
"currencyPrecision": 2,
26
"includedTaxes": []
27
}
28
}
29
]
30
}
Copied!
When using the
octo/pricing capability, the pricing of the unit item will always include the sum of the extra items that it has.Last modified 5mo ago
Copy link