Как настроить обмен 1С:УНФ с Wildberries по шагам

Что даёт связка 1С:УНФ и Wildberries

Связка нужна там, где учёт живёт в 1С, а продажи идут на маркетплейсе. 1С:УНФ редакции 3.0 держит номенклатуру, склады, партии, себестоимость, заказы и деньги. Wildberries держит витрину, заказы покупателей и еженедельный отчёт реализации. Пока системы не связаны, продавец переносит данные руками: выгружает Excel, правит остатки в кабинете, вечером заводит документы за день.

Что реально закрывает обмен:

• Остатки. Свободный остаток склада уходит на Wildberries по расписанию. Это снимает главный риск схемы FBS: продажу товара, которого на полке уже нет.
• Цены. Цена и скидка задаются в 1С видом цен и выгружаются на площадку, а не правятся в двух местах.
• Заказы. Заказы маркетплейса попадают в базу документами «Заказ покупателя». По ним резервируется товар, печатаются этикетки, собирается отгрузка.
• Продажи и деньги. Еженедельный отчёт реализации ложится в документ «Отчёт комиссионера» и закрывает выручку, вознаграждение площадки и возвраты.

Чего связка не делает. Она не превращает управленческий учёт в бухгалтерский: агентскую схему, счета 45 и 76, УПД от площадки всё равно нужно отражать отдельно, и это ближе к 1С:Бухгалтерии. Порядок такой работы разобран в материале о том, как провести отчёты Wildberries в 1С. Она также не заменяет кабинет продавца: карточки, поставки, участие в акциях и реклама остаются в WB Partners.

Важная оговорка про модели продаж. На FBO товар лежит на складе Wildberries, и остаток там формируется поставкой, а не выгрузкой из 1С. Автоматическая передача остатков имеет смысл только для собственных складов продавца, то есть для FBS. Для FBO обмен полезен другим: заказами для статистики и загрузкой отчёта о продажах.

Три способа обмена: файлы, CommerceML и HTTP-сервис

Одного универсального способа нет. В 1С:УНФ сосуществуют три механизма, и они решают разные задачи. Их можно комбинировать: остатки гнать одним каналом, отчёт о продажах загружать файлом.

Способ 1. Штатные шаблоны загрузки файлов. Самый простой и не требующий ни токенов, ни публикации базы наружу. В документе «Отчёт комиссионера» есть загрузка отчёта о продажах Wildberries: файл из кабинета перетаскивается в окно программы, и документ заполняется строками продаж и возвратов. По описанию обновлений эта возможность заявлена начиная с версии 3.0.14, а сам шаблон загрузки позже дополнили колонками «Тип документа (продажа\возврат)» и «Страна происхождения». Если пункта нет, проверьте номер релиза в своей конфигурации. Минус очевиден: это ручная операция раз в неделю, остатки и заказы она не двигает.

Способ 2. Канал продаж и обмен CommerceML. В 1С:УНФ два разных механизма с похожим результатом. Первый: раздел «CRM» и пункт «Каналы продаж», где подключается сам Wildberries по токену. Второй: мастер обмена с сайтом в разделе «CRM» и пункте «Интернет-магазин», который работает по стандарту CommerceML версии 2.05 и выше. Второй вариант применяют, когда между 1С и маркетплейсом стоит промежуточная система: 1С сама по расписанию ходит на адрес обмена, забирает заказы документами «Заказ покупателя» и отдаёт обратно номенклатуру, цены и остатки. Наружу ничего публиковать не нужно, инициатор обмена всегда 1С.

Способ 3. Прямая отправка в HTTP-сервис 1С. Обратная схема: внешняя система сама дёргает опубликованный HTTP-сервис вашей базы и передаёт заказ параметрами запроса. Способ для доработанных конфигураций, где проще написать свой обработчик, чем настраивать CommerceML. Требует доступной снаружи базы: белый IP, публикация на веб-сервере или туннель.

Кроме штатных механизмов есть ещё два пути, о которых честно стоит сказать. Первый: платные модули и расширения от франчайзи и независимых разработчиков, которые добавляют в УНФ загрузку сборочных заданий, статусы и печать этикеток. Второй: обмен через сторонний сервис, который сам держит связь с API маркетплейсов, а в 1С отдаёт данные по CommerceML или по ссылке. По такой схеме работает и раздел «1С» в Sell Profit: расширение внутрь 1С:Предприятия не ставится, заказы уходят в базу штатным обменом или прямым запросом, а товары, остатки и цены приходят обратно.

Шаг 1. Токен Wildberries и категории доступа

Любой автоматический обмен начинается с токена. Он выпускается в кабинете продавца: «Профиль», далее «Настройки», далее «Доступ к API» и кнопка создания нового токена. Токен показывается один раз, скопируйте его сразу и сохраните в надёжном месте.

При создании выбираются две вещи: категории данных и уровень доступа. Категории определяют, к каким разделам API токен пускает. Уровень доступа задаётся переключателем «только чтение» или «чтение и запись». Для обмена с 1С чтения недостаточно: остатки и цены это запись, поэтому токен для канала продаж должен быть с правом записи. Если та же база или сервис только читает статистику, выпускайте для них отдельный токен только на чтение. Подробный разбор с таблицей прав есть в гайде про API-ключ Wildberries.

Два практических момента. Токен имеет ограниченный срок жизни, по информации площадки это 180 дней, а за несколько дней до окончания владельцу профиля приходит уведомление. Заведите напоминание о перевыпуске: молчаливо протухший токен выглядит как «обмен сломался». И выпускайте отдельный токен на каждую систему. Тогда при подозрении на утечку достаточно удалить один токен, а не перенастраивать всё сразу.

Если у вас несколько юридических лиц, у каждого свой кабинет и свой токен. В 1С:УНФ это означает отдельную настройку обмена на каждую организацию, а не один общий ключ на всю базу.

Шаг 2. Подключение канала продаж в 1С:УНФ

Штатное подключение маркетплейса живёт в разделе «CRM», пункт «Каналы продаж». Возможность подключить Wildberries заявлена начиная с версии 1С:УНФ 3.0.13. Если пункта нет или в списке площадок нет Wildberries, проверьте релиз своей конфигурации и обновитесь.

Порядок действий:

1. Откройте «CRM», далее «Каналы продаж», далее «Wildberries» и нажмите «Начать настройку».
2. Подтвердите доступ к сервису «1С:Интернет-поддержка пользователей». Без действующего договора сопровождения мастер дальше не пойдёт, и это частая причина остановки на первом экране.
3. Укажите организацию, от имени которой ведутся продажи на площадке.
4. Вставьте токен, выпущенный на первом шаге, и сохраните настройку.

Что именно умеет типовой канал, стоит проверить заранее. В официальных описаниях для Wildberries названы три вещи: настройка соответствия номенклатуры и складов базы с номенклатурой и складами маркетплейса, выгрузка товарных остатков на площадку и выгрузка цен. Загрузка заказов и сборочных заданий в перечне возможностей типового канала не заявлена. Это не ошибка вашей установки, а граница штатного механизма, и именно из-за неё рынок модулей для 1С такой плотный. Если в вашей конфигурации заказы всё же загружаются, отлично, но планировать работу на этом допущении не стоит: проверьте в своей конфигурации, что именно приходит после первого обмена.

Перед настройкой включите нужные опции программы. Флаги комиссионной торговли находятся в настройках раздела «Продажи», пункт «Ещё больше возможностей». Там же включается сборка заказов, если вы планируете собирать отправления в 1С. Без включённого признака передачи товаров на комиссию документы комиссионной схемы в базе просто не появятся.

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

Шаг 3. Сопоставление складов и номенклатуры по артикулу

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

Склады. Сопоставление идёт парами: склад маркетплейса против склада 1С. У FBS склад продавца создаётся в кабинете WB и получает свой идентификатор, порядок создания разобран в инструкции о том, как создать склад FBS. В 1С ему сопоставляется реальный склад, с которого вы отгружаете. Если складов несколько, а в 1С указан один, остаток уедет не туда. Отдельно решите, какой остаток отдавать: весь или свободный. Если склад один и на нём же лежит товар под опт и под розницу, безопаснее выгружать свободный остаток за вычетом резервов.

Номенклатура. Сопоставление делается по артикулу либо по баркоду. Артикул продавца это ваше поле, и его нужно привести в порядок до обмена, а не после. Рабочие правила:

• Артикул уникален в пределах базы. Два товара с одним артикулом это гарантированная путаница в заказах.
• Регистр и пробелы имеют значение. Артикул «ART-100» и «art 100» для механизма сопоставления разные строки.
• Размеры и цвета на Wildberries это отдельные баркоды внутри карточки. Если в 1С характеристики не ведутся, размерный товар сопоставлять по артикулу нельзя, только по баркоду.
• Товары с одинаковым названием и разной фасовкой разводите артикулом, а не наименованием.

Порядок работы такой: выгрузите карточки с площадки, сопоставьте автоматически по артикулу, а остаток строк разберите руками. Не оставляйте несопоставленные строки «на потом»: по ним обмен либо промолчит, либо создаст дубль номенклатуры. Дубли потом вычищаются тяжело, потому что на них уже висят движения.

Проверьте единицы измерения. Если в 1С товар в упаковках, а на площадке продаётся штуками, остаток уедет с множителем. Это редкая, но дорогая ошибка: витрина показывает десятикратный остаток, заказы приходят, товара нет.

Шаг 4. Настройка расписания обмена

Обмен в 1С:УНФ выполняется регламентными заданиями. Настройка расписания живёт в карточке канала продаж, а общий список заданий в разделе администрирования, пункт обслуживания и регламентных операций.

Разумные интервалы:

• Остатки. Каждые 30 минут или раз в час. Чаще смысла мало: площадка обновляет данные не мгновенно, а частые обращения упираются в лимиты API.
• Цены. Раз в сутки достаточно, если вы не ведёте активный репрайсинг. Ночное окно удобно тем, что не пересекается с пиком заказов.
• Заказы. Каждые 10 или 15 минут, если заказы вообще загружаются вашим способом обмена. Для FBS это разумный компромисс между скоростью сборки и нагрузкой.
• Отчёт о продажах. Раз в неделю вручную или по расписанию после публикации отчёта реализации площадкой.

Отдельно про файловые базы. Регламентные задания в файловом варианте выполняются только при запущенном клиентском сеансе: закрыли 1С вечером, и до утра ничего не обменивается. В клиент-серверном варианте и в облачной версии задания идут сами. Если обмен «работает днём и не работает ночью», причина почти всегда здесь, а не в токене.

Заложите буфер на лимиты API. Wildberries ограничивает частоту обращений по каждому разделу, и при превышении возвращает ошибку. Для обмена это выглядит как пропущенный прогон. Ничего страшного в единичном пропуске нет, но если задание стоит на каждые пять минут по всем складам сразу, пропуски станут постоянными. Лучше реже, но стабильно.

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

Шаг 5. Проверка: как выглядит загруженный «Заказ покупателя»

После первого успешного обмена откройте список заказов покупателей и разберите одну строку целиком. Формальное «обмен завершён без ошибок» ничего не доказывает: документ мог создаться пустым или не с теми реквизитами.

Что проверить в документе:

1. Организация. Та, чей токен использован. При нескольких юрлицах это первое, что уезжает.
2. Контрагент и договор. Покупателем выступает маркетплейс. Договор должен быть тем, по которому вы планируете вести взаиморасчёты, иначе сальдо потом не сойдётся.
3. Номер и дата. В документе должен остаться номер заказа площадки, иначе сверку с кабинетом придётся делать по суммам.
4. Номенклатура. Позиция должна быть вашей, а не свежесозданным дублем с названием из карточки WB. Дубль виден по пустому артикулу и отсутствию остатков.
5. Склад. Тот, с которого вы реально отгружаете отправление.
6. Количество и цена. Цена в заказе это цена продажи покупателю до удержаний площадки, а не то, что придёт на счёт. Вознаграждение и услуги вычитаются позже, в отчёте реализации.

Дальше по документу строится обычная цепочка УНФ: резерв, сборка, расходная накладная. Если вы собираете отправления в 1С, включите опцию сборки заказов в настройках раздела «Продажи». Практическая сторона сборки и передачи отправлений на стороне площадки описана в материале о том, как отгружать заказы ФБС на Wildberries.

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

Шаг 6. Остатки и цены в обратную сторону

Обратное направление это то, ради чего канал продаж в УНФ и делали. Из базы на площадку уходят два потока: остатки и цены.

Остатки. Передаются только по складам продавца, то есть по модели FBS. Остаток на складах Wildberries по модели FBO изменить через обмен нельзя: он формируется приёмкой поставки и уменьшается продажами, площадка управляет им сама. Поэтому в настройке канала важно выбрать правильный склад 1С и правильный склад маркетплейса. Общая картина по всем площадкам и способы её посмотреть разобраны в гайде про остатки на ВБ и Ozon.

Практические правила для остатков:

• Выгружайте свободный остаток, а не физический, если часть товара зарезервирована под другие каналы.
• Держите страховой запас. Если на складе две штуки, а обмен идёт раз в час, безопаснее отдать ноль, чем получить заказ на товар, который уже уехал.
• Нулевые остатки тоже нужно передавать. Молчание по позиции площадка не читает как ноль, и товар останется в продаже.

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

Если вы выгружаете цены из 1С, перестаньте править их в кабинете. Иначе следующий прогон обмена вернёт старое значение, и получится качель: вечером цена одна, утром другая. Решите один раз, где источник истины, и держитесь этого.

Шесть причин, по которым заказы не подтягиваются

Список отсортирован по частоте. Проверяйте по порядку, не перескакивая: восьмой из десяти случаев закрывается на первых трёх пунктах.

1. Токен не тот или протух. Выпущен в другом кабинете, скопирован не полностью, истёк срок, либо создан с правом «только чтение», а обмену нужна запись. Симптом: обмен падает сразу, до первого документа. Лечение: выпустить новый токен с нужными категориями и заменить его в настройке канала.
2. Не отмечена нужная категория доступа. Токен рабочий, но без категории «Маркетплейс» заказы FBS через API не отдаются, а без «Цены и скидки» не уходит прайс. Симптом: часть обмена идёт, часть молчит без внятной ошибки. Лечение: пересоздать токен, отметив недостающие категории.
3. Номенклатура не сопоставлена. Строка заказа не нашла позицию в базе по артикулу или баркоду. Симптом: заказов в базе меньше, чем в кабинете, либо появились товары-дубли без остатков. Лечение: открыть таблицу соответствия и разобрать несопоставленные строки руками.
4. Регламентное задание не выполняется. Файловая база закрыта, задание отключено, или расписание стоит на время, когда сервер выключен. Симптом: обмен работает, когда нажимаешь кнопку вручную, и не работает сам. Лечение: проверить список регламентных заданий и режим работы базы.
5. Выбранный способ обмена в принципе не возит заказы. Типовой канал продаж Wildberries в УНФ заявлен на остатки и цены. Если вы ждёте от него сборочные задания, ждать можно долго. Симптом: остатки уходят, цены уходят, заказов нет вообще ни одного. Лечение: добавить второй механизм, CommerceML или модуль, который загружает заказы.
6. Нет сети до адреса обмена. Актуально для CommerceML и HTTP-сервиса: база за корпоративным файрволом не дотягивается до адреса, либо внешняя система не может достучаться до опубликованной базы. Симптом: журнал обмена пустой или содержит таймауты. Лечение: проверить доступность адреса с той машины, где крутится 1С, и открыть порт.

Отдельно про ложную тревогу. Отменённые покупателем заказы в базу не приходят и приходить не должны. Расхождение на единицы штук между кабинетом и 1С почти всегда объясняется именно этим, а не поломкой обмена.

Чем 1С:УНФ отличается от 1С:Бухгалтерии в задачах селлера

Продавцы часто спорят, что ставить. Спор бессмысленный, потому что конфигурации решают разные задачи, и у многих стоят обе: УНФ для оперативного контура, Бухгалтерия для отчётности.

Практический вывод. Если боль в том, что заказы переносятся руками и остатки на витрине врут, это задача УНФ. Если боль в том, что непонятно, с какой суммы платить налог и как отразить удержания площадки, это задача Бухгалтерии, и начинать надо с агентской схемы и еженедельного отчёта реализации.

Если конфигурация нетиповая или доработана

Типовая УНФ встречается реже, чем кажется. Если базу когда-то дорабатывали под ваш процесс, проверьте три вещи до начала настройки.

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

Доработаны ли документы обмена. Добавленные реквизиты в «Заказе покупателя» типовой обмен не заполнит. Если ваш процесс без них не едет, нужен либо обработчик заполнения в расширении, либо приём заказа собственным HTTP-сервисом, где вы сами решаете, что куда положить.

Где вы хотите держать источник истины. Если цены живут в 1С, площадка становится приёмником и править цену в кабинете нельзя. Если наоборот, отключите выгрузку цен, иначе обмен будет их перезатирать.

Порядок действий для доработанной базы выглядит так:

1. Сделайте копию базы и настраивайте обмен сначала на ней. Первый прогон почти всегда даёт мусорные документы.
2. Опишите на бумаге, что и в какую сторону должно ходить. Половина проблем внедрения это несогласованные ожидания, а не техника.
3. Начните с одного направления. Сначала остатки, потом цены, потом заказы. Так понятно, что именно сломалось.
4. Проверяйте после каждого обновления релиза. Расширения и внешние обработки переживают не все обновления, и молчаливая поломка обмена обнаруживается по расхождению остатков.

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

Короткие ответы по теме

• Как проверить код маркировки перед продажей и поставкой
• Где посмотреть продажи на Озон продавцу: все места в кабинете
• Где посмотреть продажи на ВБ: отчёты кабинета продавца
• Где посмотреть сумму выкупа на ВБ: продавцу и покупателю

Все короткие ответы — вопросы продавцов.