Versions Compared

Version Old Version 13 New Version Current
Changes made by

THP

Kho SA

Saved on

Key

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

File format for Season Tickets

The generic file format is described iGeneric 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

  1. The first file describes the season ticket itself.

  2. The optional second file describes each performance included in each season ticket.

...

Season Ticket

Each row describes one season ticket

...

Note

  • When you need a standard import, please use the template as example.

  • Please keep all columns, all 4 first rows, event if there’s no data.

  • Please keep the order of all columns and all rows. Don’t move or change them.

  • Please keep the headers/titles as they are, especially the 4th row.

  • If you want to send us *.csv file, please keep columns, rows and their order also.

  • Please use option “Comma delimited” for .csv file.

Examples

Attachments

File format for Season Tickets


...

Field code

Field type

Mandatory

Description

ORDER INFO

INSTITUTION

INSTIT

Code

Text 15

Yes

Institution code owning the data to be imported.

ORGANIZATION

Text 15

Code

Yes

No

Organization code owning the data to be imported.
If leave it empty, the institution code will be used.

ORDER_NR

Text 50YesOrder 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 70

Enum

Yes

Operation type in ('SALE','RESERVATION')

Allowed values: SALE or RESERVATION.

CONFIRMATION_DATE

Date

No

Expiration date to confirm reservation.

REMARK

Text 2000

 

No

Order

Internal remark

SEASON TICKET

INFO
S_TICKET

of order.

BUYING_CONTACT_NR

Text 20

Number

Yes

Instance number of season ticket

Contact number who buys the order. Mandatory because a sstk needs a contact.

SEASON

_CODE

Text 15

Code

Yes

Season code of

the organization that need to be imported

season ticket.

S

SEASON_TICKET

_CODE

Text 50

Code

Yes

Product code of season ticket.

COMMON

PRICE_

SEAT_NR

LEVEL

SeatNumberSeat number

Code

 Vat rate in percent.

No

Price level code.

COMMON_CONTText 100 Common contingent.CONTACT INFO
BUYING_CONTACT_NRNumberYesBuying contact number.CULTURAL_CONTACT_NRNumber Cultural contact number.FIRST_NAMEText 50 Beneficiary first name.LAST_NAMEText 50 Beneficiary last name.PRICE INFO
SEATCAT_CODEText 15YesSeat category code.TARIF_CODEText 15YesTarif code.PRICE_LEVELText 15YesPrice level (Not yet used).PRICEAmountYesPrice of season ticket.VATNumberYes

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 <=

 ORDERTICKET INFO
TICKET_STATEText 50YesTicket 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'

Date

 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
SHIPMENT

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 ticke

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

Code

 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 .

Field code

Field type

Mandatory

Description

INSTIT

INSTITUTION

Text 8

Code

Yes

Institution code owning the data to be imported.

ORGANIZATION

Code

No

Organization code owning the data to be imported.
If leave it empty, the institution code will be used.

SEASON_TICKET_NR

Number

Yes

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 single entry (event/competition).

EVENT

_CODE   STARTTIME   SEAT_NUMBER   CONTINGENT   TICKET_STATE   GENERATION_DATE   BARCODE   FISCAL_NR   SHIPMENT_DATE   SHIPMENT_MODE   

Code

Yes

Product code of single entry (event/competition).

START_TIME

Timestamp

Yes

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

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

Enum

Yes if SALE

Mandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED, CONTROLLED.

GENERATION_DATE

Date

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

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

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

Code

No

If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.