S-360 Documentation

Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

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.

Use cases

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.

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 : this URL should look like https://service.webhost.skidata.com/dta/webservice/sc/v10/services
    2. username
    3. password
    4. contractor id (a series of number)
  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 Read 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)


Frequently asked questions

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:

  1. Run a Read Catalog schedule to see if any data are retrieved. If there is no error, it means that the problem was temporary and is now solved.
  2. Check that the URL in field URL is the right URL provided by Skidata. (if the communication between the systems already worked, this step can be skipped)
  3. Check that the setup element 2 (File a service request by SecuTix to have the URL whitelisted by the proxy) has been executed. (if the communication between the systems already worked, this step can be skipped)
  4. Contact Skidata DTA support to understand if the systems were up at the time of the problem.
  5. If none of the following steps explains the problem, contact SecuTix support.

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?


  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?




  • No labels