Custom integration POSTER POS and CLOCK PMS (hotel)

We need a custom integration between POSTER POS and CLOCK CRM

https://developers.clock-software.com/

https://api-docs.clock-software.com/#authentication

https://joinposter.com/en

ТЗ

I. Начало работы (в админ-панели постера)

1. Клиент подключает интеграцию из маркета Постер

2. Для проводки чеков с оплатой "на номер", нужно создать в постере отдельный метод оплаты (Настройки - Заказы - Методы оплаты)

3. На странице настройки интеграции клиент вводит данные для взаимодействия с АПИ ClockPms и указывает созданный ранее метод оплаты для закрытия чеков "на номер".

4. На странице с настройками "revenue_group" и "revenue_category" нужно выбрать значения из существующих в ClockPms для категорий и товаров (для товара по-умолчанию берется из его категории, но можно изменить).

II. Работа терминала (кассы)

1. Создается и наполняется чек. Кассир нажимает кнопку "Оплатить"

2. Появляется окошко с текстом что есть возможность оплатить "на номер" и предложением ввести номер комнаты клиента.

3. Кассир спрашивает у клиента номер, вводит его в поле и нажимает "Продолжить".

4. Выполняется поиск брони и ответственного клиента (метод АПИ bookings_by_room).

5. Кассиру показывается результат - данные ответственного клиента или сообщение что номер не занят.

6. Кассир спрашивает у клиента на кого оформлен номер и сверяет с результатом поиска.

7. Если все ОК, кассир нажимает кнопку "Продолжить".

8. Осуществляется привязка найденого клиента-брони к чеку. 

   Клиент в постере ищется (или создается) по имени и ID выбранного клиента из ClockPms. 

   Он привязывается к чеку и в чеке сохраняется доп.информация про бронь.

9. Кассиру показывается инструкция-сообщение что "чек нужно закрыть методом <название метода>" (тот метод который был указан в настройках интеграции) и он попадает на экран оплаты.

10. Кассир закрывает чек указанным методом.

* В окне поиска по номеру будет кнопка "Оплата на месте". По ней будет просто переход на экран оплаты без поиска и привязки клиента. В этом случае кассир должен закрыть чек одним из стандартных методов оплаты и не использовать метод "на номер". Эта же кнопка служит для открепления ранее прикрепленного клиента (вдруг передумал).

* Закрыть чек с оплатой на месте можно и при прикрепленном клиенте-брони. 

* Закрыть чек методом "на номер" можно всегда, технически ограничить его использование невозможно. Правильное закрытие чека на совести кассира.

III. Проводка оплаты в ClockPms

По факту закрытия чека в постере будет происходить его разбор и проводка в ClockPms.

Индикатором того, что чек нужно провести служит метод оплаты, который использовали при закрытии. 

Если чек закрыли методом "на номер" и к нему привязан клиент-бронь, чек разбирается и каждая позиция из него отправляется в ClockPms отдельным "charge".We need a custom integration between POSTER POS and CLOCK CRM

https://developers.clock-software.com/

https://api-docs.clock-software.com/#authentication

https://joinposter.com/en