Concession promotions

Concession promotions allow clients to apply a promotion code to receive a special price on a concession. The promotion code should be applied at the time when the concession is added to the order. When adding more than one concession, each concession can have its own promotion code.

NB. Currently only promotions linked to Loyalty recgonitions are supported

Getting available promotion codes

When requesting concessions as a member any discounts that are available as a recognition are returned.

POST: /RESTTicketing.svc/order/concessions?userSessionId=

Response:

{
    "ConcessionItems": [
        {
            "Id": "12",
            "HeadOfficeItemCode": "A000000012",
            "Description": "Large Pop Corn",
            "DescriptionAlt": "",
            "ExtendedDescription": "",
            "ExtendedDescriptionAlt": "",
            "PriceInCents": 200,
            "DiscountsAvailable": [
                {
                    "Code": "HALFDISCL",
                    "Description": "Half Price Discount Loyalty",
                    "PriceToUseInCents": 100,
                    "IsLoyaltyOnly": true,
                    "MaxQuantity": 91,
                    "PointsCost": 0
                },
                {
                    "Code": "FULLDISCL",
                    "Description": "Full Discount Loyalty",
                    "PriceToUseInCents": 0,
                    "IsLoyaltyOnly": true,
                    "MaxQuantity": 91,
                    "PointsCost": 0
                }
            ]
        }
    ]
}

Adding a concession with a promo code

When adding a concession to the order Connect can accept PromoCode as an additional parameter for the concession.

POST: /RESTTicketing.svc/order/concessions

Request:

{
	"SessionId": "11261",
	"UserSessionId": "63129",
	"CinemaId": "0000000001",
	"Concessions": [
        {
		    "ItemId": "12",
		    "Quantity": 1,
		    "PromoCode": "HALFDISCL"
	    }
    ],
	"ReturnOrder": true
}

Response:

{
    "Order": {
        "UserSessionId": "63129",
        "CinemaId": "0000000001",
        "Concessions": [
            {
                "Id": "1",
                "ItemId": "12",
                "Quantity": 1,
                "PromoCode": "0000000012",
                "FinalPriceCents": 100
            }
        ],
		"TotalValueCents": 100
    }
}

Invalid promo code

The first invalid promotion code encountered when processing the order will cause the whole request to be aborted. The resulting error message will specify which promotion code and its associated concession caused the error.

Error Response:

{
    "ExtendedResultCode": 4,
    "Order": null,
    "Result": 4,
    "ErrorDescription": "Cannot find requested promotion code 123456 for item 72."
}