Информация
Содержание

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

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 Признак того, что на цену по данному штриховому коду запрещено предоставлять дополнительные скидки Не выгружается

 

Система JUPITER                                 www.jupiter.systems                                 (с) 2024г.

Нет комментариев
Наверх