Вводный сабж в WB API

23.01.25

Интеграция - Маркетплейсы

В этой статье выделены основные моменты API Wildberries, которые помогут на начальном этапе разобраться с документацией и понять принципы построения запросов.

Скачать файл

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование Бесплатно
Тестовые и рабочие произвольные запросы WB API
.epf 12,32Kb
11
11 Скачать бесплатно

Если вы уже знакомы с документацией API Ozon, Yandex и др., то, возможно, и API Wildberries (WB) у вас не вызовет затруднений. Не ставлю себе цель описывать очевидные вещи, но конкретно к этому сабжу подтолкнуло несколько комментариев в телеграмме по поводу сложности восприятия справки WB и обработки запросов в 1С. Постарался максимально кратко показать основные моменты, которые помогут быстро разобраться с документацией и понять принцип построения запросов на этой платформе.

 

Основные моменты:
1. Ссылки на документацию:

2. Категории запросов:

Все API-методы выделены в категории. Каждая категория имеет свой домен третьего уровня.

Например:

  • Отчеты:  statistics-api.wildberries.ru
  • Аналитика продавца:  advert-api.wildberries.ru
  • Заказы FBS:  marketplace-api.wildberries.ru

3. Тестовый и рабочий контуры:

  • Рабочий контур:

Рабочий контур предоставляет широкие возможности взаимодействия с реальными данными в рамках API. При необходимости тут можно использовать отдельные токены "только на чтение".

  • Тестовый контур:

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

  • Разница между Рабочим и Тестовым контуром:

Главное различие между песочницей и рабочим контуром — это адрес сервера.

   - Рабочий контур: *-api.wildberries.ru
   - Тестовый контур: *-api-sandbox.wildberries.ru

В документации тестовые запросы выделены в отдельную группу "Песочница", хотя по факту используют те же самые методы, что и рабочие запросы. К сожалению количество методов в песочнице меньше чем в рабочем контуре. Полный их список можно найти здесь: https://dev.wildberries.ru/sandbox

  • Примеры запросов:

    - Рабочий запрос: https://statistics-api.wildberries.ru/api/v1/supplier/stocks?dateFrom=2020-12-01
      (Примечание: этот запрос создаст выборку за любой период указанный в параметре dateFrom)

    - Тестовый запрос: https://statistics-api-sandbox.wildberries.ru/api/v1/supplier/stocks?dateFrom=2024-12-01
      (Примечание: этот тестовый запрос позволяет создавать выборку не более чем за два месяца.)

4. Конструктор запросов:
В справке есть встроенный конструктор запросов: https://dev.wildberries.ru/swagger/analytics

Чтобы полноценно взаимодействовать с ним, нужно ввести токен, который сгенерировали в кабинете продавца и нажать по кнопке "Authoriz". В целом тут все интуитивно понятно, главное при работе с конструктором читайте внимательно описание параметров и комментарии.

 

 

5. Генерация ключей:
Любые ключи (рабочие и тестовые) можно получить в реальном кабинете селлера. Вы можете генерировать токены отдельно для каждой категории или сразу для нескольких, что повышает безопасность. Ссылка на личный кабинет продавца: https://seller.wildberries.ru/supplier-settings/access-to-api.

 

 

6. Формирование запроса в 1С:
Чтобы построить корректный запрос в 1С, нужно добавить в начало токена заголовок авторизации `Bearer `(с пробелом).

 

 

Пример реализации запроса остатков на складе WB в 1С выглядит следующим образом:

 
 Запрос:
 
 Обработка запроса:

Примечание: Добавил файл с примером тестового и рабочего запросов. Собственно весь код в этом спойлере.

7. Полезные ссылки:

Надеюсь, что приведенные примеры и объяснения помогут вам быстрее освоиться с документацией и начать эффективно использовать API Wildberries в своих проектах.  Если у вас есть вопросы, замечания, дополнения или требуется помощь, дайте знать! Или просто тапните по плюсу, если окажется полезным.

Проверено на следующих конфигурациях и релизах:

  • Управление нашей фирмой, редакция 3.0, релизы 3.0.10.178

маркетплейсы вайлдберриз wb wildberries api

См. также

Маркетплейсы Платформа 1С v8.3 1С:Управление нашей фирмой 1.6 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Россия Управленческий учет Платные (руб)

Подключите маркетплейсы Ozon, WB, АлиЭкспресс, ЛаМода и ЯндексМаркет к 1С. Удобное управление заказами, остатками и синхронизация данных из одного окна 1С для УНФ, УТ, КА, ERP. Единый интерфейс работы для всех площадок. Отправка остатков по сопоставленным товарам по расписанию, гибкая настройка отправки.

12415 руб.

23.01.2023    45965    410    203    

184

Загрузка и выгрузка в Excel Маркетплейсы Программист Бухгалтер Пользователь Платформа 1С v8.3 Бухгалтерский учет 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Бухгалтерский учет Управленческий учет Платные (руб)

Реальный помощник, с помощью которого Вы преобразуете необходимые документы для Wildberries, OZON, ЯндексМаркет, Мегамаркет, Aliexpress, Детский мир, МагнитЭкспресс (быв.Казань-Экспресс), Леруа Мерлен, ЭНФАНТА (Акушерство), ЛаМода, Летуаль, Твой дом, Золотое Яблоко в документы "Отчет комиссионера (агента) о продажах" и другие. Работает в 1С:БП 3.0, 1С:БП 3.0 КОРП, 1С:УТ 11, 1С:УНФ, 1С:КА 2, 1С:ERP Управление предприятием. Возможность подключить любые маркетплейсы. Анализ продаж ОZON. 30 дней БЕСПЛАТНОГО пользования!

5400 руб.

12.08.2021    38151    408    68    

174

SALE! 10%

Маркетплейсы Платформа 1С v8.3 1С:Управление нашей фирмой 1.6 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Розничная и сетевая торговля (FMCG) Беларусь Россия Казахстан Бухгалтерский учет Управленческий учет Платные (руб)

Модуль позволяет автоматизировать интеграцию 1С с маркетплейсами Wildberries, Ozon, МегаМаркет и Яндекс.Маркет. В удобном интерфейсе вы можете управлять ценами, остатками и анализировать продажи. Для схемы FBS работает отправка кодов системы “Честный знак” на маркетплейсы. Информация о кодах берется из документа “Реализация товаров и услуг” (для УНФ: “Расходная накладная”). Также добавлен функционал парсинга цен на маркетплейсах и возможность автоматически увеличивать цены при малом остатке товара.

44389 39950 руб.

13.03.2023    11569    37    29    

28
Оставьте свое сообщение