Delivery Services for 1C-Bitrix

Transport Company APIs — Where All the Complexity Lives

Integrating with carriers looks simple: call the API, get a price and delivery time, show it to the buyer. In practice, every carrier returns data in its own format, with its own pricing logic and its own pitfalls.

CDEK — The Main Workhorse

API v2 (api/v2/calculator/tarifflist) accepts dimensions, weight, and addresses — returns all available tariffs with prices and timeframes. The gotchas:

• Volumetric weight is calculated as (L × W × H) / 5000. If the physical weight is 2 kg but the volumetric weight is 8 kg, CDEK charges by volumetric. Miss this in the calculator — the buyer sees one price but pays another
• The pickup point map loads via a separate request (deliverypoints). Filtering by city, fitting room availability, cash on delivery acceptance. The CDEK widget can be embedded, but it pulls its own styles and conflicts with Bitrix templates — we usually build our own map on Yandex.Maps
• Automatic order creation via api/v2/orders — when a customer places an order, the request goes to CDEK and a tracking number comes back
• Printing waybills and labels directly from the Bitrix admin panel — via api/v2/print/orders

Tariffs: warehouse-to-warehouse (to pickup point, 2–7 days), warehouse-to-door (courier), door-to-door (pickup + courier), express (1–3 days), parcel locker.

Boxberry

The widest pickup point network in the regions — reaches places CDEK doesn't cover. A simpler API, but with nuances around cash on delivery and partial redemption. Pickup point map with filtering: fitting room, card payment, weekend hours.

Russian Post

Maximum geographic coverage. "Otpravka" API (Russian Post Business) — cost calculation, automatic form generation (f.103 and f.116), tracking by tracking number. Tariffs: parcel, printed matter, EMS. International shipments. Integration is stable, but the API is slower than commercial carriers — we build in timeouts.

PEK

When you need to ship a sofa or industrial equipment. Calculation for consolidated freight, insurance, crating for fragile items. Terminal delivery and door-to-door.

DPD

Express delivery across Russia and internationally. Delivery in a chosen time slot, return of signed documents.

Cost Calculation — Subtleties That Break Checkout

The automatic calculator sums the physical and volumetric weight of items in the cart, adds packaging weight, picks the greater of the two, and sends it to the carrier's API. Sounds trivial, but:

• Dimensions must be filled in for every product. No dimensions — no calculation. In a catalog of 10,000 SKUs, there will inevitably be products without dimensions, and a cart containing them will break the calculator
• Promotions and free shipping thresholds — flexible configuration: by order total, for VIP customers, for specific payment methods
• A "You're N rubles away from free shipping" indicator in the cart motivates adding more items — a simple thing, but it noticeably increases average order value

Tracking

Automatic status polling from delivery services via API. On every change — order status update in Bitrix and buyer notification (email, SMS, push).

Built-in tracking page in the customer's personal account — no need to visit the carrier's website. Map with current location, estimated delivery date, option to redirect — change pickup point or address.

In-Store Pickup

Your own pickup points on a map: addresses, hours, contacts. Search for the nearest one by customer address. Real-time availability check, reservation until a specific time. QR code for quick collection. SMS notification when ready for pickup.

Courier Delivery

Delivery zones with different pricing. 2-hour slots, courier schedule management, order limit per slot. Same-day delivery — orders accepted until 14:00, express within 2–4 hours with an urgency surcharge. Navigation integration for route optimization.

Multi-Warehouse

Multiple warehouses with addresses and service zones. Automatic selection of the shipping warehouse by customer address — priority to the nearest one that has all ordered items in stock. If one warehouse doesn't have everything — order splitting across warehouses (multi-shipment). Inventory sync via 1C or WMS.

Our Approach

1. Logistics analysis — geography, average weight, order volume
2. Carrier selection — optimal combination by coverage, cost, and reliability
3. Integration — API connection, calculation setup, testing with real addresses
4. Tracking — automation of tracking and notifications
5. Launch — monitoring calculation accuracy during the first weeks

Implementation Timeline

Well-configured logistics means fewer "where's my order?" inquiries, lower operational costs, and customers who come back.