Service: AvailabilityService

Version: 1_19 (other versions, change log, ZUMSTEIN_V4.4-SNAPSHOT) END OF LIFE. Please consider switching to the latest version of the webservices, because this version may be removed anytime from support.

SOAP Demo endpoint: https://myinstit.ws.secutix.com/tnseb/external-remoting/com.secutix.service.realtime.availability.v1_19.AvailabilityService.webservice?wsdl

To get the endpoint for your own institution, replace "myinstit" (just after https://) in the url by your own institution code.

For further documentation and examples, please check in Platform Website.

Methods:

getAvailableThemeAndLanguage

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method return list selected theme and language for each timeslot already have visit group, and this method should only use for visit pass individual with multiple themes/languages

Parameters

passIdlongMandatory
timeslotIdsList of Long     

Return value

ThemeAndLanguageResult
listThemeAndLanguageList of ThemeAndLanguage     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

ThemeAndLanguage
languageCodeString (8)     
themeIdlong     
timeslotIdlong     

getEventAvailability

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Get availability data of the given event and performances

Parameters

requestIdIntegeroptional
pointOfSalesIdLongMandatory
mandatory: it specifies the point of sales
eventIdsList of Long     
performanceIdsList of LongMandatory
mandatory
seatCategoryIdsList of LongOptional: it allows refining the results by dividing the result per seat category. If the field is an empty list, the result does sum for all the categories. If the field is -1, all the possible seat categories are returned. If the field contains a list of seat categories id, only those seat categories are returned.
contingentIdsList of Longoptional: works as the categories, with the contingents.
composedProductIdLongoptional: id of the composed product allowing specific availabilities
advantageIdLong     

Return value

EventAvailabilityResult
eventAvailabilityDataEventAvailabilityData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

EventAvailabilityData
eventAvailabilitiesList of EventAvailability     

EventAvailability
eventIdLong     
minPriceInteger     
performanceIdLong     
availabilityLong     
availabilityLevel(NONE|LIMITED|GOOD)     
compQuotaLong     
contingentIdLong     
minGroupSizeInteger     
quotaLong     
reason(NOT_ON_SALE|CLOSED|
SUSPENDED|CANCELED|
SOLD_OUT|
POS_NOT_ON_SALE)
     
resaleMinPriceLong     
seatCategoryIdLong     

getPerformanceAvailability

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Get availability data of the given performance. Can be filtered by area and or block.

Parameters

requestIdIntegeroptional
pointOfSalesIdLongMandatory
mandatory: it specifies the point of sales
eventIdLongMandatory
mandatory: it specifies the event whose availability we want to know.
EventId is equivalent of productId, where the product is an event.
performanceIdsList of LongMandatory
mandatory
seatCategoryIdsList of LongOptional: it allows refining the results by dividing the result per seat category. If the value of the field is an empty list, the result does sum for all the categories. If the field is -1, all the possible seat categories are returned. If the field contains a list of seat categories id, only those seat categories are returned.
contingentIdsList of Long     
zoneBlockIdsList of AreaBlockId     
composedProductIdLongoptional: id of the composed product allowing specific availabilities
advantageIdLong     

AreaBlockId
Create a wrapper class to avoid having problem with JAXB since it required a no-arg default constructor.
given areaId and blockId correspond to SecuTix Physical Ids
areaIdLong     
blockIdLong     

Return value

PerformanceAvailabilityResult
performanceAvailabilityDataPerformanceAvailabilityData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

PerformanceAvailabilityData
performanceAvailabilitiesList of PerformanceAvailability     

PerformanceAvailability
areaIdLong     
blockIdLong     
eventIdLong     
minPriceInteger     
performanceIdLong     
availabilityLong     
availabilityLevel(NONE|LIMITED|GOOD)     
compQuotaLong     
contingentIdLong     
minGroupSizeInteger     
quotaLong     
reason(NOT_ON_SALE|CLOSED|
SUSPENDED|CANCELED|
SOLD_OUT|
POS_NOT_ON_SALE)
     
resaleMinPriceLong     
seatCategoryIdLong     

getProductAvailability

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method allows to determine the availability of one or more products, no matter the type.

Parameters

requestIdIntegeroptional
pointOfSalesIdLongMandatory
mandatory: it specifies the point of sales
productIdsList of LongMandatory
mandatory: it specifies the list of products whose availability we want to know.
itemIdsList of LongOptional: it indicates a list of items linked to this product. If the field is -1, all the items of the product are returned. If the field contains a list of items id, only those items are returned. If the field is not given, the availability of the product itself (sum of all its items) is returned.
timeslotIdsList of LongOptional: used for timeslot passes and visit passes.
seatCategoryIdsList of LongOptional: it allows refining the results by dividing the result per seat category. If the field is an empty list, the result does sum for all the categories. If the field is -1, all the possible seat categories are returned. If the field contains a list of seat categories id, only those seat categories are returned.
contingentIdsList of Longoptional: works as the categories, with the contingents.
composedProductIdLongoptional: id of the composed product allowing specific availabilities
advantageIdLong     

Return value

ProductAvailabilityResult
productAvailabilityDataProductAvailabilityData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

ProductAvailabilityData
productAvailabilitiesList of ProductAvailability     

ProductAvailability
itemIdLong     
productIdLong     
timeslotIdLong     
availabilityLong     
availabilityLevel(NONE|LIMITED|GOOD)     
compQuotaLong     
contingentIdLong     
minGroupSizeInteger     
quotaLong     
reason(NOT_ON_SALE|CLOSED|
SUSPENDED|CANCELED|
SOLD_OUT|
POS_NOT_ON_SALE)
     
resaleMinPriceLong     
seatCategoryIdLong     

getSeatsAvailability

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method lists the exhaustive list of seats in a given area/block or in a given clipping area of the map, with their respective status. It is basically limited to return 5000 seats max, and must not be used to obtain the full status of a venue.

Parameters

requestIdIntegeroptional
pointOfSalesIdLongMandatory
mandatory: it specifies the point of sales
performanceIdsList of LongMandatory
mandatory: the related performances.
productIdLongoptional
modifiedSinceDateallows to cache the result of previous calls to obtain only the seats updated since the last call.
seatCategoryIdsList of Longoptional: limits to the seats with the given categories.
contingentIdsList of Longoptional : limits to the seats with the given contingents.
areaBlockIdsList of AreaBlockIdoptional : limits to the seats with the given areas/blocks
clippingAreaClippingArea     
availabilityType(AVAILABLE|NOT_AVAILABLE|
BOTH)
optional, allows to select only the available seats. Default:AVAILABLE
composedProductIdLongoptional: id of the composed product allowing specific availabilities
advantageIdLong     

ClippingArea
hint     
wint     
xint     
yint     

Return value

SeatsAvailabilityResult
seatsAvailabilityDataSeatsAvailabilityData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

SeatsAvailabilityData
seatsAvailabilitiesList of SeatDefinition     
timestampDate     
truncatedBoolean     

SeatDefinition
UNDEFINEDString     
areaIdLong     
areaKind(INDIFFERENT|BOX)     
availableboolean     
blockIdLong     
contingentIdLong     
numberString     
physicalSeatIdLong     
rotationint     
rowString     
scenePanoLinkString     
scenePhotoLinkString     
seatCategoryIdLong     
xint     
yint     

getUpdatedAvailabilities

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Allows to list the products which availability have changed since a reference date. Much quicker than listing all the availabilities one by one.

Parameters

requestIdInteger     
pointOfSalesIdLong     
productIdsList of Long     
referenceDateDate     

Return value

UpdatedAvailabilitiesResult
availabilityUpdateDataList of AvailabilityUpdateData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

AvailabilityUpdateData
advantageIdLong     
hospitalitySessionIdLong     
lastUpdateDate     
performanceIdLong     
productIdLong     
timeslotIdLong     

isAvailabilityServiceAlive

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

validate network connection and login/password

Parameters

Return value

WebMethodResult
requestIdInteger     
statusCodeString (8)     
statusDetailString