Перейти к основному содержимому

Интеграция «Магазина 15» с «SuperMag-2000»

Описание​

Данный коннектор служит для обмена между «SuperMag-2000» и Mobile SMARTS в формате «SuperKitMobile» в режиме офлайн. Это означает, что все данные будут выгружаться/ загружаться только после обмена ТСД с сервером. В обмене участвуют:

  • Документы инвентаризации
  • Контроль цен
  • Приходные накладные
SuperMag-2000 SuperMag-2000 SuperMag-2000

Выгрузка из «Супермаг-2000» происходит в ручном режиме. Формируется необходимый файл, в зависимости от выбранной опции выгрузки и сохраняется в определенной директории, указанной в настройках. Наименование файла выгрузки для всех видов метаданных всегда одно, например, «Scanin.dat». Т. е. для каждого вида документа необходимо сделать выгрузку.

Контроль цен:

В таком варианте выгрузки файл «Scanin.dat» содержит информацию о товарах (наименование, ШК, цена). Эти данные загружаются в ТСД. Для этого необходимо выполнить обмен, и оператор сможет выполнить контроль цен, создав документ «Переоценка». Можно сканировать товар, цены уже загружены, необходимо сверить цену с текущей. Если цена верна, то можно приступать к следующему товару, в противном случае ТСД попросит внести текущую цену.

Внимание! В «Супермаг-2000» будут выгружены фактические цены и только те позиции, цены в которых отличаются от текущих.

Инвентаризация:

При инвентаризации будут загружены товары и их ШК (без цен, т.к. они в этом варианте обмена отсутствуют в исходном файле). Далее все стандартно:

  • Необходимо выполнить обмен
  • Создать документ инвентаризации
  • Сканировать товар
  • Завершить документ и выполнить обмен

Коннектор поддерживает чтение данных как по отдельности, так и всех типов выгрузки из одного файла одновременно. Т. е. можно выгружать контроль цен и инвентаризацию в один файл.

Загрузка данных в «Супермаг-2000» :

После окончания работы с документами в ТСД, необходимо выполнить обмен с сервером Mobile SMARTS. Все завершенные документы будут выгружены на сервер и коннектор автоматически их подхватит (периодичность опроса обновлений настраивается в параметре «Таймаут выгрузки документов в СМ»), выгрузив в указанный в настройках коннектора каталог обмена в файл. Далее необходимо загрузить полученный файл в «Супермаг-2000». Так же как и при выгрузке, «Супермаг-2000» ищет указанный в настройках файл и загружает. Данное действие осуществляется вручную из «Супермаг-2000».

Формат файлов Супермаг-2000

Интерфейс​

SuperMag-2000

Инвентаризация

  • Тип документа — наименование типа документа Mobile SMARTS (по умолчанию «Инвентаризация»).

Контроль цен

  • Тип документа — наименование типа документа Mobile SMARTS (по умолчанию «Переоценка»)

Настройки обмена

  • Каталог обмена — каталог, куда «Супермаг-2000» будет выгружать и забирать файлы.
  • Наименование входящего файла — файл выгрузки из «Супермаг-2000».
  • Наименование исходящего файла — файл для загрузки в «Супермаг-2000».
  • Таймаут выгрузки документов в СМ — цикличность опроса сервера на предмет новых данных для выгрузки в СМ (По умолчанию «30» секунд), в секундах.

Общее

  • Версия — версия библиотеки.
  • Единица измерения для упаковок — единица измерения, которая будет подставлена при загрузке данных из «Супермаг-2000» (По умолчанию «шт»).
  • Код пользователя/группы — код пользователя для подстановки в документы при загрузке данных из «Супермаг-2000» (По умолчанию «оператор»).
  • Код склада — склад для подстановки в документы при загрузке данных из «Супермаг-2000» (По умолчанию «1»).
  • Регистрировать события обмена — опция включает/выключает ведение журнала (лог файл расположен там же где находится лог сервера, в каталоге с базой данных — пример «C:\ProgramData\Cleverence\Databases\маг15\Logs\connectors\sm»).

Приходные накладные

  • Тип документа — наименование типа документа Mobile SMARTS (по умолчанию «Поступление») — на данный момент не используется.

Структура файлов обмена​

Файл Импорта (входной), формат файла – CSV, разделитель «;»

Имя по умолчанию SCANIN.DAT , путь к файлу настраивается в программе.

Внимание: Кодировка файла UTF-8.

Каждая строка файла импорта должна оканчиваться «Вводом» [CR]+[LF]
1.Запись справочника

(номенклатуры)

Префикс записи «P»		Структура:

<P>;<ШТРИХКОД>; <НАЗВАНИЕ>; <ЦЕНА>; <КОЛИЧЕСТВО>;

<ССЫЛОЧНЫЙ ШК ДЛЯ ГРУППОВЫХ ТОВАРОВ>;<АДРЕС>

Цветом выделены обязательные поля. Тип данных:

<ШТРИХКОД> — максимально 64 символа;

<НАЗВАНИЕ> — максимально 128 символов;

<ЦЕНА> — CURRENCY, разделитель целой и дробной части «.»

<КОЛИЧЕСТВО> — FLOAT;

<ССЫЛОЧНЫЙ ШК ДЛЯ ГРУППОВЫХ ТОВАРОВ> — максимально

64 символа;

<АДРЕС> — текстовая строка
2.Запись заголовка накладной

Префикс записи «I»		Структура:

<I>;<НОМЕР НАКЛАДНОЙ>;<НАЗВАНИЕ КОНТРАГЕНТА>;<ТИП НАКЛАДНОЙ>;<ТИП ЯЧЕЕК>

Тип данных:

<НОМЕР НАКЛАДНОЙ> — 64 символа

<НАЗВАНИЕ КОНТРАГЕНТА> — 128 символов

<ТИП НАКЛАДНОЙ> — “0” – накладная поставщика, “1” – расходная, “2” – заказ, “3” – приходная накладная, “4” – накладная на перемещение

<ТИП ЯЧЕЕК> — “0” – накладные без ячеек, “1” – накладные с ячейками
3.Запись содержимого накладной

Префикс записи «II»

Данные записи формируют отображаемый на экране список позиций накладной.		Структура:

<II>; <НОМЕР НАКЛАДНОЙ>; <ШТРИХКОД>; <КОЛИЧЕСТВО>;

<ТИП НАКЛАДНОЙ>

Тип данных:

<НОМЕР НАКЛАДНОЙ> — 64 символа

<ШТРИХКОД> — 64 символа

<КОЛИЧЕСТВО> — INTEGER

<ТИП НАКЛАДНОЙ> — “0” – накладная поставщика, “1” – расходная, “2” – заказ, “3” – приходная накладная, “4” – накладная на

перемещение.
4.Запись заголовка инвентаризации

Префикс записи «IV»		Структура:

<IV>;<Код документа инвентаризации>;<Тип инвентаризации>;<описание документа>

<Код документа инвентаризации> — уникальный номер;<br/> <br/><Тип инвентаризации> — 0 – без ячеек, 1 – с ячейками;

<описание документа> — текстовое поле.
5.Запись идентификатора ячеек

Префикс записи «С»		Структура:

<C>;<ШК ячейки>;<описание ячейки><br/> <br/><ШК ячейки> — уникальный идентификатор ячейки;

<описание ячейки> — текстовое обозначение ячейки.
Расширение форматов файла импорта.
6.Накладные

Заголовок накладной: Префикс записи «I»		Структура:

В дополнение к стандартной структуре заголовка накладной:

<I>;<НОМЕР НАКЛАДНОЙ>;<НАЗВАНИЕ КОНТРАГЕНТА>;<ТИП НАКЛАДНОЙ>;<ТИП ЯЧЕЕК>

добавляются новые поля:

<Сроки годности> — идентификатор присутствия сроков годности. Если равен «1», то накладная со сроками годности, если – «0», то без запроса сроков годности.

<Цена в накладной> — если равно «1», то накладная с выводом цены, если «0» или отсутствует, то без вывода цены.

В итоге общая запись заголовка накладно выглядит следующим образом:

<I>;<НОМЕР НАКЛАДНОЙ>;<НАЗВАНИЕ КОНТРАГЕНТА>;<ТИП НАКЛАДНОЙ>;<ТИП ЯЧЕЕК>;<СРОКИ ГОДНОСТИ>;<ЦЕНА В НАКЛАДНОЙ>

Примечание! В структуре записи накладной могут отсутствовать поля: <ТИП ЯЧЕЕК>; <Сроки годности>; <Цена в накладной>.

При этом поля в структуре записи разбираются последовательно. Если не используются, например, сроки годности, то соответствующее поле должно быть «0» или просто выделено «;» - проп:

I;12;Postavschik;0;1;;1
7.Накладная

Содержимое накладной: Префикс записи «II»		Вводятся дополнительные поля:

<СРОК ГОДНОСТИ> — число в формате ДД.ММ.ГГГГ;

<ЦЕНА 1> — цена товара по накладной;

<ЦЕНА 2> - дополнительная цена товара по накладной. Общая структура:

<II>; <НОМЕР НАКЛАДНОЙ>; <ШТРИХКОД>; <КОЛИЧЕСТВО>;

<ТИП НАКЛАДНОЙ>;<СРОК ГОДНОСТИ>;<ЦЕНА 1>;<ЦЕНА 2>

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

«Учитывать НДС» в окне ввода позиции по накладной.
Поля структуры, описанные в пп. 6, 7 могут отсутствовать.
Альтернативная форма представления товара.
8.Артикул

Префикс записи «P2»		Структура:

<I>;<АРИКУЛ>;<НАЗВАНИЕ ТОВАРА>;<ШТРИХКОД ПО УМОЛЧАНИЮ>;<ЦЕНА ПО УМОЛЧАНИЮ>;<АДРЕС>

Запись строки Артикула может сопровождаться строкой штрихкода или доп. классификатора для этого артикула.
9.Штрихкод

Префикс записи «B»		Общая структура:

<B>; <ШТРИХКОД>; <АРТИКУЛ>; <ЦЕНА>;<КОЭФФИЦИЕНТ КОЛИЧЕСТВА>
10.Дополнительный классификатор

Префикс записи «Q»		Структура:

<Q>;<ШТРИХКОД>;<АРТИКУЛ>;<ЗНАЧЕНИЕ>;<ТИП КЛАССИФИКАТОРА>;<ЦЕНА>;<КОЛИЧЕСТВО>

<ЗНАЧЕНИЕ> — значение классификатора по штрихкоду

<ТИП КЛАССИФИКАТОРА> — характеристика товара, которая может принимать несколько значений. Например, Цвет, Размер и т.п.

например, для строки:

Q;77777;12345;СИНИЙ;ЦВЕТ;10;11

будет выведена дополнительная строка к товару с Артикулом 12345

«ЦВЕТ: СИНИЙ»
Файл Экспорта (выходной), формат файла – CSV, разделитель «;»

Имя по умолчанию SCANOUT.DAT, путь к файлу настраивается в программе.

Кодировка файла UTF-8.
1.Запись инвентаризации

Префикс записи «P»		Структура:

<P>;<ШТРИХКОД>;<КОЛИЧЕСТВО>

Тип данных:

<ШТРИХКОД> — 64 символа;

<КОЛИЧЕСТВО> — FLOAT.

Инвентаризация с заголовками без ячеек:

<P>; <ШТРИХКОД>;<КОЛИЧЕСТВО>;<Код документа

инвентаризации>

Инвентаризация с заголовками с ячейками:

<P>; <ШТРИХКОД>; <КОЛИЧЕСТВО>;<Код документа

инвентаризации>;<ШК ячейки>
2.Запись заголовка накладной

Префикс записи «I»		Структура:

<I>;<НОМЕР НАКЛАДНОЙ>;<ТИП НАКЛАДНОЙ>

Тип данных:

<НОМЕР НАКЛАДНОЙ> — 64 символа

<ТИП НАКЛАДНОЙ> — “0” – накладная поставщика, “1” – расходная, “2” – заказ, “3” – приходная накладная, “4” – накладная на

перемещение.
3.Запись содержимого накладной

Префикс записи «II»

Данные записи формируют отображаемый на экране список позиций накладной.		Структура:

<II>;<НОМЕР НАКЛАДНОЙ>;<ТИП НАКЛАДНОЙ>;<ШТРИХКОД>;

<КОЛИЧЕСТВО>;<ИДЕНТИФИКАТОР ЯЧЕЙКИ>;<СРОК ГОДНОСТИ>

Тип данных:

<НОМЕР НАКЛАДНОЙ> — 64 символа

<ШТРИХКОД> — 64 символа

<КОЛИЧЕСТВО> — INTEGER

<ТИП НАКЛАДНОЙ> — “0” – накладная поставщика, “1” – расходная, “2” – заказ, “3” – приходная накладная, “4” – накладная на перемещение.

<ИДЕНТИФИКАТОР ЯЧЕЙКИ> — номер ячейки для товара.

<СРОК ГОДНОСТИ> — дата в формате ДД.ММ.ГГГГ

Поля <ИДЕНТИФИКАТОР ЯЧЕЙКИ> и <СРОК ГОДНОСТИ> могут

отсутствовать, если ведется работа без их использования.
4.Запись результатов проверки цен

Префикс записи «С»		Структура:

<С>; <ШТРИХКОД>; <ЦЕНА>.

Тип данных:

<ШТРИХКОД> — 64 символа;

<КОЛИЧЕСТВО> — FLOAT.
В этой статье