Service: ProductionPublicService

Version: 1_9 (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/tnpsb/external-remoting/com.secutix.facade.production.v1_9.ProductionPublicService.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.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.

Methods:

cancelTicketResales

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Cancel tickets that put on resale.

Parameters

ticketIdsList of LongThe Ids of tickets.
contactNumberString (20)The number of contact who resell tickets.

Return value

WebMethodResult
requestIdInteger     
statusCodeString (8)     
statusDetailString     

createDefaultDocuments

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Creates default documents for an order. Information contained in the DocumentInformation may override some values of the newShipmentOptions

Parameters

shipmentOptionsShipmentOptionsthe options to create the new shipments.
pointOfSalesIdlongMandatory
actionKindsList of Stringthe actionsKind of the order
documentTuningDocumentsInformation     

ShipmentOptions
addRarDocumentboolean     
contactAddressIdLong     
contactIdLong     
emailString     
orderIdLong     
rarNumberString     
shipmentModeIdLong     

DocumentsInformation
allDocumentsList of DocumentInformation     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

DocumentInformation
addressIdLong     
contactIdLong     
documentToSendIdLong     
documentTypeIdLong     
emailString     
isImmediateboolean     
operation(ADD|MODIFY|REMOVE|
SKIPPED)
     
rarRefNumberString     
shipmentModeIdLong     
withTicketsboolean     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

Return value

CreatedDocumentsInformation
allDocumentsList of CreatedDocumentInformation     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

CreatedDocumentInformation
documentIdLong     
isEmailContentboolean     
isRarDocumentboolean     
shipmentIdlong     
statusString     
addressIdLong     
contactIdLong     
documentToSendIdLong     
documentTypeIdLong     
emailString     
isImmediateboolean     
operation(ADD|MODIFY|REMOVE|
SKIPPED)
     
rarRefNumberString     
shipmentModeIdLong     
withTicketsboolean     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

createReprintShipment

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Creates shipments to reprint/duplicate tickets and documents

Parameters

shipmentOptionsShipmentOptionsthe options to create the new shipments. orderId must be filled if documents are provided
pointOfSalesIdlongMandatory
ticketIdsList of Longid of the tickets
documentIdsList of Longid of the documents
creationCause(PRINT|REPRINT|DUPLICATE|
PRINT_FILE)
     
invalidationCause(NOT_CANCELLED|REFUNDED|
LOSS|THEFT|OTHER|
EBO_CANCELLED|FORBIDDEN|
REPRINT|PRINT_KO|
CHANGE_RFID)
     

Return value

ShipmentsData
dataList of ShipmentData     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

ShipmentData
contactAddressIdLong     
contactIdLong     
documentsIdsList of Long     
emailIdLong     
idlong     
rarDocumentIdLong     
referenceNumberString     
shipmentModeIdLong     
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)
     
ticketIdsList of Long     

getAvailableTicketSupports

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Retrieve the available tickets supports for the given list of tickets identified by their IDs

Parameters

ticketIdsList of Longlist of technical identifier of the tickets to be considered

Return value

AvailableTicketSupportsResult
availableTicketSupportsList of AvailableTicketSupports     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

AvailableTicketSupports
cardNumberString     
cardTypesList of CardTypeData     
firstNameString     
lastNameString     
ticketIdLong     
ticketSupportDataList of TicketSupportData     

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

TicketSupportData
nameString     
ticketSupport(THERMAL|ETICKET|PAPER_A4|
PASSBOOK|MOBILE|BADGE|
RFID|PR_RFID_CARD|
DEMAT_BADGE)
     

getDocuments

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

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

Parameters

documentIdsList of Longlist of technical identifier of the documents to consider.
contactNumberString (20)contact number of contact linked to the documents by the shipments.

Return value

PrintableDocumentsData
documentsList of PrintableDocumentData     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

PrintableDocumentData
databyte     
filenameString     
mimetypeString     
EMPTY_IDlong     
idlong     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

getFileSummaryDocument

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Parameters

fileIdLong     
contactNumberString (20)     
contactAddresIdLong     

Return value

PrintableDocumentsData

getTicketTemplates

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

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.

Parameters

posIdLong     
productIdsList of Long     

Return value

TicketTemplateResult
productTicketTemplatesList of ProductTicketTemplate     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

ProductTicketTemplate
productIdLong     
ticketTemplatebyte     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

getTickets

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

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.

Parameters

ticketIdsList of Longlist of technical identifier of the tickets to consider.
contactNumberString (20)contact number of contact is allowed to download the tickets.
beneficiariesList of TicketBeneficiaryDatalist of beneficiaries for the tickets; optional.
ticketSupportsList of (THERMAL|ETICKET|PAPER_A4|
PASSBOOK|MOBILE|BADGE|
RFID|PR_RFID_CARD|
DEMAT_BADGE)
     
questionnaireAnswersList of AnswerQuestionnaire     

TicketBeneficiaryData
beneficiaryBirthdateDate     
beneficiaryCountryCodeString (8)     
beneficiaryFirstnameStringMandatory
beneficiaryIdNumberString     
beneficiaryLastnameStringMandatory
ticketIdlongMandatory

AnswerQuestionnaire
answerQuestionsList of AnswerQuestionMandatory
ticketIdLongMandatory

AnswerQuestion
answerCodesList of StringMandatory
questionCodeString (8)Mandatory

Return value

PrintableTicketsData
ticketsList of PrintableTicketData     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

PrintableTicketData
barcodeString (8)     
humanReadableBarcodeString (8)     
databyte     
filenameString     
mimetypeString     
EMPTY_IDlong     
idlong     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

getTicketsToResell

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Get the list of tickets to resell.

Parameters

itemIdsList of Longthe list of item ids
performanceIdsList of Longthe list of performance ids
dateDate     

Return value

TicketResaleGroups
dateDate     
ticketResaleGroupsList of TicketResaleGroup     
expectedExceptionboolean     
statusMessageString     
requestIdInteger     
statusCodeString (8)     
statusDetailString     

TicketResaleGroup
areaIdLong     
audienceSubCategoryIdLong     
blockIdLong     
itemIdLong     
performanceIdLong     
quantityInteger     
seatCategoryIdLong     
ticketResaleSeatsList of TicketResaleSeat     
unitAmountInteger     

TicketResaleSeat
endValidityDateDate     
movementIdLong     
realAmountInteger     
remarkString     
resaleState(OPEN|PROCESSING|RESOLD|
INVALIDATED|CANCELED)
     
seatIdLong     
startValidityDateDate     

loadTicketsOnCard

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Load tickets on badge/RFID card.

Parameters

ticketDefinitionsList of TicketBeneficiaryData     
containerIdentifierStringcontainer identifier used to update tickets
cardTypeIdLongMandatory
specify the chosen card type id(optional for loading on Badge cards but mandatory for RFID cards).
questionnaireAnswersList of AnswerQuestionnaire     

Return value

WebMethodResult

resellTickets

REST_RPCMOSACUBEPLAY
SOAPMOSACUBEPLAY

Put list of tickets to resale.

Parameters

ticketsList of TicketResaleDataThe list of ticket data that contains ticket Id and resale amount.
contactNumberString (20)The number of contact who buying tickets.
paymentMethodIdLongThe payment method Id
remarkStringThe remark of the resale tickets.

TicketResaleData
ticketIdLong     
unitAmountInteger     

Return value

WebMethodResult