When ordering items, the client may also indicate when and where the items should be delivered. This is done by providing one or more itemDeliveries and assigning them to individual items.
The following item delivery methods are supported:
- In-seat delivery - items are delivered to a seat during a showtime.
- Custom location delivery - items are immediately delivered to a custom location (e.g., a table).
- Electronic delivery - items are delivered electronically (e.g., a digital voucher or gift card).
- Service area pickup - items are delivered to a service area for pickup by the patron.
- Counter pickup - items are picked up from POS by the patron.
Clients must inspect the allowedDeliveryMethods property of an item to determine which delivery methods are available.
Available delivery methods are limited based on whether an item requires preparation.
When creating an in-seat item delivery, the showtimeId and seats properties must be provided. These details are typically sourced from:
- Showtimes within in-progress ticket orders.
- Completed orders that contains tickets or in-seat deliveries.
- QR codes displayed at physical seats.
In-seat deliveries can be prepared immediately via the Immediate schedule or at a specific time via the ShowtimeDeliveryWindow schedule.
When specifying an ShowtimeDeliveryWindow preparation schedule, the showtimeDeliveryWindowId must be provided.
Use the GetItemProfileForSite endpoint to get the available showtime delivery windows for a site.
{
"itemProfile": {
"siteId": "0000000003",
"itemShowtimeDeliveryWindows": [
{
"minutes": 10,
"type": "MinutesFromStart",
"id": "0000000003-FirstService",
"name": {
"text": "First Service - 10 mins"
}
},
{
"minutes": 45,
"type": "MinutesFromStart",
"id": "0000000003-SecondService",
"name": {
"text": "Second Service - 45 mins"
}
}
]
}
}Some properties have been omitted from the code snippet above for brevity.
When creating a postal delivery, the postalDeliveryMethodId property must be provided, to indicate which delivery method to use, e.g. standard vs express shipping. Delivery methods supported by the gift shop can be sourced from the gift shop item profile.
{
"itemProfile": {
"itemPostalDeliveryMethods": [
{
"id": "1002-0000000001",
"name": {
"text": "1 Day Courier",
"translations": []
},
"isDefault": true,
"deliveryFee": {
"type": "FixedPrice",
"price": {
"valueIncludingTax": 10.0,
"valueExcludingTax": 8.64,
"tax": 0.86
}
}
},
{
"id": "1002-0000000002",
"name": {
"text": "3 Day Courier",
"translations": []
},
"isDefault": false,
"deliveryFee": {
"type": "FixedPrice",
"price": {
"valueIncludingTax": 5.0,
"valueExcludingTax": 4.33,
"tax": 0.43
}
}
}
]
}
}
Customer postal address details must be set via the SetCustomer endpoint after creating the postal delivery.
Postal deliveries do not support scheduled delivery.
Postal deliveries are only available for gift shop orders and are limited to one postal delivery per order.
When creating a service area pickup, no additional information is required as the service areas are back-end configuration and cannot be defined by the client.
The schedule of a service area pickup can be set to Immediate or OnRequest.
Items that require preparation and have no delivery assigned by the client will be assigned a ServiceAreaPickup delivery with the OnRequest schedule.
For convenience, the serviceAreaPickupSchedule request property on the SetItems endpoint can be used to control which type of schedule will be applied to default service area pick up deliveries.
{
"items": [
{
"itemId": "0002-001"
},
{
"itemId": "0002-002"
}
],
"serviceAreaPickupSchedule": {
"type": "Immediate"
}
}Note that the serviceAreaPickupSchedule request property is only applicable for Standard Orders.
Item deliveries that require preparation allow for comments to be provided. Delivery comments can be used to offer free-text additional requests that go beyond system-defined item modifiers and options.
Item deliveries with an OnRequest schedule require the patron to request preparation after the order has been completed.
See item delivery preparation for more info.