karrio-hermes 2026.1__py3-none-any.whl → 2026.1.3__py3-none-any.whl

karrio/providers/hermes/tracking.py

@@ -0,0 +1,156 @@
+"""Karrio Hermes tracking API implementation."""
+
+import typing
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.hermes.error as error
+import karrio.providers.hermes.utils as provider_utils
+import karrio.providers.hermes.units as provider_units
+import karrio.schemas.hermes.tracking_response as hermes_res
+
+
+def _match_status(code: str) -> typing.Optional[str]:
+    """Match Hermes event code against TrackingStatus enum values."""
+    if not code:
+        return None
+    for status in list(provider_units.TrackingStatus):
+        if code in status.value:
+            return status.name
+    return None
+
+
+def _match_reason(code: str) -> typing.Optional[str]:
+    """Match Hermes event code against TrackingIncidentReason enum values."""
+    if not code:
+        return None
+    for reason in list(provider_units.TrackingIncidentReason):
+        if code in reason.value:
+            return reason.name
+    return None
+
+
+def parse_tracking_response(
+    _response: lib.Deserializable[dict],
+    settings: provider_utils.Settings,
+) -> typing.Tuple[typing.List[models.TrackingDetails], typing.List[models.Message]]:
+    """Parse tracking response from Hermes Shipment Info API."""
+    response = _response.deserialize()
+
+    # Parse the response using generated schema
+    tracking_response = lib.to_object(hermes_res.TrackingResponseType, response)
+
+    # Collect error messages
+    messages: typing.List[models.Message] = []
+
+    # Extract tracking details for each shipment
+    tracking_details: typing.List[models.TrackingDetails] = []
+
+    for shipment_info in tracking_response.shipmentinfo or []:
+        # Check for errors in individual shipment result
+        if shipment_info.result and shipment_info.result.code:
+            if shipment_info.result.code.startswith("e"):
+                messages.append(
+                    models.Message(
+                        carrier_id=settings.carrier_id,
+                        carrier_name=settings.carrier_name,
+                        code=shipment_info.result.code,
+                        message=shipment_info.result.message or "",
+                        details=dict(shipment_id=shipment_info.shipmentID),
+                    )
+                )
+                continue
+
+        # Extract tracking details
+        details = _extract_details(shipment_info, settings)
+        if details:
+            tracking_details.append(details)
+
+    return tracking_details, messages
+
+
+def _extract_details(
+    shipment_info: hermes_res.ShipmentinfoType,
+    settings: provider_utils.Settings,
+) -> typing.Optional[models.TrackingDetails]:
+    """Extract tracking details from Hermes shipment info."""
+    if not shipment_info.shipmentID:
+        return None
+
+    # Get status events (already in chronological order, most recent last in API)
+    # Reverse to have most recent first for Karrio convention
+    status_list = list(reversed(shipment_info.status or []))
+
+    # Get latest event code for overall status
+    latest_code = status_list[0].code if status_list else None
+    overall_status = _match_status(latest_code) or provider_units.TrackingStatus.in_transit.name
+
+    # Build tracking events with all required fields per CARRIER_INTEGRATION_GUIDE.md
+    events = [
+        models.TrackingEvent(
+            date=lib.fdate(event.timestamp, "%Y-%m-%dT%H:%M:%S%z"),
+            time=lib.flocaltime(event.timestamp, "%Y-%m-%dT%H:%M:%S%z"),
+            description=event.description or "",
+            code=event.code,
+            location=lib.join(
+                event.scanningUnit.city if event.scanningUnit else None,
+                event.scanningUnit.countryCode if event.scanningUnit else None,
+                join=True,
+                separator=", ",
+            ),
+            # REQUIRED: timestamp in ISO 8601 format (already provided by Hermes)
+            timestamp=event.timestamp,
+            # REQUIRED: normalized status at event level
+            status=_match_status(event.code),
+            # Incident reason for exception events
+            reason=_match_reason(event.code),
+        )
+        for event in status_list
+    ]
+
+    # Build delivery forecast info if available
+    estimated_delivery = None
+    if shipment_info.deliveryForecast and shipment_info.deliveryForecast.date:
+        estimated_delivery = shipment_info.deliveryForecast.date
+
+    return models.TrackingDetails(
+        carrier_id=settings.carrier_id,
+        carrier_name=settings.carrier_name,
+        tracking_number=shipment_info.shipmentID,
+        events=events,
+        delivered=overall_status == "delivered",
+        status=overall_status,
+        estimated_delivery=estimated_delivery,
+        info=models.TrackingInfo(
+            carrier_tracking_link=shipment_info.trackingLink,
+            customer_name=None,
+            shipment_destination_country=(
+                shipment_info.receiverAddress.countryCode
+                if shipment_info.receiverAddress
+                else None
+            ),
+            shipment_destination_postal_code=(
+                str(shipment_info.receiverAddress.zipCode)
+                if shipment_info.receiverAddress and shipment_info.receiverAddress.zipCode
+                else None
+            ),
+        ),
+        meta=dict(
+            client_id=shipment_info.clientID,
+            client_reference=shipment_info.clientReference,
+            client_reference2=shipment_info.clientReference2,
+            part_number=shipment_info.partNumber,
+            international_shipment_id=shipment_info.internationalShipmentID,
+        ),
+    )
+
+
+def tracking_request(
+    payload: models.TrackingRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    """Create tracking request for Hermes Shipment Info API.
+
+    Hermes uses GET requests with query parameters, so we just return
+    the tracking numbers to be used as shipmentID query params.
+    """
+    return lib.Serializable(payload.tracking_numbers)

karrio/providers/hermes/units.py

@@ -66,41 +66,41 @@ class ShippingOption(lib.Enum):
 
     # Hermes services as options
     hermes_tan_service = lib.OptionEnum("tanService", bool)
-    hermes_limited_quantities = lib.OptionEnum("limitedQuantitiesService", bool)
+    hermes_limited_quantities = lib.OptionEnum("limitedQuantitiesService", bool, meta=dict(category="DANGEROUS_GOOD"))
     hermes_bulk_goods = lib.OptionEnum("bulkGoodService", bool)
-    hermes_household_signature = lib.OptionEnum("householdSignatureService", bool)
+    hermes_household_signature = lib.OptionEnum("householdSignatureService", bool, meta=dict(category="SIGNATURE"))
     hermes_compact_parcel = lib.OptionEnum("compactParcelService", bool)
-    hermes_next_day = lib.OptionEnum("nextDayService", bool)
-    hermes_signature = lib.OptionEnum("signatureService", bool)
-    hermes_redirection_prohibited = lib.OptionEnum("redirectionProhibitedService", bool)
-    hermes_exclude_parcel_shop_auth = lib.OptionEnum("excludeParcelShopAuthorization", bool)
+    hermes_next_day = lib.OptionEnum("nextDayService", bool, meta=dict(category="DELIVERY_OPTIONS"))
+    hermes_signature = lib.OptionEnum("signatureService", bool, meta=dict(category="SIGNATURE"))
+    hermes_redirection_prohibited = lib.OptionEnum("redirectionProhibitedService", bool, meta=dict(category="DELIVERY_OPTIONS"))
+    hermes_exclude_parcel_shop_auth = lib.OptionEnum("excludeParcelShopAuthorization", bool, meta=dict(category="PUDO"))
     hermes_late_injection = lib.OptionEnum("lateInjectionService", bool)
 
     # Cash on delivery
-    hermes_cod_amount = lib.OptionEnum("codAmount", float)
-    hermes_cod_currency = lib.OptionEnum("codCurrency", str)
+    hermes_cod_amount = lib.OptionEnum("codAmount", float, meta=dict(category="COD"))
+    hermes_cod_currency = lib.OptionEnum("codCurrency", str, meta=dict(category="COD"))
 
     # Customer alert service
-    hermes_notification_email = lib.OptionEnum("notificationEmail", str)
-    hermes_notification_type = lib.OptionEnum("notificationType", str)  # EMAIL, SMS, EMAIL_SMS
+    hermes_notification_email = lib.OptionEnum("notificationEmail", str, meta=dict(category="NOTIFICATION"))
+    hermes_notification_type = lib.OptionEnum("notificationType", str, meta=dict(category="NOTIFICATION"))  # EMAIL, SMS, EMAIL_SMS
 
     # Stated day service
-    hermes_stated_day = lib.OptionEnum("statedDay", str)  # YYYY-MM-DD format
+    hermes_stated_day = lib.OptionEnum("statedDay", str, meta=dict(category="DELIVERY_OPTIONS"))  # YYYY-MM-DD format
 
     # Stated time service
-    hermes_time_slot = lib.OptionEnum("timeSlot", str)  # FORENOON, NOON, AFTERNOON, EVENING
+    hermes_time_slot = lib.OptionEnum("timeSlot", str, meta=dict(category="DELIVERY_OPTIONS"))  # FORENOON, NOON, AFTERNOON, EVENING
 
     # Ident service
-    hermes_ident_id = lib.OptionEnum("identID", str)
-    hermes_ident_type = lib.OptionEnum("identType", str)  # GERMAN_IDENTITY_CARD, etc.
-    hermes_ident_fsk = lib.OptionEnum("identVerifyFsk", str)  # 18
-    hermes_ident_birthday = lib.OptionEnum("identVerifyBirthday", str)  # YYYY-MM-DD
+    hermes_ident_id = lib.OptionEnum("identID", str, meta=dict(category="SIGNATURE"))
+    hermes_ident_type = lib.OptionEnum("identType", str, meta=dict(category="SIGNATURE"))  # GERMAN_IDENTITY_CARD, etc.
+    hermes_ident_fsk = lib.OptionEnum("identVerifyFsk", str, meta=dict(category="SIGNATURE"))  # 18
+    hermes_ident_birthday = lib.OptionEnum("identVerifyBirthday", str, meta=dict(category="SIGNATURE"))  # YYYY-MM-DD
 
     # Parcel shop delivery
-    hermes_parcel_shop_id = lib.OptionEnum("psID", str)
-    hermes_parcel_shop_selection_rule = lib.OptionEnum("psSelectionRule", str)  # SELECT_BY_ID, SELECT_BY_RECEIVER_ADDRESS
-    hermes_parcel_shop_customer_firstname = lib.OptionEnum("psCustomerFirstName", str)
-    hermes_parcel_shop_customer_lastname = lib.OptionEnum("psCustomerLastName", str)
+    hermes_parcel_shop_id = lib.OptionEnum("psID", str, meta=dict(category="PUDO"))
+    hermes_parcel_shop_selection_rule = lib.OptionEnum("psSelectionRule", str, meta=dict(category="PUDO"))  # SELECT_BY_ID, SELECT_BY_RECEIVER_ADDRESS
+    hermes_parcel_shop_customer_firstname = lib.OptionEnum("psCustomerFirstName", str, meta=dict(category="PUDO"))
+    hermes_parcel_shop_customer_lastname = lib.OptionEnum("psCustomerLastName", str, meta=dict(category="PUDO"))
 
     # Multipart service
     hermes_part_number = lib.OptionEnum("partNumber", int)
@@ -128,15 +128,247 @@ def shipping_options_initializer(
 
 
 class TrackingStatus(lib.Enum):
-    """Hermes tracking status mapping."""
-
-    on_hold = ["on_hold"]
-    delivered = ["delivered"]
-    in_transit = ["in_transit"]
-    delivery_failed = ["delivery_failed"]
-    delivery_delayed = ["delivery_delayed"]
-    out_for_delivery = ["out_for_delivery"]
-    ready_for_pickup = ["ready_for_pickup"]
+    """Hermes tracking status mapping.
+
+    Maps Hermes 2x2 event codes (4-digit) to Karrio unified statuses.
+    Based on Hermes Germany Eventcodes.csv.
+    """
+
+    pending = [
+        "0000",  # Die Sendung wurde Hermes elektronisch angekündigt
+        "0600",  # Shipment has not arrived at the depot (1st notice)
+        "0700",  # Shipment has not arrived at the depot (2nd notice)
+        "0800",  # Shipment has not arrived at the depot (7 days)
+        "0900",  # Shipment has not arrived at the depot (28 days)
+    ]
+    picked_up = [
+        "1000",  # Die Sendung hat das Lager des Auftraggebers verlassen
+        "1900",  # Shipment accepted after collection
+        "1901",  # Shipment arrived at branch by self-delivery
+        "1910",  # Shipment received on tour
+    ]
+    in_transit = [
+        "1510",  # Sendung am LC umgeschlagen (sorted at logistics center)
+        "1610",  # Shipment in international transit
+        "1710",  # Customs export created
+        "1720",  # Customs clearance completed
+        "1810",  # Handed to partner carrier (international)
+        "1820",  # Handed to partner carrier (international)
+        "2000",  # Die Sendung ist eingetroffen (arrived at depot)
+        "2100",  # Arrived without advice data
+        "2300",  # Automatic shipment received
+        "2400",  # Shipment handed in at ParcelShop
+    ]
+    out_for_delivery = [
+        "3000",  # Die Sendung ist auf Zustelltour gegangen
+        "3010",  # Shipment has left depot on tour
+        "3300",  # Sorted for delivery tour (automatic)
+    ]
+    ready_for_pickup = [
+        "3410",  # Die Sendung liegt im PaketShop zur Abholung bereit
+        "3430",  # Handed over to island carrier
+    ]
+    delivered = [
+        "3500",  # Die Sendung wurde zugestellt
+        "3510",  # Shipment delivered (with scanner)
+        "3511",  # Delivered in letterbox
+        "3520",  # Shipment delivered (without scanner)
+        "3530",  # Collected by recipient from ParcelShop
+        "7500",  # Return shipment arrived at client
+    ]
+    delivery_failed = [
+        "3710",  # Annahmeverweigerung (refused)
+        "3715",  # COD not paid
+        "3720",  # Address not found
+        "3731",  # Recipient not present (1st attempt)
+        "3732",  # Recipient not present (2nd attempt)
+        "3733",  # Recipient not present (3rd attempt)
+        "3734",  # Recipient not present (4th attempt)
+        "3740",  # Damage detected
+        "3750",  # Tour cancellation
+        "3751",  # Incorrect TAN (1st attempt)
+        "3752",  # Incorrect TAN (2nd attempt)
+        "3753",  # Incorrect TAN (3rd attempt)
+        "3754",  # Incorrect TAN (4th attempt)
+        "3760",  # Return shipment collected
+        "3761",  # Return shipment taken
+        "3780",  # Misdirected
+        "3782",  # Ident failed - photo mismatch
+        "3783",  # Ident failed - name mismatch
+        "3784",  # Ident failed - DOB mismatch
+        "3785",  # Ident failed - document mismatch
+        "3786",  # Ident failed - PIN code
+        "3787",  # Ident failed - age verification
+        "3795",  # Shipment stopped
+    ]
+    on_hold = [
+        "1730",  # Held by customs
+        "1751",  # Rejected by customs
+        "4100",  # Sendung wird aufbewahrt (shipment stored)
+        "4500",  # Stored (stocktaking)
+        "4610",  # ParcelShop - high volume, cannot pick up
+        "4620",  # ParcelShop - shipment not available
+        "4630",  # ParcelShop - shipment not found
+        "4690",  # Status corrected at ParcelShop
+    ]
+    delivery_delayed = [
+        "4010",  # Return - refused
+        "4015",  # Return - COD not paid
+        "4020",  # Return - address not found
+        "4024",  # Return - too large/heavy for ParcelShop
+        "4025",  # Shipment returned to depot
+        "4031",  # Return - N1 (1st attempt failed)
+        "4032",  # Return - N2 (2nd attempt failed)
+        "4033",  # Return - N3 (3rd attempt failed)
+        "4034",  # Return - N4 (4th attempt failed)
+        "4035",  # Return - not collected from ParcelShop
+        "4040",  # Return - damage
+        "4050",  # Return - tour cancellation
+        "4051",  # Return - TAN 1
+        "4052",  # Return - TAN 2
+        "4053",  # Return - TAN 3
+        "4054",  # Return - TAN 4
+        "4060",  # Return shipment received (pickup)
+        "4061",  # Return shipment received (take-away)
+        "4062",  # Return handed in at ParcelShop
+        "4070",  # Tour departure cancelled
+        "4072",  # Return cancelled (correction)
+        "4080",  # Misdirected
+        "4081",  # Ident failed
+        "4082",  # Ident failed - photo
+        "4083",  # Ident failed - name
+        "4084",  # Ident failed - DOB
+        "4085",  # Ident failed - document
+        "4086",  # Ident failed - PIN
+        "4087",  # Ident failed - age
+        "4095",  # Delivery stopped
+    ]
+    return_to_sender = [
+        "1520",  # Return shipment sorted
+        "6080",  # Rückversand (return shipment)
+        "6081",  # Return - refused
+        "6082",  # Return - address not readable
+        "6083",  # Return - address not found
+        "6084",  # Return - receiver not met
+        "6085",  # Return - damage
+        "6086",  # Return - sorting error
+        "6087",  # Return - technical issue
+        "6088",  # Redirected at receiver request
+        "6089",  # Return - returns
+        "6090",  # Forwarded to logistics center
+        "6092",  # Return - ident failed
+        "6093",  # Return - not collected from ParcelShop
+        "6094",  # Return - COD not paid
+        "6096",  # Return - too large/heavy for ParcelShop
+        "6098",  # Return - incorrect TAN
+        "6099",  # Return - delivery stopped
+    ]
+
+
+class TrackingIncidentReason(lib.Enum):
+    """Maps Hermes exception codes to normalized incident reasons.
+
+    Based on Hermes Germany Eventcodes.csv.
+    Maps carrier-specific exception/status codes to standardized
+    incident reasons for tracking events.
+    """
+
+    # Consignee-caused issues
+    consignee_refused = [
+        "3710",  # Annahmeverweigerung
+        "4010",  # Return - refused
+        "6081",  # Return - refused
+    ]
+    consignee_not_home = [
+        "3731",  # Recipient not present (1st attempt)
+        "3732",  # Recipient not present (2nd attempt)
+        "3733",  # Recipient not present (3rd attempt)
+        "3734",  # Recipient not present (4th attempt)
+        "4031",  # Return - N1
+        "4032",  # Return - N2
+        "4033",  # Return - N3
+        "4034",  # Return - N4
+        "6084",  # Return - receiver not met
+    ]
+    consignee_incorrect_address = [
+        "3720",  # Address not found
+        "4020",  # Return - address not found
+        "6082",  # Return - address not readable
+        "6083",  # Return - address not found
+    ]
+    consignee_not_available = [
+        "4035",  # Not collected from ParcelShop
+        "6093",  # Return - not collected from ParcelShop
+    ]
+    consignee_cod_unpaid = [
+        "3715",  # COD not paid
+        "4015",  # Return - COD not paid
+        "6094",  # Return - COD not paid
+    ]
+    consignee_id_failed = [
+        "3782",  # Ident failed - photo mismatch
+        "3783",  # Ident failed - name mismatch
+        "3784",  # Ident failed - DOB mismatch
+        "3785",  # Ident failed - document mismatch
+        "3786",  # Ident failed - PIN code
+        "3787",  # Ident failed - age verification
+        "4081",  # Ident failed
+        "4082",  # Ident failed - photo
+        "4083",  # Ident failed - name
+        "4084",  # Ident failed - DOB
+        "4085",  # Ident failed - document
+        "4086",  # Ident failed - PIN
+        "4087",  # Ident failed - age
+        "6092",  # Return - ident failed
+    ]
+    consignee_tan_invalid = [
+        "3751",  # Incorrect TAN (1st attempt)
+        "3752",  # Incorrect TAN (2nd attempt)
+        "3753",  # Incorrect TAN (3rd attempt)
+        "3754",  # Incorrect TAN (4th attempt)
+        "4051",  # Return - TAN 1
+        "4052",  # Return - TAN 2
+        "4053",  # Return - TAN 3
+        "4054",  # Return - TAN 4
+        "6098",  # Return - incorrect TAN
+    ]
+
+    # Carrier-caused issues
+    carrier_damaged_parcel = [
+        "3740",  # Damage detected
+        "4040",  # Return - damage
+        "6085",  # Return - damage
+    ]
+    carrier_sorting_error = [
+        "3780",  # Misdirected
+        "4080",  # Misdirected
+        "6086",  # Return - sorting error
+        "6087",  # Return - technical issue
+    ]
+    carrier_not_enough_time = [
+        "3750",  # Tour cancellation
+        "4050",  # Return - tour cancellation
+        "4070",  # Tour departure cancelled
+    ]
+    carrier_parcel_too_large = [
+        "4024",  # Return - too large/heavy for ParcelShop
+        "6096",  # Return - too large/heavy for ParcelShop
+    ]
+
+    # Customs-related issues
+    customs_delay = [
+        "1730",  # Held by customs
+    ]
+    customs_rejected = [
+        "1751",  # Rejected by customs
+    ]
+
+    # Shipment stopped
+    shipment_stopped = [
+        "3795",  # Shipment stopped
+        "4095",  # Delivery stopped
+        "6099",  # Return - delivery stopped
+    ]
 
 
 class LabelType(lib.StrEnum):

karrio/providers/hermes/utils.py

@@ -100,3 +100,29 @@ def login(settings: Settings):
         seconds=float(response.get("expires_in", 3600))
     )
     return {**response, "expiry": lib.fdatetime(expiry)}
+
+
+def get_access_token(settings: Settings) -> str:
+    """Get access token from settings."""
+    token_data = settings.access_token
+    return token_data.get("access_token") if isinstance(token_data, dict) else token_data
+
+
+def prepare_shipment_data(request: lib.Serializable) -> tuple:
+    """Prepare shipment request data and multi-piece flag."""
+    requests_data = request.serialize()
+    is_multi_piece = request.ctx.get("is_multi_piece", False) if request.ctx else False
+    requests_data = requests_data if isinstance(requests_data, list) else [requests_data]
+    return requests_data, is_multi_piece
+
+
+def inject_parent_shipment_id(req_data: dict, parent_id: str) -> dict:
+    """Inject parentShipmentOrderID for multi-piece packages 2+."""
+    if req_data.get("service", {}).get("multipartService"):
+        req_data["service"]["multipartService"]["parentShipmentOrderID"] = parent_id
+    return req_data
+
+
+def extract_shipment_order_id(response: dict) -> str:
+    """Extract shipmentOrderID from response for multi-piece linking."""
+    return response.get("shipmentOrderID")

karrio/schemas/hermes/__init__.py

@@ -41,3 +41,13 @@ from karrio.schemas.hermes.pickup_create_request import (
 from karrio.schemas.hermes.pickup_create_response import PickupCreateResponseType
 from karrio.schemas.hermes.pickup_cancel_request import PickupCancelRequestType
 from karrio.schemas.hermes.pickup_cancel_response import PickupCancelResponseType
+from karrio.schemas.hermes.tracking_response import (
+    TrackingResponseType,
+    ShipmentinfoType,
+    ResultType,
+    StatusType,
+    ScanningUnitType,
+    ReceiverAddressType as TrackingReceiverAddressType,
+    DeliveryForecastType,
+    TimeSlotType,
+)

karrio/schemas/hermes/tracking_response.py

@@ -0,0 +1,64 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class TimeSlotType:
+    timeSlotfrom: typing.Optional[str] = None
+    to: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DeliveryForecastType:
+    fixed: typing.Optional[bool] = None
+    date: typing.Optional[str] = None
+    timeSlot: typing.Optional[TimeSlotType] = jstruct.JStruct[TimeSlotType]
+
+
+@attr.s(auto_attribs=True)
+class ReceiverAddressType:
+    city: typing.Optional[str] = None
+    zipCode: typing.Optional[int] = None
+    countryCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ResultType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ScanningUnitType:
+    name: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class StatusType:
+    timestamp: typing.Optional[str] = None
+    code: typing.Optional[str] = None
+    description: typing.Optional[str] = None
+    scanningUnit: typing.Optional[ScanningUnitType] = jstruct.JStruct[ScanningUnitType]
+
+
+@attr.s(auto_attribs=True)
+class ShipmentinfoType:
+    shipmentID: typing.Optional[str] = None
+    partNumber: typing.Optional[int] = None
+    clientID: typing.Optional[int] = None
+    clientReference: typing.Optional[str] = None
+    clientReference2: typing.Optional[int] = None
+    internationalShipmentID: typing.Optional[str] = None
+    trackingLink: typing.Optional[str] = None
+    result: typing.Optional[ResultType] = jstruct.JStruct[ResultType]
+    receiverAddress: typing.Optional[ReceiverAddressType] = jstruct.JStruct[ReceiverAddressType]
+    deliveryForecast: typing.Optional[DeliveryForecastType] = jstruct.JStruct[DeliveryForecastType]
+    status: typing.Optional[typing.List[StatusType]] = jstruct.JList[StatusType]
+
+
+@attr.s(auto_attribs=True)
+class TrackingResponseType:
+    shipmentinfo: typing.Optional[typing.List[ShipmentinfoType]] = jstruct.JList[ShipmentinfoType]

{karrio_hermes-2026.1.dist-info → karrio_hermes-2026.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: karrio_hermes
-Version: 2026.1
+Version: 2026.1.3
 Summary: Karrio - Hermes Shipping Extension
 Author-email: karrio <hello@karrio.io>
 License-Expression: LGPL-3.0

karrio_hermes-2026.1.3.dist-info/RECORD

@@ -0,0 +1,29 @@
+karrio/mappers/hermes/__init__.py,sha256=3WcvIpOkQAy1p54BhLGfmi1hyY9Dhe0qSG2yZY9mPes,145
+karrio/mappers/hermes/mapper.py,sha256=4xOrR9eFX-MKv6LKB32WD8hZuhnscB_OTgeKVVrGo6Q,2700
+karrio/mappers/hermes/proxy.py,sha256=zGbLwJTwunrWp8b1Lg_hs3AwxPSd8Ogy6sydl99YaSs,4492
+karrio/mappers/hermes/settings.py,sha256=4BTM7ncSQqTBP6J_oJTksBDGhaFHOWoHDnpq0iOWHVo,1151
+karrio/plugins/hermes/__init__.py,sha256=zUfOhtzuErd1H1ICL4rQt68e6BWRQf_B6_kW5UVzd9M,1020
+karrio/providers/hermes/__init__.py,sha256=wMiVnPz7EgKdbu1pGBuvalfyuHj5QwSeMijjvEP6q4w,590
+karrio/providers/hermes/error.py,sha256=YWmYC_l7_nyJCxiqM0Kgf6yV9IpJ04tkdZyyMT7QnkY,2974
+karrio/providers/hermes/tracking.py,sha256=F_NYX_G7hnQe04zPbeXfc_IuN69XLOjYC9v9ezHB0Kg,5958
+karrio/providers/hermes/units.py,sha256=voG1oHUfF2Fjzo0w7FOVqrNGmGLTCWDai1zlMng-9mQ,18148
+karrio/providers/hermes/utils.py,sha256=NOfS_K0Zw7_wxJGBJfkdXwZP6hs0bsaZye5uypztGc4,4163
+karrio/providers/hermes/pickup/__init__.py,sha256=E59ks-qJAsNmfQgaZ7X0tZuBetITsdRSMJUAZnqxabg,307
+karrio/providers/hermes/pickup/cancel.py,sha256=JYVGL9decPB0QOHsjrYU5cwT_4vzrpsaEjapC9F3t7A,1587
+karrio/providers/hermes/pickup/create.py,sha256=ICSG7HgF45h8XY0Ypc8voA5TWFSVmysGerh1F-fha24,3993
+karrio/providers/hermes/shipment/__init__.py,sha256=B_zc5eaS4st1bnIyB_RwYY9XJJ9DyjB1Tb0SaIEJRJ8,209
+karrio/providers/hermes/shipment/create.py,sha256=DAkC5O9XHs6QOlLKBTQ8zKQlLNf6h5Ty29_qFhMSBWM,16677
+karrio/schemas/hermes/__init__.py,sha256=zcJLsZ0HvWk9q7J07BAel3ib_eXFoN6_5joxbdzBLV0,1530
+karrio/schemas/hermes/error_response.py,sha256=BJhI7P8wursdYsYACfDLT8cs-bsnKlJDs0OzurYMPR4,343
+karrio/schemas/hermes/pickup_cancel_request.py,sha256=rZgm3BpL3iziO_TC_y-cAELMsWjXyvRYWmXYyExhdR0,148
+karrio/schemas/hermes/pickup_cancel_response.py,sha256=9-STL_Aq0EvXWrNMfvc4DiPK658e1JPp0uhW695XOGI,397
+karrio/schemas/hermes/pickup_create_request.py,sha256=0V14LMl0XVLOZ_zXRzoTLUZ8nB_TZHCmr2G03NPl4tw,1375
+karrio/schemas/hermes/pickup_create_response.py,sha256=sAgq92J0TZOUolhMcvDkp6qSRvxOqWCIZHNQWQN7KeU,397
+karrio/schemas/hermes/shipment_request.py,sha256=FMqrSlCDG4eGDkuqPDc_DDCbtV_vGRyrRBFCiNTFkmM,7415
+karrio/schemas/hermes/shipment_response.py,sha256=BI2kUemG-wTzAFpok9KEnlwjm6eK_LemBA_Cyga_e6A,3477
+karrio/schemas/hermes/tracking_response.py,sha256=Ye4Uo6UEnEy-A5VX4MDmyyePXZMM_meMiecJlht9qMc,2013
+karrio_hermes-2026.1.3.dist-info/METADATA,sha256=P2iafkpDRgz5fQhi9oQvv_GWYDj2N23CwqdgPnnqvhc,982
+karrio_hermes-2026.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+karrio_hermes-2026.1.3.dist-info/entry_points.txt,sha256=R8XDrYBqWXTPqaO0iTi4Buz8iQiiBiuHkJVNtZIXTkU,57
+karrio_hermes-2026.1.3.dist-info/top_level.txt,sha256=9Nasa6abG7pPPG8MGzlemnqw1ohIqgouzQ7HGBnOFLg,27
+karrio_hermes-2026.1.3.dist-info/RECORD,,

{karrio_hermes-2026.1.dist-info → karrio_hermes-2026.1.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

karrio_hermes-2026.1.dist-info/RECORD

@@ -1,27 +0,0 @@
-karrio/mappers/hermes/__init__.py,sha256=3WcvIpOkQAy1p54BhLGfmi1hyY9Dhe0qSG2yZY9mPes,145
-karrio/mappers/hermes/mapper.py,sha256=0fZbXPHGg5R4bbhRyJbzfEGNiKXSINW1FJQnhz-4MRM,2258
-karrio/mappers/hermes/proxy.py,sha256=FG_OcaMEXiZxZp37m25pgrOtcdCziVk3Kft9HjoEnT8,2858
-karrio/mappers/hermes/settings.py,sha256=4BTM7ncSQqTBP6J_oJTksBDGhaFHOWoHDnpq0iOWHVo,1151
-karrio/plugins/hermes/__init__.py,sha256=zUfOhtzuErd1H1ICL4rQt68e6BWRQf_B6_kW5UVzd9M,1020
-karrio/providers/hermes/__init__.py,sha256=lwP0P714ipPISsbd_6xXZ4oaCK32yTEHktP8yxmF4NQ,490
-karrio/providers/hermes/error.py,sha256=YWmYC_l7_nyJCxiqM0Kgf6yV9IpJ04tkdZyyMT7QnkY,2974
-karrio/providers/hermes/units.py,sha256=MO1ap8ItQUlwfTTx7_CqxJqx96KY-FyLm4pMSIXRg8g,8665
-karrio/providers/hermes/utils.py,sha256=84N70gICmOmP2vjYmnzJbjzLhFaEHvXLKgHALZiE-2k,3077
-karrio/providers/hermes/pickup/__init__.py,sha256=E59ks-qJAsNmfQgaZ7X0tZuBetITsdRSMJUAZnqxabg,307
-karrio/providers/hermes/pickup/cancel.py,sha256=JYVGL9decPB0QOHsjrYU5cwT_4vzrpsaEjapC9F3t7A,1587
-karrio/providers/hermes/pickup/create.py,sha256=q4AbBqI-_oXglD2DffJpqBp93zZo2hz-gf32DtX5lg8,3556
-karrio/providers/hermes/shipment/__init__.py,sha256=B_zc5eaS4st1bnIyB_RwYY9XJJ9DyjB1Tb0SaIEJRJ8,209
-karrio/providers/hermes/shipment/create.py,sha256=UcKTavylyrdbeFmzXY7pqCUI1lfOxmMO2Cr07xoB1YY,13046
-karrio/schemas/hermes/__init__.py,sha256=yw5kUm6WMQ_UJEVW-LQUY-916m7Y-qxp0yLbqIMb2b4,1272
-karrio/schemas/hermes/error_response.py,sha256=BJhI7P8wursdYsYACfDLT8cs-bsnKlJDs0OzurYMPR4,343
-karrio/schemas/hermes/pickup_cancel_request.py,sha256=rZgm3BpL3iziO_TC_y-cAELMsWjXyvRYWmXYyExhdR0,148
-karrio/schemas/hermes/pickup_cancel_response.py,sha256=9-STL_Aq0EvXWrNMfvc4DiPK658e1JPp0uhW695XOGI,397
-karrio/schemas/hermes/pickup_create_request.py,sha256=0V14LMl0XVLOZ_zXRzoTLUZ8nB_TZHCmr2G03NPl4tw,1375
-karrio/schemas/hermes/pickup_create_response.py,sha256=sAgq92J0TZOUolhMcvDkp6qSRvxOqWCIZHNQWQN7KeU,397
-karrio/schemas/hermes/shipment_request.py,sha256=FMqrSlCDG4eGDkuqPDc_DDCbtV_vGRyrRBFCiNTFkmM,7415
-karrio/schemas/hermes/shipment_response.py,sha256=BI2kUemG-wTzAFpok9KEnlwjm6eK_LemBA_Cyga_e6A,3477
-karrio_hermes-2026.1.dist-info/METADATA,sha256=yF6_59XBxGBqORO5gj9Gjp5TJTdk4GOUJ_TxlGzA4eE,980
-karrio_hermes-2026.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-karrio_hermes-2026.1.dist-info/entry_points.txt,sha256=R8XDrYBqWXTPqaO0iTi4Buz8iQiiBiuHkJVNtZIXTkU,57
-karrio_hermes-2026.1.dist-info/top_level.txt,sha256=9Nasa6abG7pPPG8MGzlemnqw1ohIqgouzQ7HGBnOFLg,27
-karrio_hermes-2026.1.dist-info/RECORD,,