Как подключить МойСклад

Новые Telegram-магазины подключаются через решение Appiko в каталоге МойСклад. Создайте код в Appiko на вкладке МойСклад, вставьте его в окно установленного решения и завершите настройку в МойСклад.

Пошаговая инструкция для существующего и нового магазина: магазин из каталога МойСклад. Ниже описаны параметры обмена, цены и управление подключением.

К сведению

Подписка на магазин Appiko и подписка на коннектор МойСклад оплачиваются отдельно. Код подключения действует 15 минут и используется один раз. Вручную получать API-токен МойСклад для нового подключения не нужно.

Шаги настройки (организация, склад, статусы)

После ввода кода в окне решения МойСклад выберите:

• Юридическое лицо — вашу организацию в МойСклад, на которую будут оформляться заказы.
• Контрагент-покупатель — контрагента для заказов из Telegram-магазина.
• Склад — источник остатков для витрины. Если оставить все склады, остатки суммируются по всем складам аккаунта.

Нажмите Далее. Проверьте предложенное соответствие статусов Appiko и МойСклад и при необходимости измените его. Значение Не синхронизировать оставляет статус без сопоставления.

Статус в мини-приложении	Пример статуса в МойСклад
Новый	«Новый» или «Создан»
Собирается	«В обработке», «На сборке» или «Подтверждён»
Готов к выдаче	Выберите нужное состояние
Доставляется	«Отгружен» или «В доставке»
Доставлен	«Доставлен» или «Выдан»
Подтверждён	Выберите нужное состояние
Завершён	«Выполнен» или «Завершён»
Отменён	«Отменён» или «Аннулирован»

Если нужно резервирование, включите Резервировать товары при создании заказа. Выбранный склад будет указан в заказе; доставка не резервируется. Нажмите Готово, чтобы завершить подключение.

К сведению

Если покупатель применил промокод, Appiko добавит его в комментарий заказа МойСклад и передаст скидку в товарные позиции. Стоимость доставки промокодом не уменьшается.

Цены витрины

В Appiko откройте настройки магазина → МойСклад → Изменить. На шаге Каталог в блоке Цены витрины выберите типы цен из МойСклад:

• Основная цена — обычная цена товара в Telegram-магазине. По умолчанию используется «Цена продажи» или тип цены по умолчанию в МойСклад.
• Цена со скидкой — необязательная цена. Если она ниже основной, покупатель увидит скидку. Выберите Не использовать, если такая цена не нужна.

Пройдите оставшиеся шаги через Далее и нажмите Сохранить.

После подключения ассортимент в разделе Каталог Appiko доступен для просмотра. Названия, цены и остатки редактируйте в МойСклад. В Appiko можно скрывать отдельные товары и категории от покупателей.

Изменение настроек

Для действующего подключения откройте в Appiko МойСклад → Изменить. В окне Настройки МойСклад доступны шаги:

1. Подключение — организация и контрагент для заказов.
2. Каталог — склад и цены витрины.
3. Заказы — резервирование и соответствие статусов.

Измените нужные значения и нажмите Сохранить на последнем шаге. Для подключения через решение МойСклад ввод или замена API-токена здесь не требуется.

Отключение и смена магазина

В Appiko нажмите Перейти на каталог Appiko в каталоге или Отключить МойСклад и перейти на каталог Appiko на вкладке МойСклад. После подтверждения обе кнопки отключают обмен и открывают редактирование каталога в Appiko.

Товары, категории, цены и последние загруженные остатки сохраняются. Обновление товаров и остатков, передача новых заказов и резервов, обновление статусов ранее переданных заказов прекращаются. Уже созданные документы и резервы в МойСклад остаются; изменять или снимать их нужно в МойСклад.

Плашка о каталоге МойСклад исчезает; над каталогом отображается Управление в Appiko. Если магазин подключён через решение, связь с магазином снимается, а само решение остаётся установленным. Для подключения снова создайте код.

В окне решения МойСклад нажмите Отключить магазин. Обмен с этим магазином прекратится, а решение останется установленным. Чтобы связать другой магазин, создайте код в его настройках Appiko, вставьте в МойСклад и завершите настройку.

Чтобы удалить решение полностью, удалите его в каталоге МойСклад. Это также очистит настройки интеграции у связанного магазина. Для повторного подключения нужны новая установка и новый код.

При приостановке подписки коннектора обмен с МойСклад останавливается, а после возобновления ранее завершённое подключение восстанавливается. Подписка самого магазина Appiko действует отдельно.

Ранее подключённые магазины с API-токеном

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

Как заменить токен в старом подключении

1. В Appiko откройте настройки магазина → МойСклад → Изменить.
2. На шаге Подключение нажмите Изменить токен и вставьте новый токен доступа МойСклад.
3. Проверьте организацию, контрагента, склад, цены и статусы на следующих шагах.
4. Нажмите Сохранить.

Если старое подключение отключено, но ввод токена ещё доступен, нажмите Проверить токен и продолжить, вставьте токен и заполните настройки. Подтвердите повторное подключение кнопкой Подключить МойСклад. МойСклад снова станет источником данных: локальные изменения связанных товаров заменятся, а товары только из Appiko после синхронизации перейдут в Удалённые. Корзины с ними могут сброситься. Эти последствия показаны перед подтверждением. Чтобы отключить старое подключение, нажмите Отключить МойСклад и перейти на каталог Appiko на вкладке МойСклад.

Возможные ошибки

Ситуация	Что сделать
Код не принят	Создайте новый код в нужном магазине Appiko. Он должен быть неиспользованным и не старше 15 минут
Время настройки истекло	Снова откройте установленное решение из МойСклад
Нет доступа к настройке	Войдите в МойСклад как администратор
Товары не появляются	Проверьте завершение подключения и состояние синхронизации, затем обновите каталог
Неверные остатки	Проверьте, какой склад выбран в настройках
Неверная цена	Проверьте типы основной и скидочной цены в Appiko и значения этих цен в МойСклад
Коннектор приостановлен	Проверьте срок подписки решения в МойСклад
Неверный API-токен в старом подключении	Замените токен в настройках прежнего подключения
Лимит документов	Проверьте лимит документов на тарифе МойСклад: он может мешать созданию новых заказов

Если проблема сохраняется, напишите в поддержку.