Интеграция с Wildberries по API

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

Карточки, варианты и идентификаторы

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

Обновление контента отделяем от цен и остатков. Фотографии, описание и характеристики имеют собственные проверки. Принятый запрос ещё не означает готовность карточки к продаже: сохраняем результат обработки и причины отказа по конкретным товарам. Для PIM фиксируем, кто вправе менять описание в кабинете и как учитывать ручные изменения.

Цены и доступный остаток

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

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

Заказы и исполнение

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

Интеграцию Wildberries через API проверяем на новом, отменённом и уже обработанном заказе. Идентификатор задания позволяет распознать повтор получения. Запрос, завершившийся таймаутом, сначала сверяем с площадкой: слепой повтор операции может нарушить процесс исполнения.

Возвраты, отчёты и финансовая сверка

Оперативные заказы, продажи, возвраты и финансовые отчёты имеют разное назначение и могут поступать в разное время. Отдельно определяем источник каждого показателя и период, к которому он относится. Выручка по заказам не равна сумме перечисления продавцу: в сверке учитываются применимые удержания и корректировки.

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

Надёжность и передача в эксплуатацию

Разделяем доступы по нужным категориям API, сохраняем прогресс загрузки и повторяем только недоставленные события. Лимиты, размеры пакетов и интервалы берём из актуальной документации, а не закладываем навсегда в код. Журнал показывает товар или заказ, действие, время и результат без публикации токена.

Приёмка проходит на контрольном ассортименте: новая карточка, ошибка характеристики, смена цены, последний остаток, заказ, отмена и восстановление после остановки. Для оценки нужны схема продаж, перечень систем, число складов и список ручных операций. Результат — работающие маршруты и возможность объяснить состояние каждой передачи.

Вопросы перед началом работ

Можно подключить несколько кабинетов продавца?

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

Можно использовать готовый модуль вместо разработки?

Да. Проверяем, какие операции и схемы продаж он поддерживает, как обрабатывает ошибки и совместим ли с вашей системой. Собственную разработку оставляем для отсутствующих сценариев.

API-запрос принят: товар уже обновился?

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

Можно получать отчёты для расчёта прибыли?

Можно загружать доступные отчётные данные, но методику прибыли нужно определить отдельно: себестоимость, логистика, удержания и корректировки не заменяются одной суммой продаж.

Что делать при изменении WB API?

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