Инструкция по настройке

Как подключить и настроить ДЛ Коннект

От установки из amoMarket до первой заявки на доставку из сделки. Занимает 10–15 минут вместе с получением ключей на стороне Деловых Линий.

Содержание
01

Подключение интеграции к вашему аккаунту

ДЛ Коннект доступен в каталоге amoMarket — интеграция устанавливается прямо из вашего аккаунта amoCRM за пару минут.

  1. Откройте amo.receptly.ru и нажмите «Установить в amoCRM» (либо найдите «ДЛ Коннект для amoCRM» в каталоге amoMarket).
  2. amoCRM покажет стандартное окно с запросом прав доступа — подтвердите его.
  3. После подтверждения интеграция появится в разделе Настройки → Интеграции вашего аккаунта.
02

Ключ ДЛ Коннект (widget_key)

Сразу после установки открывается страница с уникальным ключом интеграции — полем Ключ ДЛ Коннект. Он нужен для настройки виджета на следующем шаге.

Скопируйте ключ сразу. Если потеряли — откройте настройки виджета в amoCRM и нажмите кнопку «Открыть страницу с ключом ДЛ Коннект» под полем ключа: ключ не перегенерируется, страница с ним откроется снова. Удалять интеграцию не нужно.
03

APPKEY и токен (PAT) Деловых Линий

Виджет считает и оформляет доставку от имени вашей организации по вашему договору с Деловыми Линиями — для этого нужна пара ключей API, а не логин/пароль от личного кабинета.

  1. APPKEY — зарегистрируйте приложение на dev.dellin.ru/registration; ключ придёт на email, указанный при регистрации.
  2. PAT (персональный токен) — выпустите в личном кабинете Деловых Линий, в разделе «Интеграция».
Важно: PAT — это полноценный доступ к оформлению заявок от имени вашей организации. В ДЛ Коннект он хранится в зашифрованном виде и не показывается повторно после сохранения — если нужно поменять, выпустите новый токен в личном кабинете ДЛ и вставьте его в настройки заново.
04

Настройки виджета в amoCRM

В разделе Настройки → Интеграции → ДЛ Коннект откройте настройки виджета и заполните:

  • Ключ ДЛ Коннект — значение из шага 2;
  • APPKEY Деловых Линий и Персональный токен (PAT) Деловых Линий — значения из шага 3;
  • чекбокс согласия на передачу данных сделки (ФИО, телефон, адрес получателя) — без него сохранение не пройдёт.

Сохраните настройки. Если реквизиты неверны, ошибку покажет сама форма настроек — авторизация в ДЛ проверяется сразу при сохранении.

05

Склад отправителя

Прежде чем считать доставку, нужно указать хотя бы один склад-отправитель — там же, в расширенных настройках интеграции, в разделе «Склады отправителя»:

  • адрес склада или терминал ДЛ, откуда забирают грузы;
  • организационно-правовая форма и реквизиты отправителя (по ИНН — подтягиваются автоматически);
  • контактное лицо на складе — имя и телефон, по которому Деловые Линии свяжутся при заборе груза.

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

Реквизиты подтягиваются по ИНН или названию: при выборе компании из подсказок ИНН, КПП, название и тип отправителя подставятся сами.

Электронное поручение экспедитору (ЭПЭ). На вкладке склада «ЭПЭ» выберите режим «Черновик ЭПЭ» — Деловые Линии сформируют черновик по данным заявки. Куда он придёт:

  • в личный кабинет оператора ЭДО — нажмите «Подобрать кабинет ЭДО»: виджет найдёт кабинет по ИНН и КПП отправителя (для юрлица КПП обязателен; если кабинет не нашёлся, UID можно ввести вручную);
  • на email — укажите один или несколько адресов через запятую.

Что именно выбрано, видно в примечании к сделке после создания заявки.

06

Расчёт и заявка из карточки сделки

Настройка на этом закончена. Дальше — обычная работа со сделкой:

  1. Откройте карточку сделки — в панели виджетов справа появится блок «ДЛ».
  2. Заполните получателя, адрес и габариты груза — часть полей подставится из карточки сделки автоматически.
  3. Выберите тариф (Авто, Экспресс, Авиа, МГГ) — виджет покажет стоимость и срок по вашему договору.
  4. Нажмите «Создать заявку» — номер накладной, статус и итоговая стоимость запишутся в поля сделки сами, без второй формы и звонков в ДЛ.
07

Бесплатный лимит и подписка

На бесплатном тарифе доступно до 10 заявок на доставку в месяц. Когда лимит подходит к концу, виджет заранее предупреждает об этом в карточке сделки. После оформления подписки ограничение по количеству заявок снимается.

08

Частые проблемы

Виджет пишет «Виджет не настроен»

Не заполнены или неверны APPKEY/PAT в настройках интеграции — вернитесь к шагу 4.

Виджет пишет «Склад отправителя не настроен»

В расширенных настройках интеграции не заполнен ни один склад — см. шаг 5.

Расчёт возвращает ошибку

Чаще всего — устаревший или отозванный PAT, либо незаполненные обязательные поля получателя. Подробности ошибки видно прямо в карточке сделки; если неясно — напишите в поддержку с номером сделки.

«Кабинет ЭДО не найден» при подборе

Значит, у отправителя нет личного кабинета оператора ЭДО, привязанного к этому ИНН и КПП. Укажите email для черновика ЭПЭ на той же вкладке или введите UID кабинета вручную. Для юрлица проверьте КПП — он подставляется из реквизитов, но должен совпадать с тем, под которым зарегистрирован кабинет.

Потерял ключ ДЛ Коннект (widget_key)

В настройках виджета в amoCRM нажмите «Открыть страницу с ключом ДЛ Коннект» под полем ключа — ключ останется прежним, страница с ним откроется снова (см. шаг 2). Удалять интеграцию не нужно.

Остались вопросы?

Подключаем и настраиваем интеграцию сами, если что-то не получается

Написать в поддержку