Combo Pocket API

Описание:
На этой странице описан базовый сценарий интеграции вашей учетной системы с сервисом Combo Pocket для подключения ТСД (или смартфона)

Вариант 1
Базовая интеграция (самый простой вариант)
(Ваша учетная система → смартфон или ТСД):

• Ваша учётная система передаёт в Combo Pocket массив структур.
• Каждая структура содержит:
  • bc — штрихкод (barcode)
  • nom — наименование товара
  • qty — фактическое количество
• Дополнительно передаётся токен, полученный на странице тестового входа.
• Обмен данными идёт через HTTPS POST в формате JSON.

Пример — так отправляются данные:

Метод: POST
URL: https://combopocket.online/api/upload

Тело запроса
{
  "token": "6b77d741-5f2e-4720-afad-4823d3bc",
  "goods": [
    {
      "nom": "Energy Drink MonsterEnergy",
      "bc": "5060947547162",
      "qty": 0
    },
    {
      "nom": "Red Bull 0.5l",
      "bc": "9002490212100",
      "qty": 0
    }
  ]
}

Код успешного ответа
200

Пример обработки в формате epf для интеграции ТСД

Пример — как получить посчитанные данные назад
(Смартфон или ТСД → ваша учетная система):

Метод: POST
URL: https://combopocket.online/api/download

Тело запроса
{
  "token": "6b77d741-5f2e-4720-afad-4823d3bc"
}

Тело ответа:
{
  "goods": [
    {
      "nom": "Energy Drink MonsterEnergy",
      "bc": "5060947547162",
      "qty": 10
    },
    {
      "nom": "Red Bull 0.5l",
      "bc": "9002490212100",
      "qty": 20
    }
  ]
}

Сценарий работы выглядит так.
Вы отправляете список товаров в смартфон (или ТСД) методом upload.
Затем после окончания пересчета выгружаете данные обратно в учетную систему методом download

При повторной отправке таблицы методом upload — ранняя версия таблица удаляется.

Если необходимо дополнить таблицу пересчета на устройстве новыми товарами — ее необходимо сначала выгрузить метом download (чтобы не утратить уже пересчитанные данные). А затем отправить обновленную таблицу методом upload.

Возникли вопросы. Смело задавай прям тут 👈

Вот интерфейс связи с нашими IT

Есть подозрение, что они ничего не делают — пора их разбудить. 😹

Имя

Email-адрес (Не обязательно)

Номер телефона (Не обязательно)

Сообщение0 / 180

Отправить

Пожалуйста, не заполняйте это поле.

Имя

Email-адрес (Не обязательно)

Номер телефона (Не обязательно)

Сообщение0 / 180

Отправить

Пожалуйста, не заполняйте это поле.

Вариант2
При наличии весовых товаров

При наличии в учетной системе весовых товаров — как правило используются их внутреннее штрихкодирование.
Штрих-коды таких товаров обычно начинаются с префикса 21 или 221.
В таких штрихкодах уже содержится и идентификатор товара в виде СКЮ кода, и его вес.

Пример такого штрихкода:
270123015009
27 — это префикс
0123 — это СКЮ код товара
1.5 — это вес товара

Система переучета Combo Pocket содержит встроенный парсер для таких штрихкодов. И может определять и суммировать вес таких товаров в автоматическом режиме. Это означает что количество (вес) вообще не нужно вводить — достаточно просто сканировать весовые товары.

Для реализации работы с весовыми товарами

Следует передать описание способов которыми у вас принято кодировать весовые товары. Наша система поддерживает множество различных комбинаций префиксов штрихкода одновременно. Для каждого префикса может быть разная длина СКЮ, количество значений веса и длина дробной части веса.

Как и в Варианте 1, вы отправляете массив товаров goods и token. Дополнительно передаётся массив правил weightSettings, по которым сервер распознаёт весовые штрихкоды: выделяет из кода префикс, SKU и вес, конвертирует вес в килограммы.

Тело запроса
{
  "token": "6b77d741-5f2e-4720-afad-4823d3bc",
  "weightSettings": [
    {
      "prefix": "27",
      "skuLength": 5,
      "weightLength": 5,
      "weightDecimals": 3
    }
  ],
  "goods": [
    {"nom": "Товар А", "bc": "2701234005000", "qty": 0},
    {"nom": "Товар Б", "bc": "2701235015000", "qty": 0},
    {"nom": "Товар В", "bc": "2701236123450", "qty": 0}
  ]
}

prefix (string) — префикс весового кода .

skuLength (integer ≥1) — длина участка, где хранится SKU после префикса.

weightLength (integer ≥1) — длина участка с весом после SKU.

weightDecimals (integer ≥1) — число знаков после запятой в весе (масштаб). Вес вычисляется как

Пример обработки в формате epf для интеграции ТСД для управляемых форм.

Пример обработки в формате epf для интеграции ТСД для обычных форм (не управляемых).

Вариант 3
Использование характеристик товаров

Существуют случаи когда товар может иметь разные штрихкоды, но одно наименование. Если ваш сценарий использования оборудования для пересчетов предполагает такую ситуацию то вы можете передавать в таблице товаров дополнительное поле char. В таком случае в приложении на устройстве пересчета будет отображено дополнительное поле которое будет содержать эти данные.
Например: размер одежды, состав ящика итд

{"nom": "Ма", "bc": "2701234005000", "qty": 0, "char": "Размер L"}

Разбудить айтишника можно нажав сюда 👈

Давайте все-таки пошевелим наш IT отдел
и задами им пару вопросов. 😹

Имя

Email-адрес (Не обязательно)

Номер телефона (Не обязательно)

Сообщение0 / 180

Отправить

Пожалуйста, не заполняйте это поле. Пожалуйста, не заполняйте это поле.

Вариант 4
Передача учетного и фактического количества товаров

Существуют случаи когда сотруднику можно показывать учетное количество товаров.
Например: если вы доверяете сотруднику — намного удобнее будет сразу показывать ему учетное (желаемое) количество товара в интерфейсе мобильного приложения.
Таким образом сотрудник будет видеть расхождения факта и учета еще до того как товар будет выгружен обратно в вашу учетную систему.
Этот режим удобен для управляющего персонала, экспертных проверок актуальных остатков итд.
Плюсы: значительное ускорение — исключается процесс «Досчета» и «Поиска товара в закромах для досчета» — так как эту аналитику проводит сам сотрудник. И если он сообщает что пересчет закончен — значит все данные были проверены с его стороны и товара действительно столько сколько удалось насчитать.
Минусы: Зная учетное количество сотрудник сможет подгонять под него фактическое — таким образом минусы товара могут быть переданы по смене на другого сотрудника.

{"nom": "Ма", "bc": "2701234005000", "qty": 0, "mqty": 100}

mqty - это учетное количество товара, просто добавляйте его в строку товаров если необходимо отображение фактического количества.

Сценарии использования нескольких устройств

Для пересчета одного списка товаров несколькими сотрудниками — необходимо на всех желаемый устройствах зайти под одной учетной записью.
В таком случае на сервер Combo Pocket достаточно передать одну таблицу.

Для пересчета разных списков товаров несколькими сотрудниками — необходимо на всех желаемый устройствах зайти под разными учетными записями.
В таком случае на сервер Combo Pocket необходимо передать разные таблицы. Токен каждой таблицы должен соответствовать учетным данным пользователей которые будут ее считать.

Дополнительно

Работа ТСД и Смартфонов одновременно
Можно использовать ТСД и Смартфоны одновременно.

Для крупных предприятий
Рекомендуем закрепить ТСД за торговой точкой, кассой или сотрудником.
Тогда будет удобно хранить токен на уровне такого закрепления.
Что позволит визуально организовать очень простой интерфейс для оператора.