Импорт исторических транзакций

Импорт исторических транзакций

Интерфейс

В раздел Аналитика (/analytics/sales/index) вкладка "Импорт транзакций"

Загрузка

Загрузка выполняется посредством импорта из файла.

Формат импортируемого файла .json

Структура:

[

{

"check_id": "check-123456", // номер чека, должен быть уникальный в пределах сети партнера

"user_id": 1, // идентификатор пользователя в БД лояльности. Для неидент. продажи передаем "0"

"partner_id": 1, // идентификатор партнера в БД лояльности

"branch_id": 1, // идентификатор торговой точки в БД лояльности

"operator_id": 1, // идентификатор кассира в БД лояльности (значение не обязательно к заполнению)

"session_id": null, // номер смены (значение не обязательно к заполнению)

"terminal_id": 1, // идентификатор кассы в БД лояльности (значение не обязательно к заполнению)

"receipt_description": "", // описание транзакции

"receipt_time": 1563463047, // дата чека продажи

"receipt_sum": 2000, // сумма чека

"receipt_currency":"BON" // бонусная валюта

"details": [ // детали чека

{

"position": 1, // номер позиции

"prod_code": "1010", // sku товара

"prod_price": 1000, // цена товара

"prod_amount": 1, // количество товара

"prod_sum": 1000, // сумма по позиции

"meta": [

{ // meta-свойства товара (не обязательный параметр)

"meta1": "meta1", // свойсвто товара и его значение

"meta2": "meta2" // свойсвто товара и его значение

}

]

},

{

"position": 2,

"prod_code": "2020",

"prod_price": 1000,

"prod_amount": 1,

"prod_sum": 1000,

"meta": [

{

"meta1": "meta1",

"meta2": "meta2"

}

]

}

],

"payment_types": [ // информация по типам оплаты (1-нал.; 2-безнал.)

{

"type": 1, // тип оплаты

"sum": 1000 // сумма по типу

},

{

"type": 2,

"sum": 1000

}

]

}

]

Особенности:

• величина массива - ограничение по файлу 50 Мб
• если не прошла валидация, то пользователю будут отображены ошибки на странице с указанием номера элемента массива (нумерация начинается с 0)
• базовые настройки на момент загрузки значение не имеют (могут быть установлены любые настройки)
• не рекомендуется загрузка в момент работы процессинга в продуктиве (во время обработки транзакций таблицы в БД блокируются)
• на момент загрузки в системе должны быть загружены (созданы):
  • партнер
  • участники программы лояльности
  • валюта бонусная
  • Торговые точки
  • Кассиры (если используется для исторических транзакций)
  • Кассы (если используется для исторических транзакций)
  • Товары, группы товаров с установленными свойствами, мета-свойства

Кол-во начисленных бонусов в транзакции не передается. Нужно передавать только чеки, по которым не было возвратов. Баланс нужно устанавливать отдельно для каждого участника ПЛ.