1. Интеграция

Система имеет возможность интеграции с внешними системами для ввода и вывода информации. Интеграция проходит через услугу WebService/SOAP установленную в центральной системе.

Рис. 1 Архитектура интеграции

Центральная интеграция предназначена для импорта информации о товаре в центральную систему БитДата.  Интеграция разделена на следующие составляющие:

  1. Импорт общей информации о товарах
  2. Импорт изображений и логотипов
  3. Импорт цен
  4. Импорт акций и скидок

2. Импорт общей информации о товарах

string PostArticles(string productXml) - функция импорта общей информации товаров.

Данная функция предназначена для создания, обновления и удаления товаров из системы. Общая информация о товаре после импорта доступна всем магазинам сети.  Рекомендуется создавать XML-файлы, которые содержат максимум 5000 товаров.

Общая информация о товаре подразумевает:

  • наименование и марка товара;
  • другие текстовые поля товара;
  • код товара EAN, номер артикула и до 5 пользовательских кодов;
  • привязка изображений и логотипов к соответствующим полям товара;
  • дополнительные, комплектующие или рекомендуемые товары.

2.1. Параметры

string productXml – данный параметр содержит XML-файл с описанием товаров. Файл формируется в соответствии с XSD-схемой «artlices-upload-vXX.xsd». Где ХХ является номером версии XSD-файла. Более детальное техническое описание описано в XSD-файле.

Внимание! Для отправки параметра хmlString в сообщении SOAP необходимо применить параметр «Escaping XML Data», либо заключить хmlString в капсулу CDATA. Смотрите примеры SOAP-сообщений, прикреплённые к документации. Некоторые языки программирования автоматически применяют необходимое изменения.

2.2. Значение возврата

После отправки SOAP-послания, необходимо дождаться ответа системы. После обработки входного файла, система создаст XML-файл со списком товаров, которые не были импортированы по той или иной причине. Если ошибок не было тогда XML-файл возврата пустой. Если ответ возврата это «Exception Message», тогда файл не был импортирован полностью.

2.3. Первая загрузка string PostArticles(string productXml)

При первой загрузке рекомендуется загрузить все товары системы, которые имели последнюю активную продажу в регистре клиента не позднее, чем 1 год. Данная фильтрация уменьшит количество товаров в системе БитДата и облегчить поиск и печать товаров. Также малое количество товаров способствует боле быстрой работе системы.

2.4. Список доступных полей в системе

Список доступных полей в системе описывается отдельным документом. Документ описывает рекомендуемую содержание и длину поля.

3. Импорт изображений и логотипов

PostPicture(byte[] pictureBytes, string fileNameAndExtension)

Это функция для импорта изображений в систему. Изображение необходимо загрузить в систему до привязки изображения к товару. В системе можно присоединять одно изображение одному или многим товарам. Например, логотип необходимо загрузить всего один раз и присоединить ко всем товарам, которые связанны с данным логотипом.

Рис. 2 Пакет изображений

3.1. Параметры

byte[] pictureBytes

Изображение в форме bytes.

string fileNameAndExtension

Наименование файла изображения, включая расширение файла, например, «Pictue123.jpeg».

3.2. Значение возврата

Функция возвращает MD5-код изображения, которое является уникальным идентификатором изображения. Данный код используется при импорте общей информации товара для привязки изображения к полям. MD5-код изображения можно вычислить вне системы простым алгоритмом, который предоставляется по запросу.

3.3. Формат Изображений

Для оптимального качества печати шаблонов, рекомендуется загружать изображения, которые имеют размер как минимум 1500 пикселей в ширину или длину. Изображения больше 15 мегабайт не принимаются системой. Система принимает следующие форматы изображений:

  • «Graphics Interchange Format» (*.gif);
  • «Joint Photographic Experts Group» (*.jpg; *.jpeg) (Рекомендуемый формат);
  • «Portable Network Graphics» (*.png) (Рекомендуемый формат);
  • «Tag Image File Format» (*.tif; *.tiff);
  • «Bitmap Picture» (*.bmp; *.dib);
  • «Windows Metafile» (*.wmf).

4. Импорт цен

string PostPrices(string priceXML)

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

Если цена одинакова для всех магазинов сети, тогда пакет цен загружается один раз с уникальным номером головного офиса.

Рис. 3 Пакет цен единый

Если цена товаров в магазинах разделена по регионам, тогда пакет цен загружается для каждого региона отдельно. При загрузке используется уникальный номер соответствующего региона.

Рис. 4 Пакет цен региональный

Если цена товаров в магазинах индивидуальная, тогда пакет цен загружается для каждого магазина отдельно. При загрузке используется уникальный номер соответствующего магазина.

Рис. 5 Пакет цен индивидуальный

Уникальные номера головного офиса или магазинов сети согласуется заранее.

4.1. Параметры

string priceXML - данный параметр содержит XML-файл со списком цен на товары и уникальным номеров товара EAN, номер артикула или другим уникальным номером. XML-файл должен соответствовать XSD-схеме «price-upload-vXX.xsd». Где ХХ является номером версии XSD-файла. Более детальное техническое описание описано в XSD-файле.

4.2. Значение возврата

После отправки SOAP-послания, необходимо дождаться ответа системы. После обработки входного файла система создаст XML-файл возврата, который содержит цены, которые не были импортированы по той или иной причине. Если ошибок не было тогда XML-файл возврата пустой. Если ответ возврата это «Exception Message», тогда файл не был импортирован полностью.

5. Импорт акций и скидок

string PostPromotion(string promotionXML)

Акции и скидки, как и цены, могут импортироваться как на уровне головного офиса, так и на уровне определённого магазина. Как в случае импорта цен, при импорте акций используется уникальный номер магазина или головного офиса.

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

5.1. Параметры

string promotionXML - данный параметр содержит XML-файл со списком сниженных цен на товары и уникальных номеров товара EAN, номеров артикулов или других уникальных номеров. ХМL-файл должен соответствовать XSD-схеме «price-upload-vXX.xsd». Где ХХ является номером версии XSD-файла. Более детальное техническое описание описано в XSD-файле.

Поддерживается множество разных видов акций:

  • Скидка (скидка на шаблоне может отображаться как в процентном, так и цифровом формате);
  • «Купи Х шт. заплати за Y шт.»;
  • Управление заголовком шаблона, например, «Скидка», «Новинка», «Без заголовка». Данная функция достигается специальным полем цифровое значение, которого означает тот или иной заголовок. Количество возможных заголовков ограничено. Ниже приведён пример шаблона, который видоизменился в зависимости от поля управление заголовком.

 

5.2. Значение возврата

Смотри «Импорт цен» пункт 4.2

 

6. Печать по запросу

Рис. 6 Печать по запросу

Опция печать по запросу используется для печати из внешних систем POS, ERP и т.п. путём заказа автоматической печати шаблонов с информацией о конкретном товаре или товарах.

Архитектура заказа печати простая:

  1. Внешняя система генерирует XML-файл со списком товаров, которые необходимо напечатать с указанием id группы шаблонов. XML-файл должен следовать XSD-схеме «pod-vXX.xsd». Где ХХ является номером версии XSD-файла. Более детальное техническое описание описано в XSD-файле.
  2. Далее файл помещается в специальном каталоге программы БитПостер.
  3. Программа обрабатывает XML-файл и печатает товары на предопределенном шаблоне или шаблонах. Притом дополнительная информация о товаре в системе тоже выводится на шаблон.

Группы печати шаблонов создаются в программе БитПостер. Все id групп с описанием экспортируются программой БитПостер в XML-файл в определённый каталог. Экспорт файла происходит при каждом изменении группы печати.