Cart Test
Web/Cart/{sessionKey}/Packages/Fixed
Adds a new fixed seat package item to the cart

Adds a seated or unseated fixed seat package line item to the cart and reserves seats using either the best seat function or reserves specific seats.

PackageId line items can be added as alternate/upgrade line items to another line item in the cart. To add an alternate/upgrade line item, the parent line item ID must be retrieved using /Web/Cart (GET) and then passed as the ParentPackageLineItemId parameter value for this method.

This method will allow the reservation of held seats.To enable this functionality, add the key ''Reserve Held Seats' to T_DEFAULTS with a value of 'Yes' under the "Tessitura Web" parent table (or organization name if operating in a consortium environment).
Http Verb POST
Resource URL https://ts-stg-appgw.calacademy.org/TessituraService/Web/Cart/{sessionKey}/Packages/Fixed

URI Parameters

Parameter Name Data Type Required Notes
sessionKey string Y

Request Body

Request object type : AddPackageItemRequest

Request object type AddPackageItemRequest has the following properties.
Property Name Data Type Length Required Readonly Notes
LeaveSingleSeats boolean N When set to True, the best seating function is allowed to reserve seats that would leave a single contiguous seat available. When set to False, the best seating function will not reserve seats that would leave a single contiguous seat available.
NumberOfSeats integer Y The number of seats to be added to the cart for the request.
PackageId integer Y The ID number of package to be added to the cart. Must be a fixed seat package.
FK: T_PKG.pkg_no   Resource: Packages
ParentPackageLineItemId integer N If the line item being added is primary (a new package) pass 0 for this parameter. If the line item being added is an alternate/upgrade line item pass the line item ID of parent package line item.
PriceType string Y The price type for the package. If multiple seats are being requested different price types can be used for each seat by passing a comma separated list of price types.When using multiple price types, a price type must be specified for each seat even if some seats are using the same price type.For example, if there are 4 seats, two at the Adult and two at the Child price type, 4 price type IDs must be passed. The price types passed must be valid for the current mode of sale.
FK: TR_PRICE_TYPE.id   Resource: PriceTypes
PriceTypeReason string N Price Type reasons (Comp Codes) for use with price types that require them. If multiple seats are being requested with different price types, the price type reasons can be specified in a list, matching the price types.
FK: TR_COMP_CODE.id   Resource: PriceTypeReasons
RequestedSeats string N The ID numbers (seat_no) of specific seats to reserve. Multiple seat numbers can be passed as a comma separated list. If no value is passed seats are reserved using the best seating function.
Unseated boolean N Setting this as True will create an unseated package lineitem.
ZoneId integer Y The ID number of the desired price zone for the request. A value of 0 can be passed When reserving specific seats, the zone of the specified seats overrides whatever zone value is passed here.As the parameter is required but essentially irrelevant, you can pass a value of 0 to meet the requirement.
FK: T_ZONE.zone_no   Resource: Zones 
{
  "PriceType": "sample string 1",
  "PriceTypeReason": "sample string 2",
  "PackageId": 3,
  "NumberOfSeats": 4,
  "ZoneId": 5,
  "RequestedSeats": "sample string 6",
  "LeaveSingleSeats": true,
  "ParentPackageLineItemId": 8,
  "Unseated": true
}
<AddPackageItemRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <LeaveSingleSeats>true</LeaveSingleSeats>
  <NumberOfSeats>4</NumberOfSeats>
  <PackageId>3</PackageId>
  <ParentPackageLineItemId>8</ParentPackageLineItemId>
  <PriceType>sample string 1</PriceType>
  <PriceTypeReason>sample string 2</PriceTypeReason>
  <RequestedSeats>sample string 6</RequestedSeats>
  <Unseated>true</Unseated>
  <ZoneId>5</ZoneId>
</AddPackageItemRequest>

Response object type : AddPackageItemResponse

Response object type AddPackageItemResponse has the following properties.
Property Name Data Type Length Required Readonly Notes
LineItemId integer
SeatsReserved integer 
{
  "LineItemId": 1,
  "SeatsReserved": 2
}
<AddPackageItemResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <LineItemId>1</LineItemId>
  <SeatsReserved>2</SeatsReserved>
</AddPackageItemResponse>
Change Version Description Contract Old New
Parameter Changed 15.0.0 sessionKey has been marked as required. Required