Интеграция с вашей кассой: iiko, Poster, Frontpad

Заказы из Yumurta уходят прямо в вашу кассовую программу, а меню и стоп-лист приходят из неё. Подключение, сопоставление товаров и что делать, если заказ не ушёл.

Если у вас уже стоит iiko, Poster или Frontpad, подключите её — и заказы с сайта и из приложений будут приходить в кассу сами, как обычные заказы: касса напечатает их на кухню и спишет ингредиенты по своим тех.картам. Обратно из кассы приходят меню и стоп-лист.

Раздел — «Интеграция с кассой» в меню кабинета (внизу, рядом с «Настройками»).

Это не про нашу программу «Yumurta Касса» для Windows — та работает без всякой интеграции. Здесь речь о кассе другой фирмы, которая у вас уже есть.

Что умеет интеграция

Переключатель	Что делает
Отправлять заказы в кассу	Заказ с сайта и из приложений уходит в кассу
Подтягивать меню	Номенклатура кассы появляется в сопоставлении; позиция, которую убрали из меню кассы, снимается с продажи у вас
Обновлять цены по кассе	Цены сопоставленных товаров берутся из кассы
Подтягивать стоп-лист	То, что кончилось в кассе, снимается с продажи у вас (проверяем каждые 5 минут)
Передавать добавки отдельно	Добавка уходит в заказ своей строкой, и касса списывает её ингредиенты

Одно заведение — одна касса. Если у вас несколько точек, подключайте каждую в своём кабинете.

Шаг 1. Получите ключ доступа

Касса	Где взять ключ
iiko	iikoWeb → «Интеграции» → «API-ключи». Ключ из 32 символов. У него есть срок действия — когда он закончится, iiko перестанет принимать заказы, и ключ нужно будет выпустить заново
Poster	Настройки аккаунта → «Интеграции» → API. Выглядит как `687409:4164553abf…`
Frontpad	«Настройки» → «Общие» → секретный код для API

Ключ мы не показываем и никуда не передаём. После сохранения поле остаётся пустым — это нормально: пустое поле значит «оставить прежний ключ». Вводите новый только когда меняете его.

Шаг 2. Проверьте связь

Выберите кассу, вставьте ключ и нажмите «Проверить связь». Касса ответит, и в полях появятся списки: организация, группа терминалов (точка), тип заказа, вид оплаты. До проверки связи выбирать там не из чего — списки приходят от кассы.

Выберите свою организацию и терминал, поставьте галочки из таблицы выше и сохраните. Галочку «Интеграция включена» лучше ставить последней — после сопоставления товаров.

Шаг 3. Сопоставьте товары

Касса знает свои блюда по своим внутренним номерам: название «Бургер» ей ничего не говорит. Нажмите «Забрать меню из кассы» — появится список её позиций, а напротив каждой нужно выбрать ваш товар.

Часть сопоставится сама: сначала по артикулу, потом по точному совпадению названия. Остальное выбирается руками. Фильтр «только несопоставленные» показывает, сколько осталось.

Пока позиция не сопоставлена, заказ с ней в кассу не уйдёт — целиком, а не половиной. Это сделано нарочно: половина заказа на кухне хуже, чем понятная ошибка в очереди. Поэтому сопоставление стоит довести до конца, прежде чем включать интеграцию.

Добавки — отдельный список

Переключатель «Товары / Добавки» над списком. В кассе добавка — такая же позиция номенклатуры, поэтому сопоставляется так же.

Сопоставленная добавка уходит в заказ отдельной строкой со своей ценой — касса списывает её ингредиенты (сыр, второй сыр, бекон).
Несопоставленная уйдёт названием в комментарий к блюду, а её цена останется внутри цены блюда. Деньги в чеке будут верные, но склад кассы спишет блюдо без добавки.

«Нет в кассе»

Позиция, которую убрали из меню кассы, помечается «нет в кассе» и снимается с продажи у вас. Два важных правила:

товар снимается только когда пропали все его позиции в кассе — один ваш товар может стоять за несколькими позициями номенклатуры;
если касса отдала меню не полностью (обрыв связи на середине), мы ничего не снимаем и пишем об этом в журнал. Иначе с сайта ушла бы половина каталога.

Когда позиция возвращается в меню кассы, она возвращается и в продажу. Ваш собственный стоп-лист при этом не затирается: у снятия «нет в кассе» своя причина.

Шаг 4. Столы — только для зала

Касса принимает заказ в зале только со своим номером стола: ваш «стол 5» ей ничего не говорит. Нажмите «Забрать столы из кассы» и сопоставьте со своими столами.

На доставку и самовывоз это не влияет вовсе. Если стол не сопоставлен, заказ из зала уйдёт обычным способом или остановится в очереди — там будет видно.

Очередь заказов: где смотреть, если заказ не пришёл

Заказ уходит в кассу не мгновенно, а через очередь. Это сделано, чтобы ничего не терялось: если касса выключена, занята или нет интернета — заказ дождётся и уйдёт сам. Повторы идут с нарастающей паузой (минута, две, четыре… до часа), всего до восьми попыток.

В блоке «Очередь заказов» у каждого заказа видно состояние и причину. Что они значат:

Состояние	Что это значит и что делать
В очереди	Ждёт отправки. Ничего делать не нужно
Отправлен	Касса приняла, но ещё не подтвердила. iiko и Poster отвечают «принято в обработку» — подтверждение приходит чуть позже
Подтверждён	Заказ в кассе. Всё хорошо
Не отправлен	Причина написана рядом. Кнопка «Повторить» пробует ещё раз сразу
Снят	Отправлять нечего: заказ отменён или вы сменили кассу

Частые причины «не отправлен»:

«позиция не сопоставлена» — сопоставьте её и нажмите «Повторить»;
«стол не сопоставлен» — то же про стол;
«нет связи с кассой», «касса не ответила» — повторится само;
«ключ не принят» — у iiko закончился срок действия API-ключа, выпустите новый;
«отправка прервалась, результат неизвестен — проверьте заказ в кассе» — у Poster и Frontpad нельзя повторять автоматически: повтор напечатал бы второй чек. Посмотрите в кассе, пришёл ли заказ; если нет — нажмите «Повторить».

Любой заказ можно отправить в кассу руками — кнопка есть у заказа в очереди. Неоплаченный онлайн-заказ в кассу не уходит, пока деньги не подтвердятся: иначе кухня готовила бы то, за что не заплатили.

Что именно уходит в кассу

Скидки, промокоды и баллы — в цене позиций. В кассу уходит то, что гость реально заплатил, чтобы чек кассы не расходился с нашим.
Возвращённые позиции вычитаются, а скидка пересчитывается на остаток.
Чаевые в кассу не передаются.
Продажи, пробитые на нашей кассе и на киоске самозаказа, в чужую кассу не уходят — они там и не нужны.

Если решили отключить

Кнопка отключения снимает галочку и возвращает в продажу всё, что снимала интеграция — и по стоп-листу кассы, и по «нет в кассе». Незавершённые задания очереди снимаются, и мы отдельно скажем, сколько оплаченных заказов в них было: их нужно принять в кассе руками.

Смена кассы на другую делает то же самое и вдобавок очищает сопоставление: номера позиций у другой кассы свои.

Возвраты в кассу не уходят. Возврат оформляется у нас — в кабинете или на нашей кассе, — а в вашей кассовой программе его нужно провести отдельно. Иначе её отчёты и остатки разойдутся с нашими.

← Все статьи