Интеграция с SetRetail, описание и настройка

Настройки интеграции

• Пользователи
  • Пользователям, которые будут выгружать/загружать данные включить роль СКЛАД + ПРОИЗВОДСТВО → Начальные сценарии → Внешние кассовые системы → Прием продаж из SetRetail
• Торговые залы
  • В Юпитере установить коды торговых залов в соответствии с магазинами в SetRetail
    • Коды магазинов можно будет посмотреть\выгрузить из SetRetail
  • Для каждого торгового зала должен быть заведен документ "Прейскурант для клиента"
    • Прейскурант должен быть указан в карточке торгового Доп. параметры → Прейскурант
    • В прейскуранте должен быть перечислен весь ассортимент с актуальными ценами
    • Прейскурант должен быть акцептован
    • Дата прейскуранта должна быть больше текущей даты (на момент выгрузки)
• Виды оплат
  • В Юпитере создать виды оплаты, которые используются в магазинах. Установить им внешние коды в соответствии со списком:
    • CashPaymentEntity – наличные;
    • BankCardPaymentEntity – безналичный;
    • GiftCardPaymentEntity – подарочная карта;
    • ConsumerCreditPaymentEntity – потребительский кредит;
    • ExternalBankTerminalPaymentEntity — внешний банковский терминал;
    • BonusCardPaymentEntity — оплата бонусами;
    • BonusSberbankPaymentEntity – Бонусная карта Сбербанка;
    • CFTGiftCardPaymentEntity – Оплата по подарочной карте ЦФТ;
    • ChildrenCardPaymentEntity – оплата Детской картой;
    • BankQRPaymentEntity - оплата QR-кодом;
    • BankBiometricsPaymentEntity – оплата по биометрии CSI-K.
• Справочник ТМЦ

  • ТМЦ, которые будут выгружаться в SetRetail, должны находиться в подгруппе с признаком «Для продажи через кассу».

  • Для ТМЦ которые будут выгружаться в SetRetail, должен быть введен хотя бы один штрих код (упаковка)
  • ТМЦ, которые будут выгружаться в SetRetail, должны быть добавлены в хотя бы один прейскурант торгового зала.

Процедура загрузки продаж в Юпитер из SetRetail

• Процедура может запускаться из раздела SetRetail → Загрузка продаж из SetRetail
• Процедура загружает данные по кассовым продажам из XML-файлов по маске purchases*.XML (формат), предварительно выгруженных из SetRetail в заранее обговоренный каталог. 
• В результате загрузки, в программе Юпитер будут созданы рабочие дни и кассовые заказы. По созданным рабочим дням будет сформирована реализация.
• Предполагается, что SetRetail выгружает файл с чеками после закрытия рабочей смены, т.е. файл выгрузки должен содержать все чеки за смену.
• Предполагается, что за одну календарную дату для одного магазина может быть только одна смена (рабочий день).
• При импорте существующие данные (документы реализации, рабочие дни, кассовые заказы) пересоздаются.
• Работа процедуры логгируется в файл import_from_SetRetail_{дата}.log

Таблица параметров загрузки

Параметр в выгрузке	Описание параметра	Значение в Юпитере
operDay*	Операционный день	Дата рабочего дня
shop*	Номер магазина	Код торгового зала
cash	Номер кассы	Игнорируется
shift	Номер смены	Игнорируется
number*	Номер чека	Номер заказа
saletime	Дата/Время продажи	Дата закрытия заказа
begintime	Дата создания чека (добавления первого товара)	Дата открытия заказа
amount	Сумма чека	Игнорируется
discountAmount	Сумма скидки на чек	Игнорируется
inn	ИНН юридического лица в смене	Игнорируется
qrcode	Состав QR-кода чека отправленного в ОФД	Игнорируется
fiscalDocNum	Номер фискального документа	Игнорируется
storno	Признак сторнирования (если чек был хотя бы один раз сторнирован)	Чеки со значением true — игнорируются
status	Статус чека	Чек и в статусах CANCELLED (Чек аннулирован), DEFERRED (Чек отложен) — игнорируются
cashType	Тип кассы	Игнорируется
fiscalnum	Регистрационный номер фискального регистратора	Игнорируется
tabNumber	Табельный номер кассира	Игнорируется
returndayinday	Признак для чека возврата "День в день"	Игнорируется
username	Имя кассира	Игнорируется
operationType	Кассовая операция	True - продажа, False - возврат
cashOperation	Кассовые операции для лотерей Столото	Игнорируется
discountCards	Список дисконтных карт, примененных при оплате этого чека	Игнорируется
card	Список карт, использованных при оплате этой покупки	Игнорируется
original-purchase	Оригинальный чек продажи для возвратного чека	Игнорируется
exciseBottles	Бутылки с акцизными марками	Игнорируется
presents	Выданные подарки	Игнорируется
coupons	Выданные купоны	Игнорируется
discount	Список скидок, сработавших в этом чеке	Игнорируется
discountCard	Список дисконтных карт, примененных при оплате этого чека	Игнорируется
bonuses	Список бонусных транзакций, проведенных в этом чеке	Игнорируется
plugin-property	Список "плагинных" (расширенных, не базовых) свойств этого чека. Может отсутствовать.	Игнорируется
positions	Товарные позиции чека
order	Номер позиции	Игнорируется
departNumber	Номер отдела	Игнорируется
goodsCode*	Код товара	Используется для поиска ТМЦ по коду
barCode	ШК товара	Используется для поиска ТМЦ через упаковки
count*	Количество	Количество по строке
cost*	Цена за единицу	Розничная цена по строке
nds	Значение НДС	Игнорируется
ndsClass	Наименование налога	Игнорируется
ndsSum	Сумма НДС	Игнорируется
discountValue	Сумма скидки	Игнорируется
costWithDiscount*	Цена за единицу с учётом скидки	Фактическая цена строки
amount	Стоимость позиции	Игнорируется
softCheckNumber	Номер мягкого чека	Игнорируется
dateCommit	Дата/время добавления позиции	Игнорируется
insertType	Способ добавления позиции	Игнорируется
plugin-property	Плагинные свойства товара	Игнорируется
payment	Оплаты по чеку
order	Порядковый номер оплаты в чеке	Игнорируется
typeClass	Тип оплаты	Используется для поиска вида оплаты по внешнему коду. CashChangePaymentEntity - сдача
amount	Сумма	Сумма строки оплаты
description	Описание	Игнорируется
plugin-property	Плагинные свойства оплаты	Игнорируется

 

Процедура выгрузки справочника товаров из Юпитер в SetRetail

• Запускается пользователем вручную из раздела SetRetail → Выгрузка товарного справочника в SetRetail
• Процедура выгружает справочник ТМЦ в XML-файл в формате SetRetail по схеме "Товар целиком", в заранее обговоренный каталог
• Выгрузка не предполагает работу с алкоголем
• В параметрах выгрузки можно выбрать какие группы/подгруппы нужно выгружать
• Выгружаются только ТМЦ с типом Изделие, Товар, Услуга
• Выгружаются только ТМЦ которые находятся в подгруппе с признаком "Для продажи через кассу"
• Выгружаются только ТМЦ у которых есть хотя бы один штрихкод (упаковка)
• Выгружаются только ТМЦ у которых есть цена в прейскуранте хотя бы для одного торгового зала

• Список магазинов, на которых доступна ТМЦ, определяется по наличию цены в прейскуранте. Если в прейскуранте торгового зала есть ТМЦ, то считается, что ТМЦ используется на этом торговом зале, если нет, то не используется.

• Операция вывода товара из меню не предусмотрена, т.к. товары пробиваются через сканирование штрихкода. Если товар лежит на полке, его можно купить. Если не лежит на полке, то его и не смогут отсканировать.

Таблица параметров выгрузки

Параметр в выгрузке	Описание параметра	Значение в Юпитере
marking-of-the-good*	Артикул товара.	"Код" из карточки ТМЦ
shop-indices	Список номеров магазинов, в которых этот товар будет продаваться, разделенных пробелом.	Определяется прейскурантами. Коды торговых залов, для которых есть цена в прейскуранте.
name*	Наименование товара	"Наименование для счета" из карточки ТМЦ, если не задано, то "Наименование"
goods-feature	Признак товара. Для использования в Республике Беларусь.	Не выгружается
child	Признак детского товара	Не выгружается
excise	Признак акцизного товара (только для алкогольного товара)	Не выгружается
energy	Признак товара – энергетик.	Не выгружается
pyro	Признак товара – пиротехническое изделие	Не выгружается
naturalgas	Признак товара, содержащего сжиженный природный газ.	Не выгружается
gift	Признак товара – подарок	Не выгружается
service-charge	Признак товара – сервисный сбор	Не выгружается
returnable	Признак, что товар разрешен к возврату	Не выгружается
essential	Признак, что данный товар является "социальным" (товаром первой необходимости - essential goods)	Не выгружается
social-pay	Признак, что данный товар что данный товар можно оплатить социальным сертификатом.	Не выгружается
ofd-product-code	Признак, что данный товар должен иметь код для передачи в ОФД. Для использования при работе с товарами СИЗ (Средства индивидуальной защиты)	Не выгружается
product-type*	Тип товара	Всегда ProductPieceEntity – Штучный товар
vat*	НДС	Ставка НДС из карточки ТМЦ
weight	Вес товара в граммах	Вес в КГ из карточки ТМЦ
group*	Товарная группа	"Подгруппа" из карточки ТМЦ
measure-type*	Единица измерения	Аббревиатура "Базовой ЕИ" из карточки ТМЦ
country	Страна	Не выгружается
manufacturer	Производитель	Не выгружается
sale-group	Группа продаж	Не выгружается
delete-from-cash	Признак удаления товара с касс, на сервере.	Не выгружается. Т.к. продажа происходит всегда по штрихкодам, и операции вывода из меня нет
mrc-required	Признак, что для данного товара надо указывать МРЦ	Не выгружается
age-limit	Возрастное ограничение для товара	Не выгружается
rack-number	Номер (идентификатор) стеллажа	Не выгружается
shelf-number	Номер (идентификатор) полки	Не выгружается
location-on-shelf	Место на полке	Не выгружается
facing	Фэйсинг товара	Не выгружается
plugin-property	Плагинное свойство товара, определенное для конкретного типа товара	Не выгружается
erp-code	ERP-код товара. Дополнительный код товара, который может использоваться для идентификации товара в ERP системе.	Не выгружается
fullname	Полное наименование товара. Используется для ввода на ценниках более полного или подробного наименования товара.	"Наименование для меню" из карточки ТМЦ
mark-type	Тип маркированного товара	"Вид обязательной маркировки товара" из подгруппы ТМЦ
certification-type	Тип сертификации товара. Используется для печати на ценниках и весовых этикетках.	Не выгружается
excise-bottles	Алкогольный набор	Не выгружается
non-excise-bottles	Алкогольный набор с безакцизным алкоголем	Не выгружается
alcocodes	Коллекция алкокодов	Не выгружается
gtd	Код государственной таможенной декларации по которой данный товар	Не выгружается
section	Принадлежность товара к секции в магазине	Не выгружается
rfid-classification	Признак наличия RFID-метки у товара	Не выгружается
counterparty	Юридическое лицо - Поставщик/эмитент товара	Не выгружается
ffd-tag-1212	Признак предмета расчета	"Признак предмета расчета" из карточки ТМЦ
ffd-tag-2108	Мера предмета расчета	Не выгружается
brand	Наименование бренда товара	Не выгружается
description	Описание товара для вывода служебной/дополнительной информации о нем, чтобы не допустить ошибок в работе.	Не выгружается
price-entry*	Коллекция цен на товар
price*	Цена на товар за единицу измерения	Цена из прейскуранта
shop-indices	Список номеров магазинов, в которых действует эта цена	Коды торговых залов, которые работают по прейскуранту с данной ценой.
currency	Валюта, по умолчанию RUB (Российские рубли)	Не выгружается
deleted	Признак того, что данную цену надо удалить	Не выгружается. Т.к. продажа происходит всегда по штрихкодам, и операции вывода из меня нет
approve-without-delay	Признак того, что цену нужно утвердить без печати ценников	Не выгружается
price-type	Тип значения (цены или скидки) на товар указанной в поле price	Не выгружается
begin-date	Начало периода действия цены
end-date	Если не указано, цена действует бессрочно.	Не выгружается
department*	Отдел, для которого действует цена	Всегда 1, т.к. отделы не используются.
identifier	Идентификатор цены – акции, который будет выгружаться в чеке при срабатывании данной цены.	Не выгружается
pack	Кратность товара, на которое срабатывает цена	Не выгружается
print	Список кодов ценников, которые будут действовать по умолчанию для этой цены.	Не выгружается
template-format	Код формата печати ценников	Не выгружается
old-price	Старое значение цены	Не выгружается
bar-code	Коллекция штриховых кодов	Коды упаковок ТМЦ. Выгружаются только первые 10 упаковок (ограничение SetRetail)
code*	Значение штрихового кода	Код упаковки
marked	Признак маркированного штрих-кода товара	Признак "Маркированный товар" из ТМЦ или подгруппы
do-not-send-to-scales	Признак: данный штрих-код не выгружать на весы	Не выгружается
deleted	Признак удаления штрихового кода	Не выгружается. Т.к. продажа происходит всегда по штрихкодам, и операции вывода из меня нет
barcode-type	Тип штрих-кода (GTIN)	Не выгружается
deny-sale-juristic-person	Признак запрета продажи товара юридическому ли	Не выгружается
name	Наименование товара в ШК	Не выгружается
price-entry	Цена по штрихкоду	Не выгружается
count	Количество товара по данному штрихкоду (для фасовки)	Всегда 1
default-code	Признак ШК по умолчанию	Всегда false
discount-forbidden	Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки	Не выгружается