Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

File format for Service import

The generic file format is described in Generic file format (Extended). This documents describes all available import fields.

Examples

Attachments

Don't need

Bar code of the ticket. (Not yet used).

Default now is FISCALNR

The fiscal number of the ticket.(Not yet used).

Default now is Shipment date. If not input: Shipment date = Order dateItem code of Service
Field codeField typeMandatoryDescription
INSTITUTIONText 15CodeYesInstitution code owning the data to be imported.
ORGANIZATIONText 15CodeYesNoOrganization code owning the data to be imported.
By default, the organization code is the same as If leave it empty, the institution code will be used.
OPERATIONNot yet use.
ORDER_NRNumberYesNoIf 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 alsoOrder number.
ORDER_DATEDateNoYesOrder date.Buying date.
If leave it empty, it will be imported date by default.
OPERATIONOP_TYPEText 50EnumYesOperation typeAllowed values: SALE or RESERVATION, SALE.REMARKTextOrder remark.SEASON_CODEText15Yes
SERVICE_CODEText15YesCode of service product.
CONFIRMATION_DATEDateNoExpiration date to confirm reservation.
REMARKText 2000NoInternal remark of orderSTART_TIMEDateDon't need.SEAT_NUMBER.
BUYING_CONTACT_NRNumberNoBuying contact number.Contact number who buys the order.
If leave it empty, the sale will be anonymous by default.
ORIGIN_COUNTRYText 50NoCountry of buying contact (only if buying contact is not specified).
ORIGIN_REGIONText 50NoRegion of buying contact (only if buying contact is not specified).
ORIGIN_ZIPCODEText 50NoZip code of buying contact (only if buying contact is not specified).CULTURAL_CONTACT_NRNumberCultural contact number.FIRST_NAMEText 50First name of cultural contact.LAST_NAMEText 50Last name of cultural contact.
SEASONCodeYesSeason code of service.
SERVICECodeYesProduct code of service.
ITEMCodeYesItem code of service.
VALIDITY_BEGINTimestampYesThe date starts to validate.
VALIDITY_ENDTimestampYesThe date stops to validate.
TARIFFCodeYesTariff codeSEATCAT_CODEText 15Not use yet.TARIF_CODEText 15Tarif code of order.CONTINGENT_CODEText 15Not use yet.
PRICEAmountYesPrice of serviceticket * 100 (so that 25$ = 2500).
CHARGEAmountNoCharge of serviceticket * 100 (so that 1$ = 100).
VATNumberPercentageNoIf 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 <= ORDER_DATE <= Valid to date of vat rateVAT in percent.
PAYMENT_DATEDate

Payment date is null when operation type = 'SALE' and price = 0

or operation type = 'RESERVATION'
NoIf 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_NRNumberNoEach service has a unique number to know how many services 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_NRNumberNoContact 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_FIRSTNAMEText 50NoBeneficiary first name (only if cultural contact is not specified).
BENEFICIARY_LASTNAMEText 50NoBeneficiary last name (only if cultural contact is not specified).
TICKET_STATEText 50EnumYes if SALEMandatory when the operation type is SALE.
Allowed values: Ticket state in (' NOT_PRINTED', ' PRINTED', ' CONTROLLED').
GENERATION_DATETimestampDateNoIf 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 givenGeneration date is null when ticket state = 'NOT_PRINTED'.
BARCODEText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default 'IMP-' + ticket id.
TAX_NUMBERText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default 'IMP-' + ticket id.
SHIPMENT_DATEDateNoIf 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_MODECodeText 50Shipment date is null when ticket state = 'NOT_PRINTED'.PERFORMANCE_DATEDon't need.ITEM_CODEText15YesNoIf leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.