File format for Single Entries
The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
Each line import one single ticket. If an existing order contains several tickets with the same seat category, same tarif, same contingent, they have to be duplicated.
Examples
| Field code | Field type | Mandatory | Description |
|---|---|---|---|
| INSTITUTION | Code | Yes | Institution code owning the data to be imported. |
| ORGANIZATION | Code | Yes | Organization code owning the data to be imported. |
| ORDER_NR | Number | Yes | If leave it empty, order number will be set while importing by default. |
| ORDER_DATE | Date | Yes | Buying date. |
| OPERATION_TYPE | Enum | Yes | Allowed values: SALE or RESERVATION. |
| CONFIRMATION_DATE | Date | No | Expiration date to confirm reservation. |
| REMARK | Text 2000 | No | Internal remark of order. |
BUYING_CONTACT_NR | Number | No | Contact number who buys the order. If leave it empty, the sale will be anonymous by default. |
| ORIGIN_COUNTRY | Text 50 | No | Country of buying contact (only if Buying contact is not specified). |
| ORIGIN_REGION | Text 50 | No | Region of buying contact (only if Buying contact is not specified). |
| ORIGIN_ZIPCODE | Text 50 | No | Zip code of buying contact (only if Buying contact is not specified). |
| SEASON | Code | Yes | Season code of the event/competition. |
| EVENT | Code | Yes | Product code of event/competition. |
| START_TIME | Timestamp | Yes | The performance start time of the event or the match start time of the competition. |
| TARIFF | Code | Yes | Tariff code. It is looked up first in a mapping table and if not found, it will checked against a code of the tarifs in SecuTix. |
| CONTINGENT | Code | No | Contingent code. |
| SEAT_CATEGORY | Code | Yes | Seat category code. |
| PRICE | Amount | Yes | Price of ticket * 100 (so that 25$ = 2500). |
| CHARGE | Amount | No | Charge of ticket * 100 (so that 1$ = 100). |
| VAT | Percentage | Yes | If leave it empty, it will be 0 while importing by default. Vat rate in percent * 100 (so that 1% = 100). Choose the rate that active and valid following this: Valid from date of vat rate <= ORDER_DATE <= Valid to date of vat rate. |
| PAYMENT_DATE | Date | Yes if SALE | If leave it empty, the operation type is SALE and the price is not 0, the order date will be used by default. Means it can be imported date if the order date is not given. |
| SEAT_NUMBER | SeatNumber | Yes | If leave it empty, the operation type is SALE and the price is not 0, the order date will be used by default. Means it can be imported date if the order date is not given. |
| CULTURAL_CONTACT_NR | Number | No | Contact number who is ticket holder. If leave it empty and first/last name are empty, the buying contact will be used by default. Means it can be imported as anonymous if the buying contact is not given. |
| BENEFICIARY_FIRSTNAME | Text 50 | No | Beneficiary first name (only if cultural contact is not specified). |
| BENEFICIARY_LASTNAME | Text 50 | No | Beneficiary last name (only if cultural contact is not specified). |
| TICKET_STATE | Enum | Yes if SALE | If leave it empty, the operation type is SALE, it will be NOT_PRINTED by default. Allowed values: NOT_PRINTED, PRINTED, CONTROLLED. |
| GENERATION_DATE | Timestamp | Yes if PRINTED or CONTROLLED | If leave it empty and the ticket has been printed or controlled, the order date will be used by default. Means it can be imported date if the order date is not given. |
| BARCODE | Text 50 | Yes if PRINTED or CONTROLLED | If leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default. |
| TAX_NUMBER | Text 50 | Yes if PRINTED or CONTROLLED | If leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default. |
| SHIPMENT_DATE | Date | No | If leave it empty, the order date will be used by default. Means it can be imported date if the order date is not given. |
| SHIPMENT_MODE | Code | No | If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default. |