Skidata DTA is a ticketing system provided by Skidata company and accessible through APIs.

Use cases

The use cases below only apply to the products handled by Skidata DTA interface.

RFID loading

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.

Reservations

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.

Refunds

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.

Setting the interface up a Skidata DTA interface for a new place

1. Ask your Skidata DTA partner to provide you the following parameters:
   1. url
   2. username
   3. password
   4. contractor id.
2. File a service request by SecuTix to have the URL whitelisted by the proxy
3. Create a new external manager interface of type Skidata DTA v2. The other type is deprecated and not supported.
4. Fille the following values according to the screen capture below
   1. 1 - URL
   2. 2 - Username
   3. 3 - Password
   4. 4 - Contractor id
   5. 5 - put here LOAD_RFID_CARD (this is the shipment type code of the shipment modes related to RFID loading)
   6. 6 - put here the following values:
      1. setValidityDateFromMovement=true
         movementValidity=false
5. In the schedules screen, create a new schedule called Run Catalog and execute it immediately. If it is working and displaying you product ids and tariff ids, the connection is working
6. In the mappings, map the SecuTix products (visit passes or timeslot passes) to Skidata product ids and the SecuTix tariffs to Skidata tariff ids. (mappings example below)

Image Added

Image Added

Frequently asked questions

What does the following error in the execution mean?
à Cancelation of a 'Reservation'-order is not allowed.

1. Why is there a “Read time out” error in the execution?

VWO: No answer from Skidata

1. What does the following error mean?
   à Unable to cancel an order with an order type of "TICKET_RESERVATION”

1. Why is the execution still set on “OPEN”?

1. Why is it possible to cancel controlled tickets in some interfaces and in other interfaces it is giving an error?

1. 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)

1. How can I check for which order the error appeared?

1. How can I know, which customer was concerned in the error?

1. How could the customer load the swisspass even though the Skidata interface is not yet set up?

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.

1. Why is there the same error message for controlled and out of validity tickets?
   à Message: Ticket has already been consumed

1. "Referenced consumer category "ERWHTA16" is not defined" – What does this message mean?

1. Why are the different Skidata interfaces processing cancellations in a different way?

1. How can we reintegrate tickets in a Skidata interface, if we set up the interface after some sales have been done?

1. Why do we only receive a warning and not an error in the old Skidata interface when a cancellation is failing in Skidata, but working in Secutix?

1. Why are we not receiving email notifications for warnings in Skidata interfaces?