File format for Pass Visits
The generic file format is described in Generic file format (Extended). This documents describes all available import fields.
Examples
| View file | ||||
|---|---|---|---|---|
|
| Attachments |
|---|
| Field code | Field type | Mandatory | Description | |||
|---|---|---|---|---|---|---|
| INSTITUTION | Code | Yes | Institution code owning the data to be imported. | |||
| ORGANIZATION | Code | YesNo | 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_IDNR | Number | No | Order number. Will be set by import package while importing if left empty. | 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 | YesNo | 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. | |||
| REMARKCONFIRMATION_DATE | TextDate | No | Order remarkExpiration date to confirm reservation. | |||
| CONTACT_NR | Number | Yes | Buying contact number. | |||
| REMARK | Text 2000 | No | Internal remark of order. | |||
| BUYING_CONTACT_NR | Number | No | If not filled in, the purchase contact is used. For a group visit, the contact must be of type RELAY. | FIRST_NAMEContact number who buys the order. If leave it empty, the sale will be anonymous by default. | ||
| ORIGIN_COUNTRY | Text 50 | No | Country of buying contact (only if buying contact is not specified). | |||
| ORIGIN_REGION | Text 50 | No | Beneficiary first name. Set this info only for sold visits. | LAST_NAMERegion of buying contact (only if buying contact is not specified). | ||
| ORIGIN_ZIPCODE | Text 50 | No | Beneficiary last name. Set this info only for sold visitsZip code of buying contact (only if buying contact is not specified). | |||
| SEASON_CODE | Code | Yes | Season code of visit pass. | |||
| VISIT_CODEPASS | Code | Yes | Product code of visit pass. | |||
| START_TIME | Timestamp | Yes | Start time of the visit. | |||
| DURATION | Number | Yes | Duration of the visit in seconds. | |||
| CONTINGENTTARIFF | Code | NoYes | Contingent Tariff code. | |||
| TARIFFCONTINGENT | Code | YesNo | Tariff Contingent code. | |||
| PRICE | Amount | Yes | Price of visit ticket * 100 . If flat rate, full price of the visit. If individual rate, unit price per participant. (so that 25$ = 2500). | |||
| CHARGE | Amount | No | Charge of ticket * 100 (so that 1$ = 100). | |||
| VAT | PercentageYes | 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 <= ORDERORDER_DATE <= Valid to date of vat rate. | |||
| PAYMENT_DATE | TimestampDate | Yes if SALE | Mandatory when No | If 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. | ||
| VISIT_PASS_NR | Number | No | Each visit pass has a unique number to know how many visit passes 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 | The state of ticket. Mandatory when the operation type is SALE.Allowed values: NOT_PRINTED, PRINTED or , CONTROLLED. | |||
| GENERATION_DATE | Timestamp | Yes if PRINTED or CONTROLLED | Date | No | If leave it empty and the ticket has been printed or controlled | .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. |
| BARCODE | Text 50 | Yes if PRINTED or CONTROLLED | Bar code of the visit. Mandatory if theNo | 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 | Yes if PRINTED or CONTROLLED | The tax number of the visit. Mandatory if theNo | If leave it empty and the ticket has been printed | or controlled, it will be generated following import rules by default. | |
| SHIPMENT_DATE | Timestamp | Yes if SHIPMENT_MODE=SENT | 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 | Yes if PRINTED or CONTROLLED | No | If leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default. | ||
| GROUP_NAME | Text 50 | Yes if group visits | Name of the group. Leave empty for individual visits. | |||
| GROUP_KIND | Code | Yes if group visits | Group kindKind of the group. Leave empty for individual visits. | |||
| THEME | Code | No | Theme of the visit (only useful use for guided visits). | |||
| LANGUAGE | Code | No | ISO Language code of the visit (fr, en, ...) (only useful use for guided visits). | |||
| VISITOR_TYPE | Enum | Yes | Type of visitor.Allowed values: PARTICIPANT or ACCOMPANIER. | |||
| NB_VISITORS | Number | Yes | Number of visitors.Must be > 0. | |||
| PLACE | Text50Code | No | ||||
| GUIDE | Text50Code | No | Last name and | Firstfirst name of the guide. | ||
| GROUP_CRIT_ELEMENT | Code | No | Group criterion element code. |