Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

File format for Season Tickets

 


Field codeField typeMandatoryDescription
INSTITUTION
Text 15
CodeYesInstitution code owning the data to be imported.
ORGANIZATION
Text 15
Code
Yes
NoOrganization code owning the data to be imported.
By default, the organization code is the same as the institution code
If leave it empty, the institution code will be used.
ORDER_NRNumber
YesOrder numberOrder date
NoIf 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_DATEDateNo
Yes
Buying date.
If leave it empty, it will be imported date by default.
OPERATION_TYPE
Text 70Possible
EnumYes

Operation type.

Allowed values: SALE or RESERVATION
REMARKText Order remarkBUYING_CONTACT_NRNumberYesBuying contact number
.
CULTURAL
CONFIRMATION_
CONTACT_NR
DATE
Number
Date
 Cultural contact number. By default it is identical to the buying contact number.
NoExpiration date to confirm reservation.
REMARKText 2000NoInternal remark of order.
BUYING_CONTACT_NR
FIRST_NAMEText 50 Beneficiary first name.LAST_NAMEText 50 Beneficiary last name.ST_NUMBER
NumberYes
Season ticket number
Contact number who buys the order. Mandatory because a sstk needs a contact.
SEASONCodeYesSeason code of
the
season ticket.
ST
SEASON_
CODE
TICKETCodeYesProduct code of season ticket.
PRICE_LEVELCode
 
NoPrice level code.
SEAT_NUMBER
TARIFF
SeatNumber
Code
 
YesTariff code.
Seat number if the ticket holder is seated at the same place for all performances included in the season ticket
CONTINGENTCode
 
No
Common contingent
Contingent code.
SEATCAT
SEAT_
CODE
CATEGORYCodeYesSeat category code.
TARIFF
PRICE
Code
AmountYes
Tarif code
Price of ticket * 100 (so that 25$ = 2500).
PRICE
CHARGEAmount
Yes
No
Price
Charge of
season ticket
ticket * 100 (so that 1$ = 100).
VATPercentage
Yes
NoIf 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
ORDER_DATE <= Valid to date of vat rate.
PAYMENT_DATEDate
 
NoIf 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)
Payment date must be empty if price is 0 or operation type is RESERVATION
.
TICKET_STATEEnumYes
Ticket state
if SALEMandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED
or
, CONTROLLED.
GENERATION_DATE
Timestamp
Date
 
NoIf 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.

Generation date

Mandatory when the ticket state is PRINTED or CONTROLLED
BARCODEText 50
 
NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default
Bar code of the season ticket
.
TAX_NUMBERText 50
 The tax number of the season ticket
NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
SHIPMENT_DATEDate
 
NoIf 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 date of the season ticket.

Default value: Order date
.
SHIPMENT_MODE
Text 50
Code
 

Shipment mode of the season ticket.

Allowed values: TBD

Mandatory when the ticket state is PRINTED or CONTROLLED

 

NoIf 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
INSTITUTION
Text 15
CodeYesInstitution code owning the data to be imported.
ORGANIZATION
Text 15
Code
Yes
NoOrganization code owning the data to be imported.
If leave it empty, the institution code will be used.
ST
SEASON_TICKET_
NUMBER
NR
Text 20
NumberYes
Instance 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.
SEASONCodeYesSeason code of
the event
single entry (event/competition).
EVENT
_CODE
CodeYes
The event codeSTARTTIME
Product code of single entry (event/competition).
START_TIMETimestampYes
The performance start
Start date time of
the event
performance.
TARIFFCode
SEAT_NUMBERSeatNumber
Yes
 
Tariff code.
CONTINGENTCode
 
NoContingent code.
SEATCAT
SEAT_
CODE
CATEGORYCodeYesSeat category code.
TARIFF
PRICE
Code
AmountYes
Tarif code
Price of ticket * 100 (so that 25$ = 2500).
CHARGE
PRICE
Amount
Yes
No
Price of the seat
Charge of ticket * 100 (so that 1$ = 100).
VATPercentage
Yes
NoIf 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
ORDER_DATE <= Valid to date of vat rate.
PAYMENT_DATEDate
 Payment date must be
NoIf 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)
empty if price is 0 or operation type is RESERVATION
.
TICKET_STATE
Code
EnumYes
Ticket state
if SALEMandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED
or
, CONTROLLED.
GENERATION_DATE
Timestamp
Date
 
NoIf 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.

Generation date.

Mandatory when the ticket state is PRINTED or CONTROLLED
BARCODEText 50
 Bar
NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default
code of the ticket
.
TAX_NUMBERText 50
 
NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default
The tax number of the ticket
.
SHIPMENT_DATEDate
 

Shipment date.

Default value: Order date
NoIf 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
Code
 
NoIf leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.

Shipment mode.

Allowed values:

Mandatory when the ticket state is PRINTED or CONTROLLED