Интеграция Битрикс с транспортными компаниями без переделок

Если после оформления заказа менеджер вручную переносит адреса в кабинет перевозчика, а покупатель не видит сроки и стоимость доставки, интеграция не закончена — даже если на сайте уже стоит модуль транспортной компании. В 1С-Битрикс сначала зафиксируйте сценарии доставки и точки обмена данными, затем выбирайте между готовым модулем, агрегатором и собственной связкой через API. Иначе ошибку в статусах, адресах или тарифах обнаружите уже после запуска.

Сначала опишите путь заказа

У доставки в интернет-магазине обычно несколько разных задач. Покупатель должен выбрать способ получения и увидеть подходящую стоимость; магазин — сохранить выбор в заказе; сотрудник — передать отправление перевозчику и получить номер отслеживания. Иногда нужен ещё один шаг: обновлять статус заказа после движения посылки.

Нарисуйте этот путь до установки решения. Для каждого пункта ответьте на три вопроса: какие данные вводит или выбирает покупатель, где они хранятся в заказе, кто и когда передаёт их перевозчику. Это помогает увидеть, что надпись «доставка подключена» не гарантирует, например, что пункт выдачи попадёт в заказ в пригодном для создания отправления виде.

• Способ доставки: курьер, пункт выдачи, постамат или самовывоз.
• Расчёт: фиксированная цена, тариф перевозчика или стоимость, которую менеджер подтверждает вручную.
• Оформление отправления: автоматически при оплате, по команде сотрудника или после сборки заказа.
• Обратные данные: трек-номер, статус перевозки, причина ошибки при создании отправления.
• Исключения: наложенный платёж, несколько посылок, частичный выкуп, изменение веса или состава заказа.

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

Три подхода и их цена

В 1С-Битрикс выбор часто сводится к готовому модулю, агрегатору или собственной интеграции с перевозчиком. Универсально лучшего варианта нет: экономия времени на запуске может обернуться платой за посредника, а контроль над API — дополнительной поддержкой и тестированием.

Перед выбором попросите показать не только форму настройки, но и результат в заказе Битрикс: куда записываются служба доставки, выбранный пункт, тариф и идентификатор отправления. Проверьте также, как сотрудник повторяет неудачную передачу заказа и видит ответ перевозчика. Если решение не сохраняет причину сбоя, поддержка быстро превратится в поиск «почему не уехало» по переписке и журналам сервера.

Проверки до установки

Сначала выясните точную версию 1С-Битрикс: Управление сайтом и установленных модулей. Затем сверьте требования выбранного решения с этой версией и вашей схемой оформления заказа. Номер версии CMS сам по себе не доказывает совместимость: важны редакция, обновления, шаблон оформления заказа, свойства заказа и другие модули, которые меняют корзину или доставку.

1. Соберите обязательные сценарии. Зафиксируйте направления доставки, типы получения, оплату и исключения. Проверка: для каждого сценария понятно, что выбирает покупатель и что должен получить менеджер.
2. Проверьте документацию и совместимость. Уточните поддерживаемые версии, необходимые настройки и ограничения решения у его разработчика или в официальной документации. Проверка: совместимость подтверждена для вашей установки, а не только для демонстрационного магазина.
3. Сверьте данные заказа. Проверьте адрес, контактные данные, состав заказа, вес и габариты, если перевозчик использует их для расчёта. Проверка: в тестовом заказе значения совпадают с теми, что нужны для выбранного тарифа и создания отправления.
4. Проверьте выбор пункта выдачи. Уточните, сохраняет ли модуль не только отображаемый адрес, но и необходимые перевозчику данные пункта. Проверка: сотрудник видит в заказе однозначное место получения, а не только название города.
5. Настройте передачу отправления и статусов. Определите момент отправки заказа и порядок действий при временном сбое. Проверка: тестовая отправка получает понятный результат; при ошибке заказ остаётся доступен для повторной обработки без создания дубля.
6. Прогоните тестовые заказы. Проверьте доставку до двери, получение в пункте выдачи и хотя бы один отрицательный сценарий — например, недоступный тариф или неполные данные. Проверка: для каждого теста записано, что увидел покупатель, что сохранилось в Битрикс и что получил перевозчик.

Где интеграция чаще всего ломается

Цена в корзине отличается от цены перевозчика

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

Пункт выдачи виден, но не попадает в отправление

Покупатель выбрал точку на карте, однако в заказе сохранился только текст адреса или не сохранилось ничего. Это может быть следствием несовместимости модуля с оформлением заказа или ошибки обмена между виджетом и свойствами заказа. Проверяйте сохранённый заказ после обновления страницы и именно тот набор данных, который нужен для создания отправления.

Повторная отправка создаёт дубль

Если запрос завершился ошибкой по тайм-ауту, сайт не всегда знает, успел ли перевозчик создать отправление. Слепой повтор может породить две накладные. Уточните, как выбранное решение находит ранее созданное отправление и показывает его идентификатор; отдельно проверьте повтор после искусственно прерванного обмена на тестовом контуре.

Сайт показывает старый статус

Обновление статусов может происходить не мгновенно: способ и расписание обмена зависят от конкретного модуля и перевозчика. Проверьте, где смотреть время последнего обновления и текст ошибки обмена. Не обещайте покупателю обновление «в реальном времени», пока это не подтверждено документацией и тестом.

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

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

Когда выбирать каждый вариант

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

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

Что делать дальше

Составьте короткий протокол приёмки: версия Битрикс и модулей, тестовые сценарии, ожидаемые данные в заказе, результат передачи перевозчику и действия при сбое. После запуска наблюдайте за долей заказов без тарифа, ошибками создания отправлений, повторами и расхождениями между рассчитанной и фактической стоимостью. Эти показатели подскажут, где именно рвётся цепочка — в оформлении заказа, данных товара или обмене с перевозчиком.

Версии и возможности модулей доставки меняются. Перед установкой сверяйте актуальные требования с документацией самого решения и документацией 1С-Битрикс; при нестандартном оформлении заказа отдельно проверьте совместимость на тестовой копии сайта.