Karrio patch 2026.1.1

Changes

Feat

• feat: add payment as well on rate and update API schemas
• feat: update rate requests to use exhaustive customs data when provided for international requests
• feat: introduce computed estimated_delivery on tracker creation when transit day is available

Fix

• fix: add missing customs field to RateRequest serializer
• fix: affected the computed adjusted weight on all integrations
• fix: below 3 decimal items' weight rounding causing invalid total package weight

Karrio OSS 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

Karrio patch 2025.5.7

Changes

Feat

• feat: set up agent-specific md files + enhanced shared AGENTS.md
• feat: add support for karrio migrate post dev install
• feat: draft Claude Carrier integration skill and PRD for integrator agent implementation
• feat: introduce reason, timestamp and status at the tracking event object level + picked_up status for richer tracking analytics
• feat(sapient): improve error handling + upgrade to standardized authenticate proxy method for a more robust auth handling

Fix

• fix(FedEx): exclude customs for domestic shipments

Docs

• docs: prepare PRDs for upcoming feature developments

Chore

• refactor: authentications to the new proxy interface

Karrio patch 2025.5.6

Changes

Feat

• feat: ratesheet datastructure upgrade + support for surcharges
• feat: improve UX with document download to support all authentication methods available to the API

Chores

• chore(deps): bump next from 15.4.8 to 15.4.10 in /packages/core

Karrio patch 2025.5.5

Changes

Feat

• feat: implement full features for mydhl express integration + vendor assets updates
• feat(mydhl): implement complete shipment creation with customs support

Docs

• docs: update README with recent app screenshots

Chore

• chore(deps): bump next from 15.0.3 to 15.4.7 on all apps

Karrio patch 2025.5.4

Changes

Feat

• feat(WIP): introduce karrio studio to enhance dev experience and assist integration and development
• feat: introduce shipping_documents field on shipment object that returns a more structured list of shipping documents details, and include base64 documents version from purchasing APIs
• feat: add audit log Model settings required by django-auditlog==3.4.0
• feat: introduce reason field to karrio unified tracking event data

Fix

• fix: idempotent API response for shipment cancellation when called twice on a shipment that was successfully cancelled, return HTTP code 304

Docs

• docs: karrio Shipping integration quick start with key APIs

Chore

• chore: remove poorly implemented permissions layer

Karrio patch 2025.5.3

Changes

Feat

• feat: make shipment cancellation idempotent
• feat: Implement POST requests for shipping documents downloads
• feat: map error/message levels in carrier integrations and karrio server
• feat: add support for shipping method purchase on /v1/shipments for EE edition

Fix

• fix: constance N+1 issue

Chore

• chore: apply sentry setup fix + permissions unstable migrations

Karrio patch 2025.5.2

Changes

Feat

• feat: consolidate apply_shipping_rules with support for single call label generation

Fix

• fix: server perf affected by Sentry + fix permission issues caused by carriers permission update

Karrio OSS 2025.5 (Yayra Edition)

Release Date: Dec 1st, 2025

Full Changelog: https://github.com/karrioapi/karrio/releases/tag/v2025.5

Blog Post: https://karrio.io/blog/karrio-2025-5-sustainability

Highlights

Karrio 2025.5 is a milestone release introducing a dual-license model to ensure long-term sustainability while preserving the open-source core. This release also includes significant technical improvements, new carrier integrations, and enhanced developer experience.

License Transition

Karrio now uses a dual-license structure:

• LGPL-3.0 for the open-source core (server, SDK, community plugins)
• Karrio Enterprise License for enterprise features (/ee directory)

This follows the proven models of Odoo and n8n—enabling a thriving open-source community alongside a sustainable business.

Discontinuation of Karrio Insiders

The Karrio Insiders program is discontinued in favor of a focused Karrio Enterprise License for embedding and white-labeling needs.
Existing Insiders donations and subscriptions will end December 31st.

What's New

New Interfaces & APIs

Karrio 2025.5 introduces a comprehensive set of interfaces that extend the platform's capabilities beyond core shipping operations. These interfaces allow carriers and LSP (Logistics Service Provider) plugins to provide specialized services.

Interface	Purpose	Example Use Cases
Hooks	Custom shipping logic integration points	Pre/post shipment processing, custom validations
Duties	International duties and taxes calculation	Landed cost estimation, DDP shipments
Insurance	Shipment protection capabilities	Third-party insurance providers, declared value
Webhook	Carrier webhook management	Real-time tracking updates, event subscriptions
Auth Proxy	Standardized OAuth/authentication	Carrier OAuth flows, token management

New Carrier Integrations

• Teleship - Full integration with OAuth, webhooks, and duties engine support
• Landmark Global - Cross-border e-commerce shipping (enhanced)
• DTDC - Indian courier and logistics integration

Dashboard & UI

• Migrated to shadcn/ui with Tailwind CSS
• Dark mode theme for developer tools
• New Karrio Dev Tools drawer
• Improved carrier connection management
• Enhanced settings and organization management
• Document template editor improvements
• Bulk print and shipment CSV export
• App Store for managing shipping apps (beta)
• Swagger API playground (replaced Redoc)
• Shippers addons management page

Performance & Reliability

• Resolved N+1 query issues across models and GraphQL
• Database lock fixes for SQLite-based workers
• Improved Redis configuration (REDIS_URL, REDIS_SSL support)
• HUEY worker initialization race condition fix
• Optimized archiving queries with batch processing
• Database indexes for date-based filters

Automation & Workflows

• Shipping Rules API and dashboard panels
• Workflows management for automated shipping logic
• has_alternative_services flag for carrier connections

Developer Experience

• Plugin development guide documentation
• Telemetry abstraction (Sentry, DataDog, OpenTelemetry)
• Loguru logging improvements
• AGENTS.md for AI-assisted development
• Improved error parsing and notifications
• Karrio CLI (kcli) with plugin management and carrier details
• SDK plugins loader with entrypoint support
• Docker-Compose plugins mount point (./plugins dir)
• x-tenant-id and x-request-id headers support

Security & Enterprise

• Limited scope API tokens for secure document downloads
• SSO metadata fields for organizations
• Secure Redis connection handling
• Admin session cookie customization
• Tenant isolation improvements

Breaking Changes

• Python SDK import: Changed from import karrio to import karrio.sdk as karrio
• Dashboard port: Default changed from 3000 to 3002
• Python version: Now requires >=3.11
• Deprecated carrier connections and custom models removed
• GraphQL query/mutation changes (see integration tests)
• Dashboard component refactor (shadcn migration)
• Headless UI removed in favor of shadcn/ui components

Bug Fixes

• OAuth token expiry calculation
• Package preset override regression
• Custom rate resolution with missing dimensions
• Order duplication and race conditions
• Shipment cancellation webhook format
• Email change token validation
• Organization dropdown errors
• Dashboard state management issues

Documentation

• Updated plugin development guide
• Redis setup instructions
• Dashboard navigation guide
• Missing environment variables documented

Upgrade Notes

1. Review the new LICENSE file
2. Insiders users: contact hello@karrio.io for questions
3. Update Python SDK imports: import karrio → import karrio.sdk as karrio
4. Update dashboard port references from 3000 to 3002
5. Ensure Python >=3.11 is installed
6. Check GraphQL queries and Shipping REST APIs for breaking changes

Contributors

Thanks to all contributors who made this release possible, including @mazzarito, @Ansh-Dev-Nagar @akaylia123 and @ashishdevnagar

Karrio preview 2025.5rc23

Changes

Feat

• feat: adds a button to copy docs pages for LLMs

Fix

• fix: redirection issue when the sign-in page is accessed directly
• fix: the readability of certain features on the documentation when in dark mode

Chore

• chore: set up Posthog for docs analytics

DevX

• devx: prevent node constant override to the latest version and set a minimum version for karrio development
• devx: debugging and improving dev and HTTPS support, both for development and production deployment
• devx: introduce AGENTS.md using cursor