Импорт исторических транзакций
Импорт исторических транзакций
Интерфейс
В раздел Аналитика (/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)
- базовые настройки на момент загрузки значение не имеют (могут быть установлены любые настройки)
- не рекомендуется загрузка в момент работы процессинга в продуктиве (во время обработки транзакций таблицы в БД блокируются)
- на момент загрузки в системе должны быть загружены (созданы):
- партнер
- участники программы лояльности
- валюта бонусная
- Торговые точки
- Кассиры (если используется для исторических транзакций)
- Кассы (если используется для исторических транзакций)
- Товары, группы товаров с установленными свойствами, мета-свойства
Кол-во начисленных бонусов в транзакции не передается. Нужно передавать только чеки, по которым не было возвратов. Баланс нужно устанавливать отдельно для каждого участника ПЛ.