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

  1. The first file describes the season ticket itself.
  2. The optional second file describes each performance included in each season ticket.

Examples

File format for Season Tickets


Field codeField typeMandatoryDescription
INSTITUTIONCodeYesInstitution code owning the data to be imported.
ORGANIZATIONCodeNoOrganization code owning the data to be imported.
If leave it empty, the institution code will be used.
ORDER_NRNumberNoIf 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_DATEDateNoBuying date.
If leave it empty, it will be imported date by default.
OPERATION_TYPEEnumYesAllowed values: SALE or RESERVATION.
CONFIRMATION_DATEDateNoExpiration date to confirm reservation.
REMARKText 2000NoInternal remark of order.
BUYING_CONTACT_NRNumberYesContact number who buys the order. Mandatory because a sstk needs a contact.
SEASONCodeYesSeason code of season ticket.
SEASON_TICKETCodeYesProduct code of season ticket.
PRICE_LEVELCodeNoPrice level code.
TARIFFCodeYesTariff code.
CONTINGENTCodeNoContingent code.
SEAT_CATEGORYCodeYesSeat category code.
PRICEAmountYesPrice of ticket * 100 (so that 25$ = 2500).
CHARGEAmountNoCharge of ticket * 100 (so that 1$ = 100).
VATPercentageNoIf 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_DATEDateNoIf 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_NRNumberNoEach 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_NUMBERSeatNumberYesSeat number if the ticket holder is seated at the same place for all performances included in the season ticket.
CULTURAL_CONTACT_NRNumberNoContact 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_FIRSTNAMEText 50NoBeneficiary first name (only if cultural contact is not specified).
BENEFICIARY_LASTNAMEText 50NoBeneficiary last name (only if cultural contact is not specified).
TICKET_STATEEnumYes if SALEMandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED, CONTROLLED.
GENERATION_DATEDateNoIf 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.
BARCODEText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
TAX_NUMBERText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
SHIPMENT_DATEDateNoIf 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_MODECodeNoIf 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 codeField typeMandatoryDescription
INSTITUTIONCodeYesInstitution code owning the data to be imported.
ORGANIZATIONCodeNoOrganization code owning the data to be imported.
If leave it empty, the institution code will be used.
SEASON_TICKET_NRNumberYesEach 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.
SEASONCodeYesSeason code of single entry (event/competition).
EVENTCodeYesProduct code of single entry (event/competition).
START_TIMETimestampYesStart date time of performance.
TARIFFCodeYesTariff code.
CONTINGENTCodeNoContingent code.
SEAT_CATEGORYCodeYesSeat category code.
PRICEAmountYesPrice of ticket * 100 (so that 25$ = 2500).
CHARGEAmountNoCharge of ticket * 100 (so that 1$ = 100).
VATPercentageNoIf 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_DATEDateNoIf 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_NUMBERSeatNumberYesSeat number for each performance in the season ticket.
BENEFICIARY_FIRSTNAMEText 50NoBeneficiary first name (only if cultural contact is not specified).
BENEFICIARY_LASTNAMEText 50NoBeneficiary last name (only if cultural contact is not specified).
TICKET_STATEEnumYes if SALEMandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED, CONTROLLED.
GENERATION_DATEDateNoIf 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.
BARCODEText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
TAX_NUMBERText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
SHIPMENT_DATEDateNoIf 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_MODECodeNoIf leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.