Уведомление об изменениях в заказах через httpordernotify

Введение

Интерфейс предназначен для транслирования информации по протоколу HTTP о событиях с кассовой станции на адрес, указанный в параметре драйвера.
Основная задача - передача данных об изменениях в заказах и других событиях кассовой станции.

Есть два варианта настройки механизма отправки уведомлений:

Механизм подписок для версии 7.6.5.440 и старше
Через интерфейс HTTP Order Notify для версий ниже 7.06.05.440

Схема работы

После старта драйвер находится в ожидании событий от кассы, либо завершения работы кассового сервера.

События передаваемые драйвером идут в порядке поступления. На текущий момент размер очереди равен 256. При достижении максимального количества прием новых событий приостанавливается до освобождения места для события. Это необходимо для предотвращения переполнения памяти и аварийной остановки кассового сервера, если отправка сообщений невозможна.

Для каждого адреса подписки ведется своя очередь рассылки, так же как и свой файл логирования. При завершении работы кассового сервера оставшиеся в очереди события отправляться не будут.

Данные пытаются отправляться сразу при поступлении в драйвер. Времени ожидания события "приход данных" нет.

Драйвер загружается при старте кассового сервера. Независимо от наличия кассовой станции в очередь ставится сообщение о запуске кассового сервера с Situation="1". Событие аналогично старту кассы, но с ограниченным количество узлов.

Пример сообщения после загрузки и инициализации кассового сервера:

<?xml version="1.0" encoding="utf-8"?>
<a RestCode="199990093" DateTime="2020-01-14T15:38:23" Situation="1" seqnumber="1" guid="{9ECCB1B5-97EE-4B88-9840-8568F05586D0}" name="Started" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">
<Server id="15002"/>
<Item/>
</a>

XML

В данном событии указан только идентификатор кассового сервера. Если адрес задан в свойствах кассового сервера, то он уведомляет драйвер о готовности к работе. Далее происходит это событие.

После старта кассовой станции в очередь ставится похожее сообщение, но с расширенным набором узлов:

<?xml version="1.0" encoding="utf-8"?>
<a RestCode="199990093" DateTime="2019-12-18T17:17:58" Situation="1" seqnumber="1" guid="{9ECCB1B5-97EE-4B88-9840-8568F05586D0}" name="Started" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">
<Station id="15003" code="1" name="MM_CASH" NetName="MM_CASH_169058"/>
<Server id="15002" code="15002" name="MM_MID" NetName="MM_MID"/>
<Item/>
</a>

XML

В нем указана расширенная информация о кассовом сервере и данные о кассовой станции. Данный механизм позволяет разделить события загрузки кассового сервера и кассовой станции для их раздельной обработки.

Указанный в примере GUID не является константой.

Поддерживаемые команды, передающиеся драйвером в атрибуте Situation:

Situation	Событие	Описание
1	Started Запуск станции обслуживания	Событие отправляется в момент запуска станции обслуживания (doscash.exe). Станция указывается в тэге Station передаваемого xml Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="133820009"` `DateTime="2023-11-10T09:48:35"` `Situation="1"` `seqnumber="1"` `guid="{9ECCB1B5-97EE-4B88-9840-8568F05586D0}"` `name="Started"` `ShiftNum="347"` `ShiftDate="2023-09-25T00:00:00">` `<Station` `id="15003"` `code="1"` `name="ST01"` `guid="{85755F28-063F-4FEB-86C2-10500FE25C3F}"` `NetName="ST01"/>` `<Server` `id="15001"` `code="15001"` `name="MIDSERVER"` `guid="{5C64169B-64A6-4F48-B621-2453EB4A8007}"` `NetName="MIDSERVER"/>` `<Item/>` `</a>`
2	Переход на станции обслуживания в главное меню	Событие отправляется при переходе в главное меню на станции обслуживания. Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="199990366"` `DateTime="2023-11-09T15:51:22"` `Situation="2"` `seqnumber="58"` `guid="{84560B45-DAE3-4AF6-A625-2A12D086D770}"` `name="Main Menu"` `ShiftNum="36"` `ShiftDate="2023-10-24T00:00:00">` `<Station` `id="15002"` `code="1"` `name="ST01"` `guid="{CAFDC4EC-B585-4287-8BD4-AA23ACE9BAAF}"` `NetName="ST01"/>` `<Server` `id="15001"` `code="15001"` `name="MIDSERVER"` `guid="{FF0E6A0A-BFAC-43A7-8416-10E2FB181A22}"` `NetName="MIDSERVER"/>` `<Waiter` `id="1000005"` `code="4"` `name="stend"` `guid="{523122F5-1188-42E5-9F1C-5558CD59E2DA}">` `<Role` `id="100004"` `code="4"` `name="Кассиры"` `guid="{7D9DBADD-BA02-4319-B104-75933735D21F}"/>` `</Waiter>` `<Item>` `<RefItem` `id="19"` `code="19"` `name="Главное меню"` `guid="{CD3E7840-95B6-4912-8C07-E520D6CA0190}"/>` `</Item>` `</a>`
3	Изменение заказа	Событие отправляется в момент внесения изменения в заказ на станции обслуживания, ДО фактического сохранения заказа. В теле запроса передается xml с составом заказа и ChangeLog. Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="133820009"` `DateTime="2023-11-10T18:26:10"` `Situation="3"` `seqnumber="15"` `guid="{8A4AB428-B1AB-4301-A400-A3B889A1F7CA}"` `name="Order Changed"` `ShiftNum="322"` `ShiftDate="2023-11-02T00:00:00">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"` `NetName="ST01"/>` `<Server` `id="15014"` `code="15014"` `name="MIDSERVER"` `guid="{D212B690-760C-41C1-A0A9-1114C9BABC0F}"` `NetName="MIDSERV"/>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<Order` `visit="655369548"` `orderIdent="256"` `guid="{B3884E04-D074-420E-9281-5E6FC74C12FC}"` `url="http://code.ucs.ru/qr?id=D212B690760C41C1A0A91114C9BABC0FB3884E04D074420E92815E6FC74C12FC5AF3417B"` `orderName="т7"` `locked="1"` `version="0"` `crc32="431150315"` `orderSum="4410"` `unpaidSum="4410"` `discountSum="0"` `totalPieces="1000"` `seqNumber="6"` `paid="0"` `finished="0"` `persistentComment=""` `nonPersistentComment=""` `openTime="2023-11-10T18:25:53">` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<OrderCategory` `id="10033"` `code="1"` `name="Основная"` `guid="{1E113335-9F76-4CDF-A860-96ADB5D33E77}"/>` `<OrderType` `id="1"` `code="1"` `name="Общий"` `guid="{839218BA-96AE-4480-9DC1-50C802E13840}"/>` `<Table` `id="100053"` `code="107"` `name="т7"` `guid="{733CD936-CA49-4C07-898A-FDDBA5D1D848}"/>` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<ExternalProps>` `<Prop` `name="{71F830D3-2DE3-4F74-B8F6-0BF199291C86}"` `value="{BACC15A2-3973-4CD9-A267-B14E1454DF78}"/>` `<Prop` `name="{7DC7AF79-1D00-4573-BE8A-A02C6FA3B430}"` `value="E10"/>` `</ExternalProps>` `</Order>` `<Session` `uni="2"` `line_guid="{7BC291B3-F9B0-4A91-996D-E2E1C6EDAEBF}"` `state="1"` `sessionID="2"` `isDraft="0"` `remindTime="2023-11-10T18:21:00"` `startService="2023-11-10T18:26:08"` `printed="0"` `cookMins="5">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<Author` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Author>` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<Course` `id="100256"` `code="2"` `name="Без времен"` `guid="{22BFE438-E362-445A-9EB6-4B9EEAAC2E33}"/>` `<Dish` `id="100021"` `code="33"` `name="Чай зеленый"` `guid="{DB4A4719-6147-4383-B22E-C6CFB7134285}"` `uni="4"` `line_guid="{9438E19B-F691-411E-A89A-0A8AA076432F}"` `state="1"` `price="4200"` `amount="4410"` `new="1"` `sortOrder="0"` `quantity="1000"` `srcQuantity="1000">` `<Modi` `id="100100"` `code="100"` `name="С сахаром"` `guid="{08B95829-2C17-4BB4-804A-86205FFFDEFA}"` `uni="12"` `line_guid="{36F92D15-D55B-4C38-BA9C-61F51042BF37}"` `state="1"` `count="1"/>` `</Dish>` `<PriceScale` `id="1002492"` `code="2"` `name="Д"` `guid="{964DB26D-9013-409D-AD36-29A6DC2658BF}"/>` `<TradeGroup` `id="100266"` `code="2"` `name="Вечернее меню"` `guid="{5606E4A4-11EB-47C9-AAC1-B479066831EA}"/>` `</Session>` `<Item/>` `<ChangeLog>` `<Dish` `id="100021"` `code="33"` `name="Чай зеленый"` `guid="{DB4A4719-6147-4383-B22E-C6CFB7134285}"` `uni="4"` `line_guid="{9438E19B-F691-411E-A89A-0A8AA076432F}"` `state="1"` `price="4200"` `amount="0"` `new="1"` `sortOrder="0"` `quantity="1000"` `srcQuantity="1000"` `number="1"` `oldvalue="0"` `newvalue="1000"` `OldStrValue="0.000"` `NewStrValue="1.000">` `<Oper` `id="475"` `name="Блюдо"` `guid="{61FC8058-B5E0-49D8-8E11-46D2F7EADB7F}"/>` `</Dish>` `<Modi` `id="100100"` `code="100"` `name="С сахаром"` `guid="{08B95829-2C17-4BB4-804A-86205FFFDEFA}"` `uni="12"` `line_guid="{36F92D15-D55B-4C38-BA9C-61F51042BF37}"` `state="1"` `count="1"` `number="2"` `oldvalue="0"` `newvalue="1"` `OldStrValue="0"` `NewStrValue="1"` `new="1">` `<Oper` `id="476"` `name="Модификатор"` `guid="{A2C569C2-E342-4F3A-811A-20E31D9F5C74}"/>` `</Modi>` `</ChangeLog>` `</a>`
4	Расчет заказа	Событие отправляется в момент перехода в режим расчета на кассе, в теле запроса передается xml с составом заказа и ChangeLog.
5	Закрытие чека	Событие отправляется перед печатью чека, в теле запроса передается xml с составом заказа и ChangeLog. Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="133820009"` `DateTime="2023-11-10T18:28:18"` `Situation="5"` `seqnumber="26"` `guid="{F7A07E9D-D2EA-4865-9DFF-43C6EAF2A8C7}"` `name="Print Receipt"` `ShiftNum="322"` `ShiftDate="2023-11-02T00:00:00">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"` `NetName="ST01"/>` `<Server` `id="15014"` `code="15014"` `name="MIDSERV"` `guid="{D212B690-760C-41C1-A0A9-1114C9BABC0F}"` `NetName="MIDSERV"/>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<Order` `visit="655369548"` `orderIdent="256"` `guid="{B3884E04-D074-420E-9281-5E6FC74C12FC}"` `url="http://code.ucs.ru/qr?id=D212B690760C41C1A0A91114C9BABC0FB3884E04D074420E92815E6FC74C12FC5AF3417B"` `orderName="9548/1"` `version="3"` `crc32="431150315"` `orderSum="4410"` `unpaidSum="0"` `discountSum="0"` `totalPieces="1000"` `seqNumber="6"` `paid="1"` `finished="1"` `persistentComment=""` `nonPersistentComment=""` `openTime="2023-11-10T18:25:53"` `kdsstate="sent">` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<OrderCategory` `id="10033"` `code="1"` `name="Основная"` `guid="{1E113335-9F76-4CDF-A860-96ADB5D33E77}"/>` `<OrderType` `id="1"` `code="1"` `name="Общий"` `guid="{839218BA-96AE-4480-9DC1-50C802E13840}"/>` `<Table` `id="100053"` `code="107"` `name="т7"` `guid="{733CD936-CA49-4C07-898A-FDDBA5D1D848}"/>` `<GuestType` `id="1"` `code="1"` `name="Студенты"` `guid="{0FD823B9-1645-42A7-9028-C69A98CE190A}"/>` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<Guests` `count="2">` `<Guest` `guestLabel="1"/>` `<Guest` `guestLabel="2"/>` `</Guests>` `<ExternalProps>` `<Prop` `name="{71F830D3-2DE3-4F74-B8F6-0BF199291C86}"` `value="{BACC15A2-3973-4CD9-A267-B14E1454DF78}"/>` `<Prop` `name="{7DC7AF79-1D00-4573-BE8A-A02C6FA3B430}"` `value="E10"/>` `</ExternalProps>` `</Order>` `<Session` `uni="2"` `line_guid="{7BC291B3-F9B0-4A91-996D-E2E1C6EDAEBF}"` `state="6"` `sessionID="2"` `isDraft="0"` `remindTime="2023-11-10T18:26:32"` `startService="2023-11-10T18:26:08"` `readyTime="2023-11-10T18:26:00"` `printed="1"` `cookMins="5">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<Author` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Author>` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<Course` `id="100256"` `code="2"` `name="Без времен"` `guid="{22BFE438-E362-445A-9EB6-4B9EEAAC2E33}"/>` `<Dish` `id="100021"` `code="33"` `name="Чай зеленый"` `guid="{DB4A4719-6147-4383-B22E-C6CFB7134285}"` `uni="4"` `line_guid="{9438E19B-F691-411E-A89A-0A8AA076432F}"` `state="6"` `price="4200"` `amount="4410"` `kdsstate="sent"` `paidAmount="4410"` `sortOrder="0"` `quantity="1000"` `srcQuantity="1000">` `<Modi` `id="100100"` `code="100"` `name="С сахаром"` `guid="{08B95829-2C17-4BB4-804A-86205FFFDEFA}"` `uni="12"` `line_guid="{36F92D15-D55B-4C38-BA9C-61F51042BF37}"` `state="6"` `count="1"/>` `</Dish>` `<Pay` `id="1"` `code="1"` `name="Рубли"` `guid="{16D72549-14D8-4F31-9E2A-0A833D4F5EED}"` `uni="15"` `line_guid="{B14CDB9A-15BC-40CD-996F-3EC5C786C274}"` `state="6"` `amount="4410"` `basicSum="4410"/>` `<PriceScale` `id="1002492"` `code="2"` `name="Д"` `guid="{964DB26D-9013-409D-AD36-29A6DC2658BF}"/>` `<TradeGroup` `id="100266"` `code="2"` `name="Вечернее меню"` `guid="{5606E4A4-11EB-47C9-AAC1-B479066831EA}"/>` `</Session>` `<Session` `uni="101"` `line_guid="{1E23DFB2-A58E-44BC-BBB3-13319912E59A}"` `state="1"` `sessionID="101"` `isDraft="0"` `remindTime="2023-11-10T18:28:00"` `startService="2023-11-10T18:28:18"` `printed="0"` `cookMins="0">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<Author` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Author>` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<Course` `id="100256"` `code="2"` `name="Без времен"` `guid="{22BFE438-E362-445A-9EB6-4B9EEAAC2E33}"/>` `<PriceScale` `id="1002492"` `code="2"` `name="Д"` `guid="{964DB26D-9013-409D-AD36-29A6DC2658BF}"/>` `<TradeGroup` `id="100266"` `code="2"` `name="Вечернее меню"` `guid="{5606E4A4-11EB-47C9-AAC1-B479066831EA}"/>` `</Session>` `<Session` `uni="1"` `line_guid="{E0A5B289-1395-436A-A8F3-D2E40BE92CAC}"` `state="6"` `sessionID="1"` `isDraft="0"` `remindTime="2023-11-10T18:26:23"` `startService="2023-11-10T18:25:53"` `printed="0"` `cookMins="0">` `<Station` `id="15015"` `code="5"` `name="ST01"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"/>` `<Author` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Author>` `<Creator` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Creator>` `<PrintCheck` `uni="3"` `line_guid="{77F95983-513A-44F9-8007-B9FBDCFCC383}"` `state="6"` `amount="4410"` `CheckNum="107282"` `GlobalFiscalID="12345:17:8:2023-11-10T18:26:32"` `deleted="0"` `printTime="2023-11-10T18:26:23"` `startTime="2023-11-10T18:26:17">` `<Author` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Author>` `<Pay` `id="1"` `code="1"` `name="Рубли"` `guid="{16D72549-14D8-4F31-9E2A-0A833D4F5EED}"` `uni="15"` `line_guid="{B14CDB9A-15BC-40CD-996F-3EC5C786C274}"` `state="6"` `amount="4410"` `basicSum="4410"/>` `</PrintCheck>` `<PriceScale` `id="1002492"` `code="2"` `name="Д"` `guid="{964DB26D-9013-409D-AD36-29A6DC2658BF}"/>` `<TradeGroup` `id="100266"` `code="2"` `name="Вечернее меню"` `guid="{5606E4A4-11EB-47C9-AAC1-B479066831EA}"/>` `</Session>` `<Item` `ClassName="tPrintCheckItem"` `uni="3"/>` `<ChangeLog>` `<Dish` `id="100021"` `code="33"` `name="Чай зеленый"` `guid="{DB4A4719-6147-4383-B22E-C6CFB7134285}"` `uni="4"` `line_guid="{9438E19B-F691-411E-A89A-0A8AA076432F}"` `state="1"` `price="4200"` `amount="0"` `new="1"` `sortOrder="0"` `quantity="1000"` `srcQuantity="1000"` `number="1"` `oldvalue="0"` `newvalue="1000"` `OldStrValue="0.000"` `NewStrValue="1.000">` `<Oper` `id="475"` `name="Блюдо"` `guid="{61FC8058-B5E0-49D8-8E11-46D2F7EADB7F}"/>` `</Dish>` `<Modi` `id="100100"` `code="100"` `name="С сахаром"` `guid="{08B95829-2C17-4BB4-804A-86205FFFDEFA}"` `uni="12"` `line_guid="{36F92D15-D55B-4C38-BA9C-61F51042BF37}"` `state="1"` `count="1"` `number="2"` `oldvalue="0"` `newvalue="1"` `OldStrValue="0"` `NewStrValue="1"` `new="1">` `<Oper` `id="476"` `name="Модификатор"` `guid="{A2C569C2-E342-4F3A-811A-20E31D9F5C74}"/>` `</Modi>` `<PrintCheck` `uni="3"` `line_guid="{77F95983-513A-44F9-8007-B9FBDCFCC383}"` `state="1"` `amount="4410"` `unpaidSum="4410"` `CheckNum="0"` `deleted="0"` `startTime="2023-11-10T18:26:17"` `number="3">` `<Oper` `id="420"` `name="Расcчитать чек"` `guid="{0695DA2C-170C-419B-AFDE-43C297C8988C}"/>` `</PrintCheck>` `<Pay` `id="1"` `code="1"` `name="Рубли"` `guid="{16D72549-14D8-4F31-9E2A-0A833D4F5EED}"` `uni="15"` `line_guid="{B14CDB9A-15BC-40CD-996F-3EC5C786C274}"` `state="1"` `amount="4410"` `basicSum="4410"` `number="4"` `new="1">` `<Oper` `id="480"` `name="Оплаты"` `guid="{4AA77EE2-6D3C-4780-8EBD-5C7B9F4BC4CE}"/>` `</Pay>` `<PrintCheck` `uni="3"` `line_guid="{77F95983-513A-44F9-8007-B9FBDCFCC383}"` `state="1"` `amount="4410"` `CheckNum="0"` `deleted="0"` `startTime="2023-11-10T18:26:17"` `number="5"` `changed="1">` `<Oper` `id="459"` `name="Закрыть чек"` `guid="{BFB33FC0-A377-4B22-A244-0371E4E5843F}"/>` `</PrintCheck>` `</ChangeLog>` `</a>`
9	Закрытие заказа	Событие отправляется при выходе из заказа. В теле запроса передается xml с составом заказа.
10	Блокировка кассовой станции (logoff)	Событие отправляется в момент отмены регистрации на кассе. Работник передается в тэге Waiter. Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="199990366"` `DateTime="2023-11-09T15:51:43"` `Situation="10"` `seqnumber="61"` `guid="{F1BC366C-A009-4FFB-9D82-5493C6EF80FC}"` `name="Unregistered"` `ShiftNum="36"` `ShiftDate="2023-10-24T00:00:00">` `<Station` `id="15015"` `code="5"` `name="MIDSERVER"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"` `NetName="ST01"/>` `<Server` `id="15014"` `code="15014"` `name="ST01"` `guid="{D212B690-760C-41C1-A0A9-1114C9BABC0F}"` `NetName="ST01"/>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<Item/>` `</a>`
11	Создание нового заказа	Событие отправляется в момент создания заказа на кассе. В теле запроса передается xml с составом заказа.
12	Открытие существующего заказа	Событие отправляется в момент, когда на кассе существующий заказ открывается на редактирование. В теле запроса передается xml с составом заказа.
13	Сохранение заказа	Событие отправляется в момент сохранения заказа. В теле запроса передается xml с составом заказа.
14	Удаление чека	Событие отправляется перед удалением чека. В теле запроса передается xml с составом заказа.
18	Закрытие кассовой станции	Событие отправляется в момент завершения приложения.
21	Логин на кассовую станцию	Событие отправляется в момент логина на кассу. Работник указывается в тэге Waiter Пример xml `<?xml` `version="1.0"` `encoding="utf-8"?>` `<a` `RestCode="133820009"` `DateTime="2023-11-10T18:25:49"` `Situation="21"` `seqnumber="3"` `guid="{81A89081-D394-4070-BD37-A8E54CCA7B56}"` `name="Login"` `ShiftNum="322"` `ShiftDate="2023-11-02T00:00:00">` `<Station` `id="15015"` `code="5"` `name="MIDSERVER"` `guid="{BD750BEA-A000-46C6-AB16-75505D28C747}"` `NetName="ST01"/>` `<Server` `id="15014"` `code="15014"` `name="ST01"` `guid="{D212B690-760C-41C1-A0A9-1114C9BABC0F}"` `NetName="ST01"/>` `<Waiter` `id="1"` `code="1"` `name="Администратор"` `guid="{D388DF80-FAFA-44EA-9D2C-348879E82F27}">` `<Role` `id="100007"` `code="21"` `name="Администраторы"` `guid="{BC3C91C4-1899-464E-ABF0-ECDE9FE0066C}"/>` `</Waiter>` `<Item/>` `</a>`
24	Переход в состояние печати чека	Событие отправляется перед началом печати чека. В теле запроса передается xml с составом заказа.

Лицензирование интерфейса HTTP Order Notify

Если требуется более одного подключения, необходимо лицензировать интерфейс HttpOrderNotify.
Активировать лицензию следует начиная с версии 7.6.5.459. Лицензия в системе лицензирования называется R-Keeper модуль Интерфейс уведомлений о заказах 12 мес ПО.
Подробный процесс получения лицензии описан в статье Генерация лицензий без кода запроса

Интерфейс HTTP Order Notify

HTTP Order Notify работает на стороне кассового сервера к которому подключена кассовая станция. Драйвер добавляется на кассовый сервер.
Для корректной загрузки драйвера необходимо привязать к нему интерфейс для кассового сервера. Об этом ниже.

Для версий r_keeper младше 7.6.5

Добавьте драйвер HTTP Order Notify на кассовый сервер:

Параметры:

Название

Описание и возможные значения

Log File

Путь к файлу, который будет использоваться в качестве лога действий драйвера. Может отсутствовать, но в этом случае будет затруднено выявление проблем при работе

LogLevel

Уровень логирования, может принимать одно из трех значений:

0 - errors only — В этом режиме в лог попадают только самые важные сообщения (например информация о загрузке интерфейса), либо сообщения о произошедших ошибках: превышение количества событий в очереди, сбой отправки данных на HTTP сервер и т.п.
1 - input xmls and errors — В этом режиме в дополнение к режиму errors only добавляются некоторые важные сообщения, например старт отправки XML на адрес HTTP-сервера.
2 - max log — Наиболее полный режим логирования, содержит максимально подробную информацию о работе драйвера, включая входящие и исходящие XML, текущее состояние очереди отправки и др.

DestURLs

HTTP-адрес, на который будет производится отправка данных. Задается в общепринятом формате адресов URL.
Может содержать только один адрес. При необходимости отправки данных на несколько HTTP-серверов для каждого из них должен быть добавлен свой драйвер HTTP Order Notify

Для загрузки драйвера кассовым сервером привяжите его к интерфейсу:

В менеджерской станции перейдите на вкладку сервис
Нажмите на вкладку Интерфейсы
В справочнике добавьте новый интерфейс и заполните параметры:

Название	Описание и значение
[Название кассового сервера]	выберите драйвер, добавленный на кассовый сервер
Общее имя DLL	укажите имя файла драйвера, всегда httpnotf.dll

4. Перезагрузите кассовый сервер

Для версии r_keeper 7.6.5

Параметры работы драйвера настраиваются в свойствах кассового сервера в разделе HTTP Order Notify

Параметры:

Название	Описание и возможные значения
Имя файла лога	Путь к файлу, который будет использоваться в качестве лога действий драйвера. Может отсутствовать, но в этом случае будет затруднено выявление проблем при работе. К имени файла лога добавляется порядковый номер адреса в списке адресов, начиная с нуля. Т.е. если имя файла лога httpnotf.stk, то для первого адреса подписки имя файла будет httpnotf0.stk, для второго - httpnotf1.stk и т.д.
Уровень лога	Уровень логирования, может принимать одно из трех значений: 0 - Только ошибки — В этом режиме в лог попадают только самые важные сообщения (например информация о загрузке интерфейса), либо сообщения о произошедших ошибках: превышение количества событий в очереди, сбой отправки данных на HTTP сервер и т.п. 1 - XML и ошибки — В этом режиме в дополнение к режиму "Только ошибки" добавляются некоторые важные сообщения, например старт отправки XML на адрес HTTP-сервера 2 - Полная информация — Наиболее полный режим логирования, содержит максимально подробную информацию о работе драйвера, включая входящие и исходящие XML, текущее состояние очереди отправки и др.
DestURLs	HTTP-адреса, на которые будет производится отправка данных. Задаются в общепринятом формате адресов URL. Может содержать несколько адресов, разделенных точкой с запятой. На указание нескольких адресов действуют ограничения по лицензированию.

Значение параметра DestURLs используется только при старте кассового сервера. Изменив этот параметр, перезапустите кассовый сервер для изменения списка адресов. Чтобы список адресов изменился во время работы сервера, используйте механизм подписок.

Подробности настройки Http Order Notify

Для r_keeper 7.6.5 и старше

Начиная с версии 7.6.5.371 настройки Http Order Notify переместились из Устройств в свойства кассового сервера. Порядок действий для этих версий такой:

В параметре драйвера DestURLs пропишите строку подключения в виде:
https://имя_пользователя:пароль_пользователя@адрес_сервера_KDS_PRO:порт_сервера_KDS_PRO/orderTaker
Сохраните изменения
Перезапустите кассовый сервер

Если требуется указать несколько строчек подключения, их можно указать через точку запятой ";".
Например: http://127.0.0.1:2121/api/httpNotify/postOrders;https://127.0.0.1:1234/orderTaker

Если используется несколько строчек подключения, необходимо пролицензировать свойство кассового сервера HTTP Order Notify. Подробнее читайте в статье Лицензирование.

Если строка DestURLs слишком длинная и по какой-то причине обрезается в свойстве кассового сервера, то можно использовать механизм подписок.

Для подписки на отправку, чтобы кассовый сервер начал отправлять уведомления об изменениях заказа, нужно вызвать POST-запрос (любым удобным для вас способом, например с помощью Postman) к кассовому серверу:

https://127.0.0.1:8001/rk7api/v1/subscribe.xml?service=httpnotf&url=https://HTTP_KDS2:1@172.18.2.2:1234/orderTaker

где

Параметр	Назначение
service	Наименование сервиса, должно быть httpnotf
url	url, на который нужно выполнять отправку уведомлений

Указанный в параметре url адрес будет добавлен к списку существующих адресов рассылки.

Пример строки: https://127.0.0.1:8010/rk7api/v1/subscribe.xml?service=httpnotf&url=http://192.168.0.222:2121/api/httpNotify/postOrders

Для отказа от подписки этого нужно вызвать DELETE-запрос

https://127.0.0.1:8001/rk7api/v1/subscribe.xml?service=httpnotf&url=https://HTTP_KDS2:1@172.18.2.2:1234/orderTaker

Переданный в параметре url адрес будет исключен из списка рассылок. Если в очереди оставались сообщения, то отправлены они не будут.

Для r_keeper младше 7.6.5

Если же у вас версия r_keeper меньше 7.6.5, то интерфейс HTTP Order Notify необходимо на кассовый сервер добавить самостоятельно. Инструкция ниже

Для работы KDS PRO требуется драйвер не ниже 18 версии. Поэтому, если ваша версия ниже — перед добавлением интерфейса на кассовый сервер, скачайте драйвер с FTP: ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/httpnotf.udb
Скопируйте файл httpnotf.udb с заменой в папку сервера справочников
Перезапустите кассовый сервер
Добавьте на кассовый сервер драйвер HTTP Order Notify:
Настройте драйвер для всех кассовых серверов по необходимости.
В параметре драйвера DestURLs пропишите строку подключения в виде:
https://имя_пользователя:пароль_пользователя@адрес_сервера_KDS_PRO:порт_сервера_KDS_PRO/orderTaker
Имя пользователя и пароль указывать не обязательно. Вписывайте их только, если они есть в личном кабинете. Эти данные есть в личном кабинете, их описание ниже. Порт сервера находится в файле настроек kds_pro.config.
Перейдите в Сервис > Интерфейсы и создайте новый интерфейс
В разделе Файлы библиотек (DLL) выберите нужный ресторан и укажите драйвер кассовому серверу HTTP Order Notify
Активируйте интерфейс и сохраните.

В версиях старше r_keeper 7.6.5 драйвер HTTP Order Notify работает только через механизм подписок, использование интерфейса не поддерживается.

Механизм подписок

Для отправки кассовым сервером уведомлений об изменениях отправьте POST-запрос к кассовому серверу:

https://127.0.0.1:8001/rk7api/v1/subscribe.xml?service=httpnotf&url=https://HTTP_KDS2:1@172.18.2.2:1234/orderTaker

XML

где:

Параметр	Назначение
service	Наименование сервиса, должно быть httpnotf
url	URL, на который необходимо выполнять отправку уведомлений

Указанный в параметре URL адрес будет добавлен к списку существующих адресов рассылки. На него будет сразу отправлено событие с name=Started.

Если количество адресов превысит доступное, то r_keeper выдаст ошибку "HttpOrderNotify: address URL is disabled, license check failed"

Отказ от подписки

Для отказа от подписки отправьте DELETE-запрос

https://127.0.0.1:8001/rk7api/v1/subscribe.xml?service=httpnotf&url=https://HTTP_KDS2:1@172.18.2.2:1234/orderTaker

XML

Переданный в параметре url адрес будет исключен из списка рассылок. Если в очереди оставались сообщения, то отправлены они не будут.

Примеры XML

Авторизация на кассовой станции

<?xml version="1.0" encoding="utf-8"?>
<a RestCode="199990093" DateTime="2019-12-18T17:18:00" Situation="21" seqnumber="3" guid="{81A89081-D394-4070-BD37-A8E54CCA7B56}" name="Login" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">
<Station id="15003" code="1" name="MM_CASH" NetName="MM_CASH_169058"/>
<Server id="15002" code="15002" name="MM_MID" NetName="MM_MID"/>
<Waiter id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Waiter>
<Item/>
</a>

XML

Создание нового заказа

<?xml version="1.0" encoding="utf-8"?>
<a RestCode="199990093" DateTime="2019-12-18T17:18:33" Situation="11" seqnumber="13" guid="{833F0492-E8ED-4F34-81BC-8A9F4D73A995}" name="New Order" ShiftNum="1" ShiftDate="2019-11-18T00:00:00">
<Station id="15003" code="1" name="MM_CASH" NetName="MM_CASH_169058"/>
<Server id="15002" code="15002" name="MM_MID" NetName="MM_MID"/>
<Waiter id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Waiter>
<Order visit="477823977" orderIdent="256" guid="{763C7F09-875A-438A-B6CB-25F7D3F74741}" url="http://code.ucs.ru/qr?id=209A9A2B872A4728BEC8F0B09C667E6A763C7F09875A438AB6CB25F7D3F74741B6995A91" orderName="8888888888" locked="1" version="0" crc32="0" orderSum="0" unpaidSum="0" discountSum="0" totalPieces="0" seqNumber="1" paid="1" finished="0" persistentComment="" nonPersistentComment="" openTime="2019-12-18T17:18:32">
<Creator id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Creator>
<Waiter id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Waiter>
<OrderCategory id="10033" code="1" name="Основная"/>
<OrderType id="10069" code="9001" name="не выбрано"/>
<Table id="1000259" code="93" name="8888888888"/>
<Station id="15003" code="1" name="MM_CASH"/>
<Guests count="1">
<Guest guestLabel="1"/>
</Guests>
</Order>
<Session uni="2" line_guid="{39271E37-867D-41FF-99B8-59CB182323E9}" state="1" sessionID="2" isDraft="0" remindTime="2019-12-18T17:18:00" startService="2019-12-18T17:18:33" printed="0" cookMins="0">
<Station id="15003" code="1" name="MM_CASH"/>
<Author id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Author>
<Creator id="1" code="7" name="Администратор">
<Role id="100007" code="7" name="Администраторы"/>
</Creator>
<Course id="1" code="1" name="Готовить позже"/>
<PriceScale id="3" code="1" name="Основная"/>
<TradeGroup id="7" code="1" name="По умолчанию"/>
</Session>
<Item ClassName="TOrder"/>
</a>

XML

Решение проблем

При работе драйвер добавляет информацию о своей работе в логи для упрощения локализации возникших проблем при работе.
Регулярно возникающая проблема - данные не приходят на принимающий HTTP-сервер. Здесь следует проверить корректность указания адреса в параметре DestURLs драйвера и работоспособность HTTP-сервера. Если невозможно отправить данные, в логе будут сообщения с подстрокой "HTTP: Post error", например:

18.12.2019 16:25:32:343 HTTP: Post error: Socket Error # 10061

XML

Часто встречающиеся коды ошибок:

Код HTTP	Описание
10061	Connection refused - невозможно соединиться с сервером
10054	Connection reset by peer - соединение сброшено сервером

В этом случае необходимо проверить настройки HTTP-сервера

В сообщениях вида:

SEND_THREAD: Signal [Send] ENTER, items in queue: 19

XML

содержится информация о текущем количестве объектов в очереди. При достижении максимального значения в логе будет сообщение:

XML: Can't add command. Max queue size: 256

XML