Как провести Wildberries в 1С: подключение и настройка обмена

Интеграция Wildberries с 1С сводится к обмену данными через официальный API маркетплейса: в 1С загружаются заказы, поставки, остатки и отчёты о продажах, а обратно передаются цены и складские остатки. Прямого штатного механизма в типовых конфигурациях нет — обмен реализуется через готовые модули интеграции, внешние обработки или собственную разработку на базе HTTP-запросов к API.

Перед началом работы определите, какие данные вам нужны в 1С. Минимальный набор для торговой компании — это заказы (для резервирования и отгрузки), отчёт о реализации (для учёта выручки и комиссии) и остатки (для синхронизации склада). Полный контур включает также поставки, возвраты, штрафы, хранение и детализацию выплат.

Дальнейшие шаги зависят от вашей конфигурации: для 1С:Управление торговлей 11 и ERP чаще всего ставят готовые модули от маркетплейса или сторонних разработчиков, для самописных и сильно доработанных баз пишут собственный обмен. Ниже разобраны оба пути и контрольные точки, по которым можно убедиться, что интеграция работает корректно.

Подготовка: токен API и доступы в личном кабинете

Первый шаг — получение API-токена. В личном кабинете продавца Wildberries откройте раздел «Настройки» → «Доступ к API» и создайте новый токен. При создании выберите нужный набор прав: статистика, заказы, склады, цены и скидки, продвижение. Для полноценной интеграции обычно нужен токен с максимальным набором разрешений, но для тестового обмена достаточно прав на чтение.

Сохраните токен в надёжном месте: он показывается один раз. Храните его в 1С в защищённом хранилище (в типовых конфигурациях — через механизм безопасного хранения паролей), а не в открытом виде в коде обработки. Токен даёт полный доступ к данным магазина, и его утечка означает, что посторонний сможет менять цены и остатки.

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

Выбор способа интеграции с 1С

Существует три рабочих подхода. Первый — готовый модуль интеграции: его устанавливают как расширение конфигурации или внешнюю обработку, он уже содержит типовые сценарии (заказы, отчёты, остатки, цены) и не требует программирования. Второй — посредник в виде сервиса-коннектора, который сам забирает данные из Wildberries и отдаёт их в 1С через обмен файлами или HTTP. Третий — собственная разработка: вызываете методы API напрямую из кода 1С.

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

Установка и базовая настройка модуля обмена

Модуль интеграции устанавливается как расширение конфигурации через «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения» либо поставляется внешней обработкой. Перед установкой сделайте резервную копию базы и проверьте совместимость модуля с вашей версией конфигурации и платформы — несовпадение версий платформы 1С частая причина отказа обмена.

После установки откройте настройки модуля и укажите: токен API, организацию, склад отгрузки, тип цен для передачи на маркетплейс и расписание регламентного обмена. Отдельно настройте соответствие номенклатуры: каждый артикул (SKU) Wildberries должен быть связан с позицией номенклатуры 1С, иначе заказы будут падать в ошибки сопоставления.

1. 1
   Создайте токен API в личном кабинете Wildberries с нужными правами
2. 2
   Сделайте резервную копию базы 1С
3. 3
   Установите модуль интеграции (расширение или обработку)
4. 4
   Введите токен и укажите организацию, склад и тип цен
5. 5
   Заполните соответствие артикулов WB и номенклатуры 1С
6. 6
   Запустите тестовую загрузку заказов за 1–2 дня
7. 7
   Сверьте результат с личным кабинетом и включите регламентный обмен

Расписание обмена выбирайте исходя из объёма продаж: при десятках заказов в день достаточно загрузки раз в 1–2 часа, при сотнях — каждые 10–15 минут. Учитывайте, что API Wildberries ограничивает частоту запросов, и слишком агрессивное расписание приведёт к ошибкам превышения лимитов.

Загрузка заказов и отчётов о продажах

Заказы (сборочные задания) загружаются из API и создают в 1С документы «Заказ клиента» или специализированные документы модуля. По ним резервируется товар и формируется отгрузка. Важно определиться со схемой учёта: при FBO товар уже на складе маркетплейса, и в 1С отражается перемещение на склад Wildberries поставкой, а продажа фиксируется по отчёту о реализации; при FBS/DBS отгрузка идёт с вашего склада по каждому заказу.

Отчёт о реализации (детализированный отчёт о продажах) — ключевой документ для учёта выручки. Он приходит еженедельно и содержит строки продаж, возвратов, логистики, комиссии, штрафов и хранения. В 1С на его основании создаётся «Отчёт комиссионера» или «Реализация товаров и услуг» — зависит от выбранной схемы договора с маркетплейсом.

Обратите внимание на возвраты и выкупы: в отчёте WB одна строка продажи может сопровождаться строкой возврата, а невыкупленный товар возвращается на склад. Модуль должен корректно создавать документы возврата, иначе остатки и выручка в 1С разойдутся с фактическими.

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

Передача остатков нужна при схемах FBS и DBS: маркетплейс должен знать, сколько товара доступно на вашем складе, чтобы не допустить продажи отсутствующих позиций. В настройках модуля укажите склад-источник и правило расчёта свободного остатка (обычно: остаток минус резервы минус страховой запас). Обновление остатков настраивается отдельным регламентным заданием с коротким интервалом.

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

Типичные ошибки и их устранение

Самая частая проблема — ошибки авторизации (код 401): токен просрочен, удалён или создан без нужных прав. Лечится созданием нового токена с полным набором разрешений и обновлением его в настройках модуля. Вторая по частоте — ошибки сопоставления номенклатуры: новый артикул появился на WB, но не связан с позицией 1С. Настройте регламентную проверку несопоставленных артикулов, чтобы узнавать о проблеме до сбоя обмена.

Ошибки превышения лимитов запросов (код 429) возникают при слишком частом опросе API или параллельной работе нескольких обменов с одним токеном. Увеличьте интервал регламентных заданий и убедитесь, что токен не используется одновременно в модуле, внешней обработке и стороннем сервисе.

Собственная разработка: основы обмена через HTTP

Если готовые модули не подходят, обмен пишется напрямую через HTTPСоединение. Базовый принцип: формируете GET- или POST-запрос к нужному методу API, передаёте токен в заголовке Authorization, получаете JSON и разбираете его штатным механизмом ЧтениеJSON.

Соединение = Новый HTTPСоединение("statistics-api.wildberries.ru", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/api/v1/supplier/incomes?dateFrom=2026-01-01");
Запрос.Заголовки.Вставить("Authorization", Токен);
Ответ = Соединение.Получить(Запрос);
Если Ответ.КодСостояния = 200 Тогда
    Чтение = Новый ЧтениеJSON;
    Чтение.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
    Данные = ПрочитатьJSON(Чтение);
КонецЕсли;

При самостоятельной разработке обязательно предусмотрите: обработку кодов ответов (401, 429, 500), повторные попытки с паузой при лимитах, журналирование каждого обмена и защиту от дублирования документов при повторной загрузке. API Wildberries периодически меняется — заложите в архитектуру возможность быстро обновлять адреса методов и структуры данных.

Часто задаваемые вопросы