Интеграция 1С-Битрикс с агрегатором доставок ApiShip

Интеграция 1С-Битрикс с агрегатором доставок ApiShip

Магазин на Битрикс с 500 заказами в месяц тратит до 40 часов на сопровождение прямых интеграций с СДЭК, Boxberry и Почтой России. Изменение API любой службы — аврал: правка кода, тестирование, деплой. ApiShip централизует всё: один API для 30+ перевозчиков, единый расчёт и трекинг. Мы внедрили такое решение для клиента из сегмента DIY — после интеграции время на поддержку доставки сократилось с 20 часов в неделю до 2, а ежемесячная экономия составила 80 000–100 000 ₽.

Почему стоит выбрать агрегатор ApiShip вместо прямых интеграций?

Прямая интеграция с каждой службой — это отдельные модули с разными credentials, разные схемы запросов и ответов, необходимость отслеживать изменения API каждого перевозчика и обновлять код. ApiShip унифицирует всё: единая авторизация (Bearer-токен), расчёт стоимости по всем перевозчикам одним запросом, создание отправлений через один эндпоинт, трекинг в едином формате.

Обратная сторона: агрегатор добавляет прослойку — иногда задержка при обновлении API перевозчика составляет 1–2 дня. Для магазинов с нестандартными требованиями к конкретному перевозчику прямая интеграция может быть точнее. Но в 90% случаев ApiShip — оптимальный выбор: мы гарантируем стабильность и своевременную поддержку.

API ApiShip: основные эндпоинты

Базовый URL: https://api.apiship.ru/v2. Авторизация: Bearer-токен. Тестовая среда: https://api.test.apiship.ru/v2. Подробнее см. документацию ApiShip API.

Как мы реализуем интеграцию с ApiShip в Битрикс?

Один модуль покрывает все службы. Архитектурный выбор: либо один класс \Bitrix\Sale\Delivery\Services\Base с параметром «перевозчик», либо несколько экземпляров одного класса для разных перевозчиков (курьер, ПВЗ и т.д.). Второй подход удобнее для покупателя: он видит отдельные способы доставки.

Параметры в b_sale_delivery_service_params:

• APISHIP_API_KEY — ключ из личного кабинета ApiShip;
• PROVIDER_KEY — код перевозчика (cdek, boxberry, russian_post и т.д.);
• FROM_POINT_ID — ID точки отправки (склад в системе ApiShip);
• DELIVERY_TYPE — door (курьер) или point (ПВЗ).

Расчёт стоимости

$calcRequest = [
    'fromPoint' => ['id' => $fromPointId],
    'toPoint'   => [
        'address' => $deliveryAddress,
        'cityId'  => $apishipCityId,
    ],
    'parameters' => [
        'weight' => $weightGram,
        'length' => $lengthCm,
        'width'  => $widthCm,
        'height' => $heightCm,
        'declaredValue' => $declaredValue,
    ],
    'deliveryType' => $deliveryType,
    'providers'    => [$providerKey], // пустой массив = все перевозчики
];

$results = $httpClient->post('/v2/calculator', $calcRequest);
// $results — массив вариантов с ценой и сроками для каждого перевозчика

Если providers — пустой массив, ApiShip вернёт расчёт по всем активным перевозчикам. Это позволяет реализовать на сайте блок сравнения способов доставки с ценами.

Получение и хранение ПВЗ

ПВЗ в ApiShip запрашиваются по фильтрам:

GET /points?cityId={id}&providerKey={key}&type=pickup_point

Загружаем раз в сутки агентом для активных перевозчиков. Сохраняем в HL-блок «ПВЗ» с полями: providerKey, pointId, name, address, lat, lng, workingHours, maxWeight. На карте отображаем всё агрегированно — покупатель выбирает любой ПВЗ любого перевозчика.

При выборе ПВЗ сохраняем в b_sale_order_props: APISHIP_PROVIDER_KEY и APISHIP_POINT_ID.

Создание заявки

$orderPayload = [
    'providerKey'     => $providerKey,
    'senderPointId'   => $fromPointId,
    'deliveryType'    => $deliveryType,
    'toPoint'         => [
        'id'      => $pvzId,   // если ПВЗ
        'address' => $address, // если курьер
    ],
    'recipient'       => ['name' => $name, 'phone' => $phone],
    'parameters'      => $parameters,
    'orderNumber'     => 'SHOP-' . $bitrixOrderId,
    'declaredValue'   => $declaredValue,
    'cashOnDelivery'  => $codAmount,
    'places'          => $places,
];

Ответ: orderId в системе ApiShip и trackingNumber перевозчика. Оба сохраняем в b_sale_order_props.

Трекинг и статусы

Что входит в работу

При заказе интеграции под ключ мы предоставляем:

• анализ текущей схемы доставки и рекомендации;
• разработку модуля с учётом ваших бизнес-процессов;
• настройку расчёта стоимости, выбора ПВЗ и создания заявок;
• интеграцию с трекингом и вебхуками;
• документацию по API и инструкцию для операторов;
• гарантию 3 месяца на бесперебойную работу.

Наш опыт и гарантии

Мы 5+ лет разрабатываем на 1С-Битрикс и Битрикс24. За плечами 10+ успешных проектов по интеграции служб доставки, в том числе с ApiShip, прямыми API перевозчиков и кастомными решениями. Мы даём гарантию на все работы — если что-то пойдёт не так, исправим в приоритетном порядке. Свяжитесь с нами, чтобы получить консультацию и оценку вашего проекта.

Сроки ориентировочно

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