Просмотр исходного текста страницы МойСклад

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

= Настройка интеграции =
# Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br>
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.
# Нажмите на кнопку '''Сохранить'''.<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 документации МойСклад].
# Обратите внимание, что все нужные справочники уже созданы при снхронизации. Вам не нужно создавать справочники, просто выберите нужный.
# Создайте следующие поля:
#* с типом «Строка»:
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''
#** '''Дата доставки''' — для указания даты доставки наряду со временем;
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;
#** '''Количество мест''' — для возможности указания количества мест;
#* с типом «Файл»:
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;
#* с типом «Флажок»:
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;
#* с типом «Справочник»:
#** '''Виды срочности''' — выберите автоматически созданный справочник, который имеет такое же название;
#** '''Временные интервалы''' — выберите автоматически созданный справочник, который имеет такое же название;
#** '''Способы доставки''' — выберите автоматически созданный справочник, который имеет такое же название;
#** '''Тип оплаты''' —выберите автоматически созданный справочник, который имеет такое же название;
#** '''Время доставки с''' — выберите автоматически созданный справочник, который имеет название '''Часы доставки''';
#** '''Время доставки по''' — выберите автоматически созданный справочник, который имеет название '''Часы доставки'''.
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:
:::{|class="wikitable"
!Поля контрагента в MeaSoft
!Настройки МойСклад > Контрагенты
|-
|'''Наименование'''
|'''Наименование'''
|-
|'''Email'''
|'''Электронный адрес'''
|-
|'''Телефон'''
|'''Телефон'''
|-
|'''Полное наименование'''
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''
|-
|'''Юридический адрес'''
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''
|-
|'''Фактический адрес'''
|'''Фактический адрес'''
|-
|}
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.
: 9. Сохраните настройки.

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

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

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

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

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

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

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

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

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

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

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

'''ВАЖНО!''' Если вам нужно полностью обновить ПВЗ, заменив все элементы, то делаем следующее:
* Переименовываем справочник "Способы доставки", например в "Способы доставки (старые)"
* В настройках редактирования полей в текущем поле "Способы доставки"(у вас у поля может быть другое имя - то, которое вы прописали) ставим галку "Скрывать в карточке"
* Запускаем перезагрузку данных и дожидаемся окончания работы
* Создаем новое поле "ПВЗ", с типом справочник, связывая его с новым, только что автоматически созданным, справочником "Способы доставки"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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