Versions Compared

Key

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

File format for Donation import

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

Examples

Attachments


Order service productSERVICE_CODE service_CODE service the service

Shipment date of the service.

Default value: Order date

Shipment mode of the service.

Allowed values: TBD.

Mandatory if
Field codeField typeMandatoryDescription
INSTITUTIONText 15CodeYesInstitution code owning the data to be imported.
ORGANIZATIONText 15CodeYesNoOrganization code owning the data to be imported.
By defaultIf leave it empty, the organization code is the same as the institution code will be used.
ORDER_NRNumberYesOrder numberNoIf 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_DATEDateYesOrder dateNoBuying date.
If leave it empty, it will be imported date by default.
OPERATION_TYPEEnumYes

Operation type.

Allowed values: SALE or RESERVATION.
CONFIRMATION_DATEDateNoExpiration date to confirm reservation.
REMARKText 2000NoInternal remark of order.
BUYING_CONTACT_NRNumberNoBuying contact number. If it is Contact number who buys the order.
If leave it empty, the sale is will be anonymous by default.
ORIGIN_COUNTRYText 50NoCountry of buying contact (only if Buying buying contact is not specified).
ORIGIN_REGIONText 50NoRegion of buying contact (only if Buying buying contact is not specified).
ORIGIN_ZIPCODEText 50NoZip code of buying contact (only if Buying contact is not specified).CULTURAL_CONTACT_NRNumberNo

Cultural contact number.

If left empty and first/last name are empty, the buying contact number is used.
FIRST_NAMEText 50NoBeneficiary first name (only if Cultural contact number is not specified).
LAST_NAMEText 50NoBeneficiary last name (only if Cultural contact number is not specified).
SEASONCodeYesSeason code of donation.
DONATIONCodeYesProduct code of donation.
ITEMCodeYesItem code of donation.
TARIFFCodeYesTarif Tariff code.
PRICEAmountYesPrice of ticket * 100 (so that 25$ = 2500).
CHARGEAmountYesNoCharge of service * 100ticket * 100 (so that 1$ = 100).
VATPercentageYesNoIf 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_DATEDateYes if SALEMandatory when NoIf 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.
DONATION_NRNumberNoEach donation has a unique number to know how many donations 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_STATEEnumYes if SALEThe state of ticket.Mandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED or , CONTROLLED.
GENERATION_DATETimestampYes if PRINTED or CONTROLLED

Generation date.

Mandatory if Date
NoIf 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.
BARCODEText 50Yes if PRINTED or CONTROLLEDBar code of the ticket. Mandatory if the ticket NoIf leave it empty and the ticket has been printed  or controlled.Not yet used. Default now is or controlled, it will be generated following import rules by default 'IMP-' + ticket id.
TAX_NUMBERText 50Yes if PRINTED or CONTROLLEDThe tax number of the ticket. Mandatory if the ticket NoIf leave it empty and the ticket has been printed  or controlled.Not yet used. Default now is or controlled, it will be generated following import rules by default 'IMP-' + ticket id.
SHIPMENT_DATEDateYesNoIf 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_MODECodeYes if PRINTED or CONTROLLEDNoIf leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.