Импорт данных из Wildberries

Модуль ТЗ: 5.1 · Оцифровка продаж и финансовый учёт

Что это

«Оптима» загружает из вашего кабинета Wildberries заказы, продажи, возвраты и отчёт о реализации (комиссия, логистика, штрафы и другие удержания) и хранит их у себя. На этих данных строятся прибыль, отчёты, бухгалтерия, РНП и ответы ИИ-помощника.

Обычно данные приходят сами — см. «Автообновление данных». Ручной импорт нужен, чтобы подтянуть данные сразу: после подключения кабинета или если нужно быстрее получить свежий отчёт о реализации.

Где найти

Боковое меню → «Продажи» → «Оцифровка» (/app/wb/<кабинет>/digitization), блок «Импорт из Wildberries». Если за период данных нет, кнопка «Импортировать данные» есть и в пустом состоянии экрана.

Как пользоваться

1. Убедитесь, что API-ключ кабинета проверен (см. «Кабинеты Wildberries»).
2. В «Оцифровке» выберите период — «7 дней» или «30 дней». Импорт пойдёт за этот период.
3. Нажмите «Импортировать данные». Откроется окно «Импорт данных» с двумя шагами:
   1. «Продажи и заказы» — заказы, продажи и возвраты начиная с первого дня периода;
   2. «Отчёт о реализации» — детализация отчёта WB за период.
4. Дождитесь завершения. Окно можно закрыть кнопкой «Свернуть ожидание» — импорт продолжится на сервере, а на странице останется строка «Фоновый импорт» с прошедшим временем и кнопкой «Показать прогресс». Пока идёт импорт, период сменить нельзя.
5. По окончании появится итог: сколько сохранено заказов, продаж и возвратов и сколько строк отчёта о реализации. Также придёт уведомление в «Оптиме» (см. «Уведомления»). KPI и таблицы обновятся автоматически.

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

Если по кабинету уже идёт импорт, второй не запустится — вы увидите сообщение «Импорт уже выполняется для этого кабинета». Если перезагрузить страницу во время импорта, его прогресс подхватится автоматически.

Пока идёт ежедневная оцифровка (стартует каждый день в 00:00 МСК), ручной импорт заблокирован: кнопка неактивна и подписана «Идёт оцифровка…», значок крутится, рядом виден таймер «Ежедневная оцифровка идёт · …». Кнопка станет доступна сама, как только оцифровка завершится. Подробнее — «Автообновление данных».

Почему импорт идёт долго

Wildberries разрешает запрашивать эти данные примерно раз в минуту на кабинет, а большие периоды отдаются несколькими страницами. Поэтому импорт за 30 дней обычно занимает несколько минут, а при отказах Wildberries — дольше. Если Wildberries временно отказывает по лимиту, «Оптима» сама делает до пяти попыток с растущими паузами (1, 2, 4, 8 минут) и продолжает с того места, где остановилась.

Возможные сообщения

Сообщение	Что делать
«Продажи и заказы сохранены. Отчёт реализации не загрузился…»	Продажи уже есть, денежных данных пока нет. Повторите импорт позже.
«…отчёт реализации завершился без строк…»	Wildberries ещё не сформировал отчёт за период. Повторите позже.
«Wildberries отклонил запрос из‑за лимита»	Подождите несколько минут, не запускайте импорт повторно сразу.
«Ключ кабинета WB отклонён»	Обновите API-ключ в «Кабинетах WB». Повторы не помогут.
«Wildberries временно недоступен»	Повторите позже.
«Период отчёта укорочен. Импорт продолжается.»	Начало периода раньше 29.01.2024 — отчёт загружается с этой даты.

Ограничения

• В интерфейсе импорт идёт за 7 или 30 дней. Другой период можно загрузить только через API.
• Отчёт о реализации доступен у Wildberries только с 29 января 2024 года; за один запуск — не длиннее 366 дней.
• Время — московское, как его отдаёт Wildberries.
• Возвраты приходят вместе с продажами одной лентой и помечаются отдельно.
• Пока идёт ваш импорт, плановое автообновление по этому кабинету пропускается, чтобы не делить с ним лимит Wildberries.
• Импорт доступен только для кабинетов, к которым у вас есть доступ.

Связанные страницы

• Оцифровка продаж и финансовый учёт
• Автообновление данных
• Затраты Wildberries по товарам
• Кабинеты Wildberries

Для интеграторов

• POST /digitization/import — { wbAccountId, dateFrom }: заказы/продажи/возвраты с lastChangeDate >= dateFrom. Ответ 202 + jobId.
• POST /digitization/financial-report/import — { wbAccountId, dateFrom, dateTo }: отчёт о реализации. 400, если dateFrom раньше 2024-01-29 или период длиннее REPORT_MAX_PERIOD_DAYS.
• GET /digitization/import/status/{jobId} — состояние задачи и итог.
• Повторный POST при живой задаче того же типа по кабинету возвращает её jobId с alreadyRunning: true.
• Источники WB: GET /api/v1/supplier/orders, GET /api/v1/supplier/sales (statistics API), POST /api/finance/v1/sales-reports/detailed (finance API). См. «WB API».
• ADR: 0016, 0048, 0049, 0057.