Интеграция с МойСклад

Принцип работы

Данная интеграция позволяет настроить взаимодействие сервиса автоматизации FBS oShip и МойСклад. oShip получает данные о заказах напрямую от маркетплейсов, обогащает эти данные информацией из МойСклад: наименования товаров, штрихкоды и т.д.

Также синхронизирует статусы упаковки и отгрузки заказов маркетплейсов в oShip с заказами покупателя МойСклад. Для этого на стороне МойСклад у вас должно быть настроено создание этих заказов. Данное решение не создает заказы маркетплейсов в МойСклад. Подробная информация про работу в сервисе oShip доступна в документации по Подтверждению и Упаковке заказов.

Функционал интеграции

Интеграция с облачной ERP-системой МойСклад позволяет:

• Синхронизировать статусы заказов из oShip (Упаковка, Отгрузка) в Заказ покупателя сервиса МойСклад.
• Передавать информацию о маркировке (Честном знаке) товаров из oShip в Отгрузки МойСклад.
• Находить комплекты в заказах покупателя МойСклад и выгружать их в отдельный магазин oShip с типом API для их сборки с видеофиксацией и маркировки.
• Формировать YML-файл для загрузки в oShip информации о штрихкодах и наименовании товара из МойСклад.

Регистрация

1. Для подключения откройте настройки МоегоСклада, перейдите в раздел "Токены", создайте токен и скопируйте его в буфер обмена. Данную операцию должен выполнить пользователь, обладающий административными правами в МойСклад.

2. Перейдите в раздел Настройки сервиса oShip. В блоке МойСклад нажмите Регистрация и во всплывающем окне укажите ранее полученный токен.

3. Нажмите кнопку Зарегистрировать, теперь вы можете приступать к настройке.

4. Нажмите кнопку Перейти в Настройки. У вас откроются настройки аккаунта с доступными магазинами oShip (каждый из них в отдельной вкладке).

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

Раздел Синхронизация

Раздел Синхронизация предназначен для контроля обмена данными между oShip и МойСклад. Здесь можно проверить связь заказов, передачу статусов и КИЗ, а также увидеть ошибки комплектов.

В верхней части страницы отображается общее состояние обмена:

• Синхронизация работает — ошибок за выбранный период нет;
• Есть данные, требующие внимания — обмен работает, но отдельные заказы или комплекты нужно исправить;
• Есть ошибки при передаче данных — система повторяет обмен автоматически; если ошибка сохраняется, обратитесь в поддержку;
• Синхронизация временно отложена — МойСклад ограничил частоту запросов, обмен продолжится автоматически.

Список можно отфильтровать по периоду, магазину и состоянию, а также найти запись по номеру заказа, ID, товару или штрихкоду. Кнопка Выгрузить сохраняет отфильтрованный список заказов в Excel.

Заказы и связь с МойСклад

На вкладке Заказы для каждого заказа отображаются:

• номер, магазин и дата отгрузки;
• статус и время события в oShip;
• результат поиска заказа в МойСклад;
• состояние передачи статуса и КИЗ;
• общий результат синхронизации.

Возможные ошибки связи: заказ находится вне периода автоматического поиска; заказ не найден; найдено несколько подходящих заказов; результаты поиска не совпали; результат поиска не удалось проверить; возникла ошибка поиска; связь с МойСклад не удалось сохранить. Для уточнения причины используйте номер заказа, искомое поле и найденные ID, показанные в строке.

Синхронизация статусов

Статус Упакован или Отгружен передаётся только для найденного заказа и при наличии соответствующего целевого статуса в настройках магазина. Результат Статус передан означает, что изменение подтверждено МойСклад.

Все варианты ошибок синхронизации статусов

• Нет фактической даты статуса.
• Дата статуса находится в будущем.
• Истекло 24-часовое окно синхронизации.
• Заказ не связан с МойСклад.
• Не настроен целевой статус МойСклад.
• Конфликт целевых статусов.
• Не удалось выполнить запрос.
• Ошибка API МойСклад.
• Заказ не найден в МойСклад.
• МойСклад вернул некорректный ответ.
• Изменение статуса не подтверждено.
• Заказ отсутствует в ответе МойСклад.
• Не удалось сохранить результат.

Если отображается Ожидает связи с МойСклад или Ожидает передачи, обработка ещё не завершена и будет повторена автоматически.

Передача КИЗ

В строке КИЗ отображается результат передачи кодов маркировки в Отгрузку МойСклад. Серый статус означает ожидание данных или повторную проверку, жёлтый — предупреждение, красный — ошибку, требующую исправления.

Все состояния и ошибки передачи КИЗ

• Честный знак не требуется — обработка завершена, передача КИЗ не нужна.
• КИЗ требуется, ожидаем данные от oShip — обязательные коды ещё не получены.
• Ожидаем КИЗ до отгрузки заказа — необязательный код можно передать до отгрузки.
• Честный знак не был отсканирован при упаковке — заказ отгружен без необязательного КИЗ.
• oShip не указал необходимость Честного знака — нет признака обязательности маркировки.
• В заказе МойСклад отсутствует отгрузка — модулю некуда записать КИЗ.
• У товара в МойСклад отключён учёт кодов маркировки — включите учёт кодов у товара.
• Не удалось передать КИЗ в МойСклад — запрос завершился ошибкой и будет повторён.
• Нет фактической даты статуса или Дата статуса находится в будущем — проверьте данные события в oShip.
• КИЗ не появились в oShip за 7 дней или КИЗ не обработаны за 7 дней — автоматическое окно ожидания завершилось.

В деталях ошибки показываются количество ожидаемых или переданных кодов, товар, код товара, ID позиции и тип учёта — если эти данные доступны.

Ошибки комплектов

Вкладка Комплекты отображается, когда включена сборка или выгрузка комплектов. Одинаковые ошибки объединяются; колонка Затронуто показывает число комплектов или заказов с проблемой. После исправления данных в МойСклад повторная обработка выполняется автоматически.

Все варианты ошибок комплектов

• У комплекта отсутствует EAN-13.
• EAN-13 комплекта имеет неверный формат.
• Неверная контрольная цифра EAN-13 комплекта.
• У товара отсутствует EAN-13.
• EAN-13 товара имеет неверный формат.
• Неверная контрольная цифра EAN-13 товара.
• У комплекта отсутствует штрихкод.
• У товара отсутствует штрихкод.
• У комплекта не заполнено ключевое поле.
• У товара не заполнено ключевое поле.
• У товара неверное количество в комплекте.
• У комплекта неверное количество в заказе.
• У комплекта не заполнен состав.
• Не удалось прочитать комплект из МойСклад.
• Не удалось создать комплект.
• Не удалось подготовить комплект к передаче.
• Временная ошибка передачи комплекта.
• oShip не принял комплект.

Выгрузка YML

В разделе Выгрузка товаров выбирается ключевое поле товара, включается выгрузка комплектов и формируется ссылка на YML-файл. При необходимости в файл можно добавить до трёх тегов oShip из полей товара.

Товары, модификации и комплекты без ключевого поля, наименования или штрихкода EAN-13 в YML не включаются. Ошибки состава и данных выгружаемых комплектов отображаются на вкладке Комплекты раздела Синхронизация. После исправления данных нажмите Обновить; полученную ссылку укажите в настройках аккаунта oShip. Подробнее — в разделе Передача информации о штрихкодах товара из МойСклад в oShip.

Синхронизация статусов заказов

В настройках модуля отображаются магазины из подключенного аккаунта в сервисе oShip. Для каждого из магазинов доступна индивидуальная настройка синхронизации статусов:

• Активность синхронизации. Включите или выключите функционал для конкретного магазина.
• Поле для связывания заказов. Т.к. oShip получает номер заказа от маркетплейса, для правильной синхронизации вам необходимо выбрать поле МойСклад, в котором у вас хранится оригинальный номер заказа маркетплейса. Это может быть как стандартное, так и пользовательское поле.
• Статусы в МойСклад, которые будут соответствовать статусу Упакован и Отгружен в oShip.

Важно!

Синхронизация статусов заказов происходит каждые 5 минут

Добавление маркировки в Отгрузку

В настройках магазина вы можете настроить передачу информации о Честном знаке товаров из oShip в документ Отгрузка сервиса МойСклад. Для использования функционала необходимо активировать опцию Передавать Честный знак в Отгрузки и выбрать Ключевое поле товара. Т.е. поле, которое вы используете как идентификатор товара на маркетплейсах. Передача маркировки происходит после изменения статуса заказа в oShip на Упакован.

В отгрузку автоматически добавляется комментарий вида:

oShip
2025-07-10 18:09 - дата добавления информации о маркировке товара
B2C - тип клиента (возможные значения: B2B, B2C)
0104813777775839215 - список кодов маркировки
0104813777775822215
0104813777775808215

Важно!

Модуль не создает Отгрузку, а обновляет информацию в имеющейся отгрузке, связанной с заказом покупателя. Ранее добавленный в отгрузку комментарий будет заменен интеграцией.

Сборка комплектов

Если вы торгуете комплектами в МойСклад и они не лежат у вас на складе заранее скомплектованными, то вы сталкиваетесь с проблемой при их сборке. Данный функционал позволяет упростить процесс, разделив его на два этапа:

1. Сборка и маркировка комплекта через oShip.
2. Использование этого комплекта при упаковке заказа.

Данный функционал доступен только для магазинов с типом API и отображается в дополнительном блоке Сборка комплектов.

После активации функционала модуль запрашивает из МойСклад все заказы покупателя, находящиеся в определённом статусе (задается в настройках в поле Статус для поиска комплектов, например, Новый или Нужно упаковать).

Модуль находит все находящиеся в этих заказах комплекты. По комплектам запрашивает из МойСклад информацию о входящих в них товарах, штрихкодах этих товаров, штрихкоде и наименовании комплекта. Эта информация загружается в магазин с типом API сервиса oShip. Каждый комплект загружается как отдельный заказ. После этого статус заказа покупателя, содержащего комплект, в МойСклад изменяется на выбранный в настройках (Статус при обнаружении комплекта).

У упаковщика есть два возможных сценария работы:

1. Выбрать из интерфейса oShip нужный комплект и зайти в него;
2. Отсканировать штрихкод любой из составных частей комплекта, и система найдет и откроет комплект с данным товаром.
3. Далее необходимо отсканировать штрихкод всех составных частей комплекта, после этого система автоматически напечатает этикетку. Если на рабочем месте, где производится сборка комплекта, подключена камера, то начинается видеофиксация процесса с использованием стандартного функционала oShip. На этикетке комплекта размещается:
   • Штрихкод комплекта;
   • Наименование комплекта;
   • Артикул комплекта;
   • Уникальный идентификатор.

4. Упаковщик сканирует штрихкод с этикетки и на этом процесс сборки комплекта и видеофиксация завершается.

После упаковки комплектов у заказов, их содержащих, происходит изменение статуса в соответствии с настройками модуля. Если заказ содержит несколько комплектов, то изменение статуса произойдет только после упаковки всех входящих в него комплектов. Рекомендуем настроить изменение статусов таким образом, чтобы заказ попадал в раздел Упаковка в oShip только после сборки комплекта.

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

Автоматическое изменение статусов комплекта

Если вам необходимо отменить упаковку комплекта, который уже создан в oShip, переведите Заказ покупателя в МойСклад, содержащий этот комплект, в статус, отличный от Статуса при обнаружении комплекта. Комплект в oShip отменится автоматически.

Уникальный идентификатор на этикетке

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

Передача информации о штрихкодах товара из МойСклад в oShip

Весь процесс работы в сервисе oShip построен на сканировании штрихкодов. Это позволяет вашим сотрудникам не ошибаться и упаковывать заказы даже без знания товара. По умолчанию oShip получает информацию о штрихкодах товара от маркетплейсов в момент, когда поступает новый заказ, но у многих магазинов там содержится неполная информация. Данная интеграция позволяет вам выгрузить информацию о штрихкодах товаров, модификаций и комплектов из МойСклад в формате YML-файла, а затем указать ссылку на этот файл в настройках аккаунта oShip.

Функционал позволяет выгружать в YML-файл штрихкоды с типом EAN13 из ассортимента МойСклад с типом сущности: Товар, Комплект, Модификация.

Ассортимент не попадет в выгрузку, если будет недостаточно данных:

• Не заполнено Ключевое поле товара, которое установлено в настройках модуля (ID, Код, Внешний код, Артикул);
• Не заполнено Наименование товара;
• Нет Штрихкода с типом EAN13.

1. В разделе Выгрузка товаров модуля интеграции укажите параметры выгрузки. Необходимо выбрать Ключевое поле товара, которое вы используете как идентификатор товара на маркетплейсах.

Для выбора доступны следующие варианты ключевого поля:

2. Нажмите кнопку Обновить, скопируйте полученную ссылку и добавьте ее в поле Ссылка на YML файл в настройках аккаунта oShip.

3. Сохраните настройки.

Важно!

Данные из YML в oShip обновляются каждый час