Descartes® is pleased to announce the latest release of ShipRush. This update includes various improvements designed to enhance system performance and user experience. Below, you'll find a summary of the changes implemented in this version. For any questions about specific items, please reference the associated number (if provided) when contacting Descartes Customer Support.
FedEx® Migration to REST APIs + OAuth
FedEx has announced upcoming mandatory deadlines to migrate all integrations to their new REST APIs, which include updated OAuth-based security protocols. Most ShipRush users have already completed this transition. If you have already migrated your FedEx accounts to the new REST connections, no action is required.
However, if you are still using legacy API connections, you must migrate before the carrier deadlines below to avoid disruptions in rating, shipping, and tracking.
FedEx Migration Information
Deadline: April 30, 2026
FedEx will discontinue legacy authentication and requires all integrations to use REST and OAuth for secure access to FedEx services.
Documentation:
New DHL Paket REST API (V2025)
ShipRush has upgraded its DHL Paket (Germany) integration from the legacy SOAP API to DHL's modern REST API, using OAuth 2.0 authentication. This brings enhanced reliability, new shipping features, and enhanced international and return shipment capabilities.
DHL requires us to migrate all users of DHL Paket (Germany) to move to the new REST API integration, we will start moving users soon and we will notify you once we are going to move you from SOAP to REST.
Supported Services
Domestic (Germany → Germany)
Service |
|---|
DHL Paket |
DHL Paket Kleinpaket (replaces Warenpost domestic) |
DHL Paket Retoure |
International (Germany → World, incl. intra-EU)
Service |
|---|
DHL Paket International (220+ countries) |
DHL Warenpost International (220+ countries) |
DHL Europaket (EU + CH, NO, GB) |
DHL Paket Retoure (EU + CH, NO, GB) |
Value-Added Services (Accessorials)
Service |
Notes |
|---|---|
Cash on Delivery (COD) |
Includes IBAN, BIC, transfer note, and explicit currency |
Additional Insurance |
Now includes explicit currency |
Bulky Goods |
Flag for oversized or difficult-to-handle shipments |
Premium |
Priority handling for domestic shipments |
Preferred Delivery Date |
Specify a desired delivery date for the recipient |
Preferred Location / Neighbour |
Authorize delivery to a specified safe location or a named neighbour |
No Neighbour Delivery |
Restrict delivery attempts to the addressee's address only |
Parcel Outlet Routing |
Route undeliverable parcels to the nearest parcel shop; requires a delivery notification email address |
Closest Drop Point |
Deliver to the nearest DHL drop point if home delivery is not possible |
Identity Check (IdentCheck) |
Verify recipient identity by name and date of birth; optional minimum age enforcement |
Visual Age Check |
Confirm recipient is at least 16 or 18 years old at the door |
Named Person Only |
Deliver exclusively to the named recipient; no proxy acceptance |
GoGreen Plus (Carbon-Neutral) |
⭐ New — offset the carbon footprint of the shipment; available for outbound and return shipments |
Enclosed Return Label |
Include a return label inside the outbound parcel; available for DHL Paket and Kleinpaket |
Individual Sender Requirement |
Include special handling or delivery instructions from the sender |
Postal Delivery Duty Paid (PDDP) |
Shipper covers all import duties and taxes; enabled automatically when DDP Incoterms are selected |
International Shipping & Customs
Full customs declaration is supported for all international shipments:
Export types: Documents, Gift, Commercial Sample, Return of Goods, Commercial Goods, Other
Incoterms: DAP or DDP (new)
Electronic Export Notification (paperless customs)
Non-delivery options: Return to sender or Abandon
Per-commodity fields: Description, HS tariff code, country of origin, quantity, weight, value, and currency (currency is new)
Additional reference fields: Invoice Number, License Number, Certificate Number (all new)
Customs documents (CN23) are included automatically in the ship response alongside the shipping label.
Return Shipments
Returns are handled via a dedicated DHL Returns API, separate from the shipping API
All return scenarios use a single unified service code — domestic and international
Supported destinations: all EU countries + Switzerland, Norway, and United Kingdom
International returns to non-EU destinations (GB, CH) require a customs declaration
Optional QR code label can be generated alongside the standard return label (new)
Return shipments cannot be voided once created
What's Changed vs. the SOAP Integration
Removed Services
The following services are no longer available as they have been discontinued by DHL:
Service |
|---|
DHL Paket Same Day |
DHL Courier Same Day |
DHL Paket Connect |
DHL Warenpost (Domestic) |
Key Differences at a Glance
Area |
SOAP (Previous) |
REST 2025 (New) |
|---|---|---|
Authentication |
Username/password per request |
OAuth 2.0 bearer token, cached ~30 min |
Return service types |
Two separate types |
Unified auto-remapped for backward compatibility |
GoGreen Plus |
Not available |
✅ New |
Incoterms (DAP/DDP) |
Not supported |
✅ New |
Invoice/License/Certificate number |
Not mapped |
✅ New |
Per-commodity currency |
Not supported |
✅ New |
QR code return label |
Not supported |
✅ New |
Delivery Timeframe (Preferred Time) |
Supported |
❌ Discontinued by DHL |
Units of measurement |
LBS/IN accepted |
Metric only (KGS/CM required) |