Tax

In Connect, prices for tickets, concessions, booking fees and any other items are inclusive of tax.

Retrieving tax for reference data

Tax values for tickets and concessions can be retrieved using the following endpoints:

• GetTicketsForSession
• GetConcessions
• GetConcessionsGroupedByTabs

These values can be used to calculate the total tax for an order before the order is created. However, this tax should be considered an estimated amount only, as rounding differences may result in the actual total tax for an order being different.

GET: /restdata.svc/concessions

{
    "ResponseCode": 0,
    "ErrorDescription": null,
    "ConcessionItems": [
        {
            "Id": "123",
            "PriceInCents": 500,
            "TaxInCents": 50,
        }
    ]
}

Tax on loyalty recognitions

In some cases, a loyalty member may have a recognition which will change the price of the item, requiring tax to be recalculated. However, Connect cannot recalculate tax values without calling Sales Server so for performance reasons, the adjusted tax value is calculated assuming a percentage-based tax rate (e.g. 15% of item price).
This should again be treated as an estimated amount due to potential rounding differences.

For fixed tax rates (e.g. $1 for alcohol), recalculated tax on loyalty recognitions may differ significantly from the actual tax.

Tax on variable-priced concession items

Tax information for variable-priced concession items is not available for reference data. The tax will only be available once the item has been added to the order at the chosen price.

Retrieving tax for orders

When tickets or concessions are added to the order, the tax for individual tickets and concessions, along with the total tax for the order is calculated at the cinema and returned in Connect. These values can be treated as the final tax amount.

POST: /RESTTicketing.svc/order/concessions

Response:

{
    "Order": {
        "Concessions": [
            {
                "Id": "1",
                "ItemId": "123",
                "Quantity": 1,
				"FinalPriceCents": 500,
				"TaxCents": 50
			},
            {
				"Id": "2",
                "ItemId": "123",
                "Quantity": 1,
				"FinalPriceCents": 500,
				"TaxCents": 50
			}
		],
        "TotalValueCents": 1000,
        "TaxValueCents": 100,
    },
    "Result": 0
}

Tax on booking fees

The total tax of all booking fees is returned as part of the order.

POST: /RESTTicketing.svc/order/tickets

Response:

{
    "Order": {
        "TotalValueCents": 850,
        "TaxValueCents": 142,
        "BookingFeeValueCents": 100,
        "BookingFeeTaxValueCents": 17,
        "Sessions": [
            {
                "SessionId": 3107,
                "Tickets": [
                    {
                        "Id": "1",
                        "TicketTypeCode": "0001",
                        "FinalPriceCents": 750,
                        "TaxCents": 125
                    }
                ]
            }
        ]
    }
}