Публикация приложения в каталоге решений

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

Что должно быть готово до публикации

Публикация в каталоге решений — финальный этап, у которого есть жёсткие предусловия. Приложение уже должно корректно работать через Vendor API 1.0: обрабатывать установку, отдавать статусы и получать токены доступа к JSON API 1.2.

• рабочие эндпойнты жизненного цикла (PUT/GET/DELETE /apps/{appId}/{accountId});
• корректная JWT-аутентификация (HS256, secretKey) в обе стороны;
• iframe с адаптивной вёрсткой, если у приложения есть интерфейс;
• обработка минимально необходимых scope без избыточных прав.

Манифест и карточка приложения

Карточка в каталоге собирается из манифеста (descriptor) и маркетинговых материалов. Манифест описывает технические параметры, а карточка — то, что видит пользователь.

• описание должно объяснять ценность и сценарий, а не просто перечислять функции;
• скриншоты — реальные экраны приложения, а не заглушки;
• инструкция по настройке снимает половину обращений в поддержку.

Категория и теги влияют на видимость в каталоге — выбирайте те, по которым пользователь реально будет искать решение.

iframe и безопасность

Если у приложения есть интерфейс, он встраивается в МойСклад через iframe. Платформа передаёт в него контекст текущего аккаунта, а вы отвечаете за то, чтобы UI работал внутри чужого окна без нарушений безопасности.

• iframe отдаётся строго по HTTPS с валидным сертификатом;
• контекст (идентификатор аккаунта, пользователь) проверяется на сервере, а не принимается на веру из JS;
• секрет приложения (secretKey) никогда не попадает в код iframe;
• вёрстка адаптивная — окно приложения меняет размеры вместе с интерфейсом МойСклад.

Всё, что касается прав и токенов, решается на бэкенде: iframe лишь показывает результат, а операции с JSON API 1.2 выполняет ваш сервер по сохранённому access_token.

Тарифы и биллинг через платформу

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

• Бесплатное — без ограничений по оплате;
• Платное с пробным периодом — trial на N дней, затем списание;
• Тарифные планы — несколько уровней с разным набором возможностей.

Смена статуса подписки приходит к вам событием Vendor API: когда оплата заканчивается, вы получаете переход в Suspended и должны корректно ограничить функциональность, не удаляя данные пользователя.

Модерация: как пройти с первого раза

Перед публикацией приложение проходит проверку. Модераторы смотрят на техническую корректность, безопасность и качество карточки. Типичный чек-лист:

1. приложение устанавливается и отдаёт корректный статус;
2. запрошенные scope соответствуют реальным функциям;
3. секреты не утекают в браузер, iframe работает по HTTPS;
4. описание и скриншоты соответствуют поведению;
5. есть инструкция и контакты поддержки.

Версии и обновления

После публикации приложение живёт: выходят новые версии, меняются права, добавляются функции. МойСклад разделяет обновление кода (на вашей стороне) и изменение манифеста (проходит модерацию заново).

• изменение бизнес-логики без новых scope обычно не требует повторной модерации;
• расширение прав или смена типа приложения — модерация обязательна;
• для существующих аккаунтов новые права запрашиваются отдельно.

Поддержка и метрики после релиза

Публикация — старт, а не финиш. Дальше начинается эксплуатация: обращения пользователей, инциденты синхронизации, аналитика установок.

• Мониторинг — алерты на ошибки обработчиков и рост 4xx/5xx от Vendor API;
• Логи по accountId — чтобы быстро разбирать обращения конкретного клиента;
• Метрики — установки, удаления, конверсия trial в оплату.

Разбор причин удаления приложения (в событии DELETE приходит контекст) помогает понять, где теряются пользователи — на настройке, на оплате или на непонятной ценности.

Итог

Публикация в каталоге решений — это связка технической готовности (рабочий Vendor API, корректные scope, HTTPS-iframe), качественной карточки, продуманной тарифной модели и процесса обновлений. Модерацию проходят с первого раза те, кто запрашивает минимум прав и честно описывает поведение приложения.

Мы помогаем разработчикам довести приложение до публикации: проектируем архитектуру серверной части, настраиваем биллинг и статусы подписки, готовим приложение к модерации и выстраиваем мониторинг после релиза. Если нужна интеграция с 1С-Битрикс или сложная синхронизация данных — возьмём на себя техническую часть.