Service: ExternalOrderFacade

Version: 1_16 (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.externalorder.v1_16.ExternalOrderFacade.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.external order facade interface v1_16 : web service exposed to external world

Methods:

createOrUpdateOrder

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Same of {@link #createOrUpdateOrderWithGranularity(Integer, Long, Long, Long, OrderType, List, String, List, List, List, List, List, OrderOriginData, List, boolean, boolean, OrderUpdateGranularity)} but with default MOVEMENT granularity.

Parameters

requestIdInteger     
pointOfSalesIdLong     
orderIdLong     
fileIdLong     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
purchasersInfoList of ContactData     
externalReferenceString     
composedProductOperationsList of ComposedProductOperationCreationData     
singleEntryAttributionOperationsList of SingleEntryOperationAttributionData     
simpleProductOperationsList of SimpleProductOperationCreationData     
transportProductOperationsList of TransportProductOperationCreationData     
chargeOperationsList of ChargeOperation     
originOrderOriginData     
fileContactsList of FileContactData     
isResumeAllOptionOperationsbooleanMandatory
isResumeAllReservationOperationsbooleanMandatory

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.
  • birthRegion, optional: beneficiary birth region
  • birthPlace, optional: beneficiary birth place
answerQuestionnaireAnswerQuestionnaire     
birthPlaceString     
birthRegionString     
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)     

ComposedProductOperationCreationData
Class representing a parameter of createComposedProductOperation method of ExternalOrderService. The attributes are:
  • orderId, mandatory: the SecuTix order id
  • quantity, mandatory: number of seat (resp. place) to put in the cart
  • itemId, mandatory: the SecuTix item id
  • seatCategoryId, mandatory: the SecuTix seat category id
  • audienceSubCategoryId, mandatory: the SecuTix audience sub category id
  • advantageId, optional: the SecuTix advantage id, if the operation is for an advantage
advantageIdLong     
itemIdLong     
oneTimeCodesSet of String     
seatCategoryIdLong     
simpleProductComposedOperationsList of SimpleProductOperationCreationData     
singleEntryAttributionComposedOperationsList of SingleEntryOperationAttributionData     
transportProductComposedOperationsList of TransportProductOperationCreationData     
audienceSubCategoryIdLong     
barcodesList of String     
baseProductOperationIdsSet of Long     
checkPriceboolean     
contingentIdLong     
crossSellIdLong     
fileIdLong     
operationIdLong     
orderIdLong     
parentMovementIdsList of Long     
priceLevelIdLong     
quantityInteger     
questionnaireIdLong     
resaleMovementIdsList of Long     
seasonTicketOrMembershipMovementIdLong     
unitPriceAmountInteger     

SimpleProductOperationCreationData
Class representing a parameter of createSimpleProductOperation method of ExternalOrderService. The attributes are:
  • orderId, mandatory: the SecuTix order id
  • quantity, mandatory: number of seat (resp. place) to put in the cart
  • itemId, optional: the SecuTix item id
  • audienceSubCategoryId, mandatory: the SecuTix audience sub category id
  • parentOperationId, mandatory: the SecuTix parent operation id
  • productCompositionLineId: the SecuTix product composition line id
  • contingentId: optional: the SecuTix contingent id (used for goods, never needed for services)
  • advantageId, optional: the SecuTix advantage id, if the operation is for an advantage
  • movementId: optional: the movementId of composed product operation created already.
advantageIdLong     
dateDate     
hospRoomIdLong     
hospitalityAreaIdLong(optional) hospitality area id of hospitality item chosen
itemIdLong     
minSizeInPackageInteger     
oneTimeCodesSet of String     
parentOperationIdLong     
productCompositionLineIdLong     
productDesignationString     
timeslotIdLong(optional) TimeslotId of timeslot pass item corresponds to specific time slot
visitGroupDefinitionVisitGroup     
audienceSubCategoryIdLong     
barcodesList of String     
baseProductOperationIdsSet of Long     
checkPriceboolean     
contingentIdLong     
crossSellIdLong     
fileIdLong     
operationIdLong     
orderIdLong     
parentMovementIdsList of Long     
priceLevelIdLong     
quantityInteger     
questionnaireIdLong     
resaleMovementIdsList of Long     
seasonTicketOrMembershipMovementIdLong     
unitPriceAmountInteger     

VisitGroup
groupKindInternalCodeString (8)     
groupNameString     
numberOfAccompaniersInteger     
numberOfParticipantsInteger     
remarkString     
visitGroupIdLong     
visitLanguageCodeString (8)     
visitThemeIdLong     

SingleEntryOperationAttributionData
Class representing a parameter of createAutoAllocSingleEntryOrder method of ExternalOrderFacade. The attributes are:
  • operationAttributions, mandatory: the list of the single entry operation to create
  • preferedAreas, optional: the list of prefered area SecuTix id
  • preferedBlock, optional: the list of prefered block SecuTix id
  • mandatoryPreferences, optional: the boolean to indicate whether autoAttribution or manualAttribution of seats should strictly follow given preferences - (areas or blocks or seat definitions). By default, value is false.
mandatoryPreferencesboolean     
operationAttributionsList of SingleEntryOperationCreationData     
preferedAreasList of Long     
preferedBlockList of Long     

SingleEntryOperationCreationData
Class representing a parameter of createSingleEntryOperation method of ExternalOrderService. The attributes are:
  • orderId, mandatory: the SecuTix order id
  • quantity, mandatory: number of seat (resp. place) to put in the cart
  • performanceId, mandatory: the SecuTix performance id
  • seatCategoryId, mandatory: the SecuTix seat category id
  • audienceSubCategoryId, mandatory: the SecuTix audience sub category id
  • contingentId, optional: the SecuTix contingent id
  • parentOperationId, optional: the SecuTix parent operation id
  • productCompositionLineId, optional: the SecuTix product composition line id
  • advantageId, optional: the SecuTix advantage id, if the operation is for an advantage
  • seasonTicketOrMembershipMovementId: optional : the movementId of season ticket or membership product bought by a contact.This field is mandatory to send when a contact who is "Abonné" or "Adherent" category is logged in to buy any product to prove that contact is really a subscriber or member. selling of composed product then pass the movementId of composed product operation created already identifies the composed product to complete.
  • parentMovementIds: optional : the list of parent movementIds - which are required at the time of child operation creation. And note that caller should send number of parent movementIds equal to operation quantity. In case of fixed price season ticket completion, parent movements list can contain same elements if child operation quantity chosen > 1
advantageIdLong     
alternativeCategoryQuantityInteger     
iterationInteger     
nnSeatDefinitionsList of NotNumberedSeatDefinition     
oneTimeCodesSet of String     
parentOperationIdLong     
performanceIdLong     
productCompositionLineIdLong     
seatCategoryIdLong     
seatDefinitionsList of SeatDefinition     
seatingStrategy(MANUAL_SEATING|
AA_MANDATORY_PREFERENCES|
AA_OPTIONAL_PREFERENCES|
NO_AUTO_ALLOC)
     
audienceSubCategoryIdLong     
barcodesList of String     
baseProductOperationIdsSet of Long     
checkPriceboolean     
contingentIdLong     
crossSellIdLong     
fileIdLong     
operationIdLong     
orderIdLong     
parentMovementIdsList of Long     
priceLevelIdLong     
quantityInteger     
questionnaireIdLong     
resaleMovementIdsList of Long     
seasonTicketOrMembershipMovementIdLong     
unitPriceAmountInteger     

NotNumberedSeatDefinition
Class containing all necessary information to manually attribute seats. The following attributes are provided:
  • areaId, mandatory: the SecuTix area id
  • quantity, mandatory: specify quantity of places needed in this area
areaIdLong     
quantityInteger     

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

TransportProductOperationCreationData
Class representing a parameter of createTransportProductOperation method of ExternalOrderService. The attributes are:
  • orderId, mandatory: the SecuTix order id
  • quantity, mandatory: number of seat (resp. place) to put in the cart
  • itemId, optional: the SecuTix item id
  • audienceSubCategoryId, mandatory: the SecuTix audience sub category id
  • parentOperationId, mandatory: the SecuTix parent operation id
  • productCompositionLineId, mandatory: the SecuTix product composition line id
  • unitPriceAmount, mandatory: indicate the actual unit price. This price maybe zero
  • offerId_1, mandatory: Identifier of the first selected offer
  • offerId_2, optional: Identifier of the first selected offer
  • dateOutwardTrip, mandatory: date of the journey
  • dateReturnTrip, optional: date of return journey
  • transportDescription, optional: description of transport
  • passengers, mandatory: passenger's information
  • movementId: optional: the movementId of composed product operation created already.
dateOutwardTripDate     
dateReturnTripDate     
destinationCodeString (8)     
itemIdLong     
offerId_1String     
offerId_2String     
originCodeString (8)     
parentOperationIdLong     
passengersList of PassengerData     
productCompositionLineIdLong     
transportDescriptionString     
audienceSubCategoryIdLong     
barcodesList of String     
baseProductOperationIdsSet of Long     
checkPriceboolean     
contingentIdLong     
crossSellIdLong     
fileIdLong     
operationIdLong     
orderIdLong     
parentMovementIdsList of Long     
priceLevelIdLong     
quantityInteger     
questionnaireIdLong     
resaleMovementIdsList of Long     
seasonTicketOrMembershipMovementIdLong     
unitPriceAmountInteger     

PassengerData
birthdateDate     
firstNameString     
lastNameString     
offerPrice_1Integer     
offerPrice_2Integer     
passengerNumberLong     

ChargeOperation
chargesIdLong     
orderIdLong     
unitPriceAmountInteger     

OrderOriginData
countryCodeString (8)     
ipAddressString     
orderOriginInfoIdCodeString (8)     
trackerString     
userAgentString     
zipCodeString (8)     

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

Return value

OrderUpdateResult
Class representing the response of create order method in external order service.
orderUpdateDataOrderUpdateData     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

OrderUpdateData
Class containing information of order update result. The following attributes are provided:
  • operationDataUpdates, optional: specify the list of created or updated operations
  • removeOperationIds, optional: specify the list of deleted operations
  • movementDataUpdates, optional: specify the list of created or updated movements
  • removeMovementIds, optional: specify the list of deleted movements
  • mainOperationId, optional: specify the operation id of the given request, if existing
generatedContactQualitiesMap of String, ContactQuality     
generatedContiguitiesList of ContiguityData     
mainOperationIdLong     
movementDataUpdatesList of MovementData     
operationDataUpdatesList of OperationData     
orderIdLong     
orderSecretIdString     
originOrderOriginData     
removeMovementIdsList of Long     
removeOperationIdsList of Long     

ContactQuality
audienceCategoriesList of AudienceCategoryPriceLevel     
seasonIdLong     

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

ContiguityData
contiguousboolean     
performanceIdLong     
seatCategoryIdLong     
segmentsList of Segment     

Segment
movementIdsList of Long     

MovementData
Class containing all necessary information to display a movement. The following attributes are provided:
  • movementId, mandatory: the SecuTix movement id
  • type, mandatory: Specify if the movement concerns a numbered seat or a not numbered area
  • seatId, optional: the SecuTix seat id if type is SEAT
  • seatCategoryId, mandatory: the SecuTix seat category id
  • seatCategory, mandatory: the seat category name (language is the parameter in the request header or the favorite institution language)
  • contingentId, mandatory: the SecuTix contingent id
  • contingent, mandatory: the contingent name
  • areaId, mandatory: the SecuTix area id
  • area: the area name
  • floor: the floor name
  • sector: the sector name
  • blockId: the SecuTix block id if type is SEAT
  • block: the block name if type is SEAT
  • alley: the alley name if type is SEAT
  • entranceId: the SecuTix entrance id if type is SEAT
  • entrance: the entrance name
  • row: the row name
  • seatNumber: the seat number
  • seatQualityId: the SecuTix seat quality id
  • seatQuality: the SecuTix seat quality name
  • yCoordinate: the y coordinate in the SecuTix configuration
  • xCoordinate: the x coordinate in the SecuTix configuration
  • beneficiaryFirstname: the first name of the beneficiary
  • beneficiaryLastname: the last name of the beneficiary
  • contactReference: the id of the cultural contact
  • resaledMovementId: when the movement correspond to a resaled ticket, this field contains the movementId of
alleyString     
areaString     
areaIdLong     
areaKind(INDIFFERENT|BOX)     
attributionMatch(MATCHING_EXPECTED_AREAS|
MATCHING_EXPECTED_BLOCKS|
NOT_MATCHING|
NO_EXPECTATION)
     
barcodeString (8)     
beneficiaryBirthPlaceString     
beneficiaryBirthRegionString     
beneficiaryBirthdateDate     
beneficiaryCountryCodeString (8)     
beneficiaryFirstnameString     
beneficiaryIdNumberString     
beneficiaryLastnameString     
blockString     
blockIdLong     
contactReferenceString (20)     
contingentString     
contingentIdLong     
endValidityDateDate     
entranceString     
entranceIdLong     
externalRemarkString     
floorString     
instanceNumberLong     
movementIdLong     
operationIdLong     
parentMovementIdLong     
questionnaireIdLong     
resaledMovementIdLong     
resumedboolean     
resumedMovementIdLong     
rowString     
saleAreaIdLong     
saleSeatIdLong     
scenePanoLinkString     
scenePhotoLinkString     
seatCategoryString     
seatCategoryIdLong     
seatIdLong     
seatNumberString     
seatOrientationInteger     
seatQualityString     
seatQualityCodeString (8)     
seatQualityIdLong     
sectorString     
stageVisibilityString     
startValidityDateDate     
taxNumberString     
titlingVisibilityString     
type(SEAT|AREA|SIMPLE_PRODUCT|
COMPOSED)
     
xCoordinateLong     
yCoordinateLong     

OperationData
Class containing all necessary information for an operation. The following attributes are provided:
  • operationId, mandatory: the SecuTix operation id
  • kind, mandatory: the operation kind
  • quantity, mandatory: item quantity for this operation
  • basePrice, mandatory: price as defined in SecuTix rates table, express as unity thousandth
  • productId, mandatory: real price asked to the client, express as unity thousandth
  • product, mandatory: the product name (language is the parameter in the request header or the favorite institution language)
  • itemId, optional: the SecuTix item id
  • item, optional: the item name
  • performanceId, optional: the SecuTix performance id
  • performance, optional: the performance name
  • eventId, eventId: the SecuTix event Id
  • siteId, optional: the SecuTix site id
  • site, optional: the site name
  • contingentId, optional: the SecuTix contingent id
  • contingent, optional: the contingent name
  • isNumbered, optional: identify if operation affects numbered seat or not numbered area
  • seatCategoryId, mandatory: the SecuTix seat category id
  • seatCategory, mandatory: the seat category name
  • audienceSubCategoryId, mandatory: the SecuTix audience sub category id
  • audienceSubCategory, mandatory: the audience sub category name
  • vatRate, mandatory: the vat rate, express as milli-percent (19.6% <=> 19600)
  • String message, optional: a message could be given to explain what happened to the operator
  • advantageId, optional: the advantage used for this operation
  • advantage, optional: the name of the advantage used for this operation
  • season, optional: the name of the season of this product
activityType(LIVE_SPECT|FESTIVAL|
MUSEUM|VISIT|ENTERT_PARK|
FAIR|PARKING|SPORT|
OTHER)
     
advantageString     
advantageIdLong     
alternativeCategoryQuantityInteger     
audienceSubCategoryString     
audienceSubCategoryExternalDescriptionString     
audienceSubCategoryIdLong     
audienceSubCategoryRankInteger     
basePriceInteger     
chargesType(OTHER|RESERVATION|
CANCELLATION)
     
contingentString     
contingentIdLong     
crossSellIdLong     
crossSellParentOperationIdsList of Long     
displayDateOnlyOfitemDateBoolean     
eventIdLong     
expirationDateDate     
fileIdLong     
hospitalityAreaString     
hospitalityAreaIdLong     
hospitalityAreaQuantityInteger     
hospitalityAreaSeatQuantityInteger     
hospitalityAreaType(SKYBOX|PREMIUM_SEATS|
BOTH)
     
hospitalityRoomString     
hospitalityRoomIdLong     
hospitalitySessionString     
hospitalitySessionCodeString (8)     
hospitalitySessionDateDate     
hospitalitySessionIdLong     
hospitalitySessionTimeDate     
itemString     
itemDateDateDate of timeslot pass item
itemDisplayExternalDesignationString     
itemIdLong     
kind(CHARGES|SIMPLE_PRODUCT|
SINGLE_ENTRY|
PRODUCT_COMPOSITION|
COMPOSED_PRODUCT|
OVERHEADS|SHIPPING_FEE|
PAYMENT_FEE|TR_BALANCE|
COMMISSION)
     
locationsList of Location     
matchMatch     
messageString     
nominativeboolean     
numberedboolean     
operationIdLong     
operationNumberLong     
optionState(PRE_SALES|PRE_REQUESTED|
REQUESTED|VALIDATED|
REJECTED)
     
parentOperationIdLong     
parentOperationLinkType(SEATING_C|SEATING_T|
CHARGES|
PRODUCT_COMPOSITION|
COMMISSION|ADD_SEATS|
SEATING_M)
     
performanceString     
performanceDateDate     
performanceDurationLong     
performanceIdLong     
performanceKindString     
physicalConfigurationIdLong     
priceType(PREDEFINED|DYNAMIC)     
productString     
productCodeString (8)     
productDesignationString     
productFamilySubType(SIMPLE_TICKET|
SEASONTICKET|MEMBERSHIP|
PACKAGE|STAY|SERVICE|
VOUCHER|GOODS|VISIT|OPEN|
OPEN_PASS|
DATE_SPECIFIC_PASS|
SPORTING_EVENT|RAILAWAY|
HOTEL|MUSEUM|ENTERT_PARK|
RESTAURANT|PRODLIB|
TIMESLOT_PASS|HOSPITALITY|
HOSPITALITY_PACKAGE|
CANCELLATION_INSURANCE|
VISIT_PASS)
     
productFamilyType(SINGLE_ENTRY|
SEASONTICKET|PASS|PACKAGE|
MEMBERSHIP|SERVICE|GOODS|
TRANSPORT|HOSPITALITY)
     
productIdLong     
quantityInteger     
seasonString     
seasonTicketSubjectString     
seasonTicketSubjectIdLong     
seatCategoryString     
seatCategoryBgColorString     
seatCategoryIdLong     
seatCategoryRankInteger     
siteString     
siteAddressPlaceAddress     
siteIdLong     
spaceString     
timeslotDurationLong     
timeslotIdLong     
totalAmountLong     
tripType(ONEWAY|RETURN)     
unitPriceInteger     
vatRateInteger     
visitGroupDataVisitGroupData     
waitingAccountBalanceLong     
withoutVatTotalAmountLong     

Location
siteAddressPlaceAddress     
siteCodeString (8)     
siteExternalNameExternalName60 characters max for each translation
spaceCodeString (8)     
spaceExternalNameExternalName60 characters max for each translation

PlaceAddress
countryCodeString (8)     
emailString     
faxString     
firstAddressLineString     
gpsLatitudeString     
gpsLongitudeString     
localityString     
phoneNumberString     
secondAddressLineString     
thirdAddressLineString     
zipCodeString (8)     

ExternalName
translationsList of Translation     

Translation
localeString (2)     
valueString     

Match
finalDateBoolean     
hostTeamString     
hostTeamIdLong     
opposingTeamString     
opposingTeamIdLong     
roundString     
roundCodeString (8)     
roundExternalNameExternalName60 characters max for each translation

VisitGroupData
fileRemarksList of String     
groupKindICString     
groupKindNameString     
groupNameString     
isGuidedboolean     
numberOfAccompaniersInteger     
numberOfParticipantsInteger     
pricingType(PER_PERSON|
GROUP_FLAT_RATE)
     
ticketType(INDIVIDUAL_TICKET|
GROUP_TICKET)
     
visitGroupIdLong     
visitLanguageCodeString (8)     
visitLanguageNameString     
visitThemeCodeString (8)     
visitThemeNameString     

createOrUpdateOrderWithGranularity

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

This method creates/updates an order and creates operations with both auto-attribution of seats on given preferred areas,blocks and manual-attribution on given physical seat definitions and creates movement with given parameters. Note: This method should be called only once when any kind of item is added into the cart. Example: When a composed product item is added you should send all the operation creation details of all compositions items selected inside it, then this method will create all operation/movements of composed product and product compositions for auto-attribution of seats in case of single entries operation creation. The parameters - operation creations lists accepts null but at least one of them should be given not-null.

Parameters

requestIdInteger-- (Optional) the requestId
pointOfSalesIdLongMandatory
-- (Mandatory) the pointOfSalesId
orderIdLong-- (Optional) the orderId, if orderId is given it is the one considered for updating order's contact,reference,origin info and creating operations, otherwise a new order is created with given {purchasersInfo}, {externalReference}, {origin} and operations.
fileIdLong     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
purchasersInfoList of ContactData-- (Optional) the list of purchasing contacts to be associated to order The first contact in the list is considered as main contact of the order and remaining contacts are associated to order (Example: different contacts for several season tickets in a single order)
externalReferenceString-- (Optional) the externalReference representing external distributor
composedProductOperationsList of ComposedProductOperationCreationData-- (Optional) the composed product(PACKAGE/SEASONTICKET) operation creation details with product compositions details inside it.
singleEntryAttributionOperationsList of SingleEntryOperationAttributionData-- (Optional) the single entry(PERFORMANCE/VISIT/MATCH) operation creation details with specifying autoAttribution,preferred areas/blocks.
simpleProductOperationsList of SimpleProductOperationCreationData-- (Optional) the simple product(SERVICE/GOODS/PASSDATED/OPENPASS/VOUCHER) operation creation details
transportProductOperationsList of TransportProductOperationCreationData-- (Optional) the transport product operation creation details (This parameter should be used only when transport operation is created after a package operation is created as transport operation cannot be created outside a package, but anyway with this new interface this parameter will not be used anytime as composedProductOperation creation automatically creates)
chargeOperationsList of ChargeOperation-- (Optional) the charges operations creation details
originOrderOriginData-- (Optional) the charges operations creation details
fileContactsList of FileContactData     
isResumeAllOptionOperationsbooleanMandatory
-- param to check whether resume all option operations or not
isResumeAllReservationOperationsbooleanMandatory
-- param to check whether resume all reservation operations or not
orderUpdateGranularity(OPERATION|MOVEMENT|
MOVEMENT_OR_OPERATION)
the granularity of the result object returned: should it contain all movement data or stop at operation granularity

Return value

OrderUpdateResult

createPaymentsAndCloseOrder

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Validates given order, creates payment and closes the order. This acts as a facade wrapping these three calls into one. {@link ExternalOrderService#validateOrder(Integer, Long, String, OrderType)} {@link ExternalPaymentService#createPayment(Integer, Long, String, List, PaymentParameters)} and {@link ExternalOrderService#closeOrder(Integer, ContactData, Long, List, String, boolean, Long, OrderType)}

Parameters

requestIdInteger     
orderIdLong     
paymentsList of PaymentInfo     
paymentParamsPaymentParameters     
externalReferenceString     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
maxWaitingTimeLong     
purchasersInfoList of ContactData     
ticketsList of TicketData     
externalRemarkString     
fileContactsList of FileContactData     
oneTimeCodesList of String     
fileDataFileData     
cancellationInsuranceDataCancellationInsuranceDataTODO
isConvertedReservationbooleanMandatory

PaymentInfo
amountLong     
cardAliasString     
cardExpirationDateDate     
cardMaskedNumberString     
contactReferenceString (20)     
paymentIdentifierString     
paymentMethodIdLong     
pspAdditionalReturnedDataString     
valueDateDate     

PaymentParameters
contactIdLong     
contactNumberString (20)     
creditWaitingAccountPaymentboolean     
operationIdsList of Long     
orderIdLong     
paymentParametersMapMap of (RETURN_URL|
ORDER_IDENTIFIER), String
     
pointOfSalesIdLong     
remarkString     
totalAmountLong     

TicketData
Class containing the ticket data :
  • ticketMedium, optional: specify the ticket medium
  • additionalInfo, optional: additional info for DataWareHouse
  • beneficiaryData, optional: beneficary data (name...)
additionnalInfoString     
containerIdentifierString     
holderInfoContactData     
startValidityDateDate     
ticketMedium(THERMAL|E_TICKET|MOBILE|
RFID)
     
barcodeString (8)     
movementIdLong     
taxNumberString     

FileData
acceptAlternateCategoriesBoolean     

CancellationInsuranceData
insuranceAmountLong     
insuranceIdLong     

Return value

PaymentAndCloseOrderResult
Class representing the response of createPaymentAndcloseOrder method in external order facade.
movementTicketDatasList of MovementTicketData     
orderUpdateDataOrderUpdateData     
paymentDetailsList of PaymentDetail     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

MovementTicketData
barcodeString (8)     
beneficiaryBirthdateDate     
beneficiaryCountryCodeString (8)     
beneficiaryIdNumberString     
cardTypeIdLong     
contactReferenceString (20)     
firstNameString     
instanceNumberString     
isLinkedToTicketDistributionboolean     
lastNameString     
movementIdLong     
questionnaireIdLong     
taxNumberString     
ticketIdLong     
ticketState(CONTROLLED|PRINTED|
NOT_PRINTED|INVALIDATED|
CANCELLED|EXPORTED)
     

PaymentDetail
amountLong     
cardTypeString     
epcTransactionDataEpcTransactionData     
externalUrlString (255)     
paymentDateDate     
paymentIdLong     
paymentIdentifierString     
paymentMethodPaymentMethod     
paymentStatus(WAITING|IN_PROGRESS|
AUTHORIZED|PAID|
CANCELLED_BY_USER|FAILED|
ABANDONED|
WAITING_MANUAL_VALIDATION|
FAILED_REJECTED)
     

EpcTransactionData
aliasPaymentDetailsList of EpcAliasPaymentDetails     
postPaymentDetailsEpcPostPaymentDetails     
redirectPaymentDetailsList of EpcRedirectPaymentDetails     
transactionIdint     

EpcAliasPaymentDetails
cardExpMonthEpcPaymentField     
cardExpYearEpcPaymentField     
cardHolderEpcPaymentField     
cardNumberEpcPaymentField     
cvvEpcPaymentField     
paymentMethodEpcPaymentMethod     
hiddenFieldsList of EpcField     
urlString (255)     

EpcPaymentField
definedValuesString     
editableboolean     
mandatoryboolean     
nameString     
valueString     

EpcPaymentMethod
cardValidationRegexString     
cvvLengthint     
isCvvMandatoryboolean     
codeString (8)     
descriptionString     

EpcField
nameString     
valueString     

EpcPostPaymentDetails
cardExpMonthEpcPaymentField     
cardExpYearEpcPaymentField     
cardHolderEpcPaymentField     
cardNumberEpcPaymentField     
cardTypeEpcPaymentField     
cvvEpcPaymentField     
paymentMethodsList of EpcPaymentMethod     
storeAliasEpcPaymentField     
hiddenFieldsList of EpcField     
urlString (255)     

EpcRedirectPaymentDetails
paymentMethodEpcPaymentMethod     
hiddenFieldsList of EpcField     
urlString (255)     

PaymentMethod
changeReturnAllowedBoolean     
codeString (8)     
externalNameExternalName60 characters max for each translation
forPaymentBoolean     
forReimbursementBoolean     
idLong     
inSplitPaymentAllowedBoolean     
internetCodeString (8)Comma separated list of allowed cards (VISA,AMEX...)
manualValidationBoolean     
minOrderAmountLong     
paymentType(NUM|CHEQ|CHEQCANCEL|CB|
CBCANCEL|PREPAY|VIR|AVR|
COUPON|VOUCHER|CTRM|EXT|
CA|BVR|INV|CANOAUTH|
DEPOSIT|SAPBTRANSF|
FIDELITY_POINT|DISCOUNT|
CB_WITH_VALIDATION|
DIRECT_DEBIT)
     
tooMuchPerceivedAllowedBoolean     
withFollowUpBoolean     

isExternalOrderFacadeAlive

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

validate network connection and login/password

Parameters

Return value

WebMethodResult
requestIdInteger     
statusCodeString (8)     
statusDetailString     

refundTicketOrder

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

requestIdInteger     
pointOfSalesIdLong     
orderType(SALE|REFUND_CLIENT|
REFUND_ORGANIZATION|
EXCHANGE_ORGANIZATION|
EXCHANGE_CLIENT|
RESERVATION|RENEWAL|
OPTION|
RESERVATION_FREEING|
OPTION_FREEING|
ST_TRANSFER)
     
orderIdLong     
externalReferenceString     
ticketInfosList of TicketInfo     
autoCloseBoolean     

TicketInfo
Class containing the ticket info :
  • movementId, mandatory: the SecuTix movement id
  • barcode, mandatory: the ticket bar code, used for access control
  • taxNumber, mandatory: the ticket tax number
barcodeString (8)     
movementIdLong     
taxNumberString     

Return value

OrderUpdateResult