Загрузка сертификатов и деклараций в Wildberries из 1С

Внешняя обработка проставляет номера сертификатов и деклараций из типового учета 1С в карточки Wildberries через Content API и показывает по каждому товару, что именно будет сделано.

Решение рассчитано на 1С:Управление торговлей 11.5, 1С:Комплексная автоматизация 2.5 и 1С:ERP 2.5. Конфигурация не изменяется, расширение не устанавливается. Источник данных - типовой справочник сертификатов номенклатуры и регистр областей действия.

Чем Wildberries отличается от Ozon

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

Идентификаторы характеристик в обработку не зашиты. Состав характеристик у каждого предмета свой, поэтому справочник читается по предмету (/content/v2/object/charcs/{subjectId}), а нужные находятся по названию. Если у предмета поля под документ нет вовсе, строка честно получает "Не отправлять" с указанием предмета, а не молчаливый пропуск.

Что делает обработка

• проверяет токен безопасным запросом чтения и сообщает, сколько карточек в кабинете;
• сохраняет подключение для текущего пользователя базы только по отдельной команде;
• заполняет товары по данным 1С, при необходимости только с положительным остатком;
• сопоставляет артикул 1С с vendorCode карточки точечным запросом, а не обходом каталога;
• показывает номер, который уже стоит в карточке, рядом с номером из 1С;
• различает действия "Записать", "Уже записан", "Не отправлять", "Ошибка";
• приводит номер ЕАЭС к виду реестра, иначе проверка по реестру не пройдет;
• отсекает отметки вместо номеров: "не требуется", "письмо KZ-2533-23", просто "214";
• не дает двум документам одного вида затереть друг друга в одной карточке;
• разбирает отказ, который приезжает внутри успешного ответа;
• ведет журнал с результатом каждого шага и итоговыми счетчиками;
• формирует отдельный табличный документ "Товары без сертификатов" без обращения к кабинету.

Как выглядит рабочий сценарий

1. В кабинете продавца откройте "Настройки - Доступ к API" и создайте токен с категорией "Контент".
2. Вставьте токен, нажмите "Проверить подключение", затем "Сохранить подключение".
3. Нажмите "Заполнить товары". При необходимости включите отбор по положительному остатку.
4. Проверьте таблицу. Колонка "Сейчас в карточке" показывает номер, который стоит у товара сейчас.
5. Оставьте отметку "Отправить" только у нужных строк и выполните тестовый прогон.
6. Снимите тестовый режим и нажмите "Отправить через API". Обработка запросит подтверждение.
7. Проверьте колонку результата и журнал операций.

Что видно до отправки

Строки без артикула, с истекшим документом или с отметкой вместо номера к отправке не предлагаются. Причина выводится рядом с товаром, поэтому исходные данные правятся в 1С до обращения к API.

Номер документа: буквы имеют значение

Номер ЕАЭС набирается двумя алфавитами сразу: "ЕАЭС" и код органа по-русски, код страны латиницей. В базах в этих местах регулярно стоят латинские C и B вместо кириллических С и В, и на глаз строка неотличима. Маркетплейс сверяет номер с государственным реестром, и такая подмена означает непройденную проверку.

Обработка приводит к виду реестра только номера, начинающиеся с "ЕАЭС", и пишет подмену в журнал. Если в карточке лежит тот же документ другим написанием, строка получит "Записать", а не "Уже записан", и написание поправится. Свидетельства о государственной регистрации и отказные письма не трогаются: у них другой формат.

Код 200 еще не значит "принято"

Отказ Wildberries приезжает внутри успешного ответа: поле error со значением true, текст в errorText, подробности по полям в additionalErrors. Обработка это разбирает и показывает причину в строке. Без такой проверки на отклоненную карточку писалось бы "записано".

Кабинет спрашивается точечно

Полный обход карточек - это сотни запросов и минуты ожидания: на кабинете в 18 133 карточки выходит 182 страницы по сотне. Обработка запрашивает карточки по артикулам из таблицы, поиск идет по vendorCode. Для трех товаров это три запроса вместо ста восьмидесяти двух. Обход целиком остается для списка длиннее трехсот артикулов и отмечается в журнале отдельно.

Карточка обновляется целиком

Wildberries принимает на запись весь объект карточки, поэтому обработка берет свежую карточку из кабинета и меняет в ней только характеристики документов. Остальные характеристики переносятся как есть, а в журнал пишется, сколько их было и сколько стало: одинаковые числа означают, что чужое не потерялось.

Карточки перечитываются в момент отправки, а не в момент заполнения таблицы. Иначе правка, сделанная в кабинете между двумя шагами, была бы молча затерта.

Два документа одного вида на один товар

У карточки одно поле под сертификат и одно под декларацию. Если на товар отмечено два сертификата, второй затер бы первый, а строка все равно получила бы "Отправлено" - успех без работы. Такая строка не отправляется и говорит об этом прямо, с указанием номера, который взят в отправку.

Тестовый режим

При открытии формы тестовый режим включен. Обработка читает кабинет, сопоставляет артикулы, проверяет характеристики предмета и строит вердикты, но в Wildberries не уходит ничего. Тестовый прогон не меняет вердикт строки, поэтому сразу после него можно снять режим и отправить те же строки.

Рекомендуемый первый запуск - один товар. После отправки нажмите "Заполнить товары" еще раз: строка должна стать "Уже записан". Это и есть доказательство, что номер в карточке.

Требования к данным

• артикул номенклатуры в 1С должен совпадать с vendorCode карточки;
• сертификат должен быть связан с номенклатурой через типовой механизм области действия;
• у документа должны быть заполнены номер, вид и срок действия;
• нужен токен Wildberries с категорией "Контент";
• Wildberries принимает сертификат соответствия и декларацию о соответствии. Отказное письмо, свидетельство о регистрации и прочее отсекаются на заполнении.

Важные ограничения

• Если под один артикул в кабинете несколько карточек, берется первая.
• Скан документа заводится в кабинете руками: метода передачи файла у Content API нет.
• Самописные справочники сертификатов не поддерживаются, для них нужна адаптация источника данных.
• Юридическую применимость документа к категории обработка не проверяет: она показывает наличие действующего документа в учетной системе.
• Изменения выполняются только в кабинете Wildberries. Данные сертификатов в 1С обработка не переписывает.

Безопасность подключения

Токен передается только на сервер Wildberries, в форме он отображается как пароль. Настройки не сохраняются автоматически: для этого есть отдельная команда. Проверка подключения выполняется запросом чтения и ничего не меняет.

Проверка полного цикла

Маршрут пройден на живом кабинете в 18 133 карточки. Три артикула найдены точечным запросом, у двух номера уже стояли и строки получили "Уже записан", третьему обработка исправила написание номера и записала карточку: ошибок ноль. Карточка в кабинете после этого показала документ со статусом "Проверка пройдена".

Что входит в поставку

• внешняя обработка .epf;
• встроенная HTML-справка по заполнению сертификатов в УТ и работе с кабинетом;
• исходный код обработки открыт.