Обмен с Wildberries в 1С: от токена API до загрузки заказов и УПД

Обмен с Wildberries в 1С настраивают в конфигурациях с подсистемой работы с маркетплейсами — «Управление торговлей» 11.5, «Управление нашей фирмой», «Розница» и ERP. Связка строится на токене API, который продавец создаёт в личном кабинете WB и вписывает в карточку подключения в 1С. После этого программа сама выгружает товары, забирает заказы и остатки, а по проданному товару формирует документы реализации.

Голой «Бухгалтерии предприятия» для прямого обмена с Wildberries недостаточно: в неё данные обычно переносят уже из торговой базы или загружают отчёт комиссионера. Поэтому по умолчанию речь о торговой конфигурации с включённой функцией маркетплейсов. Ниже — порядок от первого токена до сверки продаж, с местами, где чаще всего всё ломается.

Что понадобится до начала обмена

Wildberries работает по агентской схеме: площадка продаёт товар продавца и удерживает комиссию. Юридически это ближе всего к договору комиссии (глава 51 ГК РФ), и это определяет, какими документами закрывается продажа. Держите это в голове — к учёту вернёмся в разделе про УПД.

Перед настройкой определитесь с моделью работы, от неё зависит всё остальное:

• 🏭 FBW (склад Wildberries) — товар заранее отгружается на склад маркетплейса, оттуда и уходит покупателю. 1С отвечает за поставки и за учёт проданного.
• 🚚 FBS (склад продавца) — товар лежит у вас, по заказу вы его собираете и передаёте в доставку WB. Здесь 1С ещё и управляет сборкой заказов.
• 🤝 DBS/C&C — доставка силами продавца или самовывоз; встречается реже.

Минимальный набор на старте:

• активный личный кабинет продавца на WB с заполненными карточками товаров;
• торговая конфигурация 1С актуального релиза (функция маркетплейсов в старых релизах УТ 11 отсутствует — нужен номер релиза не ниже 11.5);
• права администратора в базе 1С, чтобы включить функциональную опцию и завести подключение;
• решённый вопрос с маркировкой, если продаёте одежду, обувь, парфюм или другой подлежащий маркировке товар.

Как получить токен API в кабинете Wildberries

Обмен работает не по логину и паролю от кабинета, а по токену — длинной строке, которую продавец генерирует сам. Один токен даёт доступ только к своей группе методов, поэтому для полноценного обмена их нужно несколько.

Порядок в личном кабинете WB такой:

1. Войдите в кабинет продавца на портале Wildberries.
2. Откройте профиль продавца и перейдите в раздел настроек доступа к API (в кабинете он вынесен в отдельный пункт настроек профиля).
3. Нажмите создание нового токена.
4. Отметьте нужные категории доступа — это ключевой момент. Для обмена с 1С обычно требуются: «Контент» (карточки и номенклатура), «Маркетплейс» (заказы FBS), «Статистика» (продажи и остатки), «Цены и скидки».
5. Для безопасного режима не включайте флаг «только на чтение», если планируете из 1С менять цены или собирать заказы, — иначе эти операции площадка отклонит.
6. Скопируйте токен сразу: после закрытия окна WB показывает его только частично, и восстановить строку нельзя — придётся создавать заново.

Создавайте отдельный токен под 1С, а не общий «на всё». Тогда при проблеме вы отзываете только его, не ломая другие интеграции.

Настройка подключения к маркетплейсу в 1С

Сначала включается сама возможность обмена. В торговой конфигурации это функциональная опция в разделе администрирования — блок интеграций и обмена с маркетплейсами (в УТ 11.5 он в разделе НСИ и администрирование, название пункта в разных релизах чуть отличается). Поставьте флаг использования обмена с маркетплейсами и сохраните — после этого в интерфейсе появятся команды для работы с площадками.

Дальше заводится подключение (учётная запись обмена):

1. Откройте список настроек обмена с маркетплейсами.
2. Создайте новое подключение, в типе площадки выберите Wildberries.
3. Вставьте токен (или несколько токенов по категориям, если форма их разделяет) в соответствующие поля.
4. Укажите вашу организацию, склад, с которого идут отгрузки, и тип цен, который синхронизируется с ценами WB.
5. Выберите модель — FBW или FBS; от неё зависит, какие документы программа будет создавать.
6. Нажмите проверку соединения. Зелёный ответ означает, что токен принят и права хватает.

Сразу задайте расписание обмена — регламентное задание, которое будет забирать заказы и обновлять остатки без ручного запуска. Для FBS интервал держат коротким (например, раз в 10–15 минут), чтобы не терять новые заказы; для FBW частый опрос не нужен.

Выгрузка номенклатуры и сопоставление товаров

Карточки товаров на Wildberries обычно уже созданы в кабинете продавца. Задача обмена — не создать их заново, а связать товар на WB с номенклатурой в 1С, чтобы заказы попадали на правильную позицию, а остатки считались корректно.

Связка идёт по артикулу. У WB два идентификатора: артикул продавца (его задаёте вы) и артикул WB (номенклатурный код площадки). Надёжнее всего сопоставление по вашему артикулу продавца — он совпадает с кодом или артикулом в карточке 1С.

Порядок первой загрузки:

1. Запустите загрузку товаров из кабинета WB в обработке обмена.
2. Программа покажет список карточек WB и предложит сопоставить их с номенклатурой 1С.
3. Совпавшие по артикулу или штрихкоду свяжутся автоматически; остальные сопоставьте вручную или создайте по ним новые позиции номенклатуры.
4. Для товаров с размерами проверьте, что каждый размер лёг на свою характеристику, — иначе остатки по размерам «перемешаются».

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

Остатки и цены — две встречные дороги. Остатки по модели FBS 1С отдаёт на площадку: сколько товара реально доступно на вашем складе, столько WB и показывает к заказу. По модели FBW остатками на складе маркетплейса управляет сам WB, а 1С эти цифры получает для контроля и планирования поставок.

Что настроить по остаткам:

• для FBS — какой склад (или группа складов) считается источником доступного остатка;
• резерв под уже принятые, но не собранные заказы, чтобы не продать один товар дважды;
• периодичность выгрузки: при редком обновлении возможны продажи «в минус», когда товар на WB ещё висит, а на складе его уже нет.

Цены синхронизируются через выбранный в подключении тип цен. Поменяли цену в 1С — она уходит на WB очередным обменом. Важно помнить про механику площадки:

• на Wildberries итоговая цена для покупателя = ваша цена минус скидки продавца и акции площадки;
• если вы управляете ценой из 1С, задавайте базовую цену до скидок, а размер скидки держите согласованным с акциями WB;
• резкое снижение цены между обменами WB может воспринять как «слишком частое изменение» и ограничить — меняйте цены плановыми шагами.

Загрузка заказов и формирование документов реализации

По модели FBS заказы — главная причина, ради которой настраивают обмен. Регламентное задание забирает новые заказы с WB и создаёт в 1С документ заказа. Дальше цикл сборки:

1. Новый заказ приходит в 1С в статусе «новый».
2. Менеджер подтверждает заказ и собирает товар; 1С списывает его с остатка (в резерв/в отгрузку).
3. По собранным заказам формируется задание на поставку в сортировочный центр или на пункт приёма WB.
4. После передачи заказ переходит в статус доставки, которой занимается площадка.

По модели FBW отдельных заказов на сборку нет — товар уже на складе WB. В 1С приходят данные о продажах из отчёта площадки, по ним формируется реализация.

Теперь про документы и учёт. Поскольку WB — комиссионер, по итогам периода площадка предоставляет отчёт о продажах (отчёт комиссионера) и удерживает комиссию, логистику, хранение. В 1С на основании этих данных отражают:

• реализацию проданного через маркетплейс товара;
• вознаграждение комиссионера и прочие удержания WB как затраты;
• взаиморасчёты: WB перечисляет выручку за вычетом удержаний.

УПД здесь используется в двух ролях, не путайте их:

• УПД на отгрузку на склад WB (для FBW) — передача товара комиссионеру; это ещё не реализация, право собственности сохраняется за продавцом.
• реализация конечному покупателю — происходит в момент продажи на площадке; именно она формирует выручку и, если продавец на ОСНО, обязательства по НДС (глава 21 НК РФ).

Передача кодов маркировки в «Честный ЗНАК»

Если торгуете маркированным товаром — одеждой, обувью, парфюмерией, шинами и прочими товарными группами из перечня, — обмен с WB связывается с системой «Честный ЗНАК» (ГИС МТ). Площадка сама выводит коды из оборота при продаже, но коды к ней должны прийти от продавца.

Как это работает по моделям:

• FBW: коды маркировки передаются вместе с отгрузкой товара на склад WB. В 1С при формировании поставки к каждой единице подбирается её код маркировки, и эти коды уходят на площадку.
• FBS: код маркировки указывается при сборке заказа — конкретный экземпляр с конкретным кодом уезжает конкретному покупателю.

Порядок в 1С:

1. Убедитесь, что в базе включена работа с маркировкой и настроен обмен с «Честным ЗНАКом» (реквизиты участника оборота, подключённый оператор ЭДО).
2. Коды маркировки должны быть в базе — приняты от поставщика по УПД с кодами или введены при собственном вводе в оборот.
3. При отгрузке на WB (FBW) или сборке заказа (FBS) 1С подбирает коды к позициям.
4. После продажи вывод из оборота на стороне WB отражается в вашем личном кабинете ГИС МТ; сверяйте, что по проданному товару коды действительно выбыли.

Контроль обмена и разбор типичных ошибок

Настроенный обмен требует присмотра. Основной инструмент — журнал (протокол) обмена в самой обработке: по каждому сеансу видно, что загружено, а что завершилось ошибкой. Заведите привычку заглядывать туда хотя бы раз в день, а при FBS — чаще.

Что контролировать:

• заказы FBS не зависают в статусе «новый» дольше допустимого времени сборки;
• остатки на WB совпадают с реальными (расхождение — сигнал, что обмен остановился);
• цены после планового изменения доехали до площадки;
• по маркированному товару коды выбывают из оборота.

Частые вопросы