Как подключить МойСклад
Эта инструкция нужна для самого первого шага: создать подключение, проверить логин и пароль, выбрать организацию и решить, какие потоки будете запускать автоматически, а какие вручную.
См. также
Где находится
Модули интеграций → Интеграции → Создать
Если запись уже есть:
Модули интеграций → Интеграции → Изменить
Что подготовить заранее
| Что нужно | Где взять |
|---|---|
| Логин МойСклад | Обычно email пользователя МойСклад |
| Пароль МойСклад | Пароль этого пользователя |
| Организация в МойСклад | Та организация, в которую будут создаваться заказы покупателей |
| Точка выдачи на сайте | Та точка, для которой создадите склады и будете проверять каталог |
Если у пользователя МойСклад нет прав на склады, товары, контрагентов или заказы, часть кнопок будет работать с ошибками, даже если логин и пароль правильные.
Шаг 1. Создать запись интеграции
Заполните самые верхние поля:
| Поле | Что выбрать |
|---|---|
| Система | МойСклад |
| Название подключения | Например: Основной аккаунт МойСклад |
| Активна | Включить |
Пример. Если у вас один аккаунт МойСклад на весь магазин, пишите название вроде «МойСклад основной», чтобы потом не путать его с тестовым.
Шаг 2. Учётные данные API
В блоке «Учётные данные API» заполните:
| Поле | Что писать |
|---|---|
| МойСклад: логин | Логин пользователя МойСклад |
| МойСклад: пароль | Пароль этого пользователя |
Здесь не нужен отдельный токен: система подключается обычными данными пользователя МойСклад.
После сохранения можно нажать кнопку «Проверить подключение».
Что делает кнопка «Проверить подключение»
Кнопка отправляет тестовый запрос в МойСклад и проверяет, видит ли ваш аккаунт склады.
Если всё хорошо, увидите сообщение вроде:
Подключение успешно. Складов в учётной системе: N
Если ошибка:
- проверьте логин и пароль;
- проверьте права пользователя в МойСклад;
- откройте если не работает.
Шаг 3. Конфигурация
В блоке «Конфигурация» есть самые важные поля для первого запуска.
Точка выдачи
| Поле | Зачем |
|---|---|
| Точка выдачи | К какой точке на сайте будут привязаны автоматически созданные склады МойСклад |
Пример. Если Вы настраиваете каталог для точки «Астана», выбирайте именно её. Тогда автоматически созданные склады привяжутся к этой точке.
Валюта для новых складов
| Поле | Зачем |
|---|---|
| Валюта для новых складов (каталог) | Какая валюта будет стоять у складов, которые система создаст автоматически |
Если не выбрать — система возьмёт первую активную валюту.
Организация МойСклад для заказов
| Поле | Зачем |
|---|---|
| Организация МойСклад для заказов | В какую организацию МойСклад отправлять заказы покупателей |
Это поле особенно важно, если хотите отправлять заказы покупателей из сайта в МойСклад.
Как выбрать организацию
- Сначала заполните логин и пароль.
- Сохраните запись.
- Снова откройте её.
- В списке «Организация МойСклад для заказов» появятся организации из МойСклад.
Без выбранной организации заказы покупателей в МойСклад не создадутся.
Шаг 4. Поведение заказов
В блоке «Поведение заказов» можно сразу оставить всё как есть, если вы только начинаете. Но полезно понимать, что значит каждый переключатель.
| Поле | Как работает |
|---|---|
| Синхронизировать заказы поставщику | Разрешает создавать заказы поставщикам в МойСклад |
| Синхронизировать баланс | Включает отдельный поток баланса |
| Не отправлять заказ, если заказ не разобран | Если заказ ещё не полностью разобран по поставщикам и позициям, сайт не будет отправлять его в МойСклад |
| Обновлять карточки контрагентов | Если покупатель уже есть в МойСклад, его карточка будет обновляться |
| Не устанавливать номер заказа в МойСклад | Номер заказа будет присваивать сам МойСклад |
| Удалять отказанные позиции в МойСклад | При отказе позиции на сайте она удалится из заказа в МойСклад |
| Статусы заказов: только логировать (dry-run) | Сайт будет писать в лог, что бы он сделал, но реально ничего не менять |
| Полная отмена заказа | Как отменять заказ в МойСклад: удалить или пометить удалённым |
Что рекомендовать на старте
Для первого запуска обычно удобно так:
| Поле | Рекомендация |
|---|---|
| Синхронизировать заказы поставщику | Вкл., если реально используете закупки через МойСклад |
| Синхронизировать баланс | Выкл., пока не нужен отдельный сценарий |
| Не отправлять заказ, если заказ не разобран | Выкл. на старте, если не уверены |
| Обновлять карточки контрагентов | Вкл. |
| Не устанавливать номер заказа в МойСклад | Выкл., если хотите видеть номер сайта в МойСклад |
| Удалять отказанные позиции в МойСклад | Вкл. |
| Статусы заказов: только логировать (dry-run) | Выкл. на рабочем сайте |
| Полная отмена заказа | Удалять заказ в МойСклад |
Шаг 5. Потоки синхронизации
Ниже есть блок «Потоки синхронизации». Это отдельные куски работы интеграции.
| Поток | За что отвечает |
|---|---|
| Номенклатура (товары) | Импорт товаров |
| Категории | Импорт категорий |
| Остатки | Обновление остатков |
| Фото товаров | Загрузка фото |
| Заказы клиентов | Отправка заказов покупателей |
| Контрагенты | Синхронизация покупателей |
| Заказы поставщикам | Создание закупок поставщикам |
| Баланс | Обмен балансом |
Для каждого потока есть:
| Поле | Что означает |
|---|---|
| Включено | Поток вообще участвует в работе |
| Режим | Вручную или По расписанию |
| Расписание (cron) | Когда запускать автоматически |
Если выбрать «Вручную»
Поток не запускается сам. Его нужно запускать кнопками в карточке интеграции:
- Товары и категории
- Остатки и фото
- Контрагенты
- Отправить заказ клиента
- Заказы поставщикам
- Синхронизировать баланс
Если выбрать «По расписанию»
Поток будет запускаться сам, если на сервере работает расписание.
Если поле «Расписание (cron)» оставить пустым, система возьмёт свои стандартные интервалы:
| Поток | По умолчанию |
|---|---|
| Товары и категории | каждый день в 02:00 |
| Остатки и фото | каждые 30 минут |
| Заказы клиентов | каждые 10 минут |
| Контрагенты | каждые 6 часов |
| Заказы поставщикам | каждые 15 минут |
| Баланс | каждые 30 минут |
Шаг 6. Сохранить
После заполнения полей нажмите Сохранить.
После сохранения станут доступны основные кнопки ручного запуска:
- Проверить подключение
- Поставить поток в очередь
- Создать склады автоматически
Шаг 7. Первый правильный порядок действий
Если вы подключаете МойСклад впервые, лучше идти так:
- Сохранить интеграцию.
- Нажать Проверить подключение.
- Нажать Создать склады автоматически.
- Перейти к статье Каталог и остатки и запустить первый импорт.
Что проверить
- Запись активна
- Логин и пароль сохранены
- Проверить подключение проходит без ошибки
- Выбрана Организация МойСклад для заказов
- Выбрана Точка выдачи
- Понимаете, какие потоки запускаете вручную, а какие по расписанию
Дальше: Каталог и остатки.