Combo Pocket Україна

API

Точка обіну облікових состем з терміналами збору данних, для обміну через API

Передача та зчитування данних з ТЗД відбувається через відправку запитів на наш сервер.

Найпростіша схема обміну це “Перерахунок товарів”
1. Ви формуєте типовий документ в вашій обліковій системі.
2. Натискаєте кнопку і таблиця відправляеється на наш сервер
3. Тепер ця таблиця доступна на ТСД, ви можете сканувати товари по штрихкоду, вводити кількість. Все обробляється на нашому сервері.
4. Після завершення перерахунку ви забераєте таблицю назад в свою облікову систему.

Combo Pocket API — документація (UA)

Інтеграція облікової системи з мобільним застосунком Combo Pocket: передача таблиці товарів та отримання результатів переобліку.

Базова адреса: https://combopocket.online/api/

Формат: JSON

Метод: POST

Авторизація: token (UUID) у тілі кожного запиту

Заголовок: Content-Type: application/json; charset=utf-8

Зміст

1) Ping — перевірка доступності сервера

POST https://combopocket.online/api/ping

Метод дозволяє перевірити доступність сервера та отримати сервісну відповідь API.

Запит

{
  "token": "<TOKEN>"
}

Відповідь

{
  "status": "OK",
  "error": false,
  "error_descr": ""
}

2) Upload — передача таблиці товарів у додаток

POST https://combopocket.online/api/upload

Запит (мінімальний приклад)

{
  "token": "<TOKEN>",
  "goods": [
    {
      "nom": "Енергетик Monster energy без с",
      "bc": "5060947547162",
      "qty": 113
    }
  ]
}

Відповідь

{
  "status": "ok",
  "useDataCollectorMode": false
}

3) Download — отримання результатів переобліку

POST https://combopocket.online/api/download

Запит

{
  "token": "<TOKEN>"
}

Відповідь

{
  "goods": [
    {
      "nom": "Енергетик Monster energy без с",
      "char": "",
      "bc": "5060947547162",
      "qty": 113,
      "mqty": 0,
      "isweight": false,
      "sku": ""
    }
  ],
  "useDataCollectorMode": false
}

4) Режим «збирача даних» (useDataCollectorMode)

Коли увімкнути?
Якщо потрібно, щоб штрихкоди, яких не було в попередньо переданій таблиці, все одно потрапили у результат /download — використовуйте useDataCollectorMode=true. 
{
  "token": "<TOKEN>",
  "goods": [
    {
      "nom": "Енергетик Monster energy без с",
      "bc": "5060947547162",
      "qty": 113
    }
  ],
  "useDataCollectorMode": true
}
Важливо: для «невідомих» позицій назва може бути відсутня — тоді nom буде рівним штрихкоду. Назву ви можете визначити у своєму сценарії обробки даних.

5) Вагові товари (weightSettings)

{
  "token": "<TOKEN>",
  "goods": [
    {
      "nom": "Крупа арнаутка на кг",
      "bc": "271111112345",
      "qty": 111.11
    }
  ],
  "useDataCollectorMode": true,
  "weightSettings": [
    {
      "prefix": 27,
      "skuLength": 5,
      "weightLength": 5,
      "weightDecimals": 3
    }
  ]
}

6) Показ облікової кількості оператору (mqty)

{
  "token": "<TOKEN>",
  "goods": [
    {
      "nom": "Енергетик Monster energy без с",
      "bc": "5060947547162",
      "qty": 100,
      "mqty": 100
    }
  ],
  "useDataCollectorMode": false
}