File format for vouchers
The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
| Warning | ||
|---|---|---|
| ||
The voucher barcode can only contain characters (0 to 9) or (a to f). Example: 2JJ-MSC-8A8 has characters J, M, S which are not in (a-f), it cannot be used. |
Examples
| Attachments |
|---|
Fields
| Field code | Field type | Mandatory | Description | ||||
|---|---|---|---|---|---|---|---|
| INSTITUTION | Text 15Code | Yes | Institution code owning the data to be imported. | ||||
| ORGANIZATION | Text15Code | Yes | Organization code owning the data to be imported. By default, the organization code is the same as the institution codeIf leave it empty, the institution code will be used. | ||||
| ORDER_NR | Number | No | Order number. Will be set by import package while importing if left empty. | Yes | 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 | Yes | Order Buying date. By default, order date is importing dateIf leave it empty, it will be imported date by default. | ||||
| OPERATION_TYPE | Enum | YesOperation type. | Allowed values: SALE or RESERVATION. | ||||
| CONFIRMATION_DATE | TextDate | No | Order remarkExpiration date to confirm reservation.BUYING_CONTACT_NR | ||||
| REMARK | Text | 152000 | Yes | The contact number of contact that bought the voucher. | CULTURALNo | Internal remark of order. | |
| BUYING_CONTACT_NR | Number | No | Cultural contact numberContact number who buys the order. By default it is identical to the buying contact number. FIRST_NAMEIf leave it empty, the sale will be anonymous by default. | ||||
| ORIGIN_COUNTRY | Text 50 | No | Beneficiary first name. Set this info only for sold tickets. | LAST_NAMECountry of buying contact (only if buying contact is not specified). | |||
| ORIGIN_REGION | Text 50 | No | Beneficiary last name. Set this info only for sold tickets. | VOUCHER_NR | Number | No | The voucher number of contact. Will be set by import package while importing if left emptyRegion 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 voucher | product. | |||
| VOUCHER | _CODECode | Yes | Product code of voucher. | ||||
| ITEM | _CODECode | Yes | Item code of voucher. | ||||
| VALIDITY_BEGIN | DateTimestamp | Yes | Beginning of the validity of the voucherThe date starts to validate. | ||||
| VALIDITY_END | DateTimestamp | Yes | End of the voucherThe date stops to validate. | ||||
| TARIFF | Code | Yes | Tariff code. The tariff code linked to the season that match one of these conditions: - Main category = 'OCCASIONAL' and secondary category = 'INDIVIDUAL' | ||||
| PRICE | Amount | Yes | Price of | the voucherticket * 100 (so that 25$ = 2500). | |||
| CHARGE | Amount | No | Charge of ticket * 100 (so that 1$ = 100). | ||||
| VAT | Percentage | YesNo | 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 <= | ORDERORDER_DATE <= Valid to date of vat rate. | |||
| PAYMENT_DATE | Date | Yes if SALE | Mandatory whenIf leave it empty, the operation type is SALE and the price is not 0 | .Default value: Order date, the order date will be used by default. Means it can be imported date if the order date is not given. | |||
| VOUCHER_NR | Number | No | Each voucher has a unique number to know how many vouchers 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. | ||||
| CULTURAL_CONTACT_NR | Number | No | Contact number who is ticket holder. If leave it empty and first/last name are empty, the buying contact will be used by default. Means it can be imported as anonymous if the buying contact is not given. | ||||
| 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 | The state of ticket. Mandatory when If leave it empty, the operation type is SALE, it will be NOT_PRINTED by default.Allowed values: NOT_PRINTED or , PRINTED, CONTROLLED. | ||||
| GENERATION_DATE | TimestampDate | Yes if PRINTED Generation date. Mandatory if or CONTROLLED | If leave it empty and the ticket has been printed .Default value: Order dateor controlled, the order date will be used by default. Means it can be imported date if the order date is not given. | ||||
| BARCODE | Text 10050 | Yes if PRINTED Bar code of the voucher card. Mandatory if the or CONTROLLED | If leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default. Rule: The voucher bar code can only has characters which are (0 to 9) or (a to f). | ||||
| TAX_NUMBER | Text 3050 | Yes if PRINTED The tax number of the voucher card. Mandatory if or CONTROLLED | If leave it empty and the ticket has been printed .Will be generated with prefix equal to "IMP-" if left emptyor controlled, it will be generated following import rules by default. | ||||
| SHIPMENT_DATE | Date | Yes | Shipment date of the voucher card. Default value: Order dateNo | 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 | Yes if PRINTED | Shipment mode of the voucher card. Allowed values: TBD. Mandatory if the No | If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default. |