URL: | ||
JWT Token | ||
Template: | ||
cURL: |
Version: 1_18 (other versions, change log, ZUMSTEIN_V3.12-SNAPSHOT) Active version. This version can be subject to minor retro-compatible changes without warnings.
SOAP Demo endpoint: https://myinstit.ws.secutix.com/tnpsb/external-remoting/com.secutix.facade.production.v1_18.ProductionPublicService.webservice?wsdl
REST Demo endpoint (only POST): https://myinstit.ws.secutix.com/tnpsb/backend-apis/productionPublicService/v1_18/{methodName} Replace {methodName} for the desired method name as shown below.
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.Production public service. This service responsibility is the production of printable elements, that is, mostly tickets and documents. This service handle the proper generation of those elements, and the transfer of their content to the calling service.
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Cancel tickets that put on resale.
ticketIds | List of Long | The Ids of tickets. |
contactNumber | String (20) | The number of contact who resell tickets. |
WebMethodResult | ||
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Checks if allowed contingents have changed since the lastUpdate
lastUpdate | Date |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Creates default documents for an order. Information contained in the DocumentInformation may override some values of the newShipmentOptions
shipmentOptions | ShipmentOptions | the options to create the new shipments. |
pointOfSalesId | long | Mandatory |
actionKinds | List of String | the actionsKind of the order |
documentTuning | DocumentsInformation |
ShipmentOptions | ||
addRarDocument | boolean | |
contactAddressId | Long | |
contactId | Long | |
contactNumber | String (20) | |
documentToSendIdsPrintCollect | List of Long | |
String | ||
emailDocumentTypeId | Long | |
immediate | Boolean | |
orderId | Long | |
printConfiguredDocumentsCheckbox | Boolean | |
rarNumber | String | |
shipmentModeId | Long | |
skipShipmentModeCheck | Boolean |
DocumentsInformation | ||
allDocuments | List of DocumentInformation | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
DocumentInformation | ||
addressId | Long | |
contactId | Long | |
documentToSendId | Long | |
documentTypeId | Long | |
String | ||
isImmediate | boolean | |
operation | (ADD|MODIFY|REMOVE| SKIPPED) | |
rarRefNumber | String | |
shipmentModeId | Long | |
withTickets | boolean | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
CreatedDocumentsInformation | ||
allDocuments | List of CreatedDocumentInformation | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
CreatedDocumentInformation | ||
documentId | Long | |
isEmailContent | boolean | |
isRarDocument | boolean | |
shipmentId | long | |
status | String | |
addressId | Long | |
contactId | Long | |
documentToSendId | Long | |
documentTypeId | Long | |
String | ||
isImmediate | boolean | |
operation | (ADD|MODIFY|REMOVE| SKIPPED) | |
rarRefNumber | String | |
shipmentModeId | Long | |
withTickets | boolean | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Creates shipments to reprint/duplicate tickets and documents
shipmentOptions | ShipmentOptions | the options to create the new shipments. orderId must be filled if documents are provided |
pointOfSalesId | long | Mandatory |
ticketIds | List of Long | id of the tickets |
documentIds | List of Long | id of the documents |
creationCause | (PRINT|REPRINT|DUPLICATE| PRINT_FILE|INVALIDATE) | |
invalidationCause | (NOT_CANCELLED|REFUNDED| LOSS|THEFT|OTHER| EBO_CANCELLED|FORBIDDEN| REPRINT|PRINT_KO| CHANGE_RFID|INVALIDATE| RESOLD|RESEAT| OTHER_SECURITY_REQUEST_BL| OTHER_PNA_REQUEST_BL| LOSS_COURIER_FAILURE| LOSS_RETURN_DISTRIBUTION| REPRINT_RESEAT| REPRINT_CONTACT_PAPER| REPRINT_CONTACT_MOBILE| REPRINT_DAMAGED| REPRINT_PNA_ON_SITE| REPRINT_ORG_PAPER| REPRINT_ORG_MOBILE| REPRINT_APP_PAPER| ITA_WRONG_DATA| ITA_INVALID_PRINT| ITA_TRANS_NOT_COMPLETED| ITA_CUSTOMER_REQUEST| ITA_SERVICE_REASON| ITA_EVENT_CANCELLATION| ITA_CUST_NAME_CHANGE| ITA_THEFT_LOSS| ITA_UPSELLING| RESALE_PENDING| RESALE_CANCELLED| MOBILE_TAKE_BACK) |
ShipmentsData | ||
data | List of ShipmentData | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
ShipmentData | ||
contactAddressId | Long | |
contactId | Long | |
documentsIds | List of Long | |
emailId | Long | |
id | long | |
rarDocumentId | Long | |
referenceNumber | String | |
shipmentModeId | Long | |
shipmentModeTypeEnum | (HANDED_AT_BO| HANDED_POSTPONED| LEFT_AT_CONTROL|BY_MAIL| BY_RECOMMANDED_MAIL| BY_BROKER|BY_EMAIL| PRINT_AT_HOME|DHL|FEDEX| MOBILE|LOAD_BADGE| LOAD_RFID_CARD|ELECTRONIC| BLOCKCHAIN) | |
ticketIds | List of Long |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
shipmentOptions | ShipmentOptions | |
pointOfSalesId | long | Mandatory |
ticketIds | List of Long | |
documentIds | List of Long | |
creationCause | (PRINT|REPRINT|DUPLICATE| PRINT_FILE|INVALIDATE) | |
invalidationCause | (NOT_CANCELLED|REFUNDED| LOSS|THEFT|OTHER| EBO_CANCELLED|FORBIDDEN| REPRINT|PRINT_KO| CHANGE_RFID|INVALIDATE| RESOLD|RESEAT| OTHER_SECURITY_REQUEST_BL| OTHER_PNA_REQUEST_BL| LOSS_COURIER_FAILURE| LOSS_RETURN_DISTRIBUTION| REPRINT_RESEAT| REPRINT_CONTACT_PAPER| REPRINT_CONTACT_MOBILE| REPRINT_DAMAGED| REPRINT_PNA_ON_SITE| REPRINT_ORG_PAPER| REPRINT_ORG_MOBILE| REPRINT_APP_PAPER| ITA_WRONG_DATA| ITA_INVALID_PRINT| ITA_TRANS_NOT_COMPLETED| ITA_CUSTOMER_REQUEST| ITA_SERVICE_REASON| ITA_EVENT_CANCELLATION| ITA_CUST_NAME_CHANGE| ITA_THEFT_LOSS| ITA_UPSELLING| RESALE_PENDING| RESALE_CANCELLED| MOBILE_TAKE_BACK) | |
shipmentPickupData | ShipmentPickupData | |
collectionDateTime | Date |
ShipmentPickupData | ||
contactId | Long | |
data | byte | |
filename | String | |
mimetype | String | |
remark | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Creates shipments to reprint/duplicate tickets and documents after updating the cultural contact, if the culturalContactId is passed
shipmentOptions | ShipmentOptions | the options to create the new shipments. orderId must be filled if documents are provided |
pointOfSalesId | long | Mandatory |
ticketIds | List of Long | id of the tickets |
documentIds | List of Long | id of the documents |
creationCause | (PRINT|REPRINT|DUPLICATE| PRINT_FILE|INVALIDATE) | |
invalidationCause | (NOT_CANCELLED|REFUNDED| LOSS|THEFT|OTHER| EBO_CANCELLED|FORBIDDEN| REPRINT|PRINT_KO| CHANGE_RFID|INVALIDATE| RESOLD|RESEAT| OTHER_SECURITY_REQUEST_BL| OTHER_PNA_REQUEST_BL| LOSS_COURIER_FAILURE| LOSS_RETURN_DISTRIBUTION| REPRINT_RESEAT| REPRINT_CONTACT_PAPER| REPRINT_CONTACT_MOBILE| REPRINT_DAMAGED| REPRINT_PNA_ON_SITE| REPRINT_ORG_PAPER| REPRINT_ORG_MOBILE| REPRINT_APP_PAPER| ITA_WRONG_DATA| ITA_INVALID_PRINT| ITA_TRANS_NOT_COMPLETED| ITA_CUSTOMER_REQUEST| ITA_SERVICE_REASON| ITA_EVENT_CANCELLATION| ITA_CUST_NAME_CHANGE| ITA_THEFT_LOSS| ITA_UPSELLING| RESALE_PENDING| RESALE_CANCELLED| MOBILE_TAKE_BACK) | |
culturalContactId | Long | id of the cultural contact to update |
shipmentPickupData | ShipmentPickupData | |
collectionDateTime | Date |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Retrieve the available tickets supports for the given list of tickets identified by their IDs
ticketIds | List of Long | list of technical identifier of the tickets to be considered |
AvailableTicketSupportsResult | ||
availableTicketSupports | List of AvailableTicketSupports | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
AvailableTicketSupports | ||
cardNumber | String | |
cardTypes | List of CardTypeData | |
firstName | String | |
lastName | String | |
ticketId | Long | |
ticketSupportData | List of TicketSupportData |
CardTypeData | ||
cardTypeId | Long | |
code | String (8) | |
control | String | |
externalName | String | |
logoUrl | String (255) | |
printable | Boolean |
TicketSupportData | ||
name | String | |
ticketSupport | (THERMAL|ETICKET|PAPER_A4| PASSBOOK|MOBILE| BLOCKCHAIN|BADGE|RFID| PR_RFID_CARD| DEMAT_BADGE) |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
culturalContactNumbers | Collection of String |
CardsDataResult | ||
cards | List of CardData | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
CardData | ||
cardNumber | String | |
cardTypeData | CardTypeData | |
lastUsedDate | Date | |
linkedContactNumber | String (20) |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Retrieve the given document data for documents identified by their IDs. The same processing applied in
{@link #getDocument(long, String)} is applied for each document, except for inexistent documents. If a document
cannot be found in the system, nothing will be returned for this element. Meaning that the returned list will
contain less elements than requested.
For performance reasons, this method will only consider the
documentIds | List of Long | list of technical identifier of the documents to consider. |
contactNumber | String (20) | contact number of contact linked to the documents by the shipments. |
PrintableDocumentsData | ||
documents | List of PrintableDocumentData | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
PrintableDocumentData | ||
data | byte | |
filename | String | |
mimetype | String | |
EMPTY_ID | long | |
id | long | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
fileId | Long | |
contactNumber | String (20) | |
contactAddresId | Long |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Get list reusable vouchers by contact.
contactNumber | String (20) | The number of contact who buying tickets. |
VoucherInstancesData | ||
voucherInstanceData | List of VoucherInstanceData | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
VoucherInstanceData | ||
expirationDate | Date | |
identifier | String | |
paymentDteLogLu | Date | |
remainingAmount | MoneyData |
MoneyData | ||
currency | String | |
digits | int | |
value | BigDecimal |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Returns all the tickets in the specified shipment, with all details required for thermal printing on the configured hardware.
requestId | Long | optional |
shipmentId | Long | |
markTicketsAsPrinted | boolean | Mandatory boolean parameter to control if the tickets should be marked as printed or not by default |
ThermalPrintableTicketsResult | ||
cuttingSet | Set of Long | |
shipmentId | Long | |
thermalPrintableTickets | List of ThermalPrintableTicket | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
ThermalPrintableTicket | ||
cuttingMode | (NONE|AFTER_EACH_TICKET| AFTER_EACH_ORDER| AT_THE_END_OF_MASS_PRINTING) | |
data | byte | Binary data to be printed. |
dataEncoding | (ISO_8859_1|UTF_8| BINARY) | Encoding of {@link #data} |
id | long | Id of the ticket or document. |
metadata | Map of StringString | contains the same metadata as in JMS version, see twiki |
mimeType | String | Mime type of {@link #data} |
printableType | (TICKET|DOCUMENT) | Type of the printable |
readableReference | String | comprehensible information to identify the printable |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
This method is used to get available ticket templates of each product for a point of sales by applications that desire to produce ticket themselves.
posId | Long | |
productIds | List of Long |
TicketTemplateResult | ||
productTicketTemplates | List of ProductTicketTemplate | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
ProductTicketTemplate | ||
productId | Long | |
ticketTemplate | byte | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Retrieve the given ticket data for tickets identified by their IDs. The same processing applied in
{@link #getTicket(long, String)} is applied for each ticket, except for inexistent tickets. If a ticket cannot be
found in the system, nothing will be returned for this element. Meaning that the returned list will contain less
elements than requested.
For performance reasons, this method will only consider the first {@link #MAX_ELEMENTS} elements. If more tickets
are requested, they will be ignored.
ticketIds | List of Long | list of technical identifier of the tickets to consider. |
contactNumber | String (20) | contact number of contact is allowed to download the tickets. |
beneficiaries | List of TicketBeneficiaryData | list of beneficiaries for the tickets; optional. |
ticketSupports | List of (THERMAL|ETICKET|PAPER_A4| PASSBOOK|MOBILE| BLOCKCHAIN|BADGE|RFID| PR_RFID_CARD| DEMAT_BADGE) | |
questionnaireAnswers | List of AnswerQuestionnaire |
TicketBeneficiaryData | ||
beneficiaryBirthPlace | String | |
beneficiaryBirthRegion | String | |
beneficiaryBirthdate | Date | |
beneficiaryCountryCode | String (8) | |
beneficiaryFirstname | String | Mandatory |
beneficiaryIdNumber | String | |
beneficiaryLastname | String | Mandatory |
ticketId | long | Mandatory |
AnswerQuestionnaire | ||
answerQuestions | List of AnswerQuestion | Mandatory |
ticketId | Long | Mandatory |
AnswerQuestion | ||
answerCodes | List of String | Mandatory |
questionCode | String (8) | Mandatory |
PrintableTicketsData | ||
tickets | List of PrintableTicketData | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
PrintableTicketData | ||
barcode | String (8) | |
cardVisualId | String | |
containerIdentifier | String | |
humanReadableBarcode | String (8) | |
shipmentId | Long | |
state | (CONTROLLED| CONTROLLED_OUT|PRINTED| NOT_PRINTED|INVALIDATED| CANCELLED|EXPORTED) | |
taxNumber | String | |
ticketSupport | (THERMAL|ETICKET|PAPER_A4| PASSBOOK|MOBILE| BLOCKCHAIN|BADGE|RFID| PR_RFID_CARD| DEMAT_BADGE) | |
data | byte | |
filename | String | |
mimetype | String | |
EMPTY_ID | long | |
id | long | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Get the list of tickets to resell.
itemIds | List of Long | the list of item ids |
performanceIds | List of Long | the list of performance ids |
date | Date | |
privateBucketIdentifier | String | Identifier (as a string) of the bucket in which the private resales are stored. If empty means general public. |
TicketResaleGroups | ||
date | Date | |
ticketResaleGroups | List of TicketResaleGroup | |
expectedException | boolean | |
statusMessage | String | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
TicketResaleGroup | ||
areaId | Long | |
audienceSubCategoryId | Long | |
blockId | Long | |
itemId | Long | |
performanceId | Long | |
quantity | Integer | |
seatCategoryId | Long | |
ticketResaleSeats | List of TicketResaleSeat | |
unitAmount | Long |
TicketResaleSeat | ||
companion | boolean | |
companionTicketResaleId | Long | |
endValidityDate | Date | |
movementId | Long | |
realAmount | Long | |
remark | String | |
resaleAdvantageIds | Set of Long | |
resaleScope | (PUBLIC|PRIVATE) | |
resaleState | (OPEN|PROCESSING|RESOLD| INVALIDATED|CANCELED) | |
seatDefinition | SeatDefinition | |
seatId | Long | |
startValidityDate | Date | |
ticketResaleId | Long | |
withCompanion | boolean | |
withoutCompanion | boolean |
SeatDefinition | ||
UNDEFINED | String | |
areaId | Long | |
areaKind | (INDIFFERENT|BOX) | |
available | boolean | |
blockId | Long | |
contingentId | Long | |
number | String | |
physicalSeatId | Long | |
rotation | int | |
row | String | |
scenePanoLink | String | |
scenePhotoLink | String | |
seatCategoryId | Long | |
x | int | |
y | int |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Retrieve the given tickets and associates them with the given shipment mode. If no shipment of this mode is associated with the ticket, the shipment is created and associated to the ticket. There may be some consistency issues between shipmentMode and TicketSupport, that have to be checked. For performance reasons, this method will only consider the first {@link #MAX_ELEMENTS} elements. If more tickets are requested, they will be ignored.
shipmentModeId | long | Mandatory |
ticketIds | List of Long | list of technical identifier of the tickets to consider. |
contactNumber | String (20) | contact number of contact is allowed to download the tickets. |
beneficiaries | List of TicketBeneficiaryData | list of beneficiaries for the tickets; optional. |
ticketSupports | List of (THERMAL|ETICKET|PAPER_A4| PASSBOOK|MOBILE| BLOCKCHAIN|BADGE|RFID| PR_RFID_CARD| DEMAT_BADGE) | |
questionnaireAnswers | List of AnswerQuestionnaire |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
requestId | Long | |
voucherCriteria | VoucherCriteria | contactNumber: the logged in contact to query his voucher voucherType: target voucher type to find voucherIdentifier: specific voucher identifier to query voucherSortingCriteria: chosen sorting option to display the paging list of purchased vouchers paginationStart: page number, start from 1 according to common paging strategy of front-end paginationLimit: number of vouchers to display each page |
VoucherCriteria | ||
contactNumber | String (20) | |
paginationLimit | int | |
paginationStart | int | |
voucherIdentifier | String | |
voucherSortingCriteria | VoucherSortingCriteria | |
voucherType | (FINANCIAL_VOUCHER| EXPERIENCE_VOUCHER) |
VoucherSortingCriteria | ||
ascending | boolean | |
voucherSortingType | (EXPIRY_DATE| PURCHASE_DATE) |
VoucherResult | ||
totalVoucherCount | int | |
voucherInfo | List of VoucherData | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
VoucherData | ||
fileId | Long | |
itemId | Long | |
logoLargeUrl | String (255) | |
logoMediumUrl | String (255) | |
logoSmallUrl | String (255) | |
logoXLargeUrl | String (255) | |
movementId | Long | |
operationId | Long | |
packageExternalName | ExternalName | 60 characters max for each translation |
packageId | Long | |
parentOperationId | Long | |
seatCatId | Long | |
state | (CONTROLLED| CONTROLLED_OUT|PRINTED| NOT_PRINTED|INVALIDATED| CANCELLED|EXPORTED) | |
tariffCode | String (8) | |
tariffExternalName | ExternalName | 60 characters max for each translation |
tariffId | Long | |
voucherEndValidity | Date | |
voucherExternalName | ExternalName | 60 characters max for each translation |
voucherId | Long | |
voucherIdentifier | String | |
voucherItemExternalName | ExternalName | 60 characters max for each translation |
voucherStartValidity | Date |
ExternalName | ||
translations | List of Translation |
Translation | ||
locale | String (2) | |
value | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Load tickets on badge/RFID card.
ticketDefinitions | List of TicketBeneficiaryData | |
containerIdentifier | String | container identifier used to update tickets |
questionnaireAnswers | List of AnswerQuestionnaire | |
cardLoadingQuestions | List of SimpleQuestion | list of answers for questions required by the card type (Eg. SWISSPASS requires zip code) |
SimpleQuestion | ||
answer | String | |
key | String | |
translation | String |
LoadTicketOnCardResult | ||
cardTypeId | Long | |
questions | List of SimpleQuestion | |
requestId | Integer | |
statusCode | String (8) | |
statusDetail | String |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Mark the ticket as printed
requestId | Long | |
ticketId | Long | ticketId that will be marked as printed |
shipmentId | Long |
REST_RPC | MOSA | CUBE | PLAY |
SOAP | MOSA | CUBE | PLAY |
Put list of tickets to resale.
tickets | List of TicketResaleData | The list of ticket data that contains ticket Id and resale amount. |
contactNumber | String (20) | The number of contact who buying tickets. |
paymentMethodId | Long | The payment method Id |
remark | String | The remark of the resale tickets. |
privateBucketIdentifier | String | Identifier (as a string) of the bucket in which the private resales are stored. If empty means general public. |
TicketResaleData | ||
companionTicketId | Long | |
companionUnitAmount | Long | |
ticketId | Long | |
unitAmount | Long |