В компании «ОНИВС» автоматизирован обмен данными между учетной системой «1С:ERP Управление предприятием» и складской системой подрядчика (WMS) через REST API, для чего разработано расширение для 1С. Особенность проекта — высокий объем операций (40–50 заказов в день) и необходимость работы с распределенной инфраструктурой: собственный сайт на Битрикс, несколько маркетплейсов и склад аутсорсера. В результате операторы получили «единое окно» в 1С:ERP для управления процессами отгрузки и возвратов, ручной перенос данных сокращен на 30%.
Onives — бренд подразделения Omoda компании Chery Automobile, основанный в 2025 году. Торговая компания, специализирующаяся на оптовой и розничной продаже товаров народного потребления — велосипеды, товары легкой промышленности, автомобильные аксессуары.
Цель проекта: обеспечить автоматический двусторонний обмен данными между «1С:ERP Управление предприятием» и WMS-системой подрядчика для синхронизации справочников, движения товаров (приемка, отгрузка, возвраты) и актуальных складских остатков.
Задача проекта: создать для операторов «единое окно» работы в привычной 1С:ERP без необходимости заходить в личный кабинет подрядчика.
Продажи ведутся через собственный интернет-магазин на базе 1С-Битрикс и маркетплейсы Wildberries, Ozon, Яндекс Маркет.
Компания столкнулась с проблемой масштабирования: рост объема заказов достиг 40–50 единиц в день, что потребовало привлечения стороннего фулфилмент-оператора для хранения и сборки товаров.
Ключевыми проблемами являлось:
Учет товаров велся в 1С:ERP, а физические остатки находились на складе подрядчика с собственной WMS-системой.
Отсутствие интеграции приводило к расхождению остатков: товар на складе подрядчика мог быть продан, но в 1С это не отражалось.
Информация о приемке, отгрузках и возвратах передавалась вручную (менеджерами через Ms Excel и мессенджеры), что занимало до 30% рабочего времени сотрудников.
Высокий риск ошибок при ручном переносе данных и задержки в обработке заказов.
Реализация проекта: пошаговая разработка интеграции
Этап 1. Проектирование API-контракта
Совместно с подрядчиком утверждается схема данных (API Contract). В нее входят:
- Модели данных — описание структур номенклатуры, заказов, возвратов и статусов.
- Методы взаимодействия (эндпоинты) — спецификация REST API, задокументированная в формате Swagger (OpenAPI). Это позволило обеим сторонам иметь единое понимание форматов запросов и ответов.
Этап 2. Разработка на стороне 1С:ERP
Интеграция реализована с соблюдением методологии «расширений», что гарантирует безопасность последующих обновлений типовой конфигурации.
Ключевые компоненты разработки:
- Общий модуль «склИнтеграцияПодрядчик»:
- Содержит экспортные функции для формирования HTTP-запросов.
- Реализована работа через объект «HTTPСоединение».
- Формирование и парсинг JSON-структур для отправки и приема данных.
Регламентные задания:
- Настроены фоновые задания для периодического опроса API подрядчика (получение статусов сборки, подтверждений отгрузки, данных по возвратам).
- Использован механизм очередей сообщений для обеспечения асинхронности обмена.
Этап 3. Реализация бизнес-сценария «Заказ на отгрузку»
Рассмотрим сквозной пример обработки заказа:
- Поступление заказа: в 1С:ERP загружаются заказы из двух источников: с маркетплейсов (через ранее внедренный модуль ITC:MarketBridge) и с сайта на 1С-Битрикс.
- Формирование задания: при проведении заказа и получении от маркетплейса этикеток (или формировании своих для доставки) срабатывает алгоритм интеграции:
- система читает данные заказа (состав, адрес, уникальный идентификатор);
- формирует JSON-пакет и отправляет POST-запрос на API WMS подрядчика для резервирования товара и создания задания на сборку.
- Ожидание и обработка ответа: запрос отправляется в фоновом задании, пользователь продолжает работу в системе. При получении подтверждения от WMS статус заказа в 1С автоматически обновляется.
Технологические особенности и Best Practices
В ходе проекта были применены ключевые практики промышленной интеграции:
- Асинхронность обмена: так как WMS-система подрядчика может обрабатывать запросы с задержкой (особенно в часы пик), все критические операции вынесены в фоновые задания. Пользователь 1С не «зависает» в ожидании ответа от внешней системы.
- Идемпотентность операций: в структуру каждого запроса зашиты уникальные идентификаторы: внутренний номер документа в 1С и ID заказа, присвоенный маркетплейсом. Это гарантирует, что при повторной отправке (например, из-за сбоя сети) на стороне WMS не создастся дубль заказа или возврата.
- Полное логирование: настроен механизм записи всех запросов и ответов в регистры сведений. В случае сбоя администратор видит точную причину (неверный формат данных, таймаут, отказ API) и может перезапустить обмен без ручного вмешательства.
Проект в ООО «ОНИВС РУС» демонстрирует экспертизу исполнителя в области кастомной разработки и API-интеграции. В отличие от типовых обменов, данное решение полностью учитывает специфику работы со сторонним фулфилментом:
- Взаимодействие построено не на файловом обмене, а на промышленном REST API с четкой спецификацией (Swagger).
- Архитектура на расширениях гарантирует легкость обновления платформы «1С:Предприятие».
- Применение асинхронных фоновых заданий и принципов идемпотентности обеспечивает отказоустойчивость интеграции.
Внедрение API-интеграции позволило компании ООО «ОНИВС РУС» выстроить прозрачный контур управления складскими запасами подрядчика:
- Снижение трудозатрат: время на передачу данных между системами сократилось на 95%. Исключен ручной ввод заказов в личный кабинет подрядчика и выгрузка остатков в Excel.
- Ускорение обработки заказов: за счет автоматической передачи заданий на сборку время от поступления заказа до передачи в доставку сократилось в 2–3 раза.
- Достоверность остатков: обеспечена синхронизация складских остатков в режиме, близком к реальному времени (интервал обмена — 5–10 минут). Исключены ситуации «овербукинга», когда товар, уже отсутствующий на складе подрядчика, продолжал продаваться на витрине.
- Прозрачность возвратов: информация о браке и возвратах от клиентов автоматически загружается в 1С:ERP, что позволяет корректно вести претензионную работу с поставщиками.
- Результат: компания получила масштабируемый инструмент для работы с любыми складскими подрядчиками в будущем и полностью избавилась от ручных операций при передаче данных.
