What is Otipass?
The digital passport of your territory Otipass proposes innumerous territories ( Paris Jerusalem Nantes Reims Bordeaux Lille Grenoble Côte d'Azur Villeneuve Nancy Mulhouse Alsace Dijon) digital passes to visit freely the most beautiful local sites. Every Pass is a real good plan: you benefit from a free entrance to each of the partner sites.
You can choose the duration of validity of the Pass according to the duration of your stay.
Otipass cards are now supported in SecuTix, which means visitors can enter as many museums as they wants in a given day with a single Otipass card.
In order to allow entries with Otipass cards, the following steps need to be configured:
- Validate scanned cards with Otipass system.
- Integrate sales in SecuTix with controlled Otipass cards.
Validate scanned cards with Otipass system
SecuTix Access control system system.
- In Institution menu / Organisations / open the access control parameters of the organization and check that the version of the APÏ used is 1.4+
- In Organization/Access control/External interfaces, create a new Otipass interface, containing the setup information received from Otipass
- Interface Type: OTIPASS
- URL, Username, Password information will be provided by the Otipass system
- Open a ENV JIRA to ask that the Otipass url is added to the autorizations in the proxy.
- Mapping Parameters
- Otipass information: SectorCode has to be defined in the mapping with the Otipass SpaceID.
- SecuTix information: SeasonCode and ProductCode are mandatory to create Sales in SecuTix.
Here you can download a correct reference mappings parameter.
Beware of the following two points:
- In the parameters, a given sector code can only appear once.
- The device scanning Otipass tickets must be linked to a door which must be associated to only one sector.
Scanning Otipass cards
There are two steps to the scanning:
- Detection: recognize Otipass card by using their detection algorithm (Card length + checksum + barcode content)
- Validatio
The operator will know the results is the visitor card is valid or not .
Once the valid card is scanned successfully, the access control server generates a specific barcode with format: "OTI+cardnumber+timestamp" and stores the additional information SeasonCode and ProductCode on this barcode.
Notes:
- In offline mode, only the detection step is done. If the scanner recognizes the Otipass card, then the access is granted.
- In the post-synchronization of offline checks, Otipass controls are stored with a specific barcode + seasonCode + productCode in the SecuTix access control server, similarly to the online mode.
Sales reintegration in SecuTix with controlled Otipass cards
For each successfully scanned Otipass card, an order with a corresponding ticket will be created in SecuTix as a regular sales in order to have a consistent view of the sales and attendances in the reporting.
This requires the following configuration:
- Synchronize Otipass barcodes to SecuTix thanks to the new version of the access control interface (v1.4) and a new mapping between ProductCode and Tariff. ( How to below)
- Create sales using the current external sales interface.
SecuTix catalogue and specific external sales interface
As the Otipass card can be controlled several times, the Otipass related products have to be configured using the Open Pass product family.
- Create an Open pass that will represent the Otipass entrances.
- Create an External Sales channel: type "STX_File" (Note: Sales channel Code has to be exactly "OTIPASS")
- Associate an external contingent to that sales channel (let us call it "OTIPASS", but the name and code do not matter)
- Create Otipass contact allowing payment mode Pending account.
- Create an external interface related to that sales channel.
- Give Otipass contingent quota to the OTIPASS product.
- Add a mapping in the access control interface (see below)
New mapping in SecuTix Access control interface
For each synchronized Otipass barcode, we can link seasonCode, productCode, tariff to prepare data for the external sales integration.
