Адрес и получатель
Берём согласованные данные клиента и адрес доставки из сделки или связанных сущностей.
Собираем параметры отправления из сделки, проверяем обязательные данные, передаём их транспортной компании и возвращаем менеджеру результат: стоимость расчёта, созданное отправление, трек-номер, ориентировочную дату и доступные статусы. Конкретный набор функций зависит от API перевозчика.
Сценарий
Не заставляем сотрудника повторно переносить данные в кабинет перевозчика. Интеграция собирает доступные значения из CRM и запрашивает только то, чего не хватает.
Берём согласованные данные клиента и адрес доставки из сделки или связанных сущностей.
Вес, объём, места, габариты и другие параметры передаются в объёме, который требует выбранный перевозчик.
Если API поддерживает расчёт, можно получить подходящий тариф и стоимость до оформления отправления.
После проверки данных интеграция выполняет разрешённую операцию в кабинете перевозчика через API.
Полученные идентификаторы и доступные документы связываются с исходной сделкой.
Сотрудник видит актуальный результат в CRM без ручной проверки кабинета транспортной компании.
Путь отправления
Перед фактическим созданием отправления проверяем обязательные параметры и показываем сотруднику значимые условия.
Проверка данных
Перед API-вызовом нормализуем значения и отдельно обрабатываем неоднозначные условия. ИИ можно использовать для понимания свободного текста, но фактические параметры отправления проходят формальную проверку.
Разделяем город, улицу и другие части только в том формате, который нужен конкретному API, и не сохраняем лишний текст в технические поля.
Разгрузка, подъём, объявленная стоимость, оплата при получении и другие опции включаются только по согласованным правилам.
Неполные или противоречивые параметры не отправляем молча — возвращаем сотруднику понятное требование.
Проверяем обязательные данные перед созданием заказа у перевозчика.
Если ИИ извлекает признак из текста, он превращается в структурированный параметр, который затем проверяется обычной логикой.
Перевозчики
Единый интерфейс CRM может скрывать различия перевозчиков, но серверная часть учитывает их отдельно.
Расчёт и оформление доставки по доступным методам API, возврат идентификаторов и статусов в рабочий процесс.
Создание заявки и передача параметров груза через доступный API личного кабинета с учётом его текущих требований.
Расчёт, пункты выдачи, создание заказа и другие операции в пределах согласованного API-сценария.
Подключение возможно после проверки актуального API, авторизации и необходимых операций.
Надёжность
Создание отправления — внешняя операция, поэтому особенно важны идемпотентность и сохранение ответа перевозчика.
Перед повторным созданием проверяем, не существует ли уже связанное отправление.
Номер заказа перевозчика и трек связываются с исходной сделкой.
Таймаут или временный сбой не трактуется как успешное оформление.
Повтор выполняется только после проверки состояния предыдущего запроса.
События доставки не должны создавать дубли задач и примечаний при повторной передаче одного состояния.
Связанный процесс
Интеграция может быть частью цепочки производство → документы → отгрузка → доставка, а менеджер получает только необходимые контрольные точки.
Смотреть также
Выбираем, какое событие делает заказ готовым к отправке, откуда брать параметры и какой результат должен вернуться после оформления.
Вопросы
Да, если все обязательные параметры известны или могут быть запрошены у сотрудника перед отправкой. Серверная часть проверяет данные и только затем вызывает API перевозчика.
Да, если выбранный перевозчик предоставляет соответствующие API-методы. Расчёт и фактическое оформление лучше разделять как разные операции.
Да. Условие можно определить формальными правилами, а признаки из свободного комментария при необходимости сначала структурировать с помощью ИИ. Перед отправкой итоговые параметры проверяются.
Сохраняем идентификатор отправления, трек-номер и другие нужные данные, а затем обновляем доступные статусы в связанной сделке.
Да. Для каждой отдельно реализуется API-контракт, а сотруднику можно дать общий интерфейс выбора или автоматическое правило.
Да. По выполненной разработке предоставляем 3 месяца бесплатной технической поддержки. Дальнейшее сопровождение и развитие — по запросу.
Покажите одну отправку: откуда берутся адрес, вес и услуги, в каком перевозчике она создаётся и какие данные сотрудник потом переносит обратно в amoCRM.