API-синхронизация

На странице API-синхронизации можно проверить доступ к кабинету Wildberries или Ozon, увидеть ближайший автоматический обмен и по истории понять, готовы ли нужные данные.

Время чтения: 12 минут
Обновлено: 2 сентября 2026 г.

Проверить кабинет

Убедитесь, что выбран нужный селлер и кабинет, а сохранённые реквизиты по-прежнему дают Unit12 необходимый доступ.

Понять состояние обмена

Сопоставьте расписание, верхнюю строку истории и раскрытые сведения о периоде или текущем этапе.

Выбрать следующее действие

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

У каждого подключённого кабинета своё расписание и своя история. Перед проверкой всегда сверяйте выбранный API-аккаунт: результат одного кабинета ничего не говорит о состоянии другого.

Эта страница предназначена для контроля. Кнопка проверки подтверждает доступ, но не запускает загрузку; новые обмены Unit12 создаёт автоматически.

Выберите нужный API-аккаунт

Страница всегда показывает расписание и историю только одного выбранного кабинета. Поэтому первая проверка — название аккаунта, его номер и селлер.

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

Откройте «Данные» → «API-синхронизация» и выберите кабинет в поле «API-аккаунт». В подписи сверяйте название, номер и селлера, особенно если у организации несколько кабинетов.

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

Проверьте подключение

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

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

Прочитайте расписание автоматического обмена

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

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

Включён
Кабинет участвует в автоматическом расписании, и новые обмены создаются без ручного запуска.
Выключен
Новые плановые обмены для кабинета не создаются.
Каждый час, раз в сутки или другой интервал
Это обычная частота постановки кабинета в очередь, а не обещанная длительность загрузки и не период данных внутри обмена.
Следующий обмен: не ранее…
Это самое раннее время постановки в очередь, а не срок завершения обмена.
Следующий обмен: не запланирован
Ближайшее время запуска для кабинета сейчас не назначено.

Найдите нужный запуск в истории

История отвечает на четыре вопроса: когда обмен создан, что он обновляет, в каком состоянии находится и когда завершился.

История отсортирована от новых запусков к старым. Для обычной проверки начните с верхней строки: сопоставьте тип, статус, время запуска и ближайшее плановое время над таблицей. У активного обмена в колонке «Завершён» стоит прочерк.

«Полный обмен» получает финансовые данные, товары и остатки, а «Остатки и товары» обновляет только каталог и запасы. Время запуска не является периодом операций — нужный охват находится внутри раскрытой строки. Старые запуски доступны через пагинацию.

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

Раскройте строку и сверьте результат

Стрелка слева от времени запуска показывает сведения, которые нельзя надёжно понять только по цвету статуса.

В успешном полном обмене «Финансовые данные» показывают период операций, а «Товары и остатки» — дату обновления каталога и запасов. В активной строке вместо результата виден текущий этап; инициатор помогает отличить плановый запуск от другого обмена.

После статуса «Загружено» откройте нужный результат и снова сверьте кабинет и период: финансовые данные — в аналитике или P&L, запасы — на странице остатков.

Что означают статусы

Справочник ниже объясняет только состояние запуска. Что делать с проблемным результатом, описано в следующем разделе.

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

Если есть проблема

Справочник статусов объясняет, что произошло. Здесь собраны только действия для ситуаций, в которых штатная проверка не дала готового результата.

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

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

Обмен завершился с проблемой

Для статусов «Ошибка», «Частично загружено» и «Отменено» решение зависит от причины в раскрытой строке и результата проверки подключения.

1

Раскройте последний проблемный запуск

Зафиксируйте кабинет, время, тип обмена, конечный статус и полный текст сообщения.

2

Проверьте доступ только при ошибке реквизитов

Если текст указывает на ключ, токен или права, запустите проверку подключения. При повторной ошибке обновите реквизиты существующего аккаунта на странице «Селлеры»; дубликат кабинета создавать не нужно. Требования Wildberries · Требования Ozon.

3

Сверьте следующий обмен

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

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

Нет API-аккаунтов или истории

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

Нет доступных API-аккаунтов
Проверьте область данных в верхней панели. Если кабинета действительно нет, подключите его на странице «Селлеры» или завершите мастер начальной настройки.
Кабинет есть, но «Обменов пока нет»
Убедитесь, что автоматический обмен включён и указано следующее время. До первого планового запуска история может оставаться пустой.
Следующее время прошло, а строки нет
Обновите страницу один раз и снова сверьте кабинет. Если история остаётся пустой, сообщите поддержке плановое время и время проверки.

Если список кабинетов пуст, сначала добавьте API-подключение или верните кабинет в текущую область данных.

Статус «Загружено», но нужных данных нет

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

Проверяйте по порядку

  • На целевой странице выбраны тот же API-аккаунт, нужный период, селлер и маркетплейс; сохранённые фильтры не исключают данные.
  • Для финансовых показателей завершён именно «Полный обмен», а раскрытый финансовый период включает нужные даты.
  • Для запасов завершён полный обмен или «Остатки и товары», а дата снимка достаточно свежая.
  • Если загрузка была частичной, вы дождались следующего планового обмена и проверили новый конечный результат.

Частые вопросы

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

Можно ли закрыть страницу, пока обмен выполняется?

Да. Обмен продолжится независимо от открытой вкладки, а его состояние останется в истории выбранного кабинета.

Нужно ли обновлять страницу, чтобы увидеть завершение?

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

Что делать со старой ошибкой, если новый обмен успешен?

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

Проверка завершена

Нужный кабинет выбран, подключение проходит проверку, автоматический обмен включён, а последняя строка либо ещё штатно выполняется, либо завершилась со статусом «Загружено» и подходящим периодом. Теперь можно проверять результат в аналитике, отчётах или остатках.

Статья была полезна?

Не нашли ответ?

Укажите селлера и название кабинета, время и тип последнего обмена, его статус, раскрытый период или этап, ожидаемое время следующего запуска и полный текст ошибки. Токен WB, API key Ozon и пароль не присылайте.

Написать в поддержку