Интеграция iiko - курс молодого бойца

COVID и изоляция дали большой толчок для развития онлайн-бизнеса, в том числе – доставки еды, а где доставка – там и сайты, приложения и системы учета. Об одной из самых популярных, а именно iiko, мы и поговорим.

Не буду вдаваться подробности, если вы читаете эту статью, то уже представляете, что такое iiko и зачем она вам, упомяну лишь, что наибольшую известность данное ПО получило за удобство работы для общепита и доставки в нем.

Так что же вам нужно знать, чтобы «подружить» ваш сайт или мобильной приложение (или tg-бота, к примеру) и данную pos-систему? Начнем с небольшой теории. В реальности iiko – это целые комплекс программных продуктов, инфраструктура решений, но нас интересуем только 2 аспекта – это iiko cloud, который позволяет работать с api и ПО на терминалах, которое отвечает за непосредственный вывод заказов на «торговых точках» или кухне.

Мы не будем углубляться в детали, в целом всю информацию вы сможете найти в оригинальной документации, осветим лишь общие моменты. В большинстве задач по интеграции вам требуется следующее – получить заказ от клиента и отправить данные о нем и клиенте (опционально) на терминал, чтобы кухня или торговая точка этот заказ увидели и передали клиенту. Для этого вам нужно подключиться (доступы вам предоставит ваш дилер iiko) к iiko cloud, зарегистрировать новый api ключ, и, что очень важно, поработать с меню. Для этого там же в cloud для всех доступных организаций вы можете создать или выгрузить «внешнее меню», которое будет доступно вам в api в соответствующем методе и позиции которого вы сможете отправлять в заказ. Напомню, вы не сможете передать в заказ товары и модификаторы, которых во внешнем меню нет, но при этом – вы без проблем сможете отправлять в методах и доставки и заказа «на стол» свои цены, отличные от цен во внешнем меню, система без проблем пропускает такие расхождения. Далее вам стоит проверить – настроены ли у вас методы оплаты, без них вы не сможете отправлять «предоплаченные заказы» на терминалы и закрывать их, и если да, то получить id необходимых методов – они тоже будут нужны для заказа.

Сама техническая реализация – довольно простая, все общение с api – это набор post и get методов. Чтобы отправить заказ – вам нужно знать api ключ и знать id организации, которой этот заказ принадлежит, а также id группы терминалов (можно получить в соответствующем методе, привязанном к id организации). Далее вы с помощью метода авторизации получаете из api ключа токен, которым подписываете все дальнейшие запросы. На этом у вас есть все данные для создания заказа – токен, данные организации и точки и номенклатура, остается только запустить метод создания заказа (напомню, их два – на доставку и «на стол», отличаются они набором параметров и отображением на терминалах, но не критично, методы легко переделываются один в другой). На выходе, если все хорошо, вы получите id заказа, по которому (в том числе с помощью вебхуков в cloud) сможете получить статус заказа и прочую информацию.

Для работы с api существуют готовые библиотеки, но глобально – методы довольно просты и достаточно curl и базового знания php для работы с ними.

Остановлюсь в финале лишь на одном важном моменте. Так уж вышло, что существует 2 довольно распространенные проблемы – это «недоставка» заказа в iiko cloud (таймаут, ошибки) и «недоставка» заказа из cloud на терминал, при этом если ошибки – это понятно, то таймаут соединения – ошибка нередкая и iiko cloud ее не обрабатывает, то есть повторно заказ не отправляет, этот вопрос оставлен на откуп программистам и требует постоянного мониторинга – получен ли id заказа и поступил ли заказ на терминал или его требуется отправить повторно.

За сим базовую вводную статью завершим, уверен, мы еще вернемся к тонкостям интеграции с iiko в дальнейшем.

Сделать репост: