Создаем номенклатурную позицию в IIKO (Айко) по данным из 1С

Вступление

Здравствуйте, друзья!

Меня зовут Тян Семен. Я отвечаю в Лемме за обмен между Айко и 1С:Бухгалтерия. Я занимаюсь исследованием и разработкой обменов данными между учетными системами IIKO и 1С.

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

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

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

От теории к практике

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

• Выбираем позицию из справочника "Номенклатура"
• Жмем на кнопку "Создать в Айко"
• Заполняем служебные параметры: адрес и порт сервера, идентификаторы группы и единиц измерения
• Формируем XML для отправки на сервер
• Отправляем данные и обрабатываем ответ от Айко

Вряд ли есть смысл останавливаться на первых двух пунктах. А вот в третьем есть некоторые особенности (все их конечно же можно рассмотреть детальней в прикрепляемой обработке).

Нюансы с кодировкой

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

Формируем XML

Далее следует пункт формирования XML-файла для отправки на сервер Айко. Да простят меня присутствующие - XDTO я не одолел. Изучил тематический цикл статей уважаемого Evil Beaver и статьи по обменам с Хабра, пытался набросать простую схему в различных редакторах, делал эксперименты с отдельными фрагментами и думал, думал, думал... все тщетно (буду рад, если все-таки научите делать как положено). Возможно в поставленной задаче использование XDTO - никому ненужное усложнение, но хотелось сделать "по красоте". На деле - в обработке большая и страшная портянка из RAW XML с вкраплениями значений переменных 1С (я предупредил).

Путем многочисленных проб и ошибок удалось получить минимально пригодный для передачи текст XML:

здесь

• entities-version - версия объект, получается каждый раз с сервера запросом
• параметр eid тэга product - уникальный идентификатор номенклатурной позиции (дублируется в id)
• mainUnit - УИд единицы измерения
• type - тип номенклатуры (перечисление, GOODS - товары)
• num - артикул номенклатуры в Айко
• parent - УИд родителя (папки) создаваемой позиции

Последние два параметра - формировать ли автоматически код быстрого доступа и артикул в Айко соответственно.

Обрабатываем ответ сервера

В прилагаемом решении используется функция РасшифроватьGZIP(ДвоичныеДанные) из публикации //infostart.ru/public/844121/ . Конечно работать будет и без сжатия, достаточно в заголовках HTTP-запроса установить соответствующий параметр в none. Ответ никак не обрабатывается, однако никто не мешает сделать это для конкретного проекта (здесь и обработка сведений об ошибке и просто возможность получить информацию для уведомления о прохождении процесса).

Как пользоваться

Перед началом необходимо заполнить параметры в процедуре ИнициализацияНастроек() Помимо параметров подключения в данной процедуре можно включить флаг ведения лога и указать директорию для записи служебной информации. Параметр КодГруппы это артикул папки номенклатуры в Айко, куда будут помещены вновь созданные позиции. Отдельный функционал по обработке ответа от сервера не реализовывался. Результат можно увидеть в Айко.

Спасибо за внимание. Буду рад ответить на вопросы. Конструктивная критика приветствуется.

Версия конфигурации и платформы

Разработка велась на следующих версиях

Платформа - 1С:Предприятие 8.3 (8.3.11.2867). По идее подойдет и гораздо старше, начиная с появления методов для работы с HTTP, строковые функции типа СтрРазделить. Требования к РасшифроватьGZIP  имеются на странице публикации.

Конфигурация - Бухгалтерия предприятия, редакция 3.0 (3.0.63.15), особо не роляет, возможности БСП не задействовались.

Айко - работа проверена на версиях, начиная с 4,5 (как Chain, так и RMS)

UPDATE

[12.09.18] Добавлена публикация "Из 1С в IIKO: Передаем перемещения УТ в приходные накладные", в которой рассматриваются прикладные вопросы, возникающие при реализации.

[27.11.18] Добавлена публикация "izi.cloud: Передаем поступления БП в приходные накладные IIKO без регистрации и смс". В статье рассмотрен вариант реализации создания приходных накладных IIKO из типовой Бухгалтерии предприятия 3.0 с использованием функционала сервиса izi.cloud. (обработка инсайд)