МойСклад — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
(→‎Настройка интеграции)
(→‎Настройка интеграции)
 
(не показано 9 промежуточных версий 2 участников)
Строка 2: Строка 2:
  
 
= Настройка интеграции =
 
= Настройка интеграции =
−
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br>
+
# Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br>
 
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
 
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
 
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.
 
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.
 
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.
 
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.
 
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].
 
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].
 +
# Обратите внимание, что все нужные справочники уже созданы при снхронизации. Вам не нужно создавать справочники, просто выберите нужный.
 
# Создайте следующие поля:
 
# Создайте следующие поля:
 
#* с типом «Строка»:
 
#* с типом «Строка»:
Строка 20: Строка 21:
 
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;
 
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;
 
#* с типом «Флажок»:
 
#* с типом «Флажок»:
−
#** '''Необходимость возврата''' — необязательное поле для передачи признака «необходимость возврата»;
+
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;
 +
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;
 
#* с типом «Справочник»:
 
#* с типом «Справочник»:
−
#** '''Виды срочности''' — одноименный справочник;
+
#** '''Виды срочности''' — выберите автоматически созданный справочник, который имеет такое же название;
−
#** '''Временные интервалы''' — одноименный справочник;
+
#** '''Временные интервалы''' — выберите автоматически созданный справочник, который имеет такое же название;
−
#** '''Способы доставки''' — одноименный справочник;
+
#** '''Способы доставки''' — выберите автоматически созданный справочник, который имеет такое же название;
−
#** '''Тип оплаты''' — одноименный справочник;
+
#** '''Тип оплаты''' —выберите автоматически созданный справочник, который имеет такое же название;
−
#** '''Время доставки с''' — справочник '''Часы доставки''';
+
#** '''Время доставки с''' — выберите автоматически созданный справочник, который имеет название '''Часы доставки''';
−
#** '''Время доставки по''' — справочник '''Часы доставки'''.
+
#** '''Время доставки по''' — выберите автоматически созданный справочник, который имеет название '''Часы доставки'''.
 
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:
 
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:
 
:::{|class="wikitable"
 
:::{|class="wikitable"
Строка 76: Строка 78:
  
 
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.
 
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.
 +
 +
= Передача дробных значений количества =
 +
 +
Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом  1кг.
 +
 +
Для этого в настройках интеграции вам нужно заполнить 2 поля
 +
 +
- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"
 +
 +
- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.
 +
 +
Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001
 +
 +
= Передача данных из ЛК в МойСклад =
 +
 +
Интеграция может передавать в ваши кастомные поля заказа МойСклад следующие значения:
 +
 +
1) Статус заказа
 +
 +
2) Сумму заказа
 +
 +
3) Стоимость доставки
 +
 +
4) Внешний код подрядчика
 +
 +
5) Дату и время доставки  (для получения создайте поле с типом "строка")
 +
 +
Передача этих данных осуществляется через сопоставление полей в настройках интеграции.
  
 
= Известные проблемы =
 
= Известные проблемы =
Строка 81: Строка 111:
 
Модуль интеграции не работает на бесплатном тарифе.
 
Модуль интеграции не работает на бесплатном тарифе.
  
−
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.
+
Если заказ не уходит, попробуйте поставить ему какой-то любой статус, а потом снова тот, в котором он должен уходить и подождите 10 минут.

Текущая версия на 13:00, 11 ноября 2024

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

Настройка интеграции

  1. Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.

    Примечание. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.
    Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.

  2. Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
  3. Нажмите на кнопку Сохранить.
    В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку Сбросить.
  4. Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).
    Когда синхронизация окончится, автоматически откроется страница следующего шага.
  5. В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в Продажи > Заказы покупателей, в правой части экрана нажмите на кнопку с шестеренкой и в разделе Дополнительные поля нажмите на кнопку +Поле. Подробнее см. в документации МойСклад.
  6. Обратите внимание, что все нужные справочники уже созданы при снхронизации. Вам не нужно создавать справочники, просто выберите нужный.
  7. Создайте следующие поля:
    • с типом «Строка»:
      • Город — для указания населенного пункта получателя; Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад
      • Адрес — для указания адреса получателя; Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад
      • Индекс — для указания индекса получателя; Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад
      • Дата доставки — для указания даты доставки наряду со временем;
      • Сумма заказа — для получения суммы заказа от курьерской службы;
      • Стоимость доставки — для получения стоимости доставки от курьерской службы;
      • Строка для сохранения информации об ошибках — для получения текста ошибки;
      • Количество мест — для возможности указания количества мест;
    • с типом «Файл»:
      • Файл — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;
    • с типом «Флажок»:
      • Необходимость возврата — необязательное поле. Используется для передачи признака «необходимость возврата»;
      • Оплата получателем — необязательное поле. Используется для передачи признака «оплата получателем»;
    • с типом «Справочник»:
      • Виды срочности — выберите автоматически созданный справочник, который имеет такое же название;
      • Временные интервалы — выберите автоматически созданный справочник, который имеет такое же название;
      • Способы доставки — выберите автоматически созданный справочник, который имеет такое же название;
      • Тип оплаты —выберите автоматически созданный справочник, который имеет такое же название;
      • Время доставки с — выберите автоматически созданный справочник, который имеет название Часы доставки;
      • Время доставки по — выберите автоматически созданный справочник, который имеет название Часы доставки.
  8. В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела Контрагенты в «МойСклад»:
Поля контрагента в MeaSoft Настройки МойСклад > Контрагенты
Наименование Наименование
Email Электронный адрес
Телефон Телефон
Полное наименование для юр. лица — Полное наименование
для ИП — в формате [ИП Фамилия Имя Отчество]
для физ. лица — Фамилия Имя Отчество
Юридический адрес для юр. лица — Юридический адрес
для ИП — Адрес регистрации
для физ. лица — Адрес регистрации
Фактический адрес Фактический адрес
8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях ФИО отправителя и Телефон отправителя выберите значение Не передавать.
9. Сохраните настройки.

Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.

Поля Cтоимость доставки, Сумма и Ошибка заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.

Если нужна доставка по адресу, оставьте поле Тип доставки пустым. Иначе выберите ПВЗ из списка.

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

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

Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.

Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле Ошибка. Заполните поля, указанные в поле Ошибка, очистите поле Ошибка и сохраните заказ.

Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в личный кабинет клиента и на вкладке Отслеживание проверьте, существует ли отправленный заказ.

Обновление данных из ЛК

Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.

Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.

Передача дробных значений количества

Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом 1кг.

Для этого в настройках интеграции вам нужно заполнить 2 поля

- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"

- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.

Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001

Передача данных из ЛК в МойСклад

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

1) Статус заказа

2) Сумму заказа

3) Стоимость доставки

4) Внешний код подрядчика

5) Дату и время доставки (для получения создайте поле с типом "строка")

Передача этих данных осуществляется через сопоставление полей в настройках интеграции.

Известные проблемы

Модуль интеграции не работает на бесплатном тарифе.

Если заказ не уходит, попробуйте поставить ему какой-то любой статус, а потом снова тот, в котором он должен уходить и подождите 10 минут.

Источник — «https://wiki.courierexe.ru/index.php?title=МойСклад&oldid=15138»