/
How to Push Barcodes to External Resellers

How to Push Barcodes to External Resellers

Mar 28, 2022

SecuTix offers an interface allowing its customers to easily push small quantities of barcodes to external resellers.

What is the data format ?

Barcodes are exported in a flat file. Encoding: UTF-8, field separator: semicolon.

You can download a file example here : example file.

File format and content can be customized. Customization of the file content is a paying service.

 

 

 

 

BAR_CODE

Barcode

TICKET_STATE

PRINTED, NOT_PRINTED, CANCELLED, INVALIDATED, CONTROLLED

FILE_NUMBER

File number

PRODUCT_CODE

Code of the product

PRODUCT_NAME

Name of the product

VALIDITY_DATE

Validity date of the ticket

TARIFF_CODE

Code of the tariff

TARIFF_NAME

Name of the tariff

PRICE

Price of the ticket

ORDER_DATE

Sale date

CONTACT_NUMBER

Number of the contact associated to the ticket

 

How does it work ?

To work properly, a contact mapping or a sales channel mapping must be setup in this interface.

When tickets are bought by this contact OR on the sales channel related to the mappings, a file containing the data defined above about the ticket is sent to an email provided when setting up the interface (see below).

The email is sent every 15 minutes, containing all the tickets created in the last 15 minutes.

 

This interface runs every 15 minutes. 

How to activate the interface ?

Activation can be done directly, following the following process, or by opening a Kayako ticket.

  1. In Organization→Tools→List of interfaces, create a new interface of type "Export", sub type "Files"

  2. Give it a name. (Like "Barcodes for MyResellerCompany"). Leave url, login, password and other fields empty.

  3. In the Interface Mappings screen, create a mapping for the contact(s) or the sales channel you are referring to.

    1. Note : to create a mapping for a contact, create a New mapping, choose a "Generic" (as opposed to "Specific") mapping and type the contact number in the Generic code field

  4. In the schedule screen, create a schedule relating to BARCODES_FOR_RESELLER query (it this query is not available, please create a service ticket asking for its activation), and precising the email of the contact supposed to receive the file. This schedule must run every 15 minutes.

  5. Done !

Screen captures below.

Step 1

Step 2

 

 

Step 3

 

Step 4