{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Item delivery fees","description":"API documentation for the Vista Cloud APIs","siteUrl":"https://developer.vista.co","keywords":"Vista for Developers, Vista, Vista Group, API, API documentation, API docs","lang":"en-NZ"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"item-delivery-fees","__idx":0},"children":["Item delivery fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An item delivery fee is a calculated additional cost added on to item purchases."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Item delivery fees can be calculated as either:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fixed fee per delivery (e.g., $1 per delivery)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Percentage fee per delivery (e.g., 10% of the total item price of a delivery)."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Item delivery fees can vary by delivery method, cinema, and client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In-seat item delivery fees can also vary by cinema operator."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Item delivery fees are supported for the following delivery methods:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Counter pickup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom location delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In-seat delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Service area pickup"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For more information on item delivery fee configuration on the Digital Platform, please contact your Vista"," ","representative."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"item-delivery-fees-for-an-order","__idx":1},"children":["Item delivery fees for an order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Item delivery fees are calculated whenever items are set against an order using the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/digital-platform/openapi/items/ocapiorderitems_setitems/"},"children":["SetItems"]}," endpoint, and when relevant item prices are recalculated."," ","The order includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalItemDeliveryFee"]}," property that represents the total item delivery fee the patron is required to pay."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each delivery within the order also has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]}," property that represents the item delivery fee for the"," ","individual delivery (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if the delivery does not incur an item delivery fee)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": {\n    \"id\": \"4c5910d17fcc45e1baad99c19b89a9bb\",\n    \"type\": \"Standard\",\n    \"status\": \"InProgress\",\n    \"totalPrice\": {\n      \"valueIncludingTax\": 5.74,\n      \"valueExcludingTax\": 4.95,\n      \"tax\": 0.79\n    },\n    \"items\": [\n      {\n        \"deliveryId\": \"1111\",\n        \"itemId\": \"0002-46\",\n        \"id\": \"34ce31f5-7bb0-492f-9cf7-4914caa272e2\",\n        \"type\": \"Normal\",\n        \"price\": {\n          \"valueIncludingTax\": 5.22,\n          \"valueExcludingTax\": 4.5,\n          \"tax\": 0.72\n        }\n      }\n    ],\n    \"itemDeliveries\": [\n      {\n        \"locationName\": \"Table 1\",\n        \"schedule\": {\n          \"type\": \"Immediate\"\n        },\n        \"method\": \"CustomLocationDelivery\",\n        \"comment\": null,\n        \"fee\": {\n          \"id\": \"1\",\n          \"amount\": {\n            \"valueIncludingTax\": 1.04,\n            \"valueExcludingTax\": 0.9,\n            \"tax\": 0.14\n          },\n          \"refundStatus\": \"NotRefunded\",\n          \"refundAvailability\": {\n            \"isAvailable\": false,\n            \"unavailableReason\": \"OrderNotCompleted\"\n          }\n        },\n        \"id\": \"1111\"\n      }\n    ],\n    \"totalItemDeliveryFee\": {\n      \"valueIncludingTax\": 1.04,\n      \"valueExcludingTax\": 0.9,\n      \"tax\": 0.14\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"item-delivery-fees-for-showtimes","__idx":2},"children":["Item delivery fees for showtimes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In-seat item delivery fees are also returned by the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/digital-platform/openapi/showtimes/ocapishowtimes_getshowtime/"},"children":["GetShowtime"]}," endpoint. This is essential for"," ","clients that wish to display the item delivery fee value during item selection, before the items have been ordered."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"showtime\": {\n    \"id\": \"0002-3083\",\n    \"inSeatItemDeliveryFee\": {\n      \"type\": \"Percentage\",\n      \"percentage\": 5.5,\n      \"salesTaxId\": \"0002-0000000002\"\n    }\n  },\n  \"relatedData\": {\n    \"salesTaxes\": [\n      {\n        \"id\": \"0002-0000000002\",\n        \"level1\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 15.0\n        },\n        \"level2\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        },\n        \"level3\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        },\n        \"level4\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because the price and tax of a percentage item delivery fee are not known until after item selection,"," ","the client is provided with the information needed to calculate the fee price and tax."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"item-delivery-fees-for-sites","__idx":3},"children":["Item delivery fees for sites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Item delivery fees are also returned by the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/digital-platform/openapi/items/ocapiitemprofiles_getitemprofileforsite/"},"children":["GetItemProfileForSite"]}," endpoint. This is essential for"," ","clients that wish to display the item delivery fee value during item selection, before the items have been ordered."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"itemProfile\": {\n    \"siteId\": \"0002\",\n    \"customLocationItemDeliveryFee\": {\n      \"type\": \"Percentage\",\n      \"percentage\": 10.0,\n      \"salesTaxId\": \"0002-0000000002\"\n    },\n    \"counterItemPickupFee\": {\n      \"type\": \"Percentage\",\n      \"percentage\": 5.25,\n      \"salesTaxId\": \"0002-0000000002\"\n    },\n    \"serviceAreaItemPickupFee\": {\n      \"type\": \"FixedPrice\",\n      \"price\": {\n        \"valueIncludingTax\": 1.0,\n        \"valueExcludingTax\": 0.85,\n        \"tax\": 0.15\n      }\n    }\n  },\n  \"relatedData\": {\n    \"salesTaxes\": [\n      {\n        \"id\": \"0002-0000000002\",\n        \"level1\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 15.0\n        },\n        \"level2\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        },\n        \"level3\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        },\n        \"level4\": {\n          \"type\": \"Percentage\",\n          \"percentage\": 0.0\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because the price and tax of a percentage item delivery fee are not known until after item selection,"," ","the client is provided with the information needed to calculate the fee price and tax."]}]},"headings":[{"value":"Item delivery fees","id":"item-delivery-fees","depth":1},{"value":"Item delivery fees for an order","id":"item-delivery-fees-for-an-order","depth":2},{"value":"Item delivery fees for showtimes","id":"item-delivery-fees-for-showtimes","depth":2},{"value":"Item delivery fees for sites","id":"item-delivery-fees-for-sites","depth":2}],"frontmatter":{"seo":{"title":"Item delivery fees"}},"lastModified":"2026-09-16T22:52:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/digital-platform/orders/standard-orders/item-delivery-fees","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}