retailCRM Документация

Интеграция с МойСклад

Возможности системы МойСклад

Переход со старой версии МойСклад на новую

Для перехода на новую версию МойСклад Вам необходимо перейти в модуль интеграции и в первой вкладке нажать на кнопку «Перейти на новую версию».

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

Важно: после перехода старая интеграция будет недоступна.

Настройка интеграции с МойСклад

Важно: для работы интеграции необходим доступ к API МойСклад. Обратите внимание, что необходим платный тариф и аккаунт с правами администратора.

Пользовательские поля, необходимые для синхронизации создаются автоматически. Данные поля никоим образом редактировать нельзя. В противном случае работа интеграции не гарантирована.

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

API-ключ создается по пути Администрирование > Интеграция > Ключи доступа к API.

Важно: у создаваемого ключа должен быть открыт доступ ко всем магазинам и активированы все методы. Также данный ключ не должен использоваться в других интеграциях.

После создания ключа переходите во вкладку маркетплейс и кликайте по модулю «МойСклад 2.0».

Во всплывающем окне нажмите на кнопку «Подключить».

После нажатия Вы переходите на страницу подключения. На странице подключения МойСклад необходимо указать логин и пароль учетной записи МойСклад, а также адрес Вашей системы и ранее созданный API-ключ.

Примечание: адрес системы вписывается полностью (например https://demo.retailcrm.ru).

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

После активации Вы переходите на следующую страницу настроек.

Вкладка «CRM»

В разделе «Настройки синхронизации с сервисом МойСклад» выставляете необходимые Вам галочки.

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

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

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

Проводить перемещения автоматически - означает, что все автоматически создаваемые перемещения будут проводиться при создании (будет происходить движение остатков между складами).

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

Примечание: осуществляется прием статусов заказа, комментария менеджера и изменений по позициям в заказе.

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

Не синхронизировать остатки у неактивных товаров - данная настройка проверяет активность товаров. У неактивного товара остатки не актуализируются.

Не учитывать ожидаемый товар в общем остатке - при включении данной настройки из общего доступного остатка будет вычитаться то количество товара, которое находится на данный момент в ожидании. Стандартно, МойСклад возвращает доступный остаток товара с учётом товара в ожидании (ожидание - то количество товара, по которому создан заказ поставщику с отметкой "Ожидание").

Загружать в заказ системы себестоимость товаров при отгрузке в МойСклад - данная настройка позволяет совместно со статусом отгрузки загружать в заказ системы информацию о себестоимости товаров по данному заказу на момент создания документа отгрузки в МойСклад. При выгрузке себестоимости данные берутся по тому же алгоритму, что и при обычной синхронизации остатков и закупочных цен.

Данная настройка будет добавлять закупочную стоимость только в том случае, если на момент отправки информации из МойСклад в систему у товаров в заказе не будет проставлена закупочная стоимость. Настройка предназначена в первую очередь для товаров, которые реализуются под заказ. То есть для тех товаров, у которых на момент создания заказа неизвестна закупочная стоимость.

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

Обратите внимание, что данная настройка доступна только при активной опции «Загружать в заказ CRM себестоимость товаров при отгрузке в МойСклад»

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

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

Обратите внимание, что передача типа доставки при настроенном соответствии работает только в том случае, если включена настройка «Передавать доставку как товарную позицию в заказе».

Отключение передачи номера отгрузки при создании документа отгрузки на стороне МС - после активации данного чекбокса отгрузки создаются с номером, который присваивается системой МойCклад автоматически.

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

Выгрузка истории изменений по контрагентам из CRM в МС - после активации данного чекбокса из системы в МойСклад будут уходить изменения по клиентам:

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

Магазины

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

Односторонняя синхронизация (из системы в МойСклад) работает со следующими данными:

Двусторонняя интеграция работает со следующими данными:

Также по составу заказа передаются изменения позиций, количества, цены и скидки.

Обратная интеграция (из МойСклад в систему):

Обратите внимание, что для корректной работы функционала резервирования остатков необходимо включить работу со складами, бронирование и редактирование остатков. Данные настройки находятся по пути Администрирование > Настройки > Склад.

Изменение статуса в МойСклад, а также отгрузка проходят сразу. Изменения из системы в МойСклад выгружаются 1 раз в 10 минут.

Склады

Во вкладке «Склады» необходимо настроить соответствие складов системы и МойСклад.

Важно: соответствие складов должно быть заведено один к одному. В противном случае настройки не сохранятся.

Статусы

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

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

Важно: соответствие статусов должно быть заведено один к одному. В противном случае настройки не сохранятся.

Статусы выгрузки

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

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

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

Во время выгрузки заказа из системы также происходит и выгрузка контрагента. Во время выгрузки ведется поиск уже существующего контрагента. В случае, если контрагент не найден - создается новый контрагент.

Поиск осуществляется по полям:

Обратите внимание, что для корректной выгрузки контрагента из системы у него должны быть заполнены поля Ф.И.О. (данные должны быть заполнены в карточке клиента).

Статусы создания отгрузки

Вкладка «Статусы создания отгрузки» необходима при выгрузке заказов (создании или обновлении). Если заказ достигает одного из выбранных статусов, в МойСклад автоматически создается и проводится документ отгрузки с идентичными позициями, которые указаны в заказе в МойСклад.

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

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

Примечание: после создания проведённой отгрузки все резервы товаров по заказу будут списаны.

Статусы отмены отгрузки

Настройки во вкладке «Статусы отмены отгрузки» работают следующим образом:

Для всех заказов, которые переходят в статусы отгрузки, будут найдены связанные с ними отгрузки в МойСклад. Также для каждой отгрузки сформируется документ возврата покупателем.

Статусы резервирования продукта

На этой вкладке Вы можете выбрать статусы товаров, при которых они будут зарезервированы в заказе МойСклад. Резервирование проходит при выгрузке заказа из системы в МойСклад и при обновлении уже выгруженного заказа.

Данная настройка работает при условии, что основной функционал автоматического резервирования товара включен (опция «Создавать резерв автоматически» во вкладке «CRM»).

В случае, если этого не сделано, будет выведено соответствующее предупреждение на странице.

Если включена только опция «Создавать резерв автоматически», но не выбрано ни одного статуса для товара во вкладке «Статусы резервирования продукта», то резервирование товара будет работать по старой механике. То есть, будет резервироваться автоматически весь товар в заказе.

Типы оплат

Во вкладке «Типы оплат» производится настройка соответствия типов оплат. Для выбора доступно два документа: приходный ордер и входящий платеж (приход).

Опция «Перенос значений совпадающих польз. полей из заказа при создании» позволяет произвести перенос всех значений пользовательских полей из заказа в документ платежа в момент создания модулем платёжного документа.

Условия для успешного переноса значений пользовательских полей:

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

Статусы оплат

Во вкладке «Статусы оплаты» производится настройка статусов оплат для проведения документов оплаты.

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

Синхронизация платежных документов

На данной вкладке настраивается синхронизация по платёжным документам.

Настройки указываются отдельно для двух типов документов - приходный ордер и входящий платёж.

Для типа документа доступно две опции:

А также несколько настроек:

Обрабатываемые ситуации:

Необходимые условия для корректной работы функционала:

Расчётные счета

Во вкладке «Расчётные счета» осуществляется привязка расчётного счёта юридического лица в МойСклад к типу платежа, который указан в заказе системы.

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

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

Примечание: во время привязки учитывается последний изменённый или добавленный платёж. Если за одну итерацию добавлено/изменено несколько платежей в заказе, то учитывается первый в списке.

Для настройки расчётных счетов необходимо:

При настройке соответствия расчётных счетов необходимо выбрать нужный тип оплаты на странице настроек. Если все условия для успешной настройки соблюдены, появится список магазинов (каждый со своим списком расчётных счетов).

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

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

Пользовательские поля

Во вкладке «Пользовательские поля» производится настройка передачи пользовательcких (и некоторых стандартных) полей из заказа системы в заказ МойСклад. Передача односторонняя.

Настройки

Пользователь в retailCRM, который будет уведомлен о проблемах с интеграцией - в данной настройке выбирается пользователь системы, на которого будет поставлена задача в случае, если возникла какая-то непредвиденная ситуация с интеграцией, которую модуль не смог обработать (в первую очередь проблемы, связанные с авторизационными данными системы МойСклад).

Принудительно удалять заказ из МС вместе со связанными документами - данная настройка позволяет Вам выбирать, стоит ли форсированно удалять заказы в МойСклад, если они были удалены в Вашей системе. Обратите внимание, что все связанные документы также удаляются.

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

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

При активации опции Получать изменения адреса контрагентов из МС в систему будет выгружаться изменение адреса (Фактический адрес) контрагента в поле «Примечания к адресу» (customer[address][notes]).

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

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

Передаются изменения по полям:

Тип синхронизации контрагента в МС

На данный момент доступно 4 типа синхронизации:

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

Формирование соответствия происходит непосредственно при сохранении настроек в модуле. Если был добавлен новый магазин и/или склад, необходимо зайти в настройки модуля и повторно сохранить соответствие. Если код указанного в заказе системы магазина/склада не будет найден - в журнал будет выведено соответствующее сообщение об ошибке.

Группа контрагента

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

Розница

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

Разберем основные настройки:

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

Обратите внимание, что работа вышеописанного алгоритма зависит от включения опций «Увеличивать кол-во, если товара из заказа продано больше», «Уменьшать кол-во, если товара из заказа продано меньше», «Добавлять новые товары из продажи в заказ» и «Удалять отсутствующие в продаже товары из заказа» - при синхронизации товарного состава будут выполнены только те действия, для которых включены соответствующие опции. Если ни одна из перечисленных опций не включена, то синхронизация не сработает.

При этом не учитываются дополнительные продажи (если для заказа создано несколько розничных продаж) и документы отгрузки (если часть товара отгрузили, а часть продали через розницу).

Указанные выше опции работают только для продаж, оформленных на основе уже имеющихся заказов, когда происходит обновление уже существующего заказа в системе. При создании новых заказов товарный состав будет полностью перенесён.

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

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

Помимо выгрузки в пользовательские поля модуль поддерживает запись в стандартные поля: «Комментарий клиента», «Дата доставки», «Время доставки» и «Способ доставки». Для поля «Способ доставки» есть ограничение - в МойСклад это должен быть тип справочник, где в качестве кода для каждого значения должен быть указан полностью совпадающий код из способа доставки в системе. В противном случае значения передаваться не будут.

Журнал

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

Обратите внимание, что количество записей ограничено количеством в 50 штук, а также каждая запись хранится не более 5 дней.

Передача данных

Синхронизация номенклатуры

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

Для магазинов, имеющих синхронизацию номенклатуры с системой (настраивается для интернет-магазина и МойСклад)

Если номенклатура Вашего интернет-магазина синхронизирована с системой (из интернет-магазина приходят заказы с указанным составом товаров), то для работы с МойСклад Вам потребуется настроить синхронизацию каталога на стороне интернет-магазина с каталогом в МойСклад. Стандартные решения для синхронизации Вы сможете найти в разделе Настройки > Интернет магазин.

Обратите внимание, что для корректной работы при обмене каталога с системой через ICML, в поле xmlId для товарного предложения offer, если товар не имеет модификаций в МойСклад, должен быть указан внешний код товара (например, o6-XTo1XgVuMLHC8qWyfj2).

В случае, если товар имеет модификации, то необходимо указать внешний код товара и товарного предложения из МойСклад, разделенные символом # (например, o6-XTo1XgVuMLHC8qWyfj2#zGSFiBnYg22GQYEl3IVUQ2).

Для посадочных страниц (landing pages) и магазинов, не имеющих синхронизации номенклатуры с системой

Если Ваш магазин не имеет синхронизации по номенклатуре с системой (из магазина приходят заказы без указания состава товаров), то для синхронизации номенклатуры между МойСклад и системой необходимо сгенерировать ICML файл, используя API МойСклад. Для генерации рекомендуется использовать генератор ICML для каталога из МойСклад.

Отслеживание загрузки заказа

Отслеживание загрузки заказа возможно при помощи пользовательского поля «Идентификатор в системе МойСклад».

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

Важный момент! Настоятельно рекомендуем не редактировать данное поле. В противном случае, корректная работа интеграции не гарантирована.

Синхронизация контрагентов

В момент выгрузки заказа осуществляется поиск контрагента, соответствующего данному клиенту в заказе.

Поиск осуществляется по полям в следующей последовательности:

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

По умолчанию выгружаются следующие поля:

Дополнительно могут быть выгружены юридические реквизиты, соответствующие каждому типу контрагента (если они заполнены у Вас в системе):

При наличии в системе данных о банковских реквизитах клиента, контрагенту в МойСклад будет создан соответствующий расчётный счёт с этими данными:

При этом созданный расчётный счёт отмечается как основной счёт контрагента.

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

Если тип контрагента не является физическим лицом, в качестве имени ему будет присвоено Полное наименование из юридических реквизитов (из Вашей системы), а также будет создано контактное лицо, содержащее само имя, email и телефон.

Расчётный счёт и контактное лицо создаются только после успешного создания самого контрагента - это означает, что контрагент будет создан в любом случае (при правильно заполненных данных клиента и настройках модуля), независимо от того, успешны ли были попытки создания расчётного счёта или контактного лица для него.

Важный момент! В связи с ограничениями API МойСклад, соответствия по номеру телефона срабатывают только при полном совпадении номеров. Т.е. по номеру +79031234567 не удастся найти контрагента с номером 8 (903) 123-45-67.

Обновление остатков

Для корректной работы выгрузки остатков из «МойСклад» в систему, необходимо выполнить следующие условия:

  1. Модуль «МойСклад 2.0» должен быть активирован;
  2. Использовать отдельный API-ключ, в котором будет задан тип доступа «Доступ ко всем магазинам» и разрешены все методы API.
  3. Задано корректное соответствие магазинов и складов в настройках модуля «МойСклад 2.0»;
  4. Включена опция в настройках системы «Разрешить редактирование остатков»;
  5. Внешний код товара «МойСклад» совпадал с xmlId торгового предложения системы;

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

Примечание: если из МойСклад приходит остаток свыше 999999 штук, записывается как 999999.

Если в настройках интеграции в системе стоит галочка «Создавать перемещения», и если склад отгрузки отличается от основного склада в МойСклад - перемещения создаются в МойСклад автоматически.

Синхронизация закупочных цен товаров

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

Синхронизация менеджеров

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

Обратите внимание, что при отсутствии соответствующего сотрудника в МойСклад, новый создан не будет. Это связанно с ограничением API системы МойСклад.

Далее, в разделе «Дополнительные поля» кликните по полю «+Поле» и выберите тип «Справочник - Сотрудник», как показано ниже:

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

Синхронизация менеджеров происходит в разрезе выгрузки пользовательских полей в настройках интеграции.

Чтобы менеджер передался в МойСклад, он должен быть создан там как сотрудник. Также обратите внимание, что для корректной передачи менеджера необходимо, чтобы поля e-mail и телефон были заполнены на стороне системы и МойСклад.

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

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

Смена учётной записи МойСклад

Изменение настроек интеграции модуля, в случае создания нового кабинета в сервисе МойСклад, осуществляется только через запрос в нашу техническую поддержку по адресу support@retailcrm.ru.


Редакция от 23.08.2019 17:56