File exchange

General information

The data is transferred to the Platform in CSV format.

The data is located on a remote server. The following protocols are supported:

• FTP;

• SFTP;

• WebDAV;

• AWS;

• Dropbox.

Objects should be transmitted to the Platform when they are created and when they are changed.

Text encoding is UTF-8. Data can be unloaded several times per 24 hours. The frequency of unloading depends on how quickly you need to respond to customers. The Platform imports data once every 15 minutes.

You do not have to specify the type of operation for the object (update/create): when it is impossible to insert a record, our import mechanism itself realizes that it is an update.

When the Platform imports a file, it automatically deletes this file from the server to exclude repeated loading of the same data.

File Naming

Recommended format for naming files:

• Customers: clients*.csv;

• Orders: orders*.csv;

• Order lines: items*.csv;

• Events: events*.csv;

• Products: product_items*.csv;

• Product categories: product_cat*.csv;

• Bonus balances: bonuses*.csv;

• Promo codes: promocodes*.csv;

• Directories: dictionaries*.csv.

File names contain the timestamp of the moment of unloading, including the current date and the current time: hours, minutes, and seconds.