База знаний EMS-платформы PlatParts Руководство по настройке EMS-платформы PlatParts

Подключение

На этой странице 18

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

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

См. также

Где находится

Модули интеграций → Интеграции → Создать

Если запись уже есть:

Модули интеграций → Интеграции → Изменить

Что подготовить заранее

Что нужно Где взять
Логин МойСклад Обычно email пользователя МойСклад
Пароль МойСклад Пароль этого пользователя
Организация в МойСклад Та организация, в которую будут создаваться заказы покупателей
Точка выдачи на сайте Та точка, для которой создадите склады и будете проверять каталог
Нужны права в аккаунте МойСклад

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

Шаг 1. Создать запись интеграции

Заполните самые верхние поля:

Поле Что выбрать
Система МойСклад
Название подключения Например: Основной аккаунт МойСклад
Активна Включить

Пример. Если у вас один аккаунт МойСклад на весь магазин, пишите название вроде «МойСклад основной», чтобы потом не путать его с тестовым.

Шаг 2. Учётные данные API

В блоке «Учётные данные API» заполните:

Поле Что писать
МойСклад: логин Логин пользователя МойСклад
МойСклад: пароль Пароль этого пользователя

Здесь не нужен отдельный токен: система подключается обычными данными пользователя МойСклад.

После сохранения можно нажать кнопку «Проверить подключение».

Что делает кнопка «Проверить подключение»

Кнопка отправляет тестовый запрос в МойСклад и проверяет, видит ли ваш аккаунт склады.

Если всё хорошо, увидите сообщение вроде:

Подключение успешно. Складов в учётной системе: N

Если ошибка:

  • проверьте логин и пароль;
  • проверьте права пользователя в МойСклад;
  • откройте если не работает.

Шаг 3. Конфигурация

В блоке «Конфигурация» есть самые важные поля для первого запуска.

Точка выдачи

Поле Зачем
Точка выдачи К какой точке на сайте будут привязаны автоматически созданные склады МойСклад

Пример. Если Вы настраиваете каталог для точки «Астана», выбирайте именно её. Тогда автоматически созданные склады привяжутся к этой точке.

Валюта для новых складов

Поле Зачем
Валюта для новых складов (каталог) Какая валюта будет стоять у складов, которые система создаст автоматически

Если не выбрать — система возьмёт первую активную валюту.

Организация МойСклад для заказов

Поле Зачем
Организация МойСклад для заказов В какую организацию МойСклад отправлять заказы покупателей

Это поле особенно важно, если хотите отправлять заказы покупателей из сайта в МойСклад.

Как выбрать организацию

  1. Сначала заполните логин и пароль.
  2. Сохраните запись.
  3. Снова откройте её.
  4. В списке «Организация МойСклад для заказов» появятся организации из МойСклад.

Без выбранной организации заказы покупателей в МойСклад не создадутся.

Шаг 4. Поведение заказов

В блоке «Поведение заказов» можно сразу оставить всё как есть, если вы только начинаете. Но полезно понимать, что значит каждый переключатель.

Поле Как работает
Синхронизировать заказы поставщику Разрешает создавать заказы поставщикам в МойСклад
Синхронизировать баланс Включает отдельный поток баланса
Не отправлять заказ, если заказ не разобран Если заказ ещё не полностью разобран по поставщикам и позициям, сайт не будет отправлять его в МойСклад
Обновлять карточки контрагентов Если покупатель уже есть в МойСклад, его карточка будет обновляться
Не устанавливать номер заказа в МойСклад Номер заказа будет присваивать сам МойСклад
Удалять отказанные позиции в МойСклад При отказе позиции на сайте она удалится из заказа в МойСклад
Статусы заказов: только логировать (dry-run) Сайт будет писать в лог, что бы он сделал, но реально ничего не менять
Полная отмена заказа Как отменять заказ в МойСклад: удалить или пометить удалённым

Что рекомендовать на старте

Для первого запуска обычно удобно так:

Поле Рекомендация
Синхронизировать заказы поставщику Вкл., если реально используете закупки через МойСклад
Синхронизировать баланс Выкл., пока не нужен отдельный сценарий
Не отправлять заказ, если заказ не разобран Выкл. на старте, если не уверены
Обновлять карточки контрагентов Вкл.
Не устанавливать номер заказа в МойСклад Выкл., если хотите видеть номер сайта в МойСклад
Удалять отказанные позиции в МойСклад Вкл.
Статусы заказов: только логировать (dry-run) Выкл. на рабочем сайте
Полная отмена заказа Удалять заказ в МойСклад

Шаг 5. Потоки синхронизации

Ниже есть блок «Потоки синхронизации». Это отдельные куски работы интеграции.

Поток За что отвечает
Номенклатура (товары) Импорт товаров
Категории Импорт категорий
Остатки Обновление остатков
Фото товаров Загрузка фото
Заказы клиентов Отправка заказов покупателей
Контрагенты Синхронизация покупателей
Заказы поставщикам Создание закупок поставщикам
Баланс Обмен балансом

Для каждого потока есть:

Поле Что означает
Включено Поток вообще участвует в работе
Режим Вручную или По расписанию
Расписание (cron) Когда запускать автоматически

Если выбрать «Вручную»

Поток не запускается сам. Его нужно запускать кнопками в карточке интеграции:

  • Товары и категории
  • Остатки и фото
  • Контрагенты
  • Отправить заказ клиента
  • Заказы поставщикам
  • Синхронизировать баланс

Если выбрать «По расписанию»

Поток будет запускаться сам, если на сервере работает расписание.

Если поле «Расписание (cron)» оставить пустым, система возьмёт свои стандартные интервалы:

Поток По умолчанию
Товары и категории каждый день в 02:00
Остатки и фото каждые 30 минут
Заказы клиентов каждые 10 минут
Контрагенты каждые 6 часов
Заказы поставщикам каждые 15 минут
Баланс каждые 30 минут

Шаг 6. Сохранить

После заполнения полей нажмите Сохранить.

После сохранения станут доступны основные кнопки ручного запуска:

  • Проверить подключение
  • Поставить поток в очередь
  • Создать склады автоматически

Шаг 7. Первый правильный порядок действий

Если вы подключаете МойСклад впервые, лучше идти так:

  1. Сохранить интеграцию.
  2. Нажать Проверить подключение.
  3. Нажать Создать склады автоматически.
  4. Перейти к статье Каталог и остатки и запустить первый импорт.

Что проверить

  • Запись активна
  • Логин и пароль сохранены
  • Проверить подключение проходит без ошибки
  • Выбрана Организация МойСклад для заказов
  • Выбрана Точка выдачи
  • Понимаете, какие потоки запускаете вручную, а какие по расписанию

Дальше: Каталог и остатки.