Руководство
Как работает Маркирум
От регистрации до поставки, которую принял Wildberries: что подготовить заранее, как пройти каждый шаг и на чём чаще всего спотыкаются. Шаги, которые ещё проходят проверку, помечены.
До старта
Что нужно подготовить
Для текущей работы нужны регистрация в ГИС МТ и доступ к личному кабинету, токен Wildberries, коды и принтер. Требования к УКЭП и КриптоПро для операций в личном кабинете устанавливает ГИС МТ.
Регистрация в «Честном ЗНАКе»
Работать с кодами маркировки может только зарегистрированный участник оборота. Регистрация в ГИС МТ и доступ к личному кабинету — на вашей стороне: Маркирум их не заменяет и работает через вашу учётную запись.
УКЭП и компьютер с Windows
Для действий в личном кабинете ГИС МТ соблюдайте требования самой системы, включая УКЭП и КриптоПро CSP, если они требуются для выбранной операции. Подпись на сайте ставится только в браузере: КриптоПро CSP с официальным КриптоПро ЭЦП Browser plug-in и расширением браузера на компьютере Пользователя. Устанавливать дополнительные программы для подписи не нужно.
Что учесть
Подсказка. Для функций Маркирум — склада кодов, дизайнера, печати, FBO и FBS — УКЭП и КриптоПро не требуются. Ключ и PIN остаются на компьютере Пользователя; до включения API действия в ГИС МТ выполняйте в личном кабинете по его требованиям.
Товары с GTIN в Национальном каталоге
Коды маркировки заказываются под GTIN. Сервис берёт GTIN из самого кода и сопоставляет его с баркодом размера в карточке Wildberries; если совпадение однозначное, связь подтверждается автоматически.
Что учесть
Подсказка. Коды, чей GTIN не нашёлся ни в одной карточке, сервис показывает отдельно: чаще всего это значит, что коды заказаны под баркод, которого нет в кабинете.
Кабинет и токен Wildberries
Базовый токен из раздела «Доступ к API» личного кабинета WB с категориями «Маркетплейс», «Контент» и «Аналитика». Чтобы привязывать КИЗ по API, токен должен быть без отметки «Только чтение»; с ней кабинет работает через Excel-шаблон.
Что учесть
Подсказка. WB показывает токен один раз — сохраните его сразу. Токен действует 180 дней, сервис предупредит о замене за 30 дней. Персональный токен сервис не примет: по правилам WB его нельзя передавать облачному сервису.
Коды маркировки
Коды, заказанные в личном кабинете «Честного ЗНАКа» и выгруженные в PDF или CSV/TXT. Заказ кодов прямо из сервиса пока в разработке.
Что учесть
Подсказка. Не открывайте и не пересохраняйте CSV/TXT в Excel: он незаметно портит невидимый разделитель GS внутри кода, и Wildberries такой КИЗ не примет.
Термопринтер 58 × 40 мм
Разрешение 203 dpi (Xprinter, Godex и аналоги) или 300 dpi (Zebra ZD421 и аналоги), родной драйвер производителя, в свойствах принтера — размер этикетки 58 × 40 мм. Для проверки — сканер или камера телефона.
Что учесть
Подсказка. Перед первой печатью напечатайте из сервиса калибровочную рамку 50 мм и измерьте её штангенциркулем: допуск — ±0,3 мм.
Шаги
От регистрации до поставки
Порядок — тот же, что в приложении. Разделы названы так, как они подписаны в боковом меню.
Регистрация и команда
Зарегистрируйтесь и создайте организацию — подписка и данные принадлежат ей. Пригласите сотрудников и назначьте роли: владелец управляет оплатой и кабинетами, администратор — товарами, стилями этикеток и откатом партий, оператор — импортом кодов, поставками, печатью и отправкой КИЗ.
Подключение кабинета Wildberries
В разделе «Аккаунт → Маркетплейсы» вставьте токен. Сервис разбирает его ещё до первого запроса к WB: персональный токен отклонит с инструкцией, токен «Только чтение» переведёт кабинет в режим Excel. Затем загрузятся карточки, размеры и баркоды, а товары с обязательной маркировкой получат отметку.
Подробности шага
Подсказка. Этикетка привязана к размеру, а не к карточке: у каждого размера свой баркод, и коды одного размера не уйдут на другой.
Загрузка кодов на склад
В разделе «Коды маркировки» перетащите файлы — до 50 за раз, они разберутся по очереди. DataMatrix распознаётся прямо в браузере, GTIN берётся из самого кода. Сервис сверяет, сколько кодов найдено на скольких страницах: при расхождении партия помечается неполной и в печать не идёт. Повторно загруженный файл и уже известные коды на склад второй раз не попадут.
Подробности шага
Подсказка. Партию можно откатить, пока её коды не ушли в Wildberries. Код, отправленный в WB, на склад уже не возвращается.
Проверка кодов в ГИС МТ
Готовится к включениюПроверьте статусы кодов вручную в личном кабинете «Честного ЗНАКа» до печати и передачи КИЗ в Wildberries. Интеграция с ГИС МТ пока недоступна: перед включением нужны тестирование и подтверждение готовности.
Подробности шага
Подсказка. Wildberries примет КИЗ только в статусе «в обороте». Проверяйте это в личном кабинете ГИС МТ: сервис пока не блокирует поставку по результату автоматической проверки статуса.
Настройка этикетки
В разделе «Стили этикеток» возьмите готовую раскладку — «Компакт 58 × 40», «ГОСТ 58 × 60», «Только ЧЗ 58 × 40», «Только баркод 58 × 40», «Книжная 40 × 58», «Минимум 60 × 30» — или настройте свою: блоки, шрифты, поля карточки. Превью совпадает с печатным PDF, а печатный линтер проверяет макет: DataMatrix, у которого на модуль приходится меньше трёх точек принтера, печатать запрещено; узкий штрих тоньше 0,33 мм, EAN-13 ниже 22,85 мм, DataMatrix меньше 22 мм или ближе 5 мм к штрихкоду — предупреждения.
Подробности шага
Подсказка. На этикетке 58 × 40 мм штрихкод рядом с DataMatrix 22 мм не помещается в размер по ГОСТ, и линтер об этом предупредит. Нужна полная норма — берите раскладку «ГОСТ 58 × 60».
Печать для склада WB
В разделе «Печать для склада WB» выберите товар и размер и укажите количество. Сервис спишет коды нужного GTIN в порядке поступления и соберёт PDF со страницами ровно 58 × 40 мм. Каждый DataMatrix в файле перед выдачей распознаётся обратно и сверяется с кодом. Если кодов не хватает, печать не начнётся — сервис назовёт GTIN и нехватку.
Подробности шага
Подсказка. В диалоге печати браузера — масштаб 100 % и поля «нет», в драйвере принтера — сглаживание выключено. Второй экземпляр этикетки печатается с тем же кодом и склад не расходует.
Сборка поставки FBS
Новые сборочные задания сервис забирает из Wildberries сам: вебхуков для FBS у WB нет, поэтому это регулярный опрос. Создайте поставку — сервис заранее проверит, что задания можно собрать вместе. Затем выделите коды и напечатайте: на каждое задание этикетка, при необходимости с копией, и стикер WB — отдельными страницами 58 × 40 мм в одном PDF.
Подробности шага
Подсказка. Стикер WB печатается из файла, который отдал WB, без перерисовки. Этикетку с баркодом товара не клейте вплотную к стикеру заказа: сканер на складе может считать не тот код.
Привязка КИЗ и передача в доставку
Если токен кабинета с правом записи — отправьте КИЗ по API: сервис закрепит коды за заданиями и перечитает результат из WB. Если только чтение — скачайте заполненный Excel-шаблон WB и загрузите его в личном кабинете WB. Когда Wildberries принял все КИЗ, поставку можно передать в доставку и получить её QR-код.
Подробности шага
Подсказка. Если WB отклонил код, сервис покажет задание и причину отказа на экране проблем поставки — например, код не в обороте или без разделителя GS.
Документы оборота в ГИС МТ
Готовится к включениюДо тестирования и включения интеграции документы ввода в оборот, вывода при дистанционной продаже и возврата оформляйте в личном кабинете «Честного ЗНАКа». Сервис не отправляет и не подписывает такие документы автоматически.
Подробности шага
Подсказка. Порядок нарушать нельзя: ввести в оборот → передать КИЗ в Wildberries → отгрузить → покупатель выкупил → вывести из оборота. Код, выведенный раньше отгрузки, WB отклонит. Для вывода из оборота в личном кабинете «Честного ЗНАКа» должно быть заведено место осуществления деятельности.
Типичные ошибки
На чём спотыкаются чаще всего
Каждая из этих ошибок стоит партии этикеток или поставки, которую Wildberries не принял.
Код не введён в оборот
Что происходит. Wildberries проверяет статус каждого КИЗ и не принимает поставку, если код не в обороте. Узнать об этом при передаче в доставку, когда этикетки уже наклеены, — самый дорогой вариант.
Как избежать. Вводите коды в оборот до отгрузки и проверяйте статусы в личном кабинете ГИС МТ. Сервис пока не выполняет автоматическую проверку статуса перед сборкой поставки.
Потерян разделитель GS
Что происходит. В коде лёгкой промышленности 85 символов (у обуви — 129), среди них два невидимых символа GS. Excel, мессенджеры и сканер в режиме клавиатуры теряют их или заменяют пробелом — Wildberries отклоняет такой КИЗ.
Как избежать. Загружайте исходные файлы из личного кабинета, не пересохраняя их. Сервис восстанавливает GS только там, где это однозначно, остальное отклоняет, а его Excel-шаблон для WB разделители сохраняет.
Слишком маленький DataMatrix
Что происходит. Печать «по размеру страницы» незаметно уменьшает код, а модуль тоньше трёх точек принтера не читается терминалом сбора данных.
Как избежать. Масштаб — 100 %. Wildberries рекомендует DataMatrix не меньше 22 мм; слишком мелкий для вашего принтера код сервис печатать не даст.
Сглаживание в драйвере принтера
Что происходит. Сглаживание (Image / Graphic Smoothing) размывает границы модулей, и сканер читает их неоднозначно.
Как избежать. Выключите его в свойствах принтера и проверьте снова после обновления драйвера — настройки иногда сбрасываются на заводские.
Перерисованный стикер WB
Что происходит. Значение штрихкода в ответе WB не документировано. Стикер, собранный заново из номера задания, может не прочитаться на складе.
Как избежать. Печатайте стикер из файла, который отдаёт Wildberries, — сервис делает именно так.
Баркод товара вплотную к стикеру заказа
Что происходит. Сканер склада считывает коды по зоне упаковки и может захватить не тот: опознать заказ по баркоду товара или наоборот.
Как избежать. Клейте этикетку и стикер WB с видимым промежутком. Сервис печатает их отдельными страницами именно поэтому.
Вывод из оборота до отгрузки
Что происходит. Код в статусе «выведен из оборота» Wildberries не примет — поставка не закроется.
Как избежать. Выводите из оборота только после выкупа товара покупателем, в пределах трёх рабочих дней.
Персональный токен Wildberries
Что происходит. Правила WB запрещают передавать персональный токен облачному сервису; нарушение грозит блокировкой доступа к API самого продавца.
Как избежать. Создайте Базовый токен с категориями «Маркетплейс», «Контент» и «Аналитика» — персональный можно оставить для своих задач.
Истёк токен Wildberries
Что происходит. Токен действует 180 дней и не продлевается. После этого WB отклоняет все запросы, и кабинет перестаёт работать.
Как избежать. Когда сервис предупредит об истечении — за 30 дней, — создайте новый токен с теми же категориями и замените его в карточке кабинета: данные кабинета сохранятся.
Сертификат с ролью «Сотрудник»
Что происходит. С ним можно войти в личный кабинет, но подать документ оборота нельзя: ЦРПТ отвечает «403 Отсутствует доступ к ресурсу», и на поломку подписи это не похоже.
Как избежать. Используйте сертификат руководителя организации или сотрудника с машиночитаемой доверенностью, заведённой в личном кабинете «Честного ЗНАКа».
Поддержка
Остались вопросы?
Отвечаем в течение рабочего дня в будни.
- support@markirum.ru
- +7 993 164-34-13
- понедельник–пятница, 10:00–19:00 (МСК)