Перейти к содержанию

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

Внимание!

Перед интеграцией необходимо установить счетчик Roistat!

Как работает интеграция

  1. Новая заявка создается в CRM МойСклад как сделка + контрагент.

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

Если в настройках интеграции заполнено поле Контрагент (необязательное поле), то все сделки будут присваиваться ему. Если поле Контрагент не заполнено, то будет осуществляться проверка по контактным данным: будет ли вместе со сделкой создан новый контрагент.

  1. В аналитику Roistat выгружаются данные по сделкам и контрагентам.

Шаг 1. Добавьте дополнительное поле roistat

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

  1. Откройте Продажи -> Заказы покупателей -> Шестеренка справа -> Настройка заказов покупателей -> Дополнительные поля: 1.jpg
  2. Добавьте поле с параметрами

  3. Название: roistat

  4. Тип: Строка

  5. Обязательный: нет

2.png

Внимание!

Используя этот код, в дополнительном поле можно создать статус заявки:

'state' => '<Value>', // Статус создаваемого заказа (Необязательное поле).
'currency_uuid' => '<Value>', // Поле 'Валюта' в заказе покупателя.
'project_uuid' => '<Value>', // Поле 'Проект' в заказе покупателя.
'contract_uuid' => '<Value>', // Поле 'Договор' в заказе покупателя.
'owner_uid' => 'demo@login', // Назначения ответственного по сделке. Вместо demo@login - укажите логин сотрудника для входа в систему (логины сотрудников можно посмотреть в системе, перейдя в пункт меню "Моя компания" и нажав на вкладку "Сотрудники", в поле "Логин").
'existing_store_uuid' => '<Store_ID>', // Обязательный параметр. Заменить <Store_ID> на идентификатор склада (например, 770657b-4fd2-11e4-90a2-8eca004192b1).
'existing_organization_uuid' => '<Org_ID>', // Обязательный параметр. Заменить <Org_ID> на идентификатор Юр.лица.
'existing_counterparty_uuid' => '<Counter_ID>', // Заменить <Item_ID> на идентификатор контрагента.
'existing_good_uuid' => array( // Обязательный параметр. array( 'uuid' => '<Good_ID>', // Заменить <Good_ID> на идентификатор товара.
'count' => '<Count>', // Заменить <Count> на кол-во товаров в заказе этого наименования. (Необязательный параметр, по умолчанию = 1).
'discount' => '<Discount_percent>', // Заменить <Discount_percent> на размер скидки в процентах (Необязательный параметр, по умолчанию будет = 0).
'vat' => '18', // НДС. По умолчанию - 18%. Вы можете задать собственное значение.
'sum' => '0', // Сумма товара. Вы можете задать собственное значение. ), array( // Этот массив нужен, если товаров несколько.
'uuid' => '<Good_ID>', // Необязательный параметр.
'count' => '<Count>', // Необязательный параметр.
'discount' => '<Discount_percent>', // Необязательный параметр.
'<Field_Name>' => '<Value>', // Заменить <Value> на значение поля.

Подробнее о передаче заявок в CRM через Roistat читайте в этой статье.

Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле roistat данными об источнике сделки. Тогда информация об источнике сделки будет отображена в Аналитике.

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:

  • yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1.
  • direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
  • google{ID}, если хотите отнести сделку к каналу Google Adwords. Например, google3.
  • merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
  • vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
  • facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
  • mytarget{ID}, если хотите отнести сделку к каналу myTarget.
  • seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
  • seo_google, если хотите отнести сделку к каналу SEO - Google.

Шаг 2. Подключите МойСклад в Каталоге интеграций

  1. Откройте раздел Каталог интеграций.
  2. В блоке CRM выберите МойСклад и нажмите кнопку Настроить интеграцию.
  3. Заполните поля для авторизации в МоемСкладе:

    1. В полях Логин и Пароль введите логин и пароль вашего аккаунта в МоемСкладе.
    2. Введите идентификатор контрагента. В таком случае все сделки будут создаваться на конкретного контрагента. Идентификатор контрагента - необязательное поле.
    3. Введите идентификатор юр. лица.
    4. Введите идентификатор товара.
    5. Введите идентификатор склада.

Как узнать идентификаторы?

Идентификатор контрагента

  1. Откройте Контрагенты → Контрагент и выберите нужного контрагента.
  2. Нажмите на строку с названием выбранного контрагента. Откроется окно редактирования информации о контрагенте. Идентификатор находится в адресной строке браузера, после знака "=": 3.jpg

Идентификатор юр. лица

  1. Откройте Настройки → Юр.лица: 4.jpg

  2. Выберите нужное юр.лицо. и нажмите на строку с выбранным юр. лицом. Откроется окно редактирования информации о юр. лице. Идентификатор находится в адресной строке браузера, после знака "=": https://online.moysklad.ru/app/#mycompany/edit?id=88afc7af-ccbd-11e4-7a40-e8970025f08d. 5.jpg

Идентификатор товара

  1. Откройте Товары → Остатки и выберите нужный товар.
  2. Нажмите на строку таблицы с названием выбранного товара, справа откроется панель с остатками данного товара по складам. Идентификатор находится в адресной строке браузера, после знака "=": например, https://online.moysklad.ru/app/#right?stockReport?reportType=GOODS+%7Cdetail?XXX, где XXX - искомый идентификатор товара.

  3. Проверьте идентификатор товара в остатках и в списке Товары и услуги. Если он один и тот же, перейдите по ссылке https://online.moysklad.ru/api/remap/1.1/entity/product/XXX, где XXX - идентификатор товара.

  4. Если вы не авторизованы в МойСклад, введите логин и пароль, которые указаны в интеграции. Идентификатор товара в ссылке изменится на тот, который нужно указать в интеграции.

Идентификатор склада

  1. Откройте Настройки → Склады: 6.jpg
    1. Выберите нужный склад и нажмите на строку с названием склада. Откроется окно редактирования информации о складе. Идентификатор находится в адресной строке браузера, после знака "=": https://online.moysklad.ru/app/#warehouse/edit?id=>*88b0f625-ccbd-11e4-7a40-e8970025f08f. 7.jpg |

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

  1. Нажмите Сохранить. Загрузятся статусы сделок из МоегоСклада.
  2. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.
  3. Нажмите Продолжить.

  4. Укажите параметры для расширенной настройки:

  5. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.

  6. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.

  7. Нажмите Сохранить.

  8. В поле Ответственные за заявки выберите менеджеров из выпадающего списка: 8.png После этого Roistat будет автоматически распределять сделки по указанным менеджерам.

Как узнать идентификатор менеджера:

  1. Откройте Настройки → Сотрудники: 9.jpg
  2. Выберите нужного сотрудника и нажмите на строку с выбранным сотрудником. Откроется окно редактирования информации о сотруднике. Идентификатор находится в адресной строке браузера, после знака "=": 10.jpg

  3. Нажмите Сохранить.

Поле Контактный телефон заполнять не нужно, оно должно быть пустым: 11.jpg

Шаг 3. Настройте автоматическую отправку сделок в МойСклад

Рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

Если отправка сделок с сайта в CRM уже настроена с помощью вашего кода, для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat сделки значением куки браузера *roistat_visit.

Пример кода, с помощью которого можно получить значение этой куки:

`$roistatVisitId` `= ``array_key_exists``(``'roistat_visit'``, ``$_COOKIE``) ? ``$_COOKIE``[``'roistat_visit'``] : ``"неизвестно"``;`

Типы полей:

Тип поля в МойСклад TYPE параметр поля Название полей в МойСклад
timeValue time Дата
doubleValue double Число дробное
longValue long Число целое
valueString string Строка
valueText text Текст
entityValueUuid entity uuid (идентификатор) элемента дополнительного справочника
agentValueUuid agent uuid (идентификатор) элемента справочника контрагентов
goodValueUuid good uuid (идентификатор) элемента справочника товаров
employee employeeValueUuid uuid (идентификатор) элемента справочника сотрудников

Проверка работы

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

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

Звонки клиентов отображаются в разделе Контрагенты - Звонки:12.png

Решение проблем

Как считается себестоимость по каждому заказу в МойСклад?

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

1) Себестоимость заказа = сумме себестоимости всех товаров в заказе. Например, мы имеем заказ из 3 товаров. Сначала берем первый товар и получаем у него себестоимость, которую можно найти в отчете Склад -> Остатки и введя в поиске нужный товар. 13.png

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

После этого, по такому же принципу получается себестоимость всех оставшихся товаров и получается итоговая себестоимость заказа.

2) Если себестоимость всех заказов = 0 (то есть неправильно заполняются документы в МойСклад), то за себестоимость считается как сумма закупочной стоимости всех товаров в заказе. 14.png

3) Если вы знаете точную себестоимость заказа, и она хранится в дополнительном поле у заказа, то его можно выбрать в настройках интеграции в Roistat. 15.png

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

4) Для каждого заказа вы можете задать Прибыль от сделки в интерфейсе Roistat. Нужно перейти в Настройки -> Настройки проекта и задать значение настройки Прибыль со сделки

16.png

Себестоимость посчитается по формуле: Себестоимость = Выручка - Прибыль

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

Если себестоимость товара по отгрузке отображается неверно

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

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

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