К статье
Практический материал

Автоматизация · 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С универсальной обработкой «Загрузка данных из табличного документа» или через конвертацию данных. Способ подходит как временное решение или для разового переноса справочников и остатков.

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

Сравнение вариантов обмена

Типовой модуль iiko

Подходит для типовых 1С:Бухгалтерии и Управления торговлей. Быстрый старт, минимум настроек, но ограниченная гибкость.

Обмен через API (своя разработка)

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

Файловая выгрузка

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

Подготовка: что проверить до настройки обмена

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

Во-первых, убедитесь, что в iiko закрыты все смены и проведены документы за период выгрузки: непроведённые накладные и открытые смены в обмен не попадут, и выручка в 1С «не сойдётся».

Во-вторых, приведите в порядок справочники: у номенклатуры в iiko должны быть заполнены единицы измерения и ставки НДС, у контрагентов — корректные наименования и ИНН. Именно по этим реквизитам 1С будет искать или создавать элементы справочников.

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

В-четвёртых, убедитесь, что у пользователя, под которым работает обмен, есть права в iiko на чтение данных по API, а в 1С — на создание документов и элементов справочников.

Настройка типового модуля обмена: пошагово

Порядок действий для типового модуля обмена iiko с 1С выглядит следующим образом (детали зависят от версии модуля и конфигурации).

  1. Получите актуальную версию модуля обмена у iiko или у партнёра, который внедрял систему. Модуль поставляется как файл внешней обработки (.epf) или расширение.
  2. Откройте обработку в 1С через «Файл — Открыть» и укажите параметры подключения: адрес сервера iiko, порт, логин и пароль API-пользователя. Проверьте соединение кнопкой теста подключения.
  3. Задайте настройки учёта: организацию, склады 1С и их соответствие складам iiko, счета учёта, статьи доходов и расходов, типы цен.
  4. Выполните первичное сопоставление номенклатуры: загрузите справочник товаров из iiko и свяжите его с номенклатурой 1С по коду, артикулу или наименованию. Несопоставленные позиции отметьте для ручной обработки.
  5. Настройте расписание автоматической загрузки (например, ежедневно ночью за предыдущие сутки) или планируйте запуск вручную.
  6. Выполните пробную загрузку за один день и сверьте результат с отчётами iiko.
Порядок действий
  1. 1
    Установите модуль обмена и проверьте подключение к серверу iiko
  2. 2
    Настройте соответствие организаций, складов и счетов учёта
  3. 3
    Сопоставьте номенклатуру и контрагентов между системами
  4. 4
    Сделайте пробную загрузку за один день в копии базы
  5. 5
    Сверьте выручку и документы с отчётами iiko
  6. 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С идёт по наименованию, а наименования в iiko и 1С отличаются хотя бы пробелом. Решение: сопоставлять по коду/артикулу и вести регистр соответствий.

Вторая ошибка — выгрузка в закрытый период 1С. Если дата запрета редактирования установлена, документы не создадутся, и обмен завершится с ошибкой. Согласуйте расписание обмена с закрытием периодов в бухгалтерии.

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

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

Типичные ошибки
01
Сопоставление номенклатуры только по наименованию — приводит к дублям справочника в 1С
02
Загрузка в рабочую базу без теста на копии — массовые ошибки приходится исправлять вручную
03
Не настроен перенос возвратов и сторно — выручка в 1С завышена относительно iiko
04
Редактирование документов в iiko задним числом после выгрузки — данные систем расходятся
05
Игнорирование журнала ошибок обмена — часть документов теряется незаметно

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

Можно ли выгрузить из 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.