The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
Season tickets need There are many different possible configurations for season tickets. Not all of them are available for season tickets imports.
- For fixed prices imports, the pricing information must be given in the first part (red part).
- For calculated pricing, the pricing information must be given in the second file (yellow part) and will remain empty in the first file.
The data to be imported needs to be described on two files
- The first file describes the season ticket itself.
- The optional second file describes each performance included in each season ticket.
Season Ticket
Each row describes one season ticket
...
Examples
File format for Season Tickets
...
| Field code | Field type | Mandatory | Description |
|---|
ORDER INFOINSTITText 15 | | Yes | Institution code owning the data to be imported. |
| ORGANIZATION |
Text 15Yes| No | Organization code owning the data to be imported.
If leave it empty, the institution code will be used. |
| ORDER_NR |
Text 50 | Yes | Order numberOrder date| Number | No | If leave it empty, order number will be set while importing by default.
One line is one ticket. So each line is a unique order number if leave it empty.
Many tickets can be in an order if leave them the same order number. This number can be started from 1 in a new data file. Then it will be given new one while importing.
This will be file number also. |
| ORDER_DATE | Date | No |
Yes | Buying date.
If leave it empty, it will be imported date by default. |
| OPERATION_TYPE |
Text 70Operation type in ('SALE','RESERVATION')| Allowed values: SALE or RESERVATION. |
| CONFIRMATION_DATE | Date | No | Expiration date to confirm reservation. |
| REMARK | Text 2000 |
Order SEASON TICKET
INFOS_TICKET| of order. |
| BUYING_CONTACT_NR |
Text 20Instance number of season ticket| Contact number who buys the order. Mandatory because a sstk needs a contact. |
| SEASON |
_CODEText 15 the organization that need to be importedS_CODEText 50| Code | Yes | Product code of season ticket. |
COMMONSEAT_NRSeatNumberSeat number | PRICE INFOSEATCAT_CODE | Text 15| COMMON_CONT | Text 100 | | Common contingent. |
CONTACT INFOBUYING_CONTACT_NR | Number | Yes | Buying contact number. | | CULTURAL_CONTACT_NR | Number | | Cultural contact number. |
| FIRST_NAME | Text 50 | | Beneficiary first name. |
| LAST_NAME | Text 50 | | Beneficiary last name. |
| TARIFF | Code | Yes | Tariff code. |
| CONTINGENT | Code | No | Contingent code. |
| SEAT_CATEGORY | Code | Yes | Seat category code. |
| TARIF_CODE | Text 15 | Yes | Tarif code. |
_LEVELText 15 level (Not yet used| of ticket * 100 (so that 25$ = 2500). |
PRICEYesPrice season ticketYes| ticket * 100 (so that 1$ = 100). |
| VAT | Percentage |
Number | | No | 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 <= |
ORDERTICKET INFOTICKET_STATE | Text 50 | Yes | Ticket state in ('NOT_PRINTED','PRINTED','CONTROLLED')| ORDER_DATE <= Valid to date of vat rate. |
| PAYMENT_DATE | Date |
| Payment date is null when operation type = 'SALE' and price = 0 or operation type = 'RESERVATION'. | | No | 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. |
| SEASON_TICKET_NR | Number | No | Each season ticket has a unique number to know how many season tickets have been published.
In importation, it helps to define ticket to check between data excel file and database system after importing.
This number can be started from 1 in a new data file. Then it will be given new one while importing. |
| SEAT_NUMBER | SeatNumber | Yes | Seat number if the ticket holder is seated at the same place for all performances included in the season ticket. |
| CULTURAL_CONTACT_NR | Number | No | Contact number who is ticket holder.
If leave it empty and first/last name are empty, the buying contact number will be used by default. |
| 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 | Mandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED, CONTROLLED. |
| GENERATION_DATE |
TimestampGeneration date is null when ticket state = 'NOT_PRINTED' | FISCAL_NR| No | 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 |
| Bar code of the ticket. (Not yet used). Default now is 'IMP-' + ticket id. | SHIPMENT INFO| No | 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 |
| The fiscal number of the ticket.(Not yet used). Default now is 'IMP-' + ticket id. | Shipment date. If not input: Shipment date = Order date| No | 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 |
Text 50 | Shipment date is null when ticket state = 'NOT_PRINTED'. |
| No | If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default. |
File format for Season Ticket Lines
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 |
|---|
INSTITText 15| Code | Yes | Institution code owning the data to be imported. |
| ORGANIZATION |
Text 15Yes| No | Organization code owning the data to be imported.
If leave it empty, the institution code will be used. |
SText 20Text 15Instance number of season ticket. | SEASON_CODE | Each season ticket has a unique number to know how many season tickets have been published.
This is also used to link season ticket with season ticket lines.
This number can be started from 1 in a new data file. Then it will be given new one while importing. |
| SEASON | Code | Yes | Season code of |
the organization that need to be imported| single entry (event/competition). |
| EVENT |
_CODEText 20The event the season ticket line.STARTTIME| single entry (event/competition). |
| START_TIME | Timestamp | Yes |
The performance start time of the event of the season ticket line| Start date time of performance. |
| TARIFF | Code | Yes | Tariff code. |
| 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 | No | 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 | No | 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 |
| CONTINGENT | Text 100 | | Contingent code | Seat number for each performance in the season ticket. |
| 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 |
Text 50Ticket state in ('| if SALE | Mandatory when the operation type is SALE.
Allowed values: NOT_PRINTED |
''''')TimestampGeneration date is null when ticket state = 'NOT_PRINTED' | FISCAL_NR| No | 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 |
| Bar code of the ticket. (Not yet used). Default now is 'IMP-' + ticket id. | The fiscal number of the ticket.(Not yet used).
Default now is 'IMP-' + ticket id| No | 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 |
| Shipment date. If not input: Shipment date = Order date| No | 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 |
Text 50Shipment date is null when ticket state = 'NOT_PRINTED' | | No | If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default. |