Export Requirements
Export Format
All data export is provided in .csv format files.
Separator — ; (semicolon)
File encoding — UTF-8 without BOM
Important
- The separator symbol (
;) must not be present in the data to avoid incorrect loading. - Mandatory fields are marked with an asterisk (*).
- Other fields are optional but recommended to be filled if data is available.
Clients
The user export must contain the following fields:
- Card number
- Card type (master, student, cumulative)
- Phone*
- First name
- Last name
- Middle name
- Identifier of the store where the client was registered
(must match the identifier from the store export) - Card / customer registration date
- Current card discount size
Stores
Before loading purchases, stores must be created.
If purchases from closed stores are to be loaded, such stores must also be present in the export.
The store export must contain the following fields:
- Unique store identifier*
- Store name*
- Unit / city
- Store address
- Status "closed / open"
Purchases
To load purchases, it is necessary to form a line-by-line order export, where each line corresponds to one order position.
In the export, the following fields must be specified:
- Unique order / receipt number*
- Store identifier (must match the identifier from the store export)*
- Card number or customer phone (must match data from the client export)*
- Product barcode (code)*
- Product quantity (cannot be less than
1)* - Price (product of quantity and price per unit, cannot be less than
0)* - Product discount (product of quantity and discount per unit, discount amount cannot exceed the price)*
- Sale date (strictly in
YYYY-MM-DD HH:MM:SSformat)*
Important
- Empty values are allowed only in the "Card number" or "Phone" fields.
In this case, a purchase will be created without binding to a specific client. - Data must be sorted by sale date and order number in ascending order.