====== Общие настройки r-keeper ====== ===== Настройка параметров ===== Настройки - Параметры - Использование опций - Свойства визита. Параметры "Исп. сохраняемый комментарий", "Исп. несохраняемый комментарий" - установить значение "Необязательное свойство". {{:external:procart:01_setup:pasted:20230120-122035.png}} {{:external:procart:01_setup:pasted:20230120-122058.png}} ===== Настройка XML интерфейса ===== Настроить XML интерфейс на **кассовом сервере** и пользователя для работы с ним [[https://wiki.carbis.ru/external/zz_дополнительные_материалы/02_xml_interfaсe_rkeeper |как описано тут]]. Для создания заказов необходимо иметь действующую лицензию на XML. Если используется лицензия XML WriteOrder (Life-Time) то она должна быть прописана в свойствах ресторана в редакторе r_keeper. Если используется XML SaaS лицензия, то для настройки ее параметров запустите saas_settings.bat. ===== Настройки справочников ===== Для настройки модуля ProCart и выполнения запросов через API потребуются следующий данные: **Код кассовой станции.** Сервис → Станции и устройства → Выбрать станцию на нужном кассовом сервере → На закладке "Свойства", в группе "Главное" взять значение поля "Код". **Код стола.** Настройки → Планы залов и Столы → Выбрать план зала → Выбрать стол → В свойствах выбранного стола, в группе "Главное" взять значение поля "Код". Для более детальной работы с заказами можно завести дополнительные столы, коды которых передать представителям внешней системы. [[https://wiki.carbis.ru/external/procart/02_procart_api#работа_со_столами|Подробнее тут]]. **Код категории заказа.** Заказ → Категории заказа → Выбрать нужную → В категории заказа, в группе "Главное" взять значение поля "Код". Для более детальной работы с заказами можно завести дополнительные категории заказов, коды которых передать представителям внешней системы. [[https://wiki.carbis.ru/external/procart/02_procart_api#категория_заказа|Подробнее тут]]. ==== Валюта для оплаты бонусами ==== Со стороны внешней системы может приходить оплата (предоплата) заказа, в том числе бонусами. В справочнике "валюты" нужно добавить нефискальную валюту для оплаты бонусами. Тип фискальности для этой валюты - "фискальная скидка". Галку "без сдачи" не ставим, иначе касса не даст внести предоплату этой валютой. {{:external:procart:01_setup:pasted:20230202-172557.png}} ==== Классификация блюд ==== Код классификации блюд необходим для настройки модуля. Вы можете использовать параметры уже существующей классификации, или создать отдельную. Если вы будете использовать уже существующую классификацию, то перейдите в справочник "Меню -> Классификации блюд", из древовидного меню выберете нужную классификацию и в её свойствах будет поле "Код", значение данного поля будет нужно для настройки модуля. {{:external:procart:01_setup:pasted:20220921-045954.png}} Если вы будете использовать новую классификацию, то создайте её, для этого в пустой области древовидного меню нажмите на правую кнопку мыши и в появившемся меню выберете "Новая классификация". {{:external:procart:01_setup:pasted:20220921-080049.png}} Укажите название новой классификации, переведите статус в "Активный". {{:external:procart:01_setup:pasted:20220921-080159.png}} Создайте категории в классификации. {{:external:procart:01_setup:pasted:20220921-080321.png}} Укажите название и переведите статус в "Активный". {{:external:procart:01_setup:pasted:20220921-080358.png}} Распределите блюда меню по категориям для созданной вами классификации. {{:external:procart:01_setup:pasted:20220922-064529.png}} **Важно!** Для всех блюд, на которые ссылаются комбо-компоненты, необходимо указать категорию, обеспечивающую доступность этого элемента. Т. е. любую категорию из классификации для ProCart. ---- ==== Причина внесения ==== Начиная с версии 1.5.7.38 причина внесения денег более не используется. Предоплаты передаются без причины внесения, так работает при значении параметра "Учет предоплат" = "Не учитывать". Убедитесь, что для стола (столов), на которые создаются заказы, настроено исключение параметра "Учет предоплат" = "Не учитывать". ==== Суммовая скидка на заказ с изменяемым значением ==== Для внесения суммовой скидки в заказ при работе модуля нужно создать суммовую скидку "на заказ". Перейдите в справочник "Деньги -> Скидки и наценки", создайте новую скидку, укажите для неё параметры указанные на скриншоте {{:external:procart:01_setup:pasted:20230117-090000.png}} * Тип - сумма * Изменяемое значение - ✔ * Название - можете использовать своё название * Статус - Активный * Не вручную - ✔ Значение из поля "Код" понадобится далее при настройке модуля. ==== Суммовая наценка на заказ с изменяемым значением ==== Для внесения суммовой наценки в заказ при работе модуля нужно создать суммовую наценку "на заказ". Необходимо перейти в справочник "Деньги -> Скидки и наценки", создайте новую наценку, указать для неё параметры указанные на скриншоте {{:external:procart:01_setup:2024-11-21_17-56-56.png}} * Тип - сумма * Изменяемое значение - ✔ * Название - можете использовать своё название * Статус - Активный * Не вручную - ✔ Значение из поля "Код" понадобится далее при настройке модуля. ---- ===== Сохранение оплаты ===== ProCart может передать уже оплаченный заказ. В этом случае для фиксации оплаты в r_keeper будет использоваться механизм предоплат. API ProCart позволяет передавать в заказ предоплату любой валютой (в запросе передаётся код валюты). С целью минимизации рисков для ресторана в случае неправильной настройки предоплат необходимо доверить выполнение этого пункта квалифицированному специалисту по r_keeper. **Важно!** Значение параметра "учет предоплат" обязательно должно быть = "Не учитывать" для всех столов, на которые передаются оплаты из ProCart. **Может потребоваться дилерская учетная запись для настройки фискальности валют.** ===== Печать комментариев ===== В ProCart доступно 2 поля для комментариев - "короткий", обычно используемый для передачи номера заказа и "длинный", в который записывается ФИО, адрес, контакты, пожелания и любая другая информация. В заказе в r_keeper они записываются в поля "сохраняемый комментарий" и "несохраняемый комментарий". Короткий комментарий ProCart = "сохраняемый комментарий". Длинный комментарий ProCart = "несохраняемый комментарий". Короткий комментарий в печатную форму чека/пречека/сервис-чека можно вынести просто как поле [СохраняемыйКомментарий]. Для длинного так делать нельзя. Причина - rk7 не умеет хранить в этом поле более 100 символов, всё что больше - обрежется. Поэтому чтобы на бумаге распечатать всё полностью, в макет (печатную форму) нужно добавить небольшой скрипт. Принцип использования [[https://wiki.carbis.ru/external/procart/02_procart_api#комментарии_к_заказу| описан тут]]. Для тех печатных форм, на которые мы хотим вывести "длинный комментарий", нужно отредактировать макет. Обычно это кассовые макеты "чек", "пречек", "сервис-чек". Редактировать нужно именно тот макет, который находится в используемой схеме печати (или сервис-схеме). Внутри макета необходимо добавить переменную с типом string. Имя переменной: comment_text Эта переменная далее будет доступна в отчёте, в неё мы запросим текст комментария. {{:external:procart:01_setup:pasted:20221227-144210.png}} {{:external:procart:01_setup:pasted:20221227-144253.png}} В свободной части отчёта создаём новый виртуальный бэнд. {{:external:procart:01_setup:pasted:20221227-144410.png}} {{:external:procart:01_setup:pasted:20221227-144428.png}} Внутри него делаем два "мемо". В одном - пишем статичный текст "Комментарий от внешней системы:" Во втором будет вызов переменной [comment_text] и скрипт, который эту переменную заполняет. {{:external:procart:01_setup:pasted:20221227-144538.png}} {{:external:procart:01_setup:pasted:20221227-144640.png}} Текст скрипта: httpGet('http://192.168.1.148:11111/api/v3/internal/print_info?width=40&guid='+[Заказы.GUID], comment_text) В данном примере: 192.168.1.148 - IP-адрес компютера с серверной частью ProCart в рамках локальной сети. Лучше не использовать 127.0.0.1 если на объекте более одной станции r_keeper. 11111 - порт сервера ProCart Пример готового макета для пречека: https://disk.yandex.ru/d/jq05EBupeq8maA ===== Настройка кнопки с заказом (опционально) ===== Чтобы на кассе заказы было удобнее видеть в списке по кнопке "редактирование заказа" - имеет смысл увеличить размер формата "Кнопки с заказами (большие)", сделать чтобы для комментариев (адрес гостя и т. д.) было достаточно места. Настройки - Графический интерфейс - Формы - Форматы - Кнопки с заказами (большие). Делаем копию стандартной формы, называем "ФД Кнопки с заказами (большие) для Procart", редактируем "Модель" {{:external:procart:01_setup:pasted:20230120-170037.png}} Можно загрузить "формат" из файла. Готовый настроенный формат: https://disk.yandex.ru/d/Zu97q3PH8omQxA {{:external:procart:01_setup:pasted:20230120-170131.png}} После этого в используемой схеме форм нужно выбрать этот формат. {{:external:procart:01_setup:pasted:20230120-170312.png}} На кассе интерфейс будет выглядеть так (на кассе внешний вид кнопки изменится в режиме отображения без плана зала, по кнопке "подробнее"): {{:external:procart:01_setup:pasted:20230120-170650.png}} Также опционально можно использовать макет "Кнопки с заказами (обычные)": https://disk.yandex.ru/d/TiW-MxSifCEosA По умолчанию, если не исправлять - на этой кнопке будет только номер заказа. ===== Настройка общего (текстового) модификатора для комментариев к блюду (опционально) ===== **С версии 1.5.0.30** Чтобы через API можно было оставлять текстовые комментарии к блюдам, необходимо создать общий модификатор. Меню - Модификаторы - Создать группу модификаторов - В свойствах группы, в блоке "Основное" проставить галочку "Общий модификатор" - В группе создать модификатор - В свойствах модификатора: - В блоке "Интерфейс" проставить галочку "Ввод имени" - В блоке "Цены" ввести 0 в поле "Основная" {{:external:procart:01_setup:pasted:20230518-084024.png}} {{:external:procart:01_setup:pasted:20230518-084354.png}} **Код данного модификатора понадобится при настройке ProCart.**