Серверы iiko и сети

Одно ЭДО-подключение может обслуживать несколько ресторанов: документы из одного аккаунта СБИС расходятся по разным серверам iiko. Какие именно серверы доступны и какой из них основной — задаётся на самом ЭДО-подключении.

Эта статья объясняет, откуда берётся список серверов в документе и почему накладная уходит на один сервер, а акт услуг — сразу на несколько.

Набор серверов и сервер по умолчанию#

У каждого ЭДО-подключения свой набор серверов iiko. Он задаётся в форме подключения СБИС, блок «Серверы iiko этого подключения»: галочка — сервер входит в набор, радиокнопка «по умолчанию» — один из отмеченных становится основным.

Что это даёт:

• в документах этого ЭДО в списке «Сервер iiko (куда выгрузить)» показываются только отмеченные серверы;
• сервер по умолчанию подставляется в новый документ автоматически, менять его нужно только когда документ идёт в другой ресторан;
• справочники (товары, склады) для карточки документа берутся с того сервера, который выбран в самом документе;
• у акта услуг колонка сервера по умолчанию — та самая колонка «остаток», в которую автоматически добирается всё, что вы не разнесли по другим ресторанам;
• он же используется как основной, когда Римире нужен «какой-нибудь» сервер подключения — например, чтобы показать справочники в списке документов.

Снятая галочка не удаляет ничего: сервер просто перестаёт предлагаться в документах. Уже выгруженные на него документы и сделанные привязки остаются. Вернёте галочку — сервер снова появится в списке.

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

Накладная — один сервер, акт — несколько#

Приходная накладная выгружается ровно на один сервер. Она создаётся серверным API конкретного сервера iiko, товары и склады у каждого сервера свои, поэтому «размазать» одну накладную по нескольким ресторанам нельзя. Сервер выбирается в самом документе полем «Сервер iiko (куда выгрузить)».

Внутри одной накладной действует ещё одно ограничение: все склады её строк должны относиться к одному подразделению (юрлицу). Иначе iiko документ не примет, и Римира предупредит об этом до отправки.

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

Акт создаётся на каждом сервере отдельным документом — своей кнопкой «Создать» в колонке или сразу везде кнопкой «Создать все акты». Провести и распровести каждый акт тоже можно по отдельности.

Что такое «один чейн»#

Разнести акт можно только по серверам одного чейна — то есть одной сети iiko.

Признак чейна у Римиры один: общий ключ iiko Cloud API. Серверы, у которых сохранён один и тот же ключ, считаются сетью; колонками матрицы становятся те из них, которые входят в набор ЭДО-подключения.

Отсюда два следствия:

• если у сервера по умолчанию ключа Cloud API нет, колонка будет одна — он сам, и разносить будет некуда;
• серверы с разными ключами в одну матрицу не попадут, даже если они отмечены в одном ЭДО-подключении.

Тот же признак работает и для привязок контрагентов: справочник контрагентов в чейне общий, поэтому привязку, сделанную на одном сервере сети, Римира находит и у его соседей — смена сервера по умолчанию не прячет уже сделанную работу.

Ключ задаётся на подключении iiko — см. ключ Cloud API.