Клиент собрал заказ, дошёл до оформления — и упёрся в «стоимость доставки уточнит менеджер». Для габаритных и тяжёлых товаров, которые везут транспортными компаниями, это классическая точка потери заказа: покупатель не знает итоговой суммы, не готов ждать звонка и уходит. Интеграция с транспортной компанией вроде Деловых Линий убирает эту неопределённость: тариф и срок считаются прямо в оформлении, а после отправки клиент видит трек-номер.
Это практическое руководство по интеграции доставки Деловые Линии с интернет-магазином на 1С-Битрикс: как устроен обработчик службы доставки, как считать тариф по API с учётом веса и габаритов, давать выбор терминала, создавать заявку и показывать трекинг. Подобные интеграции мы делаем в рамках автоматизации продаж и склада на 1С, где доставка связана с заказами и учётом.
Коротко
- Интеграция по API считает тариф и срок Деловых Линий прямо в оформлении — без «уточнит менеджер».
- Реализуется как обработчик службы доставки в 1С-Битрикс, использующий вес, габариты и маршрут.
- Тариф считается по большей из величин — фактическому и объёмному весу, поэтому нужны и вес, и размеры товара.
- Дальше — выбор терминала, автосоздание заявки, трек-номер и статусы, плюс запасной сценарий при сбое API.
Зачем интегрировать транспортную компанию
Для магазинов, торгующих габаритным, тяжёлым или региональным товаром, транспортная компания — основной способ доставки. И здесь ручной расчёт стоит особенно дорого: без интеграции менеджер после заказа сам считает тариф, звонит клиенту и называет цену. Каждая такая задержка — риск потерять заказ.
Интеграция превращает доставку в понятную часть оформления. Клиент сразу видит стоимость и срок, выбирает терминал, оформляет и оплачивает — без ожидания. А магазин экономит время менеджеров и не теряет заказы на этапе «уточним доставку». Для регионального опта это часто решающий фактор конверсии.
Что даёт API Деловых Линий
Публичный API Деловых Линий покрывает основные задачи интернет-магазина по доставке. На практике из него используют несколько групп методов.
- Расчёт стоимости. Тариф по маршруту, весу и габаритам груза — основа интеграции.
- Справочники. Города, терминалы и пункты выдачи для выбора клиентом.
- Сроки доставки. Ориентировочный срок по маршруту вместе с тарифом.
- Заявки на перевозку. Создание заказа на доставку и получение номера накладной.
- Отслеживание. Статус груза по номеру накладной для трекинга на сайте.
Для подключения нужен договор с перевозчиком и ключ доступа к API из личного кабинета Деловых Линий. Дальше всё сводится к тому, чтобы аккуратно вызвать эти методы из 1С-Битрикс в нужные моменты оформления заказа.
Служба доставки в 1С-Битрикс
Технически интеграция реализуется как обработчик службы доставки — штатный механизм модуля «Интернет-магазин». Битрикс умеет подключать службы доставки с собственной логикой расчёта, и Деловые Линии оформляются именно так.
Обработчик службы доставки в момент оформления получает состав корзины, адрес и данные клиента, формирует запрос к API перевозчика, получает тариф и срок и возвращает их в оформление заказа как стоимость доставки. Для магазина это выглядит как ещё один способ доставки в списке, а вся сложность расчёта скрыта внутри обработчика.
Как устроена разработка собственных модулей и обработчиков под Битрикс, мы разбираем в статье про разработку модуля Битрикс.
Вес, габариты и объёмный вес
Точность тарифа целиком зависит от исходных данных о грузе. Транспортные компании считают доставку по большей из двух величин — фактическому весу и объёмному (габаритному) весу, который вычисляется из размеров груза.
Отсюда жёсткое требование: у товаров в каталоге должны быть заполнены и вес, и габариты. Если указан только вес, лёгкий, но объёмный товар (например, крупная, но лёгкая упаковка) посчитается дешевле реального, и магазин уйдёт в минус по доставке. Для заказа из нескольких позиций нужна логика сборки в общий груз — как товары складываются в места и коробки.
- Вес каждого товара. Обязательное свойство в каталоге, приходящее в том числе обменом из 1С.
- Габариты. Длина, ширина, высота — для расчёта объёмного веса.
- Сборка заказа. Правила объединения позиций в грузовые места.
- Наценки и упаковка. Если магазин добавляет стоимость упаковки или свою наценку на доставку.
Расчёт тарифа в оформлении
Сердце интеграции — расчёт стоимости прямо в оформлении заказа. Когда клиент выбирает Деловые Линии как способ доставки и указывает город или терминал, обработчик обращается к API и возвращает тариф и срок.
- Сбор данных. Обработчик берёт состав корзины, вес и габариты, город отправления и назначения.
- Запрос к API. Формируется вызов расчёта стоимости с параметрами груза и маршрута.
- Получение тарифа. API возвращает стоимость и ориентировочный срок доставки.
- Наценки. При необходимости применяются наценки магазина или стоимость упаковки.
- Отображение. Клиент видит итоговую стоимость и срок в оформлении, до оплаты.
Важная деталь — производительность: запрос к внешнему API не должен тормозить оформление. Недавние расчёты стоит кэшировать, а сами вызовы делать с разумным таймаутом. Как аккуратно и безопасно работать с внешними API, мы разбираем в статье про REST, вебхуки и безопасность в Битрикс.
Выбор терминала и пункта выдачи
Доставка транспортной компанией часто идёт до терминала, а не до двери, и возможность выбрать удобный терминал — важная часть удобства и экономии для клиента. Через API подтягивается список терминалов и пунктов выдачи в городе покупателя.
- Список по городу. После ввода города клиент видит доступные терминалы и ПВЗ.
- Информация о пункте. Адрес, часы работы, иногда карта для выбора.
- Сохранение в заказе. Выбранный терминал фиксируется и передаётся при создании заявки.
- Пересчёт тарифа. Доставка до терминала обычно дешевле адресной — тариф обновляется при выборе.
Выбор терминала не только удобнее для клиента, но и часто снижает стоимость доставки, что напрямую влияет на конверсию оформления. Поэтому его стоит делать наглядным, а не прятать в выпадающий список из сотни пунктов.
Создание заявки на доставку
Следующий уровень после расчёта — автоматическое создание заявки на перевозку. Без него менеджер вручную заводит накладную в личном кабинете перевозчика, переносит адрес и состав — это время и ошибки.
Автосоздание заявки обычно делают после подтверждения и оплаты заказа: обработчик передаёт в API состав груза, габариты, получателя и выбранный терминал, а в ответ получает номер накладной. Этот номер сразу сохраняется в заказе и используется для трекинга. Так путь от оплаты до отправки становится почти безручным.
Трек-номер и статусы груза
После создания заявки перевозчик присваивает номер накладной — это и есть трек-номер для клиента. Его сохраняют в свойстве заказа и показывают покупателю.
- Номер в заказе. Трек виден на странице заказа и в кабинете клиента.
- В письме. Уведомление об отправке с номером и ссылкой на отслеживание.
- Статус по API. Периодический запрос статуса груза и отображение его на сайте.
- Уведомления о движении. Сообщения при смене ключевых статусов доставки.
Чем больше информации о доставке вы показываете у себя, тем меньше клиент уходит на сайт перевозчика и тем реже пишет в поддержку «где груз». Связка трек-номера, статусов и уведомлений — часть общей страницы отслеживания заказа, о которой у нас есть отдельный материал.
Обработка сбоев API
Внешний сервис может быть временно недоступен, и интеграция обязана это переживать без потери заказа. Плохой сценарий — когда при недоступности API клиент вообще не может оформить доставку.
- Таймаут. Ограничение времени ожидания ответа, чтобы оформление не зависало.
- Запасной вариант. Фиксированная оценка или «стоимость уточнит менеджер» вместо блокировки.
- Кэш расчётов. Недавние тарифы по маршруту используются при сбое.
- Логирование. Ошибки API фиксируются для диагностики, а не теряются молча.
Главный принцип — сбой стороннего сервиса не должен ронять оформление заказа. Клиент в любом случае должен иметь возможность завершить покупку, пусть и с уточнением стоимости доставки позже.
Связка с обменом 1С
Доставка не живёт в вакууме — она часть заказа, который синхронизируется с учётной системой. Заказ с выбранной службой, терминалом и трек-номером выгружается в 1С обменом CommerceML вместе с остальными данными.
Это важно для полноты картины в учёте: видно, как и куда едет заказ, какой номер накладной. Нередко именно 1С становится местом, откуда создаётся заявка на перевозку или куда возвращается статус доставки, поэтому связку доставки и обмена проектируют вместе. Вес и габариты товаров, критичные для расчёта, тоже обычно приходят из 1С обменом — качество этих данных напрямую влияет на точность тарифа.
Пошаговое подключение
Соберём процесс подключения в понятную последовательность — от договора до боевого запуска.
- Договор и ключ API. Заключите договор с Деловыми Линиями и получите доступ к API в личном кабинете.
- Весогабаритные данные. Заполните вес и габариты товаров в каталоге, наладьте их приход из 1С.
- Обработчик службы доставки. Подключите готовый модуль или разработайте свой обработчик расчёта.
- Расчёт и терминалы. Настройте расчёт тарифа и выбор терминала в оформлении заказа.
- Заявка и трек. Настройте автосоздание заявки после оплаты и сохранение трек-номера.
- Трекинг и уведомления. Выведите статус груза на сайт и настройте письма о движении.
- Запасные сценарии и тесты. Обработайте сбои API и протестируйте на реальных маршрутах и заказах.
Частые ошибки
- Тариф считают только по весу. Без габаритов объёмный груз уходит в минус по доставке.
- Нет весогабаритных данных. У товаров пустые вес и размеры — расчёт неточный или невозможный.
- API блокирует оформление. При сбое сервиса клиент не может оформить заказ.
- Запрос без таймаута. Медленный ответ API тормозит всё оформление.
- Заявку создают до оплаты. Перевозка заводится на заказ, который ещё может отмениться.
- Трек-номер не показывают. Клиент не видит номер и не может отследить груз.
- Доставка не связана с 1С. В учёте нет данных о службе, терминале и накладной.
Чек-лист внедрения
- Доступ к API есть. Договор заключён, ключ получен и работает.
- Данные о грузе полные. Вес и габариты товаров заполнены и приходят из 1С.
- Тариф в оформлении. Стоимость и срок считаются по API до оплаты.
- Выбор терминала. Клиент выбирает пункт выдачи, тариф пересчитывается.
- Заявка автосоздаётся. После оплаты заявка уходит в перевозчика, приходит накладная.
- Трекинг работает. Трек-номер и статусы видны клиенту, уведомления о движении настроены.
- Сбои обработаны. Есть таймаут, запасной вариант и логирование ошибок API.
- Связь с 1С. Данные доставки выгружаются в учётную систему обменом.
Вывод
Интеграция Деловых Линий превращает доставку из узкого места оформления в его сильную сторону: клиент сразу видит стоимость и срок, выбирает удобный терминал и после отправки отслеживает груз, а магазин не тратит время менеджеров на ручные расчёты и заведение накладных. Всё это реализуется штатным механизмом службы доставки 1С-Битрикс поверх API перевозчика.
Успех держится на деталях: полные вес и габариты товаров, расчёт по объёмному весу, аккуратная обработка сбоев API, правильный момент создания заявки и связка с обменом 1С. Продумайте их — и доставка транспортной компанией перестанет терять заказы, а превратится в понятный и автоматизированный процесс от корзины до вручения груза.
