Skidata DTA is a ticketing system provided by Skidata company and accessible through APIs. SecuTix can connect to it to cover some specific use cases detailed below.
Skidata DTA is different from Skidata Handshake, the access control system.
A product will be handled by Skidata DTA interface if and only if a mapping exists for that product for that specific interface. |
The use cases below only apply to the products handled by Skidata DTA interface.
When a ticket is bought in SecuTix for a product handled by the Skidata DTA interface,
with shipment mode type RFID (see parameter 5 below),
it is possible for the buyer to load this ticket on a SwissPass or on a Skidata token card to directly pass at the gates with it.
Technical note: this loading is done by creating an order in Skidata DTA system and associating the SwissPass E-id or the Skidata token card id to this order.
When a ticket is bought in SecuTix for a product handled by the Skidata DTA interface,
with shipment mode type different than RFID (see parameter 5 below),
the ticket produced by SecuTix gets a barcode which is an 8 character reservation code, allowing to exchange it onsite for a Skidata keycard.
Technical note: this is done by creating a reservation order in Skidata DTA.
When one of the tickets mentionned above is refunded/cancelled, SecuTix tries to cancel the orders created in Skidata DTA. If the cancellation fails, the refund is still working in SecuTix but error messages are logged indicating that the cancellation failed in Skidata DTA.
1. What does the following error in the execution logs mean? A Cancelation of a 'Reservation'-order is not allowed.
When cancelling an order, SecuTix does not know if it is a reserved order or a normal order. It tries first to cancel it as a reserved order, then as a normal order. If an order is not a reserved order, the error message above is displayed.
2. Why is there a “Read time out” error in the execution logs?
Because SecuTix could not connect to the remote Skidata DTA system. The next steps to analyse the problem here are:
3. What does the following error mean ? Unable to cancel an order with an order type of "TICKET_RESERVATION”
Same answer as for 1.
4. Why is the execution still set on “OPEN”?
All executions of functions different from Read Catalog are what SecuTix calls daily executions. Those executions are opened dated midnight at the first interaction of the day with Skidata and are closed at the first interaction of the same kind on a subsequent day.
5. Why is it possible to cancel controlled tickets in some interfaces and in other interfaces it is giving an error?
This question concerns Skidata DTA possibilities. SecuTix has no control over the features of that system.
6. Why do I receive the following error and what does it mean? ERROR [External error] Failed to connect to the external system. (Cancelation of any ticket item of order item "79fd0ab0-6170-11eb-8f33-005056926684" not allowed, because it is already cancelled)
This error message is returned when SecuTix retries to cancel an order already cancelled in Skidata DTA. The order may have been cancelled on Skidata DTA side or SecuTix is processing to a retry. The latter case is a normal case and should raise no alarm.
How can I check for which order the error appeared?
VWO: A ticket can be load on swisspass if the product has this shipment mode associated. Swisspass loading does not need a Skidata interface. Product is live with shipment mode Swisspas = it is possible to load.