Skip to main content

Імпорт історичних транзакцій

Імпорт історичних транзакцій

Інтерфейс

У розділі Аналітика (/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" // властивість товару та його значення

}

]

},

{

"позиція": 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 // сума на кшталт

},

{

"тип": 2,

"сума": 1000

}

]

}

]

особливості:

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

Кількість нарахованих бонусів у транзакції не передається. Потрібно передавати лише чекі, за якими не було повернень.Баланс потрібно встановлювати окремо для кожного учасника підводного човна.