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

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

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

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

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

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

1. В интерфейсе CRM МойСклад откройте Продажи → Заказы покупателей → Шестеренка справа → Настройка заказов покупателей → Дополнительные поля:

1. Добавьте поле с параметрами:
2. Название: roistat
3. Тип: Строка
4. Обязательный: нет

'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 читайте в этой статье.

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

1. В проекте Roistat откройте раздел Интеграции и нажмите Добавить интеграцию. В блоке Каталог CRM/CMS найдите МойСклад и нажмите Добавить:

   

   Затем нажмите Настроить интеграцию:

   

2. Заполните поля для авторизации в CRM МойСклад:

   • В полях Логин и Пароль введите логин и пароль вашего аккаунта в CRM МойСклад;
   • Введите Ключ доступа к PhoneAPI, если нужно передавать записи звонков в CRM. Ключ можно найти в интерфейсе CRM МойСклад: Профиль → Приложения → блок Звонки → PhoneAPI → Настроить.

   Нажмите Сохранить. После этого загрузятся статусы сделок из CRM МойСклад.

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

   Нажмите Продолжить.

4. Ознакомьтесь с инструкцией по включению отправки заявок. Вы можете настроить отправку заявок на этом этапе или после завершения настройки интеграции. Подробнее об автоматической отправке сделок в CRM МойСклад – в Шаге 3.

   Чтобы продолжить настройку интеграции, нажмите Следующий шаг.

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

   • Идентификатор контрагента – заполните это поле, если хотите присваивать все заявки данному контрагенту (поле можно оставить пустым);
   • Юридическое лицо, которому будут присваиваться новые заявки;
   • Идентификатор товара, который будет автоматически присваиваться новому заказу;
   • Склад, к которому будут относиться новые заявки.

1. В разделе Расширенные настройки вы можете:

2. Указать параметры для фильтрации сделок. Подробнее – в статье Фильтрация сделок.

3. Указать значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей.

4. Включить опцию Загружать розничные продажи. Если опция включена, розничные продажи будут загружаться из CRM вместе с остальными сделками. Они будут иметь статус Розничные продажи. Подробнее – в разделе Загрузка розничных продаж.

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

   

   Нажмите Сохранить, чтобы применить изменения.

6. В разделе Распределение заявок кликните по полю Ответственные за заявки и выберите менеджеров из выпадающего списка:

   

   Нажмите Сохранить. После этого Roistat будет автоматически распределять сделки по указанным менеджерам.

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

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

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

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

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

Типы полей:

Загрузка розничных продаж¶

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

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

После этого розничные продажи будут загружаться в Roistat и отображаться в таблице аналитики.

Настройка Товарной аналитики¶

Интеграция Roistat с CRM МойСклад позволяет использовать Товарную аналитику – инструмент, с помощью которого можно анализировать эффективность продаж отдельных товаров и групп товаров (брендов, категорий).

Чтобы настроить Товарную аналитику:

1. Убедитесь, что в CRM МойСклад созданы товары. Для этого перейдите в раздел Товары → Товары и услуги. Чтобы добавить товар, нажмите соответствующую кнопку:

   

2. В проекте Roistat перейдите в настройки интеграции с CRM МойСклад в раздел Товарная аналитика. Укажите тип цены, который должен учитываться в отчете, и нажмите Сохранить:

   

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

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

   

4. По умолчанию в Товарную аналитику загружается только сущность Товары из Мой склад. Если вы хотите, чтобы Услуги также загружались в Товарную аналитику, включите опцию "Загружать Услуги в товарную аналитику".

Перейдите в раздел Аналитика на вкладку Товарная аналитика и нажмите Включить товарную аналитику:

Теперь информация о товарах будет отображаться в разделе Аналитика → Отчеты:

Также подробная информация о товаре отображается в карточке сделки:

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

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

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

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

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

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

   

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

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

   Обратите внимание:

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

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

   

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

   

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

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

   

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

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

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

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

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

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

Если нет товаров в наличии, то себестоимость равна нулю.

Почему в Состоянии проекта появляется ошибка отправки проксилидов?

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