The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
There are many different possible configurations for season tickets. Not all of them are available for season tickets imports.
The data to be imported needs to be described on two files
Field code | Field type | Mandatory | Description |
---|---|---|---|
INSTITUTION | Text 15 | Yes | Institution code owning the data to be imported. |
ORGANIZATION | Text 15 | Yes | Organization code owning the data to be imported. By default, the organization code is the same as the institution code. |
ORDER_NR | Number | Yes | Order number. |
ORDER_DATE | Date | Yes | Order date. |
OPERATION_TYPE | Text 70 | Yes | Operation type. Possible values: SALE or RESERVATION |
REMARK | Text | Order remark | |
BUYING_CONTACT_NR | Number | Yes | Buying contact number. |
CULTURAL_CONTACT_NR | Number | Cultural contact number. By default it is identical to the buying contact number. | |
FIRST_NAME | Text 50 | Beneficiary first name. Set this info only for sold tickets. | |
LAST_NAME | Text 50 | Beneficiary last name. Set this info only for sold tickets. | |
ST_NUMBER | Number | Yes | Season ticket number |
SEASON | Code | Yes | Season code of the season ticket. |
ST_CODE | Code | Yes | Product code of season ticket. |
PRICE_LEVEL | Code | Price level | |
SEAT_NUMBER | SeatNumber | Seat number if the ticket holder is seated at the same place for all performances included in the season ticket | |
CONTINGENT | Code | Common contingent. | |
SEATCAT_CODE | Code | Yes | Seat category code. |
TARIFF | Code | Yes | Tarif code. |
PRICE | Amount | Yes | Price of season ticket * 1000 |
VAT | Percentage | Yes | 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 | Payment date must be empty if price is 0 or operation type is RESERVATION. | |
TICKET_STATE | Enum | Yes | Ticket state. Allowed values: NOT_PRINTED, PRINTED or CONTROLLED |
GENERATION_DATE | Timestamp | Generation date Mandatory when the ticket state is PRINTED or CONTROLLED | |
BARCODE | Text 50 | Bar code of the season ticket. | |
TAX_NUMBER | Text 50 | The tax number of the season ticket. | |
SHIPMENT_DATE | Date | Shipment date of the season ticket. Default value: Order date. | |
SHIPMENT_MODE | Text 50 | Shipment mode of the season ticket. Allowed values: TBD Mandatory when the ticket state is PRINTED or CONTROLLED |
Each row describes one performance included in a season ticket. The rows are linked to the first file using INSTITUTION and ST_NUMBER.
Field code | Field type | Mandatory | Description |
---|---|---|---|
INSTITUTION | Text 15 | Yes | Institution code owning the data to be imported. |
ORGANIZATION | Text 15 | Yes | Organization code owning the data to be imported. |
ST_NUMBER | Text 20 | Yes | Instance number of season ticket. If several season tickets in one order, they should all have different number so that SecuTix will acknowledge them as different season ticket product |
SEASON | Code | Yes | Season code of the event |
ST_CODE | Code | Yes | Product code of season ticket. |
EVENT_CODE | Code | Yes | The event code |
STARTTIME | Timestamp | Yes | The performance start time of the event |
SEAT_NUMBER | SeatNumber | Yes | |
CONTINGENT | Code | Contingent code | |
SEATCAT_CODE | Code | Yes | Seat category code |
TARIFF | Code | Yes | Tarif code |
PRICE | Amount | Yes | Price of the seat * 1000 |
VAT | Percentage | Yes | 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 | Payment date must be empty if price is 0 or operation type is RESERVATION. | |
TICKET_STATE | Code | Yes | Ticket state. Allowed values: NOT_PRINTED, PRINTED or CONTROLLED |
GENERATION_DATE | Timestamp | Generation date. Mandatory when the ticket state is PRINTED or CONTROLLED | |
BARCODE | Text 50 | Bar code of the ticket. | |
TAX_NUMBER | Text 50 | The tax number of the ticket. | |
SHIPMENT_DATE | Date | Shipment date. Default value: Order date. | |
SHIPMENT_MODE | Text 50 | Shipment mode. Allowed values: Mandatory when the ticket state is PRINTED or CONTROLLED |