File format for vouchers
The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
Examples
Fields
| Field code | Field type | Mandatory | Description |
|---|---|---|---|
| INSTITUTION | Text 15 | Yes | Institution code owning the data to be imported. |
| ORGANIZATION | Text15 | Yes | Organization code owning the data to be imported. By default, the organization code is the same as the institution code. |
| ORDER_NR | Number | No | Order number. Will be set by import package while importing if left empty. |
| ORDER_DATE | Date | Yes | Order date. By default, order date is importing date. |
| OPERATION_TYPE | Enum | Yes | Operation type. Allowed values: SALE or RESERVATION. |
| REMARK | Text | No | Order remark. |
| BUYING_CONTACT_NR | Number | Yes | The contact number of contact that bought the voucher. |
| CULTURAL_CONTACT_NR | Number | No | Cultural contact number. By default it is identical to the buying contact number. |
| FIRST_NAME | Text 50 | No | Beneficiary first name. Set this info only for sold tickets. |
| LAST_NAME | 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 empty. |
| SEASON | Code | Yes | Season code of voucher product. |
| VOUCHER_CODE | Code | Yes | Product code of voucher. |
| ITEM_CODE | Code | Yes | Item code of voucher. |
| VALIDITY_BEGIN | Date | Yes | Beginning of the validity of the voucher. |
| VALIDITY_END | Date | Yes | End of the voucher. |
| TARIFF | Code | Yes | The tariff code linked to the season that match one of these conditions :
|
| PRICE | Amount | Yes | Price of the voucher * 100. |
| CHARGE | Amount | No | Charge of ticket * 100. Not used yet. |
| VAT | Percentage | Yes | 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 | Yes if SALE | Mandatory when the operation type is SALE and price is not 0. Default value: Order date. |
| TICKET_STATE | Enum | Yes if SALE | The state of ticket. Mandatory when the operation type is SALE. Allowed values: NOT_PRINTED or PRINTED. |
| GENERATION_DATE | Timestamp | Yes if PRINTED | Generation date. Mandatory if the ticket has been printed. Default value: Order date. |
| BARCODE | Text 100 | Yes if PRINTED | Bar code of the voucher card. Mandatory if the ticket has been printed. |
| TAX_NUMBER | Text 30 | Yes if PRINTED | The tax number of the voucher card. Mandatory if the ticket has been printed. Will be generated with prefix equal to "IMP-" if left empty. |
| SHIPMENT_DATE | Date | Yes | Shipment date of the voucher card. Default value: Order date. |
| SHIPMENT_MODE | Code | Yes if PRINTED | Shipment mode of the voucher card. Allowed values: TBD. Mandatory if the ticket has been printed. |