В этой статье:
- Что такое API ключ Wildberries?
- Как создать интеграции WB в сервисе "Финансист"?
- Когда проходит синхронизация?
- Как запустить синхронизацию вручную?
- Почему в понедельник может не пройти "ручная" выгрузка?

API ключ Wildberries

Ключ API - это уникальный цифровой идентификатор для поставщиков Wildberries, посредством которого осуществляется автоматическая передача данных с сервера Wildberries на сервер Финансист. Мы получаем данные в режиме только для чтения и гарантируем ее конфиденциальность, показывая данные только вам.

Для начала работы с интеграцией необходимо получить токен с тремя активными методами:

1.  Статистика – позволяет загружать данные статистики
2. Контент – требуется для анализа карточек товаров
3. Продвижение – получение данных по рекламе

Как получить ключи API Wildberries:

1. Откройте личный кабинет партнера на сайте Wildberries по адресу seller.wildberries.ru
2. Войдите под главным пользователем аккаунта
3. Кликните по названию юр. лица в правом верхнем углу страницы, затем выберите "Настройки", затем "Доступ к API", затем "Создать новый ключ"
4. Введите произвольное имя ключа
5. Активируйте три метода API: Статистика, Контент, Продвижение
6. Нажмите "Создать токен"
7. Скопируйте значение API ключа (длинную последовательность из букв и цифр), нажав кнопку "Скопировать". Ключ отображается только один раз!
8. Вставьте ранее скопированное значение ключа в поле "Стандартный ключ API" на странице добавления интеграции.

Создание интеграции WB в сервисе "Финансист"

Для создания интеграции нажмите на Название финмодели (1) - Настройки финмодели (2) - Интеграции (3) - Добавить интеграцию (4)

Далее заполните поля интеграции как показано на скриншоте:

1. Укажите название интеграции

2. Выберите в партнёрах "Wildberries"

3. Вставьте сгенерированный ранее API ключ Wildberries.

4. Укажите название юридического лица и контрагента (ООО "ВАЙЛДБЕРРИЗ"). Если они ранее не были внесены в вашей финмодели, то нужно чрез это же окно.

5. Укажите дату, с которой нужно загрузить данные из Wildberries.

⚠️ Важно: Wildberries передаёт данные за период не более 90 дней. То есть дата должна быть не больше этого периода.

Далее перейдите в Настройки импорта.

Настройки импорта

Метод учета выручки  - это каким образом будут детализированы данные, полученные от Wildberries.

Самый понятный вариант с точки зрения сверки данных - это "Клиентская цена + комиссии как в отчете "

Если вы хотите учитывать Скидки постоянного покупателя (СПП), то рассмотрите другие методы учёта выручки.

Затем выберите как создавать номенклатуру (1), нужно ли создавать статьи автоматически (2) и нажмите "Подключить" (3).

Если после того как вы нажали подключить, появилась ошибка, то проверьте правильность API. Если вам передали данный ключ в мессенджере, то запросите у Администратора скопировать ключ из кабинета WB в файл txt, чтобы все символы были переданы корректно.

Периодичность обновления данных

Интеграция проверяет данные ежедневно примерно в 18:00 по мск, кроме понедельника.

В понедельник Wildberries формирует отчёты и останавливает передачу данных по API.

Данные синхронизируются за период 7 дней.

⚠️ Важно: если сегодня среда, то при запросе данных у Wildberries будут получена информация только за прошлую неделю (период, по которому WB уже сформировал итоговый отчёт за неделю).

Как запустить синхронизацию вручную?

Если необходимо запустить обмен за период более 7 дней или это нужно сделать не по автоматическому расписанию, то:

(1) Перейдите в настройки и проверьте дату начала интеграции. Смените её на ту, с которой хотите получить данные сейчас.

(2) Нажмите на "круглую стрелку" для отправки запроса на получение данных с у казанной даты.

Когда начнётся обмен под интеграцией будет указано "Идёт загрузка данных".

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

⚠️ Важно:
- Wildberries передаёт данные за период не более 90 дней. То есть дата должна быть не больше этого периода.
- по понедельникам Wildberries формирует отчёты и останавливает передачу данных по API.

По интеграции будут получены данные о продажах, комиссиях, штрафах и логистике.
📝 См. статью: Данные Wildberries. Что нужно добавить вручную?