Versions Compared

Key

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

File format for memberships

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

Examples

Attachments
sortByname

Fields

Field codeField typeMandatoryDescription
INSTIT
INSTITUTION
Text 15
CodeYesInstitution code owning the data to be imported.
ORGANIZATION
Text 15
Code
Yes
NoOrganization code owning the data to be imported.
OPERATIONText 30 Not used yet.CONTACT_NUMBERText 15YesThe contact number of contact that owner the membership card.MEMBER_NUMBERText 50YesThe membership number of contact. This must contains only numbers.SEASON_CODEText 50YesSeason code of the organization owning the data to be imported.MEMBERSHIP_CODEText 50YesThe product code of the MEMBERSHIP that need to be imported.TARIF_CODEText 50Yes

The ACTIVE tarif code of the season that match 1 of 2 condition below:

  1. Main category = 'OCCASIONAL' and secondary category = 'INDIVIDUAL'
  2. Main category = 'INVITED'.
SALE_DATETimestamp Not used yet.MEMBERSHIP_BEGINTimestampYesBeginning of the membership.MEMBERSHIP_ENDTimestampYesEnd of the membership.AMOUNTAmountYesThe gross amount of order of the inserted membership.CHARGESText 30NoNot used yet.VATText 30YesVat rate in percent.
If leave it empty, the institution code will be used.
ORDER_NRNumberNoIf 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_DATEDateNoBuying date.
If leave it empty, it will be imported date by default.
OPERATION_TYPEEnumYesAllowed values: SALE or RESERVATION.
CONFIRMATION_DATEDateNoExpiration date to confirm reservation.
REMARKText 2000NoInternal remark of order.
BUYING_CONTACT_NRNumberYesContact number who buys the order. Mandatory because a membership needs a contact.
SEASONCodeYesSeason code of membership.
MEMBERSHIPCodeYesProduct code of membership.
VALIDITY_BEGINTimestampYesThe date starts to validate.
VALIDITY_ENDTimestampYesThe date stops to validate.
TARIFFCodeYesTariff code.
PRICEAmountYesPrice of ticket * 100 (so that 25$ = 2500).
CHARGEAmountNoCharge of ticket * 100 (so that 1$ = 100).
VATPercentageNoIf 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 <=
MEMBERSHIP
ORDER_
BEGIN
DATE <= Valid to date of vat rate.
TICKET_STATEText 30YesThe state of ticket must be in ('PRINTED','NOT_PRINTED')
PAYMENT_DATEDateNoIf 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_NRNumberNoEach 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_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 SALEMandatory when the operation type is SALE.
Allowed values: NOT_PRINTED, PRINTED, CONTROLLED.
GENERATION_DATE
Timestamp
Date
Yes if PRINTED
NoIf
the ticket state equal to 'PRINTED' the generation date must not null.FISCAL_NUMBERText 30Yes if PRINTEDThe fiscal number of the ticket. If not inserted, the fiscal number will be generated with prefix equal to "IMP-".BARCODEText 100Yes 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.
BARCODEText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
TAX_NUMBERText 50NoIf leave it empty and the ticket has been printed or controlled, it will be generated following import rules by default.
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_MODECodeNoIf leave it empty and the ticket has been printed or controlled, it will be imported following import rules by default.