Пошаговая инструкция: от подключения Ozon API до первого автоматического заказа в МоемСкладе. Регистрация, авторизация в МоемСкладе и подписка происходят автоматически при установке через МС Marketplace.
1. Регистрация в АйксРокки
Открой форму регистрации. Укажи рабочий email и придумай пароль (минимум 6 символов).
Кнопка «Сгенерировать ключ» → название «АйксРокки» → в правах отметь роли «Администратор» (или как минимум «Работа с заказами», «Работа с товарами», «Работа с ценами и остатками», «Работа с финансами»).
Скопируй Client-Id (число вида 12345) и Api-Key (длинная строка). Ключ показывается один раз — сохрани.
В нашем кабинете открой Настройки → Ozon API, вставь оба значения → «Сохранить» → «Тест» (должен ответить «✓ Подключение работает»).
Если не совпадает — выбери другие поля (штрихкод, наименование, externalCode).
Б. Ручное сопоставление
В разделе «Сопоставление» → вкладка «Не сопоставлено» → для каждой строки поиск товара МС и связка кнопкой.
В. Excel-импорт
Скачай шаблон .xlsx, заполни своими данными (в шапке выбери поле Ozon, в каждой строке — поле МС для поиска: артикул, штрихкод или название). Загрузи обратно — сервис сопоставит массово.
7. Автосинхронизация
На Обзоре кабинета убедись, что чек-лист «6/6 ✓ Готово к синхронизации».
В том же блоке — чекбокс «Автосинхронизация включена». По умолчанию выключена — чтобы не конфликтовать с другими интеграциями, которые могли уже работать.
Ниже — что синхронизировать: заказы / цены МС→Ozon / остатки МС→Ozon. Первый — обязательно; цены и остатки — только для FBS/rFBS/FBS Express.
Автосинк запускается каждые 15 минут. Для ручного запуска — кнопка «▶ Запустить» с выбором периода.
8. Для FBS: сопоставление складов и обмен остатков
В Настройки → Склады FBS — таблица твоих складов Ozon. Для каждого выбери соответствующий склад МС.
Один физический склад МС можно привязать к нескольким складам Ozon — например, «Метрополис FBS», «Метрополис rFBS», «Метрополис Express» это один физический склад, но три разных «виртуальных» на Ozon.
Раздел Остатки → кнопка «Обновить остатки на Ozon» — прогонит один цикл вручную.
Аналогично Раздел Цены → кнопка «Обновить цены на Ozon».
9. Моментальная синхронизация через МС Webhook
По умолчанию сервис проверяет изменения в МС каждые 5–15 минут. Для критичных FBS-остатков есть более быстрый режим:
Каждое изменение в МС (отгрузка, приём, изменение товара) прилетает к нам за 1–2 секунды и сразу пушится на Ozon.
Хуки можно выключить в любой момент той же кнопкой — режим вернётся к расписанию.
10. Оплата
А. Картой (для физлиц и ИП)
После окончания триала — Биллинг → «Оплатить» → карта → рекуррентные списания каждый месяц. Отмена в один клик.
Б. По счёту с расчётного счёта (для юрлиц)
Биллинг → «Оплатить как юрлицо» → введи реквизиты своей компании → получишь PDF-счёт на email. После поступления средств на наш р/с (обычно в течение 1 рабочего дня) — подписка активируется автоматически.
FAQ и частые ошибки
«HTTP 401» при тесте Ozon API
Обычно значит, что скопирован Api-Key с лишним пробелом или переносом строки. Или ключ был отозван. Пересоздай в личном кабинете Ozon и вставь заново.
«HTTP 401» при тесте МС API
Токен МС отозван или истёк. Создай новый в МС Настройки → Приложения → Токены доступа.
Заказы создаются, но с ошибками позиций (mapping]
Товар из Ozon не найден в МС по правилу маппинга. Проверь: (а) правило маппинга верное (например, оба поля article), (б) артикулы совпадают между Ozon и МС. Или создай товары в МС автоматически — раздел «Сопоставление → Создать в МС все несопоставленные».
Синхронизация «зависла» на одном номере отправления
В Журнале смотри детальную ошибку. Если ошибка на конкретном posting_number — можно сбросить связку в разделе Заказы (кнопка ×) и пересинкнуть кнопкой ↻.
Дубли документов в МС
Не должны появляться — сервис хранит связку posting_number ↔ ms_order_id. Если раньше синхронизацию делал другой плагин — используй кнопку «Только сопоставить» на Обзоре: она пройдёт по постам Ozon и найдёт уже созданные CO/отгрузки/платежи в МС по имени, привяжет их к нашей БД без дублирования.
Не получается создать документ Возврат покупателя
Проверь права токена МС (нужен доступ к salesreturn). Также убедись, что в разделе Возвраты стоит галка «Создавать «Возврат покупателя»».
Не пришло письмо с чеком об оплате
Проверь папку «Спам». Также в Биллинге всегда есть история платежей.