iiko API: как объединить кассу, 1С и Power BI в Казахстане

iiko API это что и какие отчёты можно получить

API это интерфейс, через который системы обмениваются данными по определённым правилам. Для владельца ресторана важно, какие сведения доступны через выбранный интерфейс, за какой период и с какими правами. Эти условия определяют, какие показатели получится рассчитать и проверить.

Через iikoServer API доступны OLAP-отчёты, в том числе почасовая выручка и число чеков. В опубликованном разборе приведён пример метода reports/olap с типом SALES. Это пример из технического материала, который нужно уточнить по официальной документации iiko для своей версии и установки. Пример получения OLAP-отчётов

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

Назначение iikoCloud API и iikoServer API проверяйте отдельно. Для задачи получения OLAP начните с проверки iikoServer. Подтвердите актуальный способ авторизации, метод, права и ограничения в официальной документации. Сохраните результат технической проверки вместе с требованиями к отчёту.

Для просмотра отчётов с телефона у iiko есть iikoDashboard. Права доступа к отчётам настраиваются отдельно. Если вопрос владельца уже решается таким просмотром, используйте эту возможность. Критерии выбора отдельной системы собраны в сравнении Power BI и аналитики кассы.

Какие источники нужны для интеграции iiko, Power BI и 1С

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

Это перечень требований к сбору. Состав конкретной выгрузки подтвердите у поставщика и владельца источника. Для r_keeper и 1С запросите образцы своей установки. Способ передачи выбирайте после проверки доступных данных: файл, API или другой согласованный вариант.

В Алматы, Астане и других городах Казахстана при объединении точек пригодится общий перечень управленческих расходов. Укажите, где отражены аренда и оплата труда, как их относите к периоду и заведению. Суммы в тенге сохраняйте вместе с исходным документом и правилом расчёта.

Зачем нужен единый справочник блюд и точек

Единый справочник это согласованный список объектов и соответствий между системами. Он связывает код блюда в кассе с нужной позицией учёта и доставки. Для точки укажите устойчивый идентификатор и соответствующие обозначения во всех источниках. Одного похожего названия для связи недостаточно.

Допустим, в вымышленной сети напиток называется «Латте большой» в кассе и «Латте 400» в файле доставки. Сначала подтвердите у ответственного, что это одна позиция с одинаковым составом. Только после проверки внесите соответствие. Другой объём или рецепт должен сохранять своё отличие.

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

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

Для техкарт сохраните даты действия и единицы. Изменение сегодняшней рецептуры нужно отдельно проверить на исторических продажах. Порядок расчёта норматива и факта разобран в статье как считать фудкост. Используйте эти определения при постановке задания на интеграцию.

Как сопоставить кассу, агрегаторы и Kaspi

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

Для Wolt, Glovo и Яндекс Еды соберите доступные выгрузки и отчёты из партнёрских кабинетов. Состав и глубина истории зависят от сервиса, уточняйте их у поставщика. Комиссия и рекламные расходы зависят от вашего договора. Подтвердите, какие суммы удержаний можете связать с заказом или периодом.

Если заказ доставки уже отражён в кассе, повторное прибавление продажи из кабинета завысит выручку. Используйте отчёт агрегатора для проверки канала и расчётов. При неполной связи вынесите спорные строки в отдельную сверку. Расходы канала разобраны в статье о марже доставки.

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

Если дополнительно используете сведения о привлечении гостей из 2ГИС, определите основание связи с продажами. Само наличие обращения ещё не даёт соответствующего чека. В расчёт включайте только ту связь, которую можете подтвердить доступными сведениями.

Как организовать обновление и проверку данных

Свежесть отчёта складывается из готовности источника, передачи, обработки и появления результата на экране. Для выбранной схемы Power BI уточните у поставщика частоту и ограничения обновления. Доступность, лицензирование и условия использования в Казахстане также требуют отдельного подтверждения.

Разделите загрузку и готовность расчёта. Продажи могут быть получены, а складские документы ещё проверяются. Покажите оба статуса. Фактический продуктовый расход подтверждайте после надёжных остатков и закрытия движений. Тогда руководитель сможет понять причину изменения ранее показанного итога.

Согласуйте проверки для каждого обновления.

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

Проверьте эти условия на копии данных. Повторите загрузку одного периода, внесите согласованное тестовое исправление и сравните результаты. Опишите, кто получает сведения о сбое и кто восстанавливает обновление. После восстановления повторите сверку контрольных сумм.

Нужный владельцу состав экранов и ритм разбора описаны в статье о дашборде для владельца ресторана. В задании свяжите каждый экран с подтверждённым источником и статусом готовности.

Какие ошибки интеграции мешают доверять отчёту

Разные определения выручки. Сравнивают продажи до скидок с итогом после возвратов. Запишите состав каждого показателя и повторите сверку на одинаковом наборе операций. Сохраните фильтры контрольного отчёта вместе с результатом.

Неверная связь справочников. Два блюда с одинаковым названием объединяют, хотя отличаются порцией. Проверьте исходные коды и рецепт. Исправьте соответствие и пересчитайте затронутые периоды, сохранив причину изменения.

Смешение единиц. Закупку в упаковках сравнивают с расходом в граммах. Запишите единицы и коэффициенты пересчёта. Сверьте их с закупщиком и кухней до оценки продуктового отклонения.

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

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

Кто отвечает за права доступа и хранение

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

Распределите доступ по рабочим задачам. Определите, кто смотрит свою точку, видит сеть, меняет формулы и управляет подключением. Проверьте эти роли отдельными пользователями. Передачу через зарубежные сервисы, расположение данных и порядок хранения решайте с ИТ и юристом организации по конкретной схеме.

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

Что включить в чек-лист подрядчику

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

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

1. Укажите версии источников, доступы, доступную историю и подтверждённые образцы данных.
2. Согласуйте формулы, периоды, скидки, возвраты и правило учёта доставки.
3. Передайте справочники блюд и точек с ответственным за новые соответствия.
4. Проверьте выручку, число чеков и выбранный продуктовый расчёт по первичным сведениям.
5. Пройдите повторную загрузку, исправление прошлого периода и пропуск источника.
6. Подтвердите роли пользователей, схему хранения и порядок передачи сопровождения.

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

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

Согласуйте передачу образца подрядчику. Подготовьте обезличенные файлы с сохранённой структурой полей и связей между записями. Отдельно перечислите исключённые сведения, чтобы проверяющий понимал ограничения примера. Доступ к рабочему источнику обсудите с ИТ по конкретной задаче и набору данных. Для проверки формулы заранее сохраните ожидаемую сумму контрольного периода. После загрузки сравните итог и число строк, затем откройте несколько исходных операций. Если сумма совпала случайно за счёт двух противоположных ошибок, такая проверка поможет обнаружить расхождение до регулярного использования отчёта.

Частые вопросы

iiko API это готовое подключение к Power BI?

API даёт способ обмена данными. Получение нужного отчёта, преобразование и сверку нужно подтвердить для выбранной схемы. Проверьте образец, доступы и результат на закрытом периоде до оценки полной интеграции.

Можно ли объединить iiko, r_keeper и 1С?

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

Будут ли данные обновляться в реальном времени?

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

Нужен ли Power BI ради отчётов iiko с телефона?

У iiko есть iikoDashboard для просмотра отчётов, права настраиваются отдельно. Проверьте нужные показатели на телефоне владельца. Отдельную BI-систему оценивайте по задачам объединения источников и доступным расчётам.

Кто должен исправлять ошибки справочника блюд?

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