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| Code | Yes | Institution code owning the data to be imported. |
| ORGANIZATION |
Text 15Yes| No | Organization code owning the data to be imported.
If leave it empty, the institution code will be used. |
| ORDER_NR | 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 | Buying date.
If leave it empty, it will be imported date by default. |
| OPERATION_TYPE |
Text 30 | Not used yetSEASON_CODE | Text 50| Yes | Allowed values: SALE or RESERVATION. |
| CONTACT_NR | Text 15 | Yes | The contact number of contact that owner the membership card. |
| MEMBER_NR | Text 50 | Yes | The membership number of contact. This must contains only numbers. |
| CONFIRMATION_DATE | Date | No | Expiration date to confirm reservation. |
| REMARK | Text 2000 | No | Internal remark of order. |
| BUYING_CONTACT_NR | Number | Yes | Contact number who buys the order. Mandatory because a membership needs a contact. |
| SEASON | Code | Yes | Season code of |
the organization owning the data to be imported_CODEText 50The product the MEMBERSHIP that need to be importedTARIFCODEText 50 ACTIVE tarif code of the season that match 1 of 2 condition below:- Main category = 'OCCASIONAL' and secondary category = 'INDIVIDUAL'
- Main category = 'INVITED'.
| SALE_DATE | Timestamp | | Not used yet. |
| MEMBERSHIP_BEGIN | Date | Yes | Beginning of the membership. |
| MEMBERSHIP_END | Date | Yes | End of the membership. |
| AMOUNT | Amount | Yes | The gross amount of order of the inserted membership. |
| CHARGES | Text 30 | No | Not used yet. |
VAT | Text 30 | Yes | Vat rate in percent. | 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.
Vat rate in percent * 100 (so that 1% = 100).
Choose the rate that active and valid following this:
Valid from date of vat rate <= |
MEMBERSHIPBEGIN | DATE <= Valid to date of vat rate. |
TICKET_STATE | Text 30 | Yes | The state of ticket must be in ('PRINTED','NOT_PRINTED') |
| 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. |
| MEMBERSHIP_NR | Number | No | Each membership has a unique number to know how many memberships 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 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 |
TimestampYes if PRINTED the ticket state equal to 'PRINTED' the generation date must not null.| FISCAL_NR | Text 30 | Yes if PRINTED | The fiscal number of the ticket. If not inserted, the fiscal number will be generated with prefix equal to "IMP-". |
BARCODE | Text 100 | Yes if PRINTED | The bar code of ticket. Ex: Input = 345678920 --> barcode will be "CODE128C;TEXT;345678920".
If not inserted, the bar code will be generated like this: "CODE128C;TEXT;IMP-xxxxxxxx"| 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. |