Деловые линии I Расчёт стоимости доставки
Рассмотрим пример интеграции, в которой будем получать данные от amoCRM и в деловых линиях производить расчёт стоимости доставки. В качестве триггера можно так же использовать создание сделки или обновление статуса сделки, но в нашем примере воспользуемся именно триггером на изменение сделки. В качестве триггера может выступать любой другой сервис.
Для начала создадим подключения нужных сервисов. Примеры инструкций можно посмотреть по этим ссылкам:
Подключение сервиса amoCRM
Подключение сервиса Деловые линии
После того как выполнили подключения, необходимо создать связку и в качестве первого шага выбрать триггер — amoCRM: Изменение сделки. Если необходимо получать каждое изменение одной и той же сделки, тогда опцию Загружать каждую сделку лишь единожды выберем в значении — Нет или оставим пустую строку, иначе выберем значение Да и будем получать только первое изменение.
Так же можно настроить фильтр входящих данных и получать сделки из определённой воронки или статусом. В нашем примере фильтр настраивать не будем, оставим без изменений.
Следующим шагом добавим действие — Деловые Линии: Рассчитать стоимость доставки.
В этом действии есть списочные поля, значения которых можно выбрать из списка. Если значения для таких полей у Вас приходит от стороннего сервиса (в нашем случае amoCRM), то необходимо что бы приходило значение, которое указано в скобках. Это системный id, который принимает сервис. При передаче значения, которого нет в списочном поле, возникнет ошибка. Поэтому необходимо обеспечить корректную передачу данных для такого типа полей.
Если у Вас нет возможности передачи именно id, тогда можно сделать замену с помощью инструмента Табличная замена и результат передать в нужное поле. В качестве примера рассмотрим поле Тип доставки.
Это поле принимает следующие значения: auto, express, letter, avia и small. Вы можете заранее выбрать один из вариантов, но мы рассмотрим именно передачу от стороннего сервиса. От amoCRM может приходить например значение Авто доставка или любое другое и тогда нам нужно будет сделать замену этого значения на auto и так для каждого значения в списке.
Выбираем результат работы инструмента Табличная замена
Следующим этапом заполним обязательные поля, которые выделены акцентным цветом:
Отправление - дата
В это поле передадим дату и время. В нашем случае эти данные приходят от amoCRM, но можно и статично прописать необходимую дату и время.
Отправление - способ
В этом поле нужно выбрать значение из списка. Это поле связано с полем Доставка - способ и поэтому необходимо выбрать одинаковый вариант в обоих полях. В нашем примере выберем “Доставка груза от/до адреса“.
Доставка - способ
Так как это поле связано с полем Отправление - способ, выберем вариант “Доставка груза от/до адреса“.
Заказчик
Значение для этого поля у нас приходит от amoCRM, поэтому необходимо сделать замену и результат добавить в это поле.
Груз - длина самого длинного грузового груза
В это поле необходимо передать длину груза. Данные приходят от amoCRM в поле “Груз - длина самого длинного грузового груза“.
Груз - ширина самого широкого грузового места
В это поле необходимо передать ширину груза. Данные приходят от amoCRM в поле “Груз - ширина самого широкого грузового места“.
Груз - высота самого высокого грузового места
В это поле необходимо передать высоту груза. Данные приходят от amoCRM в поле “Груз - высота самого высокого грузового места“.
Груз - общий вес груза
В это поле необходимо передать общий вес груза. Данные приходят от amoCRM в поле “Груз - общий вес груза“.
Груз - общий объем груза
В это поле необходимо передать общий объём груза. Данные приходят от amoCRM в поле “Груз - общий объем груза“.
Груз - класс опасности
В это поле необходимо передать клас опасности, по умолчанию используется значение 0. Остальные можно посмотреть в личном кабине деловых линий или узнать у технической поддержки деловых линий. В нашем примере данные приходят от amoCRM в поле “Груз - класс опасности“.
Груз - объявленная стоимость страховки
В это поле необходимо передать стоимость страховки. Максимальная длина поля 12 символов. Данные приходят от amoCRM в поле “Груз - объявленная стоимость страховки “.
Груз - страховка срока
В этом поле нужно выбрать есть ли страховка. Поле предполагает два варианта - Да или Нет. В нашем примере данные приходят от amoCRM и для замены использовался инструмент Табличная замена
Тип оплаты
В это поле необходимо передать тип оплаты. Данные приходят от amoCRM и для замены использовали инструмент “Табличная замена“
Отправление - адрес
В это поле необходимо передать полный адрес отправления. В нашем примере адрес был взят из документации сервиса, а именно - ул. Петухова, 33, Новосибирск, Новосибирская обл., 630088
Доставка - адрес
В это поле необходимо передать полный адрес доставки. В нашем примере использовался адрес - ул. Заводская, 3в, Республика Хакасия, Абакан, 655003
Оплата - город КЛАДР
В это поле необходимо передать КЛАДР. Значение должно состоять из цифр (25 или 24 с лидирующим 0). Может быть получен с помощью сервисов, представленных на странице - https://dev.dellin.ru/api/places/kladr/
Отправление - окончание периода передачи груза
В это поле передадим время окончания передачи груза в формате ЧЧ:ММ. В нашем примере заполним поле значением 12:00
Доставка - окончание периода передачи груза
В это поле передадим время окончания передачи доставки груза в формате ЧЧ:ММ. В нашем примере так же используем значение 12:00
Отправление - начало периода передачи груза
В это поле передадим время начала передачи груза в формате ЧЧ:ММ. В нашем примере заполним поле значением 08:00
Доставка - начало периода передачи груза
В это поле передадим время начала передачи отправления груза в формате ЧЧ:ММ. В нашем примере заполним поле так же значением 08:00
Остальные поля являются необязательными, поэтому в нашем примере они заполнены не будут. Заполненные поля в действии — Деловые Линии: Рассчитать стоимость доставки
Готовая связка
Дополнительные материалы
Деловые Линии в Albato: https://blog.albato.ru/instrukciya-po-ispolzovaniyu-delovye-linii-v-albato/
Инструмент — Табличная замена: https://blog.albato.ru/changing-data-on-the-fly-in-albato/
На этом процесс создания связки завершён. В случае возникновения дополнительных вопросов по настройке связок, можно обратиться за помощью в техническую поддержку, написав в онлайн-чат на сайте.
Для начала создадим подключения нужных сервисов. Примеры инструкций можно посмотреть по этим ссылкам:
Подключение сервиса amoCRM
Подключение сервиса Деловые линии
После того как выполнили подключения, необходимо создать связку и в качестве первого шага выбрать триггер — amoCRM: Изменение сделки. Если необходимо получать каждое изменение одной и той же сделки, тогда опцию Загружать каждую сделку лишь единожды выберем в значении — Нет или оставим пустую строку, иначе выберем значение Да и будем получать только первое изменение.
Так же можно настроить фильтр входящих данных и получать сделки из определённой воронки или статусом. В нашем примере фильтр настраивать не будем, оставим без изменений.
Следующим шагом добавим действие — Деловые Линии: Рассчитать стоимость доставки.
В этом действии есть списочные поля, значения которых можно выбрать из списка. Если значения для таких полей у Вас приходит от стороннего сервиса (в нашем случае amoCRM), то необходимо что бы приходило значение, которое указано в скобках. Это системный id, который принимает сервис. При передаче значения, которого нет в списочном поле, возникнет ошибка. Поэтому необходимо обеспечить корректную передачу данных для такого типа полей.
Если у Вас нет возможности передачи именно id, тогда можно сделать замену с помощью инструмента Табличная замена и результат передать в нужное поле. В качестве примера рассмотрим поле Тип доставки.
Это поле принимает следующие значения: auto, express, letter, avia и small. Вы можете заранее выбрать один из вариантов, но мы рассмотрим именно передачу от стороннего сервиса. От amoCRM может приходить например значение Авто доставка или любое другое и тогда нам нужно будет сделать замену этого значения на auto и так для каждого значения в списке.
Выбираем результат работы инструмента Табличная замена
Следующим этапом заполним обязательные поля, которые выделены акцентным цветом:
Отправление - дата
В это поле передадим дату и время. В нашем случае эти данные приходят от amoCRM, но можно и статично прописать необходимую дату и время.
Отправление - способ
В этом поле нужно выбрать значение из списка. Это поле связано с полем Доставка - способ и поэтому необходимо выбрать одинаковый вариант в обоих полях. В нашем примере выберем “Доставка груза от/до адреса“.
Доставка - способ
Так как это поле связано с полем Отправление - способ, выберем вариант “Доставка груза от/до адреса“.
Заказчик
Значение для этого поля у нас приходит от amoCRM, поэтому необходимо сделать замену и результат добавить в это поле.
Груз - длина самого длинного грузового груза
В это поле необходимо передать длину груза. Данные приходят от amoCRM в поле “Груз - длина самого длинного грузового груза“.
Груз - ширина самого широкого грузового места
В это поле необходимо передать ширину груза. Данные приходят от amoCRM в поле “Груз - ширина самого широкого грузового места“.
Груз - высота самого высокого грузового места
В это поле необходимо передать высоту груза. Данные приходят от amoCRM в поле “Груз - высота самого высокого грузового места“.
Груз - общий вес груза
В это поле необходимо передать общий вес груза. Данные приходят от amoCRM в поле “Груз - общий вес груза“.
Груз - общий объем груза
В это поле необходимо передать общий объём груза. Данные приходят от amoCRM в поле “Груз - общий объем груза“.
Груз - класс опасности
В это поле необходимо передать клас опасности, по умолчанию используется значение 0. Остальные можно посмотреть в личном кабине деловых линий или узнать у технической поддержки деловых линий. В нашем примере данные приходят от amoCRM в поле “Груз - класс опасности“.
Груз - объявленная стоимость страховки
В это поле необходимо передать стоимость страховки. Максимальная длина поля 12 символов. Данные приходят от amoCRM в поле “Груз - объявленная стоимость страховки “.
Груз - страховка срока
В этом поле нужно выбрать есть ли страховка. Поле предполагает два варианта - Да или Нет. В нашем примере данные приходят от amoCRM и для замены использовался инструмент Табличная замена
Тип оплаты
В это поле необходимо передать тип оплаты. Данные приходят от amoCRM и для замены использовали инструмент “Табличная замена“
Отправление - адрес
В это поле необходимо передать полный адрес отправления. В нашем примере адрес был взят из документации сервиса, а именно - ул. Петухова, 33, Новосибирск, Новосибирская обл., 630088
Доставка - адрес
В это поле необходимо передать полный адрес доставки. В нашем примере использовался адрес - ул. Заводская, 3в, Республика Хакасия, Абакан, 655003
Оплата - город КЛАДР
В это поле необходимо передать КЛАДР. Значение должно состоять из цифр (25 или 24 с лидирующим 0). Может быть получен с помощью сервисов, представленных на странице - https://dev.dellin.ru/api/places/kladr/
Отправление - окончание периода передачи груза
В это поле передадим время окончания передачи груза в формате ЧЧ:ММ. В нашем примере заполним поле значением 12:00
Доставка - окончание периода передачи груза
В это поле передадим время окончания передачи доставки груза в формате ЧЧ:ММ. В нашем примере так же используем значение 12:00
Отправление - начало периода передачи груза
В это поле передадим время начала передачи груза в формате ЧЧ:ММ. В нашем примере заполним поле значением 08:00
Доставка - начало периода передачи груза
В это поле передадим время начала передачи отправления груза в формате ЧЧ:ММ. В нашем примере заполним поле так же значением 08:00
Остальные поля являются необязательными, поэтому в нашем примере они заполнены не будут. Заполненные поля в действии — Деловые Линии: Рассчитать стоимость доставки
Готовая связка
Дополнительные материалы
Деловые Линии в Albato: https://blog.albato.ru/instrukciya-po-ispolzovaniyu-delovye-linii-v-albato/
Инструмент — Табличная замена: https://blog.albato.ru/changing-data-on-the-fly-in-albato/
На этом процесс создания связки завершён. В случае возникновения дополнительных вопросов по настройке связок, можно обратиться за помощью в техническую поддержку, написав в онлайн-чат на сайте.
Обновлено на: 14/10/2024
Спасибо!