Чтобы Трумарк получал отправления Ozon, привязывал к ним коды маркировки и готовил документы для Честного ЗНАКа, ему нужен доступ к вашему кабинету продавца: Client-Id и API Key. Вы создаёте ключ в кабинете Ozon и вводите его в Трумарке. Дальше раздел сам загружает отправления за последние 30 дней.
Что нужно заранее.
- Вы продаёте на Ozon со своего склада (FBS). При такой схеме сведения о выводе товара из оборота подаёт в Честный ЗНАК сам продавец.
- Тариф «Демо», «Опти» или «Макси». На демо Ozon работает без отдельного лимита на отправления, в «Опти» входит до 3 000 отправлений в месяц, в «Макси» — до 30 000.
- Кабинет Ozon и компания в Трумарке принадлежат одной организации. Ключ кабинета с другим ИНН Трумарк не примет.
- В Трумарке действует авторизация в ГИС МТ — карточка на главной странице кабинета. Без неё Трумарк не может сверить коды с Честным ЗНАКом. Как продлить: Авторизация в ГИС МТ и СУЗ.
Шаг 1. Откройте раздел «Ozon» в Трумарке #
В меню слева нажмите «Ozon». Пока кабинет продавца не подключён, раздел показывает карточку «Подключите кабинет Ozon». Нажмите «Как получить ключ» — откроется памятка: где создать ключ и какие роли ему выдать. Ниже в карточке — «Пройти обучение»: тур покажет подключение по шагам прямо в кабинете, и «Открыть инструкцию» — эта статья.
Шаг 2. Создайте API-ключ в кабинете Ozon #
- В кабинете продавца Ozon откройте Настройки → Seller API и нажмите «Сгенерировать ключ».
- Цель выберите «для внешнего сервиса», в названии сервиса укажите «Трумарк».
- Выдайте ключу уровень доступа Admin или четыре роли из таблицы ниже.
- Скопируйте API Key сразу после создания. Client-Id показан на той же странице Seller API.
| Роль ключа | Для чего она Трумарку |
|---|---|
| Posting FBS | Отправления, коды маркировки, сборка, этикетки и отгрузки |
| Warehouse | Склады: по ним Трумарк проверяет ключ при подключении |
| Product read-only | Штрихкоды товаров: по ним проверяется, подлежит ли товар маркировке |
| Returns read-only | Возвраты |
С ролью Admin read only Трумарк сможет только читать данные: отправления и документы будут видны, но передать в Ozon коды, сборку и отгрузку из Трумарка не получится.
Шаг 3. Введите Client-Id и API Key в Трумарке #
В разделе «Ozon» нажмите «Подключить кабинет». В окне «Подключение кабинета Ozon» вставьте Client-Id и API Key и нажмите «Проверить и подключить».
До сохранения Трумарк проверяет ключ: принимает ли его Ozon, хватает ли ролей и совпадает ли ИНН продавца в Ozon с ИНН вашей компании. Если что-то не так, причина появится в этом же окне.
Шаг 4. Дождитесь первой синхронизации #
Когда ключ принят, появляется уведомление «Ozon подключён», а раздел начинает первую синхронизацию. Трумарк поднимает историю за последние 30 дней в четыре приёма: загружает отправления, получает из Ozon коды маркировки и проверяет их, загружает отгрузки и готовит черновики документов. Под названием этапа виден счётчик проверенных отправлений.
Это разовая операция, она занимает несколько минут. Страницу перезагружать не нужно: раздел откроется сам. Дальше Трумарк обновляет данные автоматически — раз в 15 минут.
Шаг 5. Проверьте, что отправления загрузились #
После синхронизации раздел открывается на шаге «Отправления». Всего шагов три, они переключаются вверху страницы:
- Отправления — отправления Ozon с товарами, которые подлежат маркировке. Отправления без маркируемых товаров сюда не попадают.
- Отгрузки — отгрузки, в которые Ozon собрал отправления для передачи в доставку.
- Документы ЧЗ — документы для Честного ЗНАКа: вывод из оборота и возврат в оборот.
Что делать дальше: привязать коды к отправлениям — Отправления Ozon, передать сборку и собрать отгрузку — Отгрузки Ozon, подписать документы — Документы Честного ЗНАКа по Ozon.
Как заменить ключ или отключить кабинет Ozon #
Ozon выдаёт ключ на 3 месяца. Дату окончания Трумарк показывает в настройках: нажмите значок шестерёнки справа вверху раздела.
- Заменить ключ. Создайте новый ключ в кабинете Ozon с теми же ролями, нажмите «Заменить ключ», вставьте его в поле «Новый API Key» и нажмите «Проверить и сохранить». Отправления, отгрузки и документы остаются на месте.
- Отключить кабинет. Отправления, отгрузки и документы перестанут обновляться из Ozon. Подключить кабинет можно заново тем же или новым ключом.
Если что-то пошло не так #
- «Ключу Ozon не хватает прав». Ключу не выданы нужные роли. Создайте в кабинете Ozon новый ключ с ролями Posting FBS, Warehouse, Product read-only и Returns read-only или с ролью Admin и введите его заново.
- «Ozon не принял Client-Id или API Key». Ключ скопирован не полностью, перепутаны поля, или у ключа закончился срок. Скопируйте оба значения из кабинета Ozon заново. Если ключу больше трёх месяцев, создайте новый.
- «ИНН продавца в кабинете Ozon не совпадает с ИНН компании». Ключ создан в кабинете Ozon другого юрлица или ИП. Создайте ключ в кабинете нужной организации или переключитесь в Трумарке на её компанию — Как добавить вторую компанию и переключаться между компаниями.
- «Не удалось завершить синхронизацию». Нажмите «Повторить синхронизацию» на этой же карточке. Уже загруженные данные не теряются.
- «Синхронизация ещё идёт — данные догрузятся автоматически». Ничего делать не нужно. Подождите несколько минут.
- Отправления перестали обновляться. Откройте настройки интеграции и проверьте строки «Ключ действует до» и «Последний обмен с Ozon». Если срок ключа вышел, замените ключ.
Частые вопросы #
Где в кабинете Ozon взять Client-Id и API Key?
Настройки → Seller API → «Сгенерировать ключ». Цель — «для внешнего сервиса». Client-Id показан на той же странице, API Key Ozon выдаёт при создании ключа.
Какие роли нужны ключу Ozon для маркировки?
Admin или набор из четырёх ролей: Posting FBS, Warehouse, Product read-only и Returns read-only. С ролью Admin read only Трумарк только читает данные и не может передавать в Ozon коды и сборку.
Сколько действует ключ Ozon?
Три месяца. Дата окончания видна в настройках интеграции в строке «Ключ действует до». Замените ключ заранее: после окончания срока отправления перестанут обновляться.
Почему в Трумарке меньше отправлений, чем в кабинете Ozon?
Трумарк показывает только отправления с товарами, которые подлежат маркировке. Кроме того, при подключении загружается история за последние 30 дней.
Нужно ли указывать в Ozon коды маркировки, если работаю через Трумарк?
Нет, достаточно отсканировать код в Трумарке: он сам передаст код в Ozon. Если код уже указан в Ozon при сборке, Трумарк подтянет его оттуда, повторно сканировать не нужно.
Как часто Трумарк обновляет данные из Ozon?
Раз в 15 минут. Обновлять страницу или запускать синхронизацию вручную не нужно.
Связанные статьи #
- Отправления Ozon: статусы и как привязать код маркировки
- Отгрузки Ozon: как передать сборку, напечатать этикетки и подтвердить отгрузку
- Документы Честного ЗНАКа по Ozon: как подписать вывод из оборота и возврат
- Как подключить Wildberries к Трумарку: токен и первая синхронизация
- Авторизация в ГИС МТ и СУЗ: что значит «Активна до» и как продлить
- Как активировать демо-тариф Трумарка или выбрать платный
- Маркировка на Ozon: Честный ЗНАК для FBS и realFBS — обзор возможностей
