API-ключ Ozon для сервиса аналитики: какую роль выбрать и как подключить магазин

Чтобы сервис аналитики видел ваши заказы, деньги и остатки, ему нужен доступ к магазину на Ozon. Логин и пароль от кабинета для этого не нужны: у Ozon есть Seller API — программный доступ к данным магазина, и для него создаётся отдельный ключ. У ключа есть роли — они определяют, что с ним можно делать: только смотреть или ещё и менять.

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

Где создать ключ

В кабинете Ozon Seller: Настройки → API интеграции → Seller API, кнопка «Сгенерировать ключ». Откроется окно «Генерация ключа» со списком ролей. Там же, в разделе Seller API, находится и Client ID — номер, по которому Ozon понимает, к какому магазину относится ключ. Для подключения к сервису нужны оба значения: Client ID и сам ключ.

Роли: чтение и изменение

Почти у каждой роли есть два варианта:

• только чтение — в названии read-only или ReadOnly: «Product read-only», «Posting FBS read-only», «Returns read-only», «Supply order ReadOnly». Ключ с такой ролью может получать данные, но не может ничего изменить;
• полная — без приписки: «Product», «Posting FBS», «Returns», «Supply order». Такой ключ может и получать данные, и менять их: обновлять товары, цены, остатки, управлять отправлениями.

И есть две роли, которые охватывают всё сразу:

• «Admin read only» — все информационные методы Seller API без внесения изменений (на момент написания — 286 методов);
• «Admin» — вообще все методы, включая изменения (483 метода).

Ролей много: у большинства есть вариант «только чтение» и полный

Какую роль выбрать для аналитики

Сервису аналитики данные нужно читать, а не менять. Поэтому достаточно ролей только на чтение — и проще всего выбрать одну роль «Admin read only». Причин две.

Отдельными ролями всё не закрыть очевидным образом. Аналитике нужны товары, заказы FBS и FBO, финансовые операции, отчёты о реализации, остатки, возвраты, поставки. Но роли «Финансы» в списке Ozon нет, а методы, которые нужны аналитике, разбросаны по нескольким ролям. Собрать правильный набор из отдельных ролей можно, но легко что-то упустить — и тогда часть данных просто не будет загружаться.

Новые возможности сервиса заработают сами. Сервисы развиваются: например, в mplens за последние недели появились возвраты и учёт поставок FBO, которые едут на склад, — им нужны методы Ozon, которыми раньше mplens не пользовался. С ролью «Admin read only» ничего менять в кабинете Ozon не придётся: новые функции начнут работать сами. С набором отдельных ролей пришлось бы добавлять роль к ключу.

А роли на изменение нужны, только если вы хотите менять что-то из сервиса — например, цены или остатки FBS прямо из mplens. Если не хотите — не добавляйте их, аналитике они не нужны.

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

Как подключить ключ в mplens

На странице «Маркетплейсы» нажмите «Добавить аккаунт Ozon» и введите название магазина (любое, для себя), Client ID и ключ. mplens хранит ключ в зашифрованном виде, а в интерфейсе показывает только его маску — первые и последние символы, как в кабинете Ozon, — чтобы вы могли сверить, какой ключ подключён.

Сразу после подключения mplens спрашивает у Ozon, какие роли есть у ключа, и показывает, всё ли будет работать:

• «✓ Все функции доступны» — ключу хватает прав на всё;
• «🔒 Ключ только на чтение — менять остатки и цены из mplens не получится» — аналитика работает полностью, а менять цены и остатки из mplens нельзя. Для ключа с «Admin read only» это нормальное состояние;
• если не хватает ролей на чтение, mplens перечислит, какие функции не будут работать и почему: например, без возвратов не будет карточки «Возвраты» на Дашборде.

Ключ с ролью «Admin read only»: аналитика работает полностью, изменить что-то в магазине через mplens нельзя

Так выглядит ключ, которому не хватает ролей: красным — то, без чего аналитика не работает, жёлтым — необязательные функции.

Под плашками — что именно не будет работать и где добавить ключу роли

Если вы поменяли роли ключа в кабинете Ozon, нажмите «Обновить права» — mplens перечитает их и обновит список.

Срок действия ключа

У ключа Ozon есть срок действия — он виден в кабинете, в колонке «Истекает через, дата». Когда срок закончится, ключ перестанет работать, и данные в сервисе перестанут обновляться.

mplens следит за сроком сам:

• на странице «Маркетплейсы» рядом с магазином написано, до какого числа действует ключ;
• за 30 дней до окончания на Дашборде появляется предупреждение, за 14 дней — красное; после окончания оно не исчезает, пока ключ не обновят;
• владельцу и администраторам компании приходят письма — за 30, 14, 7, 3 и 1 день до окончания и в сам день, а если ключ так и не обновили — ещё раз в неделю, до четырёх писем.

Такое же письмо придёт, если ключ перестал работать раньше срока (например, его удалили в кабинете Ozon) или у него убрали роли, — с перечнем того, что теперь не обновляется.

Обновить ключ просто: создайте в кабинете Ozon новый и введите его на «Маркетплейсах» через кнопку «Изменить». Финансовые операции, заказы и отчёты за дни без ключа mplens после этого догрузит сам. А вот остатки и цены — это снимки текущего состояния: за дни, когда ключ не работал, их историю не восстановить, Ozon прошлое не отдаёт. Поэтому ключ лучше обновлять заранее, по первому письму, а не после того, как он истёк.

Коротко

• Ключ создаётся в кабинете Ozon: Настройки → API интеграции → Seller API → «Сгенерировать ключ». Для подключения нужны ключ и Client ID.
• Для аналитики хватает одной роли «Admin read only»: она открывает все данные и не позволяет ничего менять. Новые функции сервиса с ней заработают без изменений в кабинете Ozon.
• Роли на изменение нужны, только если хотите менять цены и остатки из сервиса.
• Вкладку «Разрешенные сети» для внешнего сервиса оставьте пустой.
• Следите за сроком ключа — mplens напомнит заранее в письме и на Дашборде.

Подключение магазина к mplens занимает пару минут: ключ с ролью «Admin read only», Client ID — и mplens сразу начнёт загружать данные магазина. Попробуйте бесплатно — без ограничения по времени и без привязки карты.