[patch] 2026.1.12 (#969)

* docs: add Return Shipment API PRD and rename bundled returns PRD

Rename RETURNS_SUPPORT.md to SHIPPING_RETURN_LABEL_SUPPORT.md to clarify
its scope (return labels bundled with outbound shipment creation).
Add new RETURN_SHIPMENT_API.md PRD for standalone return label creation
with is_return flag, dedicated Mapper/Proxy methods, and address auto-swap.

* feat: add return shipment support to SDK core

- add is_return flag to ShipmentRequest model
- add create_return_shipment flow to interface with address auto-swap
- add return shipment mapper and proxy abstract methods
- add SDK-level return shipment unit test

* feat: add return shipment support to server layer

- add is_return field to Shipment model with migration
- update serializers and datatypes for return shipment flow
- add return shipment filtering support
- update GraphQL types and inputs for return shipment data
- add server-level return shipment tests

* feat: add return shipment scaffolding to CLI templates

* feat: add return shipment fields to TypeScript GraphQL types

* feat: add return shipment support for DHL Parcel DE

- implement standalone return via /returns/v1/orders API
- add returns_request and returns_response schemas
- add return_shipment provider with request/response handling
- register mapper and proxy methods for return shipment flow
- add return shipment tests with request/response fixtures

* feat: add return shipment support for Canada Post

- implement standalone return via /authorizedreturn API
- add return_shipment provider with authreturn-v2 XML schema
- register mapper and proxy methods for return shipment flow
- add return shipment tests with request/response/error fixtures

* feat: add return shipment support for UPS

- implement return wrapper delegating to shipment API with ReturnService
- default to ups_return_3_attempt (code 5) when no return type specified
- register mapper and proxy methods for return shipment flow
- add return shipment tests with request/response fixtures

* feat: add return shipment support for FedEx

- implement return wrapper delegating to shipment API with returnShipmentDetail
- force PRINT_RETURN_LABEL return type via fedex_return_shipment option
- register mapper and proxy methods for return shipment flow
- add return shipment tests with request/response fixtures

* feat: add return shipment support for USPS

- implement return wrapper delegating to label API with returnLabel=true
- add usps_return_receipt to CUSTOM_OPTIONS to prevent duplicate extra service
- fix option name resolution bug in shipment request builder
- register mapper and proxy methods for return shipment flow
- add return shipment tests with request/response fixtures

* fix: resolve mypy variable redefinition errors in return shipment interface

* fix: add is_return field to server test fixtures

* feat: add return shipment support for Asendia

* feat: add return shipment support for Australia Post

* feat: add return shipment support for bpost

* feat: add return shipment support for DHL Express

* feat: add return shipment support for DHL Poland

* feat: add return shipment support for DPD Meta

* feat: add return shipment support for GLS

* feat: add return shipment support for Hermes

* feat: add return shipment support for Landmark Global

* feat: add return shipment support for MyDHL

* feat: add return shipment support for Purolator

* feat: add return shipment support for Spring

* feat: add return shipment support for USPS International

* docs: add Karrio MCP Server PRD

* fix: add missing Info type annotations for strawberry GraphQL resolvers

* fix: add missing Info type annotations for admin and graph utility resolvers

* fix: add missing Info type annotations for insiders and platform GraphQL resolvers

* feat: add X-Request-ID middleware and propagation to all operations

* feat: add request_id filters and keyword search support

* feat: expose request_id as first-class GraphQL field and filter

* test: add request_id tests and update test fixtures

* feat: update schemas and TypeScript types for request_id

* feat: display request_id in entity detail views and devtools

* chore: clean up tests and code to match AGENTS.md conventions

* docs: add X-Request-ID implementation PRD

* chore: update ee/platform submodule for request_id schema

* chore: update generated files and add pricing migration

* fix(canadapost): use recipient country for international rating (#968)

* fix(canadapost): use recipient country for international rating

* test(canadapost): use generic dummy data for intl country-code regression

* docs(canadapost): clarify format_ca_postal_code normalization

* fix(landmark): add User-Agent header to all Landmark API requests

Landmark's API rejects requests without a User-Agent header, returning
"invalid username/password" errors. This was silently breaking all
background tracking fetches, shipment creation, and cancellation calls.

* feat: bootstrap SmartKargo carrier extension

* feat: add SmartKargo API schemas

* feat: generate Python data classes from schemas

* feat: add carrier units, settings, and connection utilities

* feat: implement API proxy and error handling

* feat: implement SmartKargo rate/quotation API

* feat: implement SmartKargo shipment creation

* feat: implement SmartKargo tracking and error handling

* fix: align SmartKargo rate and shipment with standard Karrio patterns

* feat: implement shipment cancellation

* feat: fix SmartKargo quotation API endpoint and required issueDate field

* test: update tests with API responses

* fix: correct label API format parameter and test imports

* feat: add vendor folder with API documentation

* fix: align shipment void with OpenAPI specification

* fix: add uuid fallback for required reference field & add issueDate fallback

* feat: make account_number and account_id required fields

* fix: default to EST service type when none specified in SmartKargo rate requests

* fix: unwrap array-wrapped SmartKargo booking response and fix ratesheets key access in dataunits

* fix: simplify SmartKargo proxy to use labelUrl from booking response

* feat: switch SmartKargo rate and shipment to per-package request pattern

* fix: fix multi-piece cancel and move proxy helpers to utils

* test: update SmartKargo tests to FAQ-standard assertListEqual pattern

* chore: merge SmartKargo integration and Canada Post intl fix with cleanup

- Merge PR #956 (SmartKargo carrier integration) and PR #968 (Canada Post intl rating fix)
- Fix bare Exception catch in utils.py to use specific (ValueError, TypeError)
- Enable services/options in plugin metadata (were commented out)
- Add website and status fields to plugin metadata
- Remove duplicate TrackingIncidentReason mapping
- Clean up trailing whitespace in mapper.py

* docs: update CHANGELOG for 2026.1.12 release

* chore: add smartkargo to SDK and build requirements

* chore: update generated files and add SmartKargo to order shipments query

Add request_id and selected_rate_carrier to GET_ORDERS shipments
sub-query and regenerate all types to fix dashboard build.

* docs: add no-auto-commit and no-AI-co-author rules to AGENTS.md

* fix: bulk tracker webhook notifications, landmark proxy cleanup, and changelog update

- Dispatch webhook notifications for trackers changed via bulk_update
- Remove hardcoded User-Agent headers from Landmark proxy requests
- Add smartkargo carrier image mapping to base.ts
- Update CHANGELOG for 2026.1.12 release

* feat: enhance health view task breakdown with detailed execution table

- Increase task executions query from 100 to 1000
- Add expandable task rows showing individual executions
- Show status, queued time, duration, retries, and error details
- Add status filter tabs (all/complete/error/executing)
- Display last run time and avg duration per task name

* fix: use full datetime format in tracing view to match events view

* release: 2026.1.12

---------

Co-authored-by: Hans Daigle <HansDaigle@users.noreply.github.com>
Co-authored-by: Ansh Dev Nagar <anshdevnagar@gmail.com>

Author: 3 people

AGENTS.md

@@ -609,6 +609,8 @@ try {
 
 ## Commit & Pull Request Guidelines
 
+- **Never commit without explicit user permission** — always ask before creating a commit
+- **Never add AI co-author lines** (e.g., `Co-Authored-By: Claude ...`) to commit messages
 - Format: `type: summary` (e.g., `fix:`, `feat:`, `chore:`)
 - Reference issues: `refs #123` or `fixes #123`
 - Keep commits focused and atomic

CHANGELOG.md

@@ -1,3 +1,38 @@
+# Karrio 2026.1.12
+
+## Changes
+
+### Feat
+
+- feat: add SmartKargo carrier integration (rating, shipment, tracking, labels)
+- feat: add return shipment support to SDK core and server layer
+- feat: add return shipment support for UPS, FedEx, Canada Post, DHL Express, DHL Parcel DE, USPS, and more
+- feat: add return shipment fields to TypeScript GraphQL types
+- feat: add X-Request-ID middleware and propagation to all operations
+- feat: expose request_id as first-class GraphQL field and filter
+- feat: display request_id in entity detail views and devtools
+
+### Fix
+
+- fix(canadapost): use recipient country code for international rating
+- fix(landmark): remove hardcoded User-Agent headers from proxy requests
+- fix: add missing Info type annotations for strawberry GraphQL resolvers
+- fix: dispatch webhook notifications for bulk-updated trackers
+
+### Chore
+
+- chore: update generated files and add pricing migration
+- chore: clean up tests and code to match AGENTS.md conventions
+- chore: add smartkargo carrier image mapping
+
+### Docs
+
+- docs: add X-Request-ID implementation PRD
+- docs: add Return Shipment API PRD
+- docs: add Karrio MCP Server PRD
+
+---
+
 # Karrio 2026.1.11
 
 ## Changes
@@ -22,7 +57,7 @@
 - fix: show exact page counts instead of "of many" in devtools pagination
 - fix: resolve duplicate TaskExecution records causing stuck executing status
 - fix: use icontains for meta and metadata value filters on markups
-- fix: port rate sheet editor layout improvements and bug fixes 
+- fix: port rate sheet editor layout improvements and bug fixes
 
 ### Perf
 

PRDs/KARRIO_MCP_SERVER.md

@@ -1 +1 @@
-2026.1.11
+2026.1.12

PRDs/RETURN_SHIPMENT_API.md

@@ -297,6 +297,7 @@
     "corsheaders.middleware.CorsMiddleware",
     "django.middleware.common.CommonMiddleware",
     "django.middleware.csrf.CsrfViewMiddleware",
+    "karrio.server.core.middleware.RequestIDMiddleware",
     "karrio.server.core.authentication.AuthenticationMiddleware",
     "karrio.server.core.authentication.TwoFactorAuthenticationMiddleware",
     "django.contrib.messages.middleware.MessageMiddleware",

PRDs/RETURNS_SUPPORT.md PRDs/SHIPPING_RETURN_LABEL_SUPPORT.mdPRDs/RETURNS_SUPPORT.md renamed to PRDs/SHIPPING_RETURN_LABEL_SUPPORT.md

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.