Вчера этикетки 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 | Подождать и повторить |
| Заказов сейчас нет | Это не поломка: ждущих сборки заказов просто нет | Ничего делать не нужно |
Что делать, когда ключ истёк
- Войдите в личный кабинет Ozon Seller.
- Создайте новый ключ в разделе API-ключей.
- Скопируйте Client-Id и новый Api-Key.
- Замените старые значения в настройках приложения.
- Проверьте связь: попробуйте получить заказы или напечатать одну этикетку.
Если у вас несколько магазинов, ключи нужны для каждого. Проверьте каждый по отдельности.
Как обращаться с ключом
Относитесь к Api-Key как к паролю от кабинета. Не храните его в общем чате и не пересылайте сотрудникам по открытым каналам: если ключ попал не туда, создайте новый и замените его в приложении. Старый при этом перестаёт быть нужным.
Если магазинов несколько, заведите простую таблицу: название магазина, дата создания ключа, дата, когда его пора менять. Таблица занимает пять минут, а избавляет от остановленной печати в разгар дня. Дату окончания считайте от создания ключа: 90 дней, без продления.
Ещё одна мелочь: когда вы создаёте новый ключ, сразу проверьте, что Client-Id и Api-Key принадлежат одному магазину. Перепутать их при нескольких кабинетах проще всего.
Как не пропустить срок
Самая неприятная особенность в том, что на складе об окончании ключа узнают по факту: сотрудник сканирует коробку, а этикетка не печатается. Чтобы не доводить до этого, есть два способа: календарь или приложение, которое показывает срок. Если срок хранится в таблице или в заметках, кто-то должен её открывать. Приложение, которое само подсвечивает остаток, снимает эту нагрузку.
Что проверить, если ключ в порядке, а этикетки нет
Не всё сводится к ключу. Если ключ действует, а печать не идёт, проверьте принтер и размер бумаги. Типичные признаки: наклейка растянулась на две или обрезана. Это разобрано в статье этикетка Ozon растягивается на две. Если ключ не принимается, а сами данные верны, повторите сохранение и проверьте, что вы не скопировали пробел в начале или в конце строки.
Как это решает приложение
В приложении Ozon подключается на вкладке «Маркетплейсы»: вы добавляете Client-Id и Api-Key из личного кабинета Ozon Seller, и приложение находит заказ по штрихкоду товара и печатает этикетку. Магазинов можно добавить сколько угодно. Ключи проверяются сразу при сохранении: если Ozon их не принял, вы узнаете об этом здесь же, а не при первой печати.
Срок действия виден в настройках Ozon: приложение показывает, до какого числа ключ действует. За две недели до конца строка подсвечивается янтарным с числом оставшихся дней, а после истечения становится красной. Раньше ключ заканчивался молча, теперь предупреждение приходит заранее.
Юридическое лицо определяется само. По ключам приложение получает реквизиты продавца из Ozon и находит организацию с таким же ИНН в вашем МойСклад, выбирать вручную не нужно. Если подходящей организации нет, приложение предупредит. Подключение маркетплейса входит в расширенный тариф. Подробнее: печать этикеток Ozon. Если печать после замены ключа всё равно не получается, посмотрите как настроить термопринтер на 58×40.