УПД в Честный знак после поставки WB за 30 секунд

У меня на Wildberries продаётся пилинг для кожи головы — маркированный товар. После каждой FBW-поставки я обязан передать Честному знаку коды маркировки (КИЗы), выписав УПД на ООО «РВБ». Срок — три рабочих дня. Опоздал — штраф и возможная блокировка кодов.

На бумаге всё звучит просто: скачать акт, создать черновик УПД, прикрепить КИЗы, подписать. На практике каждая подача — это 20–30 минут кликанья по разным вкладкам, ручной правки CSV в Excel, переписывания реквизитов в форму ЭДО. При отправке 5–10 поставок в неделю — полноценные полдня работы только на бумажки.

Меня это достало, и я сделал себе инструмент. Потом подумал: другим селлерам, наверное, тоже больно — выложил его бесплатно. Ниже расскажу как он устроен и сколько реального времени экономит.

Видео-инструкция: 6 минут, весь цикл

Записал короткий ролик, где прохожу путь от создания WB API-токена до подписанного УПД в Честном знаке. Показано всё на реальном экране, без монтажа.

Таймкоды по шагам: 1:12 — создание API-токена WB, 1:50 — загрузка списка поставок, 2:06 — где взять ID абонента ЭДО Лайт, 2:38 — генерация XML, 3:18 — загрузка в Честный знак, 4:36 — подпись и отправка.

Боль селлера с маркировкой

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

На каждую единицу товара нанесён уникальный КИЗ (код идентификации). В типовой поставке моего пилинга — сто кодов. У одежды, детских игрушек или косметики в масс-маркете бывает по тысяче и больше. И все эти коды нужно «переуступить» Wildberries как новому владельцу товара. Форма переуступки — УПД с приложением полного списка КИЗов.

Забыл подать — штраф по статье 15.12 КоАП до 300 000 ₽ плюс риск, что коды заблокируют и товар на складе превратится в тыкву. Неправильно заполнил — черновик не принимается, приходится переделывать. Налоговая и ЭДО очень строги к формату: один лишний пробел в адресе и документ отклонён.

Как это делают руками сегодня

Если ничего не автоматизировать, флоу выглядит так:

1. Заходим в ЛК Wildberries, открываем раздел «Документы», находим нужную поставку FBW.
2. Скачиваем акт приёмки в формате xlsx. Файл приходит в ZIP-архиве вместе с подписью и МЧД.
3. Скачиваем CSV-шаблон для Честного знака — отдельной кнопкой, на той же странице. Там КИЗы уже проставлены, но наименование товара и колонка НДС пустые.
4. Открываем CSV в Excel и вручную в каждой строке вписываем название товара и «0» (для «без НДС»). На 100 строках это 10 минут кликанья, на 1000 — час.
5. Идём в ЭДО Лайт (markirovka.crpt.ru), создаём черновик УПД.
6. Заполняем реквизиты: ИНН ООО «РВБ» (9714053621), нужный КПП склада, полный адрес (у каждого склада свой), реквизиты подписанта — ФИО, должность.
7. Загружаем CSV, проверяем что все 100 кодов подтянулись.
8. Подписываем УКЭП и отправляем.

Между 2 и 7 шагом реально уходит 20–30 минут. Самое болезненное — ручная правка CSV и ручной ввод адреса склада: они у Wildberries разные, а по памяти никто их не помнит.

30 секунд вместо 30 минут

На странице /tools/wb-chestny-znak/ остаётся два поля:

1. WB API-токен (scope «Поставки» + «Документы», только чтение). Создаётся в ЛК WB за 30 секунд.
2. ID абонента ЭДО Лайт вида 2LT-XXXXXXXXXX — копируется из профиля Честного знака markirovka.crpt.ru/profile/edo.

Дальше один раз вставили — система запомнила, и больше не спрашивает. Выбираете поставку из списка, жмёте «Сгенерировать XML» — через 3–5 секунд скачивается файл с именем по регламенту ФНС, например:

ON_NSCHFDOPPR_2BM-9714053621-771401001-202407220901086561013_2LT-11004142433_20260424_a1b2c3...xml

Заходите в ЭДО Лайт, жмёте «Загрузить УПД», выбираете этот файл — черновик открывается со всеми уже заполненными полями: контрагент ООО «РВБ», адрес склада, товар, количество, 100+ кодов маркировки, основание (акт приёмки). Остаётся подписать УКЭП и нажать «Отправить».

С секундомером: от нажатия «Сгенерировать XML» до подписи УКЭП — 30–40 секунд.

Что под капотом

Инструмент дергает три API и делает всю работу за вас. Никаких облаков и сторонних сервисов — обычный PHP на том же хостинге, что и сайт.

1. Список поставок — Wildberries Supplies API

Endpoint supplies-api.wildberries.ru/api/v1/supplies возвращает ваши поставки FBW за последние 60 дней. Мы фильтруем завершённые (отгруженные) и показываем списком с номером, датой, складом.

2. Скачивание акта — Wildberries Documents API

По выбранной поставке дёргаем documents-api.wildberries.ru/api/v1/documents/download?serviceName=act-income-<номер>. WB присылает ZIP-архив с xlsx-актом, электронной подписью и МЧД — мы распаковываем, берём только xlsx.

3. Парсинг xlsx

Собственный мини-парсер на ZipArchive + SimpleXML (xlsx это просто ZIP с XML-файлами). Без тяжёлых библиотек. Вытаскиваем: ИНН продавца, наименование товара, список КИЗов из таблицы.

4. Реквизиты юрлица — ЕГРЮЛ через DaData

Вот это самая вкусная часть. ИНН у нас уже есть — мы отправляем его в suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party и получаем все реквизиты: название, КПП, полный адрес по полям (индекс/регион/город/улица/дом/корпус), ФИО и должность директора. Всё — прямо из официального источника ФНС.

Раньше селлер сам вписывал 16 полей — имя организации, КПП, индекс, регион, район, город, улицу, дом, корпус, помещение, фамилию подписанта, имя, отчество, должность… Теперь — ноль полей. Данные подтягиваются автоматически по ИНН из вашего акта.

5. Сборка XML формата ФНС 5.03

Собираем XML-файл по приказу ЕД-7-26/970@ (формат УПД для ЭДО между юрлицами): заголовок, сведения о счёт-фактуре, продавце, покупателе (ООО «РВБ», Коледино), таблица товара, 100+ блоков <КИЗ>, основание передачи, подписант.

Кодировка — windows-1251 (требование ФНС для документов с кириллицей). Все теги на русском — <СвПрод>, <ТаблСчФакт>, <НомСредИдентТов>. Имя файла собирается по регламенту и должно совпадать с внутренним атрибутом ИдФайл, иначе ЭДО Лайт отклонит импорт.

6. Скачивание

Отдаём XML с правильным Content-Disposition: filename=... — браузер сохраняет файл с нужным именем.

Все промежуточные данные (акт xlsx, реквизиты ЕГРЮЛ) кешируются на сутки по seller-ID. Если сегодня уже сгенерировали по этой поставке — повторная генерация не делает ни одного запроса к WB, ни к DaData, выдаётся мгновенно.

Сколько это реально экономит

При 10 поставках в неделю — экономия 4+ часов в неделю. За год набегает около 200 часов, или месяц рабочего времени. При ставке помощника 200 ₽/час это 40 000 ₽ в год только на одной операции.

Плюс снимается риск ошибки: адрес склада РВБ и ФИО директора больше нельзя неправильно вписать — они подтягиваются из ЕГРЮЛ и из захардкоженного справочника складов.

Безопасно ли вводить токен WB

Токен проходит через наш сервер только на момент запроса к WB API и нигде не сохраняется — ни в логах, ни в файлах, ни в базе. Тем не менее:

• Создавайте токен с минимальным scope: только Поставки и Документы.
• Тип — Только чтение. Без прав на запись максимум что кто-то может — посмотреть ваши акты, не навредить.
• После работы удалите токен в ЛК WB (одна кнопка).

Реквизиты юрлица (имя, адрес, ФИО директора), которые подтягивает DaData — публичные данные из ЕГРЮЛ, доступные по любому ИНН. Мы ничего скрытого не вытаскиваем.

Что в следующих версиях

Текущая версия (v1.5) закрывает 99% флоу. Остался один клик — загрузка XML в ЭДО Лайт и нажатие «Подписать». В следующих версиях планирую:

• Автоподача через True API Честного знака. Через CryptoPro Browser Plug-in селлер подписывает прямо на нашей странице, и XML уходит в ЭДО без пересохранения файла.
• Справочник всех складов РВБ. Сейчас работает Коледино (самый популярный), постепенно добавляются Электросталь, Подольск, Казань, Тула, Невинномысск и остальные.
• Multi-SKU поставки. Сейчас поддерживается только один товар в поставке — для мульти-SKU пока надо делать отдельный XML на каждую позицию.
• Ozon. У Ozon очень похожая схема — скоро появится соседний инструмент.

Если вы селлер WB с маркированным товаром — возьмите инструмент, прогоните пару поставок. Что сломалось или чего не хватает — напишите, доправлю.