Файловый импорт/экспорт

Описание

  • Для оптимального и быстрого экспорта данных из SetRetail10 в ERP, мы настоятельно рекомендуем использовать веб-сервисы экспорта, размещенные на стороне ERP-систем.
  • Данные для файлового импорта и экспорта соответствуют схемам веб-сервиса на стороне SetRetail10.

Транспорт предполагает обмен файлами между SetRetail10 и ERP.

Для импорта и экспорта данных предусмотрены каталоги в файловой системе определенной структуры, путь к которым может быть настроен на сервере SetCentrum или SetRetail (Импорт/ЭкспортЭкспортВкладка ERP → добавьте Протокол Set Retail 10: файлы → настройте пути экспорта или оставьте по умолчанию)

Тип данных

Формат имени файла

Папка импорта и экспорта по умолчанию

Windows

Импорт данных в SetRetail10 из ERP

Товарный справочник

catalog-goods_*.xml

{instdisk}:\products

/var/lib/jboss/products

Внутренние карты

catalog-cards_*.xml

{instdisk}:\cards

/var/lib/jboss/cards

Кассиры

catalog-cashiers_*.xml

{instdisk}:\cashiers

/var/lib/jboss/cashiers

Экспорт данных из SetRetail10 в ERP

Для экспорта данных в ERP с помощью файлов используется форма XSD-схем и веб-сервисов для выгрузки данных через веб-сервис на стороне SetRetail10

Чеки

purchases-*.xml




{instdisk}:\reports





/var/lib/jboss/reports

Z-отчеты

zreports-*.xml

Реализация

sales_report-*.xml

Результаты расчета скидок

discounts-*.xml

Внесения

cash_in-*.xml

Изъятия

cash_out-*.xml

  • Все файлы имеют кодировку UTF-8 без управляющих символов (UTF-8 without BOM).
  • Выгрузка новых данных из SetRetail10 осуществляется с заданной периодичностью, которая может быть настроена в Импорт/ЭкспортЭкспортВкладка ERP → добавьте Протокол Set Retail 10: файлы.→ вкладка Экспорт данных.
  • Файловый импорт по умолчанию выключен в настройках системы, включить его и настроить рабочие директории можно в модуле Импорт/ЭкспортЭкспортВкладка ERP → добавьте Протокол Set Retail 10: файлы.→ вкладка Импорт данных.
  • Со стороны SetRetail10 производится постоянный мониторинг папки /source на наличие файла (по умолчанию 1 раз в 60 секунд).
    • В случае появления файла модуль переносит файл во временную папку /tmp для обработки.
    • В случае некорректного прохождения валидации XML-файл перекладывается в папку /error некорректно обработанных файлов.
    • ERP может анализировать содержимое этой папки для получения обратной связи по загрузке акций.
  • Если валидация проведена успешно, данные из полученного файла принимаются в SetRetail10 для обработки и файл перемещается в папку /success.
  • В случае необходимости ERP может повторно запрашивать данные из SetRetail10 с помощью механизма файл-флагов.

Перезапрос данных из SetRetail10 с помощью механизма файл-флагов

  • Механизм файл-флагов позволяет ERP-системе осуществлять перезапрос данных из SetRetail10.
  • Для этого ERP-система должна сформировать файл с именем reports.request специального формата (файл-флаг), внутри которого, указывается тип данных и период, где необходимо выполнить перевыгрузку.
  • Файл должен быть сохранен папку .../reports/ каталога экспорта из SetRetail10 (по умолчанию это каталог ...\reports\).
  • SetRetail10 с определенной периодичностью осуществляет проверку наличия файл-флага и в случае обнаружения такого файла он обрабатывается и удаляется.
  • Запрашиваемые данные будут выгружены не моментально, а при следующей плановой выгрузке (периодичность может быть настроена в модуле 
    Импорт/ЭкспортЭкспортВкладка ERP → добавьте Протокол Set Retail 10: файлы.→ вкладка Экспорт данных.

Параметр

Допустимые значения

Описание

date

12.04.2011

Дата операционного дня

dateRange

01.04.2011-12.04.2011
01.04.2011, 05.04.2011

Диапазон дат (операционные дни)

shop

101,102,103
101-103

Список магазинов.
Если задано – все магазины.

cash

1,2,3
1-3

Список касс.
Если не задано – все кассы

shift

1,2,3
1-3

Список смен.
Если не задано – все смены

report

purchases, Zreports, sales

Тип данных для выгрузки: чеки, Z-отчёты, реализация

Пример файла-флага:

dateRange: 03.03.2011-14.03.2011 report: Zreports, purchases