Service: ExternalOrderHistoryService

Version: 1_13 (other versions, change log, ZUMSTEIN_V3.12-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.history.v1_13.ExternalOrderHistoryService.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:

countFilesByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

requestIdInteger     
pointOfSalesIdLong     
startDateDate     
endDateDate     
statesList of (RUNNING|SUSPENDED|
IN_OPTION|IN_RESERVATION|
OPTION_RESERV|CONFIRMED|
SOLDED|NOT_SOLDED|
PART_SOLDED|CANCELED|
ABANDONNED|TECH_ERROR)
     
productIdLong     
performanceIdLong     
itemIdLong     
culturalContactReferenceString     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
fileContactsList of FileContactData     
maxFileExpirationDateDate     
maxInstallmentExpirationDateDate     
fileSearchCriteria(UNION_FILE_CONTACTS|
INTERSECT_FILE_CONTACTS)
     
mainAudienceCategory(OCCASIONAL|SUBSCRIBER|
INSIDE_SEASONTICKET|
MEMBER|INVITED)
     
fileOptionStatesList of (NONE|REQUESTED|
PRE_REQUESTED)
     

FileContactData
fileContactType(SALE|OWNER|FINDER|
COMM_ENTITY)
     
answerQuestionnaireAnswerQuestionnaire     
birthdayDate     
contactIdLong     
contactReferenceString (20)     
countryCodeString (8)     
emailString     
firstAddressLineString     
firstNameString     
idNumberString     
invoiceAddressIdLong     
lastNameString     
localityString     
mobilePhoneString     
phoneString     
secondAddressLineString     
structureOfficialNameString     
thirdAddressLineString     
zipCodeString (8)     

AnswerQuestionnaire
answerQuestionsList of AnswerQuestion     
ticketIdLong     

AnswerQuestion
answerCodesList of String     
questionCodeString (8)     

Return value

AggregatedFileHistoryResult
aggregatedFileHistoriesList of AggregatedFileHistoryData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

AggregatedFileHistoryData
fileState(RUNNING|SUSPENDED|
IN_OPTION|IN_RESERVATION|
OPTION_RESERV|CONFIRMED|
SOLDED|NOT_SOLDED|
PART_SOLDED|CANCELED|
ABANDONNED|TECH_ERROR)
     
numberOfExpiredFilesLong     
numberOfFilesLong     

countOrdersByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

requestIdInteger     
pointOfSalesIdLong     
startDateDate     
endDateDate     
productIdLong     
performanceIdLong     
itemIdLong     
contactReferenceString (20)     
culturalContactFilterCriteriaContactFilterCriteria     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
orderTypesList of (SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     

ContactFilterCriteria
DTO used to specify order filter criteria for a given contact. Used in queries which look for orders by various criteria.
  • salesChannelType: the type of sales channel the contact's orders should come from
  • unionWithOtherOrders: define how to treat this contact's orders in relation to other orders of the query: union or intersection
contactReferenceString (20)     
salesChannelTypeStringString     
unionWithOtherOrdersBoolean     

Return value

AggregatedOrderHistoryResult
aggregatedOrderHistoriesList of AggregatedOrderHistoryData     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

AggregatedOrderHistoryData
numberOfOrdersLong     
orderState(OPEN|VALIDATED|CLOSED|
ABANDONNED|PROCESSING)
     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
totalAmountLong     

isExternalOrderHistoryServiceAlive

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

validate network connection and login/password

Parameters

Return value

WebMethodResult
requestIdInteger     
statusCodeString (8)     
statusDetailString     

listFilesByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Returns a list of files filtered by the given criteria. To specify a filter on the file contacts, use the fileContacts parameter. If more than one file contact is specified in the file contacts list, returns the files belonging to any of the given contacts (OR semantics). The culturalContactReference filters movement contacts.

Parameters

requestIdInteger     
pointOfSalesIdLong     
startDateDate     
endDateDate     
statesList of (RUNNING|SUSPENDED|
IN_OPTION|IN_RESERVATION|
OPTION_RESERV|CONFIRMED|
SOLDED|NOT_SOLDED|
PART_SOLDED|CANCELED|
ABANDONNED|TECH_ERROR)
     
productIdLong     
performanceIdLong     
itemIdLong     
culturalContactReferenceString     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
startPositionLong     
maxResultLong     
fileContactsList of FileContactData     
maxFileExpirationDateDate     
maxInstallmentExpirationDateDateif non-null, returns only files containing installments linked to non-abandoned orders which have an expiration date before the given maxInstallmentExpirationDate
fileSearchCriteria(UNION_FILE_CONTACTS|
INTERSECT_FILE_CONTACTS)
- applies the given searchCriteria for file contacts.This field is optional.
fileSortingCriteria(LAST_UPDATED_DATE|
MAX_EXPIRATION_DATE|
MAX_INSTALLMENT_EXPIRATION_DATE)
- orders the result by given criteria. This field is optional, by default it sorts files by last update date of file
mainAudienceCategory(OCCASIONAL|SUBSCRIBER|
INSIDE_SEASONTICKET|
MEMBER|INVITED)
if non-null, returns files which contain operations having the given main audience category. NOTE: If SUBSCRIBER is given as the audience category, then only files containing season tickets will be returned (those containing other products with main category SUBSCRIBER will NOT be returned)
fileOptionStatesList of (NONE|REQUESTED|
PRE_REQUESTED)
     

Return value

FileSummaryListResult
fileSummariesList of FileSummaryData     
truncatedBoolean     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

FileSummaryData
Class containing information of file.
fileContactsList of FileContactSummaryData     
fileIdLong     
fileState(RUNNING|SUSPENDED|
IN_OPTION|IN_RESERVATION|
OPTION_RESERV|CONFIRMED|
SOLDED|NOT_SOLDED|
PART_SOLDED|CANCELED|
ABANDONNED|TECH_ERROR)
     
lastModDateDate     
maxFileExpirationDateDate     
maxInstallmentExpirationDateDate     
numberOfMovementsLong     
optionState(PRE_REQUESTED|REQUESTED|
VALIDATED|PART_VALIDATED|
REJECTED|ABANDONED)
     
referenceDateDate     
waitingActionState(PRE_SALES|PRE_REQUESTED|
REQUESTED|VALIDATED|
REJECTED)
     

FileContactSummaryData
fileContactType(SALE|OWNER|FINDER|
COMM_ENTITY)
     
contactNumberString (20)     
nameString     
structureNameString     

listOrdersByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

requestIdInteger     
pointOfSalesIdLong     
startDateDate     
endDateDate     
statesList of (OPEN|VALIDATED|CLOSED|
ABANDONNED|PROCESSING)
     
productIdLong     
performanceIdLong     
itemIdLong     
contactReferenceString (20)     
culturalContactFilterCriteriaContactFilterCriteria     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
startPositionLong     
maxResultLong     
orderTypesList of (SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
orderByOrderBy     

OrderBy
field(FILE_LAST_UPDATED_DATE|
FILE_MAX_EXPIRATION_DATE|
ORDER_CREATION_DATE)
     
order(ASC|DESC)     

Return value

OrderSummaryListResult
orderSummariesList of OrderSummaryData     
truncatedBoolean     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

OrderSummaryData
Class containing information of order creation result. The following attributes are provided:
  • orderId, mandatory: specify the SecuTix order id
  • orderState, mandatory: specify the order state
  • referenceDate, mandatory: specify the date when order will be count
  • totalAmount, mandatory: total amount of the order, express as unity thousandth
  • numberOfMovements, mandatory: specify the list of deleted movements
  • externalReference, optional: specify the operation id of the given request, if existing
buyingContactInfoContactSummaryData     
culturalContactsInfoList of ContactSummaryData     
expirationDateDate     
externalReferenceString     
fileIdsList of Long     
numberOfMovementsLong     
orderIdLong     
orderState(OPEN|VALIDATED|CLOSED|
ABANDONNED|PROCESSING)
     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
referenceDateDate     
salesChannelNameExternalName     
salesChannelType(AGENCY|BOXOFFICE|
INTERNET_B2C|INTERNET_B2B|
INTERNET_B2B2C)
     
totalAmountInteger     

ContactSummaryData
contactNumberString (20)     
nameString     
structureNameString     

ExternalName
translationsList of Translation     

Translation
localeString (2)     
valueString     

listTicketsByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

requestIdInteger     
pointOfSalesIdLong     
startDateDate     
endDateDate     
state(CANCELLED|VALID|
NOT_PRINTED|INVALIDATED)
     
productIdLong     
performanceIdLong     
itemIdLong     
startPositionLong     
maxResultLong     
buyingContactReferenceString     
culturalContactReferenceString     
ticketMedium(THERMAL|E_TICKET|MOBILE|
RFID)
     
ordersIdList of Long     
joinType(UNION_FILE_CONTACTS|
INTERSECT_FILE_CONTACTS)
     
seatIdsList of Long     
ticketSearchCriteria(EXCLUDE_PAST_TICKETS)     
ticketSortingCriteria(CREATION_DATE|
PERFORMANCE_DATE)
     
membershipBarcodeString (8)     

Return value

TicketSummaryListResult
ticketSummariesList of TicketSummaryData     
truncatedBoolean     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

TicketSummaryData
activityType(LIVE_SPECT|FESTIVAL|
MUSEUM|VISIT|ENTERT_PARK|
FAIR|PARKING|SPORT|
OTHER)
     
alleyString     
areaString     
areaIdLong     
areaKind(INDIFFERENT|BOX)     
audienceSubCategoryString     
audienceSubCategoryIdLong     
barcodeString (8)     
beneficiaryBirthdateDate     
beneficiaryCountryCodeString (8)     
beneficiaryIdNumberString     
blockString     
blockIdLong     
buyingContactContactData     
buyingContactReferenceString     
cardTypeCardTypeData     
contactQualitiesList of ContactQuality     
containerIdentifierString     
creationDateDate     
culturalContactContactData     
culturalContactReferenceString     
displayDateOnlyOfTimeslotStartboolean     
duplicateboolean     
endValidityDateDate     
entranceString     
entranceIdLong     
fileIdLong     
firstNameString     
floorString     
hostTeamString     
isAvailableForPrintboolean     
isNominativeTicketboolean     
itemDescriptionString     
itemIdLong     
itemNameString     
lastNameString     
matchRoundString     
movementIdLong     
operationType(SALE|REFUND|PRE_SALE|
RESERVATION|OPTION|
RES_CANCELLATION|
OPTION_CANCELLATION|
REFUND_ORGANIZATION|
REFUND_CLIENT|
RESERVATION_FREEING|
OPTION_FREEING|ABANDON|
PRE_REFUND)
     
opposingTeamString     
orderExternalReferenceString     
orderIdLong     
parentMovementIdLong     
parentProductString     
parentProductIdLong     
performanceDateDate     
performanceIdLong     
priceInteger     
productString     
productFamilyType(SINGLE_ENTRY|
SEASONTICKET|PASS|PACKAGE|
MEMBERSHIP|SERVICE|GOODS|
TRANSPORT|HOSPITALITY)
     
productIdLong     
questionnaireIdLong     
resaleableboolean     
rowString     
scenePanoLinkString     
scenePhotoLinkString     
seasonString     
seatCategoryString     
seatCategoryIdLong     
seatNumberString     
seatQualityString     
seatQualityIdLong     
sectorString     
shipmentModeTypeString     
siteString     
spaceString     
startValidityDateDate     
taxNumberString     
ticketIdLong     
ticketMedium(THERMAL|E_TICKET|MOBILE|
RFID)
     
ticketResaleState(OPEN|PROCESSING|RESOLD|
INVALIDATED|CANCELED)
     
ticketState(CANCELLED|VALID|
NOT_PRINTED|INVALIDATED)
     
ticketSupportsList of String     
timeslotStartDate     

ContactData
Class containing the beneficiary data :
  • contactReference, optional: the secutix contact number
  • firstName, optional: beneficiary first name
  • lastName, optional: beneficiary last name
  • email, optional: beneficiary email
  • birthday, optional: beneficiary birthday
  • firstAddressLine, optional: first address line
  • secondAddressLine, optional: second address line
  • thirdAddressLine, optional: third address line
  • zipCode, optional: address zip code
  • locality, optional: address locality
  • countryCode, optional: address country code
  • phone, optional: beneficary phone number
  • mobilePhone, optional: beneficary mobile phone number
  • contactId, optional: the contact internal id
  • invoiceAddressId, optional: the contact address internal id
  • idNumber, optional: To store beneficiary id number like passport number.
answerQuestionnaireAnswerQuestionnaire     
birthdayDate     
contactIdLong     
contactReferenceString (20)     
countryCodeString (8)     
emailString     
firstAddressLineString     
firstNameString     
idNumberString     
invoiceAddressIdLong     
lastNameString     
localityString     
mobilePhoneString     
phoneString     
secondAddressLineString     
structureOfficialNameString     
thirdAddressLineString     
zipCodeString (8)     

CardTypeData
cardTypeIdLong     
codeString (8)     
controlString     
externalNameString     
logoUrlString (255)     
printableBoolean     

ContactQuality
audienceCategoriesList of AudienceCategoryPriceLevel     
contactNumberString (20)     
seasonIdLong     

AudienceCategoryPriceLevel
audienceCatIdLong     
instanceNumberString     
mainCategory(OCCASIONAL|SUBSCRIBER|
MEMBER|INVITED|
INSIDE_SEASONTICKET)
     
movementIdLong     
priceLevelIdLong     
productIdLong     
secondaryCategory(INDIVIDUAL|COMMUNITY|
GROUP|TAXED|FREE|
PROMOTIONAL)
     

searchCulturalContactsOfOrdersByCriteria

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

orderIdsList of Long     
fileIdsList of Long     
buyerContactReferenceString     
pointOfSalesIdLong     
startDateDate     
endDateDate     
statesList of (OPEN|VALIDATED|CLOSED|
ABANDONNED|PROCESSING)
     
productIdLong     
performanceIdLong     
itemIdLong     
paymentStatesList of (WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION)
     
startPositionLong     
maxResultLong     
orderTypesList of (SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     

Return value

SearchOrdersResult
culturalContactsList of ContactSummaryData     
truncatedBoolean     
requestIdInteger     
statusCodeString (8)     
statusDetailString