S-360 Documentation

Page tree

Versions Compared

Old Version 2

changes.mady.by.user LKL

Saved on

compared with

New Version 3

changes.mady.by.user LKL

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Table of Contents

Use cases

Warning
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,

...

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,

...

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)


Frequently asked questions

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

...