Автоматизация · 11 мин
Как из iiko выгрузить данные в 1С: практическая инструкция
Как настроить выгрузку из iiko в 1С: выгрузка продаж, списаний и остатков, форматы обмена, типичные ошибки и проверка результата.
Рестораны и кафе, работающие на iiko, почти всегда ведут бухгалтерский и налоговый учёт в 1С:Бухгалтерии или 1С:Управление торговлей. Чтобы не вносить продажи, списания и приходы вручную, данные из iiko выгружают в 1С автоматически — через типовые обработки, обмен по API или файловую выгрузку.
Выбор способа зависит от версии iiko (iikoRms или iikoChain), конфигурации 1С и объёма документов. Ниже разобраны основные варианты обмена, подготовка справочников, настройка выгрузки и проверка результата, а также типичные ошибки, из-за которых данные в 1С «не сходятся».
Главное правило: выгрузка из iiko в 1С — это не одноразовая операция, а регулярный обмен. Поэтому важнее всего настроить его так, чтобы он работал стабильно и не требовал ручных правок каждый день.
Какие данные обычно выгружают из iiko в 1С
Прежде чем настраивать обмен, определите состав передаваемых данных. От этого зависит выбор инструмента и объём работ по сопоставлению справочников.
Обычно из iiko в 1С передают:
- отчёты о розничных продажах (выручка по кассам, типам оплат и ставкам НДС);
- приходные накладные от поставщиков;
- акты списания и внутренние перемещения между складами;
- инвентаризации;
- остатки складов на дату;
- корреспонденцию с контрагентами (поставщиками) и номенклатурой.
Зарплата, графики сотрудников и кассовые операции чаще всего ведутся отдельно и в обмен либо не включаются, либо передаются укрупнённо — через сводные документы.
Способы выгрузки: модуль обмена, API и файлы
Существует три рабочих подхода к переносу данных. У каждого — свои условия применения и ограничения.
Типовой модуль обмена от iiko
Компания iiko предоставляет готовый модуль обмена для популярных конфигураций 1С (Бухгалтерия предприятия, Управление торговлей, Комплексная автоматизация). Модуль устанавливается как внешняя обработка, подключается к серверу iiko по API и загружает документы за выбранный период.
Преимущества: не требует программирования, поддерживает сопоставление номенклатуры, складов и контрагентов, умеет работать по расписанию. Ограничение: модуль рассчитан на типовые конфигурации — если ваша 1С сильно доработана, потребуется адаптация.
Обмен через iiko API собственной разработкой
iiko предоставляет документированный API (iikoServer API и iikoCloud API), через который можно получать продажи, накладные, остатки и справочники. На его основе программист 1С пишет собственную обработку загрузки.
Этот путь оправдан, если учёт в 1С нестандартный: например, нужно разносить выручку по нескольким организациям, формировать особые проводки или загружать данные в самописную конфигурацию. Минус — стоимость разработки и необходимость поддержки при обновлении iiko и 1С.
Файловая выгрузка (CSV, XML, Excel)
Из отчётов iiko можно выгрузить данные в файлы и загрузить их в 1С универсальной обработкой «Загрузка данных из табличного документа» или через конвертацию данных. Способ подходит как временное решение или для разового переноса справочников и остатков.
Для ежедневного обмена файловый вариант неудобен: высок риск человеческой ошибки, дублей и пропусков документов.
Сравнение вариантов обмена
Подходит для типовых 1С:Бухгалтерии и Управления торговлей. Быстрый старт, минимум настроек, но ограниченная гибкость.
Для нестандартного учёта и доработанных конфигураций. Полный контроль, но требует программиста и сопровождения.
Для разового переноса справочников и остатков или как резервный канал. Не подходит для ежедневного обмена.
Подготовка: что проверить до настройки обмена
Большинство проблем с выгрузкой возникает не из-за самого обмена, а из-за неподготовленных данных. Перед запуском проверьте четыре вещи.
Во-первых, убедитесь, что в iiko закрыты все смены и проведены документы за период выгрузки: непроведённые накладные и открытые смены в обмен не попадут, и выручка в 1С «не сойдётся».
Во-вторых, приведите в порядок справочники: у номенклатуры в iiko должны быть заполнены единицы измерения и ставки НДС, у контрагентов — корректные наименования и ИНН. Именно по этим реквизитам 1С будет искать или создавать элементы справочников.
В-третьих, определите сторону, в которой ведётся номенклатура. Правильная практика — один мастер-справочник: либо товары заводятся в iiko и выгружаются в 1С, либо наоборот. Двойное ведение гарантированно приводит к дублям.
В-четвёртых, убедитесь, что у пользователя, под которым работает обмен, есть права в iiko на чтение данных по API, а в 1С — на создание документов и элементов справочников.
Настройка типового модуля обмена: пошагово
Порядок действий для типового модуля обмена iiko с 1С выглядит следующим образом (детали зависят от версии модуля и конфигурации).
- Получите актуальную версию модуля обмена у iiko или у партнёра, который внедрял систему. Модуль поставляется как файл внешней обработки (.epf) или расширение.
- Откройте обработку в 1С через «Файл — Открыть» и укажите параметры подключения: адрес сервера iiko, порт, логин и пароль API-пользователя. Проверьте соединение кнопкой теста подключения.
- Задайте настройки учёта: организацию, склады 1С и их соответствие складам iiko, счета учёта, статьи доходов и расходов, типы цен.
- Выполните первичное сопоставление номенклатуры: загрузите справочник товаров из iiko и свяжите его с номенклатурой 1С по коду, артикулу или наименованию. Несопоставленные позиции отметьте для ручной обработки.
- Настройте расписание автоматической загрузки (например, ежедневно ночью за предыдущие сутки) или планируйте запуск вручную.
- Выполните пробную загрузку за один день и сверьте результат с отчётами iiko.
- 1Установите модуль обмена и проверьте подключение к серверу iiko
- 2Настройте соответствие организаций, складов и счетов учёта
- 3Сопоставьте номенклатуру и контрагентов между системами
- 4Сделайте пробную загрузку за один день в копии базы
- 5Сверьте выручку и документы с отчётами iiko
- 6Включите загрузку по расписанию в рабочей базе
Выгрузка через API: что нужно знать разработчику
Если типовой модуль не подходит, обмен строится на API iiko. Для iikoRms используется iikoServer API (REST поверх HTTP, авторизация по логину и ключу), для облачных решений — iikoCloud API с авторизацией по API-ключу организации.
Типовой сценарий интеграции: 1С по регламентному заданию обращается к API, получает список документов за период (накладные, отчёты о продажах), преобразует их в структуры 1С и создаёт документы с проверкой на дубли по уникальному идентификатору документа iiko.
Ключевые технические моменты:
- каждый документ iiko имеет уникальный ID — его нужно сохранять в 1С (в комментарии, дополнительном реквизите или регистре соответствий), чтобы не создавать дубли при повторной загрузке;
- запросы к API следует делать пакетно по периодам, а не «всё сразу» — это снижает нагрузку на сервер iiko;
- ошибки загрузки (несопоставленная номенклатура, закрытый период) нужно логировать и показывать пользователю списком, а не прерывать обмен целиком.
Самая частая причина расхождений после обмена — документы, изменённые в iiko задним числом после выгрузки. Настройте правило: период, уже переданный в 1С, в iiko закрывается для редактирования, либо обмен периодически перезагружает последние несколько дней с заменой документов.
Проверка результата после выгрузки
После каждой загрузки (особенно в первые недели) сверяйте данные. Минимальный набор контрольных точек:
- выручка за день в отчёте о розничных продажах 1С равна выручке по кассовому отчёту iiko (с точностью до копеек);
- суммы по типам оплат (наличные, эквайринг, сертификаты) совпадают с разбивкой в iiko;
- количество приходных накладных за период в 1С равно количеству проведённых накладных в iiko;
- в журнале обмена нет ошибок «номенклатура не найдена» или «контрагент не сопоставлен».
Если выручка расходится, проверьте: не остались ли открытые смены в iiko, не попали ли в выгрузку возвраты и сторно, одинаково ли настроены ставки НДС в обеих системах.
Как проверить результат
Суммы совпадают до копейки
Расхождение — ищите открытые смены или незагруженные возвраты
Журнал пуст или только информационные сообщения
Ошибки сопоставления номенклатуры и контрагентов
Число накладных и отчётов в 1С равно числу проведённых документов в iiko
Документов меньше — часть не загрузилась, больше — есть дубли
Типичные ошибки и как их избежать
Первая ошибка — дубли номенклатуры. Возникает, когда поиск в 1С идёт по наименованию, а наименования в iiko и 1С отличаются хотя бы пробелом. Решение: сопоставлять по коду/артикулу и вести регистр соответствий.
Вторая ошибка — выгрузка в закрытый период 1С. Если дата запрета редактирования установлена, документы не создадутся, и обмен завершится с ошибкой. Согласуйте расписание обмена с закрытием периодов в бухгалтерии.
Третья ошибка — разные единицы измерения. В iiko товар может учитываться в килограммах, а в 1С — в граммах или штуках. При сопоставлении проверяйте коэффициенты пересчёта, иначе остатки и себестоимость будут искажены.
Четвёртая ошибка — игнорирование возвратов и корректировок. Если обмен переносит только продажи, а возвраты обрабатываются вручную, со временем данные разойдутся. Включите возвраты в состав обмена.
Частые вопросы
Можно ли выгрузить из iiko в 1С без покупки модуля обмена?
Да. Можно выгружать отчёты из iiko в Excel/CSV и загружать их в 1С типовой обработкой «Загрузка данных из табличного документа». Это бесплатно, но требует ручной работы каждый день и подходит только для небольшого объёма документов или разового переноса.
Какие конфигурации 1С поддерживает типовой модуль iiko?
Модуль ориентирован на популярные конфигурации: 1С:Бухгалтерия предприятия, 1С:Управление торговлей, 1С:Комплексная автоматизация и ERP. Точный список поддерживаемых версий уточняйте у поставщика модуля — он меняется по мере обновлений.
Как перенести остатки склада из iiko в 1С при старте учёта?
Проведите инвентаризацию в iiko, выгрузите остатки в файл и загрузите их в 1С документом «Оприходование товаров» или «Ввод начальных остатков». Дату ввода остатков согласуйте с бухгалтером — с неё начнётся параллельный учёт в обеих системах.
Что делать, если после выгрузки в 1С появились дубли контрагентов?
Остановите обмен, удалите созданные дубли (предварительно проверив, что на них нет ссылок в документах), настройте сопоставление контрагентов по ИНН и КПП вместо наименования, затем повторите загрузку. Для поиска и объединения уже существующих дублей используйте типовую обработку «Поиск и удаление дублей» в 1С.
Как часто нужно выполнять обмен?
Оптимально — ежедневно за предыдущие сутки, обычно ночью после закрытия всех смен. Более редкий обмен (раз в неделю) допустим, но затрудняет поиск расхождений: чем больше период, тем сложнее найти конкретный потерянный документ.
Сохранятся ли данные в iiko после выгрузки в 1С?
Да. Обмен работает в режиме чтения: документы остаются в iiko без изменений, в 1С создаются их учётные отражения. Риск для данных iiko минимален, но перед первой настройкой всё равно рекомендуется сделать резервную копию базы 1С.
Что важно запомнить
Выгрузка из iiko в 1С настраивается через типовой модуль обмена, API или файлы. Ключ к стабильному обмену — чистые справочники, сопоставление номенклатуры по кодам, тест на копии базы и ежедневная сверка выручки с кассовыми отчётами iiko.