Service import file formats
File format for Service import
The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
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
Field code | Field type | Mandatory | Description |
|---|---|---|---|
INSTITUTION | Code | Yes | Institution code owning the data to be imported. |
ORGANIZATION | Code | No | Organization code owning the data to be imported. |
ORDER_NR | Number | No | If leave it empty, order number will be set while importing by default. |
ORDER_DATE | Date | No | Buying date. |
OPERATION_TYPE | Enum | Yes | Allowed values: SALE or RESERVATION. |
CONFIRMATION_DATE | Date | No | Expiration date to confirm reservation. |
REMARK | Text 2000 | No | Internal remark of order. |
BUYING_CONTACT_NR | Number | No | Contact number who buys the order. |
ORIGIN_COUNTRY | Text 50 | No | Country of buying contact (only if buying contact is not specified). |
ORIGIN_REGION | Text 50 | No | Region of buying contact (only if buying contact is not specified). |
ORIGIN_ZIPCODE | Text 50 | No | Zip code of buying contact (only if buying contact is not specified). |
SEASON | Code | Yes | Season code of service. |
SERVICE | Code | Yes | Product code of service. |
ITEM | Code | Yes | Item code of service. |
VALIDITY_BEGIN | Timestamp | Yes | The date starts to validate. |
VALIDITY_END | Timestamp | Yes | The date stops to validate. |
TARIFF | Code | Yes | Tariff 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. |
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. |
SERVICE_NR | Number | No | Each service has a unique number to know how many services have been published. |
CULTURAL_CONTACT_NR | Number | No | Contact number who is ticket holder. |
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. |
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 'IMP-' + ticket id. |
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 'IMP-' + ticket id. |
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. |