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

API ключ Wildberries

Для настройки интеграции необходимо указать токен API, который можно получить в личном кабинете Wildberries (seller.wildberries.ru).

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

⚠️ Мы получаем данные в режиме только для чтения и гарантируем ее конфиденциальность, показывая данные только вам. 

❗️Срок действия токена ограничен.

Необходимо получить токен, где будут активными методы:

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

Токены API владелец личного кабинета генерирует самостоятельно в разделе:

Профиль --> Настройки --> Доступ к API

1. Нажмите «Создать новый токен»

2. Заполните имя универсального токена

3. Активируйте опцию «Только на чтение»

4. Активируйте следующие методы получения данных:
- Контент
- Статистика
- Продвижение
- Цены и скидки

5. Нажмите «Создать токен»

6. Скопируйте значение API ключа (длинную последовательность из букв и цифр), нажав кнопку «Скопировать».

7. В «Финансисте» укажите ранее скопированное значение токена в поле «API Токен» на странице добавления интеграции

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

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

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

(1) Укажите название интеграции в формате «ВБ Название организации»

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

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

(4) Укажите название вашей Организации и Контрагента (ООО "ВАЙЛДБЕРРИЗ").
Если их пока нет в вашей финмодели, то нажмите «+ Добавить».

(5) Укажите как интеграция будет связана с Группами аналитик:

- Не создавать
Поле «Группа аналитик» у полученных данных будет пустое.

- Создать автоматически
В системе будет создана группа аналитик «Канал продаж», для данной интеграции будет создано значение в формате «Wildberries {Название интеграции}»

- Выбрать из существующих
Вы сможете выбрать группу аналитик из списка, который создали в финансовой модели ранее.

📝 См. статью «Группы аналитик: возможности, примеры и настройка» (ссылка)

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

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

(7) Укажите валюту, в которой ведётся учёт в кабинете Wildberries.

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

Импорт НДС

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

- Выручка С НДС, НДС не загружаем
Выручка загрузится как в еженедельном отчете Wildberries, этот вариант используется по умолчанию

- Выручка С НДС, НДС в расходах
Для юридических лиц на УСН, которые обязаны уплачивать НДС по ставкам 5% и 7%, выручка загружается с НДС, а НДС – отдельной строкой в расходах.

- Выручка С НДС, НДС в доходах (с минусом)
Для юридических лиц на УСН, которые обязаны уплачивать НДС по ставкам 5% и 7%, выручка загружается с НДС, а НДС – отдельной строкой в доходы с минусом.

Метод учета выручки

Здесь выберите, каким образом будут детализированы данные:

- Клиентская цена + комиссии как в отчете
Цифры будут как в "детализации еженедельного отчета".
Система создаст 2 документа:
1-й документ в доходах с суммой по колонке отчета "Вайлдберриз реализовал Товар (Пр)"
2-й документ в расходе с суммой возмещений и вознаграждений WB

- Розничная цена + СПП + возмещение СПП + полная комиссия
Полезно если вы хотите увидеть цены товаров без учета СПП и комиссии не скорректированные на СПП и при этом хотите свериться по цифрам с еженедельным отчетом.
Система создаст 5 документов:
1-й документ в доходах с суммой по колонке отчета "Цена розничная с учетом согласованной скидки" (то есть цена ДО применения СПП)
2-й документ в доходах с суммой скидки постоянного покупателя с минусом (чтобы выручка была как в отчете ВБ)
3-й документ в доходах с суммой дополнительных возмещений
4-й документ в расходе с суммой полной комиссии ВБ (то есть полная комиссия до вычета из нее СПП)
5-й документ в расходе с суммой скидки постоянного покупателя (чтобы комиссии были как в отчете ВБ)

Номенклатура и статьи

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

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

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

Итоговый отчёт за неделю

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

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

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

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

❗️После получения итогового отчёта можно делать полную сверку.

Ежедневные данные о продажах

Как это работает

Для импорта ежедневных данных дополнительных настроек и подключения дополнительных токенов не требуется.

Данные за текущий день загружаются каждое утро с 3 до 9 утра.
Импортируются данные за каждый день текущей недели.

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

То есть за текущую неделю всегда импортируются ежедневные данные,
за предыдущую - еженедельные финансовые отчеты.

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

Что импортируется ежедневно

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

В зависимости от настроек импорта документы будут выглядеть в системе следующим образом:

⚠️ Обратите внимание, что если стоит настройка Способ учета НДС в выручке,
при которой импортируется НДС -  то будет создан документ на НДС.

Как сверить ежедневные данные

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

Разница связана с разными способами и сроками формирования отчетов на стороне Wildberries.

В сервисе «Финансист» в реестре документов ежедневные данные о продажах начинаются текстом «Отчет Продажи» в Назначении документа. Этот признак можно использовать для поиска по реестру:

⚠️ Обратите внимание, что некоторые заказы могут быть не отражены из-за разницы в способах сбора данных для отчета между API и ежедневным финансовым отчетом в личном кабинете селлера.

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

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

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

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

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

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

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

🔸🔸🔸

Статьи по теме:
📝 Отчёты для сверки Wildberries (ссылка)
📝 Сверка данных с Wildberries. Особенности (ссылка)
📝 Как загрузить еженедельный отчет WB (ссылка)
📝 Группы аналитик: возможности, примеры и настройка (ссылка)

💬 Если у Вас возникли сложности по этому или другому вопросу, напишите нам в чат поддержки. Будем рады Вам помочь!