Skip to content

Conversation

@danh91
Copy link
Member

@danh91 danh91 commented Jan 2, 2026

Karrio 2026.1

Changes

Feat

  • feat(hermes): add Hermes Germany carrier integration with shipping, pickup, and rating support
  • feat(gls): add GLS Group carrier integration with OAuth2 authentication and shipment/tracking
  • feat(dpd_meta): add DPD META-API carrier integration with Bearer token authentication and caching
  • feat(postat): add Austrian Post (PostAT) carrier integration via Post-Labelcenter SOAP API
  • feat(parcelone): add ParcelOne multi-carrier hub integration with JSON REST API
  • feat(dhl_parcel_de): implement pickup support
  • feat: apply ratesheet GraphQL enhancements and the editor with shared zones and surcharges
  • feat: implement find helper for status and reason mapping retrieval
  • feat: introduce carrier integration FAQ and improve multi-piece shipment abstraction

Chore

  • chore: move chronopost to Karrio Core maintained connectors
  • refactor: standardize carrier authentication to use Proxy.authenticate() method
  • refactor: review and cleanup new integrations to match coding standard

danh91 and others added 30 commits December 24, 2025 12:42
- Implement OAuth2 authentication with token caching
- Add shipment creation with label generation support
- Add tracking functionality for shipments
- Support for multiple parcel types and services
- Generated schemas from GLS Group API documentation
- Include basic test structure for shipment and tracking

Features:
- OAuth2 client credentials flow for authentication
- Shipment creation with parcels, services, and references
- Tracking with event history and status mapping
- Support for GLS Group services (PARCEL, EXPRESS, GUARANTEED24, etc.)
- PDF label generation

API Endpoints:
- Production: https://api.gls-group.net
- Sandbox: https://api-sandbox.gls-group.net
- OAuth2: /oauth2/v2/token
- Shipments: /rs/shipments
- Tracking: /rs/tracking/{trackingNumber}
- Replace manual cache checking with thread_safe() pattern
- Match implementation pattern from UPS connector
- Add trace parameter to login function for better debugging
- Use proper keyword argument for ParsedMessagesError
- Ensure thread-safe token refresh with 30-minute buffer

This improves performance and reliability in multi-threaded environments
by delegating token refresh to ThreadSafeTokenManager.
…de-011CUpJCML3GaBaxuEHCXMXu

[carrier-integration] GLS Group
Add comprehensive DPD Group shipping integration with the following features:

- Shipment creation with JWT authentication
- Package tracking
- Label generation (PDF format)
- Support for multiple DPD Group services (Classic, Express 10/12/18, Parcelshop)
- Full test coverage for shipment and tracking operations
- Support for shipping options (Saturday delivery, insurance)

API Endpoints:
- PREPROD: https://nst-preprod.dpsin.dpdgroup.com/api/v1.1/
- PROD: https://shipping.dpdgroup.com/api/v1.1/

Integration follows Karrio carrier integration guide with:
- Generated Python data classes from JSON schemas
- Functional programming patterns
- Comprehensive error handling
- Full plugin metadata configuration
Remove custom async wrappers and logic from mapper.py to strictly follow
the Karrio mapper template. The mapper should only contain simple delegation
methods that call provider functions.

Changes:
- Removed create_shipment(), _create_shipment() async wrapper methods
- Removed get_tracking(), _get_tracking() async wrapper methods
- Removed custom response handling logic from parse_tracking_response()
- Updated tracking provider to handle multiple responses from proxy
- Mapper now only contains pure delegation methods as per template

This follows the template at:
github.com/karrioapi/karrio/.../templates/sdk.py
@vercel
Copy link

vercel bot commented Jan 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
karrio-web Ready Ready Preview, Comment Jan 8, 2026 3:34am

@danh91 danh91 changed the title [patch] 2025.5.8 [release] 2026.1 Jan 8, 2026
@danh91
Copy link
Member Author

danh91 commented Jan 8, 2026

#930

@danh91 danh91 closed this Jan 8, 2026
@danh91 danh91 deleted the patch-2025.5.8 branch January 8, 2026 04:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants