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