Ключ API Ozon Seller: как получить, срок действия и что делать после

Вчера этикетки Ozon печатались, сегодня сотрудник сканирует коробку, а наклейки нет. Одна из самых частых причин: истёк ключ API. Он не продлевается сам, и о нём легко забыть, пока не встанет работа. Ниже: где взять Client-Id и Api-Key, сколько живёт ключ, как понять, что он истёк, и что делать дальше.

Что такое Client-Id и Api-Key

Чтобы стороннее приложение могло получать ваши заказы и этикетки из Ozon, ему нужны два значения:

  • Client-Id — идентификатор вашего магазина (продавца);
  • Api-Key — секретный ключ, по которому Ozon понимает, что обращение разрешено вам.

Оба значения берутся в личном кабинете Ozon Seller. Api-Key вы создаёте сами. Он работает как пароль: не публикуйте его, не отправляйте в мессенджеры, не оставляйте на виду.

Где взять ключи

Названия пунктов меню в кабинете Ozon Seller меняются, поэтому описываем общий путь, а не точные кнопки. В кабинете откройте настройки аккаунта и найдите раздел, где выпускаются API-ключи. Там создаётся новый ключ, там же виден ваш Client-Id. Ключ обычно показывается один раз при создании, поэтому сразу скопируйте его в то место, где он понадобится. Если пропустили, создайте новый.

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

Сколько живёт ключ

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

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

Симптом, причина, что сделать

Симптом Вероятная причина Что сделать
Этикетка перестала печататься, хотя принтер в порядке Истёк срок ключа Создать новый ключ в кабинете Ozon и обновить в приложении
Приложение не принимает ключи при сохранении Опечатка, лишний пробел или неверный Client-Id Скопировать значения заново, проверить, что они из одного магазина
Заказы не подгружаются Ключ не от того магазина или отозван Проверить в кабинете, какой магазин подключён
Сообщение «магазин не подключён» В приложении нет ключей Добавить Client-Id и Api-Key
Ozon не ответил Временная проблема на стороне Ozon Подождать и повторить
Заказов сейчас нет Это не поломка: ждущих сборки заказов просто нет Ничего делать не нужно

Что делать, когда ключ истёк

  1. Войдите в личный кабинет Ozon Seller.
  2. Создайте новый ключ в разделе API-ключей.
  3. Скопируйте Client-Id и новый Api-Key.
  4. Замените старые значения в настройках приложения.
  5. Проверьте связь: попробуйте получить заказы или напечатать одну этикетку.

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

Как обращаться с ключом

Относитесь к Api-Key как к паролю от кабинета. Не храните его в общем чате и не пересылайте сотрудникам по открытым каналам: если ключ попал не туда, создайте новый и замените его в приложении. Старый при этом перестаёт быть нужным.

Если магазинов несколько, заведите простую таблицу: название магазина, дата создания ключа, дата, когда его пора менять. Таблица занимает пять минут, а избавляет от остановленной печати в разгар дня. Дату окончания считайте от создания ключа: 90 дней, без продления.

Ещё одна мелочь: когда вы создаёте новый ключ, сразу проверьте, что Client-Id и Api-Key принадлежат одному магазину. Перепутать их при нескольких кабинетах проще всего.

Как не пропустить срок

Самая неприятная особенность в том, что на складе об окончании ключа узнают по факту: сотрудник сканирует коробку, а этикетка не печатается. Чтобы не доводить до этого, есть два способа: календарь или приложение, которое показывает срок. Если срок хранится в таблице или в заметках, кто-то должен её открывать. Приложение, которое само подсвечивает остаток, снимает эту нагрузку.

Что проверить, если ключ в порядке, а этикетки нет

Не всё сводится к ключу. Если ключ действует, а печать не идёт, проверьте принтер и размер бумаги. Типичные признаки: наклейка растянулась на две или обрезана. Это разобрано в статье этикетка Ozon растягивается на две. Если ключ не принимается, а сами данные верны, повторите сохранение и проверьте, что вы не скопировали пробел в начале или в конце строки.

Как это решает приложение

В приложении Ozon подключается на вкладке «Маркетплейсы»: вы добавляете Client-Id и Api-Key из личного кабинета Ozon Seller, и приложение находит заказ по штрихкоду товара и печатает этикетку. Магазинов можно добавить сколько угодно. Ключи проверяются сразу при сохранении: если Ozon их не принял, вы узнаете об этом здесь же, а не при первой печати.

Срок действия виден в настройках Ozon: приложение показывает, до какого числа ключ действует. За две недели до конца строка подсвечивается янтарным с числом оставшихся дней, а после истечения становится красной. Раньше ключ заканчивался молча, теперь предупреждение приходит заранее.

Юридическое лицо определяется само. По ключам приложение получает реквизиты продавца из Ozon и находит организацию с таким же ИНН в вашем МойСклад, выбирать вручную не нужно. Если подходящей организации нет, приложение предупредит. Подключение маркетплейса входит в расширенный тариф. Подробнее: печать этикеток Ozon. Если печать после замены ключа всё равно не получается, посмотрите как настроить термопринтер на 58×40.

Нужен МойСклад? Зарегистрируйтесь — это бесплатно. О сервисе — moysklad.ru.

Попробуйте на своём складе

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

Скачать приложение