karrio-parcelone 2026.1.4__py3-none-any.whl → 2026.1.5__py3-none-any.whl

karrio/plugins/parcelone/__init__.py

@@ -21,6 +21,7 @@ METADATA = PluginMetadata(
     is_hub=True,  # ParcelOne is a multi-carrier hub
     options=units.ShippingOption,
     services=units.ShippingService,
+    service_levels=units.DEFAULT_SERVICES,
     connection_configs=units.ConnectionConfig,
     # Extra info
     website="https://parcel.one",

karrio/providers/parcelone/shipment/cancel.py

@@ -1,6 +1,7 @@
 """Karrio ParcelOne shipment cancellation implementation."""
 
 import typing
+import karrio.schemas.parcelone as parcelone
 import karrio.lib as lib
 import karrio.core.models as models
 import karrio.providers.parcelone.error as error
@@ -14,7 +15,10 @@ def parse_shipment_cancel_response(
     """Parse shipment cancellation response from ParcelOne REST API."""
     response = _response.deserialize()
     messages = error.parse_error_response(response, settings)
-    success = response.get("success") == 1
+
+    cancel_response = lib.to_object(parcelone.CancelResponseType, response)
+    result = cancel_response.results
+    success = cancel_response.success == 1 and (result.Success == 1 if result else False)
 
     confirmation = lib.identity(
         models.ConfirmationDetails(

karrio/providers/parcelone/tracking.py

@@ -99,6 +99,7 @@ def _parse_tracking_event(event: parcelone.TrackingEventType) -> models.Tracking
         try_formats=["%Y-%m-%dT%H:%M:%S", "%Y-%m-%d %H:%M:%S"],
     )
     status = provider_units.TrackingStatus.find(event.StatusCode)
+    reason = provider_units.TrackingIncidentReason.find(event.StatusCode)
 
     return models.TrackingEvent(
         date=date,
@@ -111,6 +112,7 @@ def _parse_tracking_event(event: parcelone.TrackingEventType) -> models.Tracking
             current_format="%Y-%m-%dT%H:%M:%S",
         ),
         status=status.name if status else None,
+        reason=reason.name if reason else None,
     )
 
 

karrio/providers/parcelone/units.py

@@ -234,6 +234,50 @@ class TrackingStatus(lib.Enum):
     ]
 
 
+class TrackingIncidentReason(lib.Enum):
+    """Maps carrier exception codes to normalized incident reasons.
+
+    IMPORTANT: This enum is required for tracking implementations.
+    It maps carrier-specific exception/status codes to standardized
+    incident reasons for tracking events. The reason field helps
+    identify why a delivery exception occurred.
+
+    Categories of reasons:
+    - carrier_*: Issues caused by the carrier
+    - consignee_*: Issues caused by the recipient
+    - customs_*: Customs-related delays
+    - weather_*: Weather/force majeure events
+    """
+
+    # Carrier-caused issues
+    carrier_damaged_parcel = ["DAMAGED", "DMG"]
+    carrier_sorting_error = ["MISROUTED", "MSR"]
+    carrier_address_not_found = ["ADDRESS_NOT_FOUND", "ANF"]
+    carrier_parcel_lost = ["LOST", "LP"]
+    carrier_not_enough_time = ["LATE", "NO_TIME"]
+    carrier_vehicle_issue = ["VEHICLE_BREAKDOWN", "VB"]
+
+    # Consignee-caused issues
+    consignee_refused = ["REFUSED", "RJ"]
+    consignee_business_closed = ["BUSINESS_CLOSED", "BC"]
+    consignee_not_available = ["NOT_AVAILABLE", "NA"]
+    consignee_not_home = ["NOT_HOME", "NH", "ADDRESSEE_NOT_FOUND"]
+    consignee_incorrect_address = ["WRONG_ADDRESS", "IA"]
+    consignee_access_restricted = ["ACCESS_RESTRICTED", "AR"]
+
+    # Customs-related issues
+    customs_delay = ["CUSTOMS", "CUSTOMS_CLEARANCE", "CD"]
+    customs_documentation = ["CUSTOMS_DOCS", "CM"]
+    customs_duties_unpaid = ["PAYMENT_REQUIRED", "DU"]
+
+    # Weather/force majeure
+    weather_delay = ["WEATHER", "WE"]
+    natural_disaster = ["NATURAL_DISASTER", "ND"]
+
+    # Unknown/unmapped
+    unknown = []
+
+
 def load_services_from_csv() -> list:
     """
     Load service definitions from CSV file.
@@ -311,6 +355,8 @@ def load_services_from_csv() -> list:
             zone = models.ServiceZone(
                 label=row.get("zone_label", "Default Zone"),
                 rate=float(row.get("rate", 0.0)),
+                min_weight=float(row["min_weight"]) if row.get("min_weight") else None,
+                max_weight=float(row["max_weight"]) if row.get("max_weight") else None,
                 transit_days=transit_days,
                 country_codes=country_codes if country_codes else None,
             )

karrio/schemas/parcelone/__init__.py

@@ -1,6 +1,69 @@
 """ParcelOne API schema types."""
 
-from karrio.schemas.parcelone.shipping_request import *
-from karrio.schemas.parcelone.shipping_response import *
-from karrio.schemas.parcelone.tracking_response import *
-from karrio.schemas.parcelone.error import *
+# Import shipping request types
+from karrio.schemas.parcelone.shipping_request import (
+    CepSpecialType,
+    FormatType,
+    MaxChargesType,
+    CustomDetailType,
+    IntDocDataType,
+    PackageDimensionsType,
+    PackageVolumeClassType,
+    ServiceType,
+    PackageType,
+    BankAccountType,
+    ShipmentAddressType,
+    ShipmentContactType,
+    ShipFromDataType,
+    ShipToDataType,
+    ShippingDataType,
+    ShippingRequestType,
+)
+
+# Import shipping response types with prefixes to avoid collision
+from karrio.schemas.parcelone.shipping_response import (
+    ErrorType as ShipmentErrorType,
+    WarningType as ShipmentWarningType,
+    ActionResultType as ShipmentActionResultType,
+    TotalChargesType,
+    FormatType as ResponseFormatType,
+    DocumentsResultType as ShipmentDocumentsResultType,
+    PackageResultType as ShipmentPackageResultType,
+    ResultsType as ShipmentResultType,
+    ShippingResponseType,
+)
+
+# Import tracking response types
+from karrio.schemas.parcelone.tracking_response import (
+    EventType as TrackingEventType,
+    ResultsType as TrackingResultType,
+    TrackingResponseType,
+)
+
+# Import cancel response types
+from karrio.schemas.parcelone.cancel_response import (
+    ErrorType as CancelErrorType,
+    WarningType as CancelWarningType,
+    ResultsType as CancelResultType,
+    CancelResponseType,
+)
+
+# Import error types
+from karrio.schemas.parcelone.error import (
+    ErrorType as ErrorDetailType,
+    ErrorResponseType,
+)
+
+# Backwards compatibility aliases for shipping request types
+ShippingDataRequestType = ShippingRequestType
+ShipmentType = ShippingDataType
+AddressType = ShipmentAddressType
+ContactType = ShipmentContactType
+ShipToType = ShipToDataType
+ShipFromType = ShipFromDataType
+MeasurementType = PackageVolumeClassType
+DimensionsType = PackageDimensionsType
+AmountType = MaxChargesType
+ShipmentServiceType = ServiceType
+ShipmentPackageType = PackageType
+CEPSpecialType = CepSpecialType

karrio/schemas/parcelone/cancel_response.py

@@ -0,0 +1,37 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ErrorType:
+    ErrorNo: typing.Optional[str] = None
+    Message: typing.Optional[str] = None
+    StatusCode: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class WarningType:
+    WarningNo: typing.Optional[str] = None
+    Message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ResultsType:
+    ShipmentID: typing.Optional[int] = None
+    ShipmentRef: typing.Optional[str] = None
+    TrackingID: typing.Optional[str] = None
+    Success: typing.Optional[int] = None
+    Errors: typing.Optional[typing.List[ErrorType]] = jstruct.JList[ErrorType]
+    Warnings: typing.Optional[typing.List[WarningType]] = jstruct.JList[WarningType]
+
+
+@attr.s(auto_attribs=True)
+class CancelResponseType:
+    status: typing.Optional[int] = None
+    success: typing.Optional[int] = None
+    message: typing.Optional[str] = None
+    type: typing.Optional[str] = None
+    instance: typing.Optional[str] = None
+    results: typing.Optional[ResultsType] = jstruct.JStruct[ResultsType]
+    UniqId: typing.Optional[str] = None

karrio/schemas/parcelone/error.py

@@ -1,27 +1,21 @@
-"""ParcelOne REST API v1 - Error Types."""
-
 import attr
 import jstruct
 import typing
 
 
 @attr.s(auto_attribs=True)
-class ErrorDetailType:
-    """Error detail information."""
-
+class ErrorType:
     ErrorNo: typing.Optional[str] = None
     Message: typing.Optional[str] = None
-    StatusCode: typing.Optional[str] = None
+    StatusCode: typing.Optional[int] = None
 
 
 @attr.s(auto_attribs=True)
 class ErrorResponseType:
-    """API error response."""
-
     status: typing.Optional[int] = None
     success: typing.Optional[int] = None
     message: typing.Optional[str] = None
     type: typing.Optional[str] = None
     instance: typing.Optional[str] = None
-    errors: typing.Optional[typing.List[ErrorDetailType]] = jstruct.JList[ErrorDetailType]
+    errors: typing.Optional[typing.List[ErrorType]] = jstruct.JList[ErrorType]
     UniqId: typing.Optional[str] = None

karrio/schemas/parcelone/shipping_request.py

@@ -1,69 +1,16 @@
-"""ParcelOne Shipping REST API v1 - Request Types."""
-
 import attr
 import jstruct
 import typing
 
 
 @attr.s(auto_attribs=True)
-class AddressType:
-    """Address data format."""
-
-    Street: typing.Optional[str] = None
-    Streetno: typing.Optional[str] = None
-    PostalCode: typing.Optional[str] = None
-    City: typing.Optional[str] = None
-    District: typing.Optional[str] = None
-    State: typing.Optional[str] = None
-    Country: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ContactType:
-    """Contact information."""
-
-    Email: typing.Optional[str] = None
-    Phone: typing.Optional[str] = None
-    Mobile: typing.Optional[str] = None
-    Fax: typing.Optional[str] = None
-    AttentionName: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ShipToType:
-    """Recipient/consignee address data."""
-
-    Name1: typing.Optional[str] = None
-    Name2: typing.Optional[str] = None
-    Name3: typing.Optional[str] = None
-    Reference: typing.Optional[str] = None
-    ShipmentAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
-    ShipmentContact: typing.Optional[ContactType] = jstruct.JStruct[ContactType]
-    PrivateAddressIndicator: typing.Optional[int] = None
-    SalesTaxID: typing.Optional[str] = None
-    CustomsID: typing.Optional[str] = None
-    BranchID: typing.Optional[str] = None
-    CEPCustID: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ShipFromType:
-    """Consigner/sender address data."""
-
-    Name1: typing.Optional[str] = None
-    Name2: typing.Optional[str] = None
-    Name3: typing.Optional[str] = None
-    Reference: typing.Optional[str] = None
-    ShipmentAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
-    ShipmentContact: typing.Optional[ContactType] = jstruct.JStruct[ContactType]
-    SalesTaxID: typing.Optional[str] = None
-    CustomsID: typing.Optional[str] = None
+class CepSpecialType:
+    Key: typing.Optional[str] = None
+    Value: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
 class FormatType:
-    """Document format specification."""
-
     Type: typing.Optional[str] = None
     Size: typing.Optional[str] = None
     Unit: typing.Optional[str] = None
@@ -73,122 +20,175 @@ class FormatType:
 
 
 @attr.s(auto_attribs=True)
-class MeasurementType:
-    """Weight or volume measurement."""
-
-    Unit: typing.Optional[str] = None
+class MaxChargesType:
+    Currency: typing.Optional[str] = None
     Value: typing.Optional[str] = None
+    Description: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomDetailType:
+    Contents: typing.Optional[str] = None
+    Quantity: typing.Optional[int] = None
+    NetWeightPerItem: typing.Optional[float] = None
+    NetWeight: typing.Optional[float] = None
+    ItemValuePerItem: typing.Optional[float] = None
+    ItemValue: typing.Optional[float] = None
+    TariffNumber: typing.Optional[int] = None
+    Origin: typing.Optional[str] = None
+    AdditionalInfo: typing.Optional[typing.List[CepSpecialType]] = jstruct.JList[CepSpecialType]
 
 
 @attr.s(auto_attribs=True)
-class DimensionsType:
-    """Package dimensions."""
+class IntDocDataType:
+    PrintInternationalDocuments: typing.Optional[int] = None
+    InternationalDocumentFormat: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
+    ConsignerCustomsID: typing.Optional[int] = None
+    ShipToRef: typing.Optional[str] = None
+    CustomDetails: typing.Optional[typing.List[CustomDetailType]] = jstruct.JList[CustomDetailType]
+    Postage: typing.Optional[float] = None
+    TotalValue: typing.Optional[float] = None
+    Currency: typing.Optional[str] = None
+    TotalWeightkg: typing.Optional[float] = None
+    ItemCategory: typing.Optional[int] = None
+    Explanation: typing.Optional[str] = None
+    OfficeOfOrigin: typing.Optional[str] = None
+    Comments: typing.Optional[str] = None
+    Date: typing.Optional[str] = None
+    License: typing.Optional[int] = None
+    LicenseNo: typing.Optional[str] = None
+    Certificate: typing.Optional[int] = None
+    CertificateNo: typing.Optional[str] = None
+    Invoice: typing.Optional[int] = None
+    InvoiceNo: typing.Optional[str] = None
+    NonDeliveryInstruction: typing.Optional[str] = None
+    ServiceLevel: typing.Optional[str] = None
+    ValidatedForExport: typing.Optional[str] = None
+    AdditionalInfo: typing.Optional[typing.List[CepSpecialType]] = jstruct.JList[CepSpecialType]
 
+
+@attr.s(auto_attribs=True)
+class PackageDimensionsType:
+    Measurement: typing.Optional[str] = None
     Length: typing.Optional[str] = None
     Width: typing.Optional[str] = None
     Height: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class AmountType:
-    """Monetary amount."""
-
-    Currency: typing.Optional[str] = None
+class PackageVolumeClassType:
+    Unit: typing.Optional[str] = None
     Value: typing.Optional[str] = None
-    Description: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentServiceType:
-    """Service for shipment or package."""
-
+class ServiceType:
     ServiceID: typing.Optional[str] = None
-    Value: typing.Optional[AmountType] = jstruct.JStruct[AmountType]
+    Value: typing.Optional[MaxChargesType] = jstruct.JStruct[MaxChargesType]
     Parameters: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class CustomDetailType:
-    """Customs detail line item."""
-
-    Contents: typing.Optional[str] = None
-    ItemValue: typing.Optional[float] = None
-    ItemValuePerItem: typing.Optional[float] = None
-    NetWeight: typing.Optional[float] = None
-    NetWeightPerItem: typing.Optional[float] = None
-    Origin: typing.Optional[str] = None
-    Quantity: typing.Optional[int] = None
-    TariffNumber: typing.Optional[str] = None
+class PackageType:
+    PackageID: typing.Optional[str] = None
+    PackageRef: typing.Optional[str] = None
+    PackageTrackingID: typing.Optional[str] = None
+    PackageType: typing.Optional[str] = None
+    PackageWeight: typing.Optional[PackageVolumeClassType] = jstruct.JStruct[PackageVolumeClassType]
+    PackageDimensions: typing.Optional[PackageDimensionsType] = jstruct.JStruct[PackageDimensionsType]
+    PackageVolume: typing.Optional[PackageVolumeClassType] = jstruct.JStruct[PackageVolumeClassType]
+    Services: typing.Optional[typing.List[ServiceType]] = jstruct.JList[ServiceType]
+    IntDocData: typing.Optional[IntDocDataType] = jstruct.JStruct[IntDocDataType]
+    Remarks: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class InternationalDocFormatType:
-    """International document format."""
-
-    Type: typing.Optional[str] = None
-    Size: typing.Optional[str] = None
+class BankAccountType:
+    BankCode: typing.Optional[str] = None
+    Bank: typing.Optional[str] = None
+    AccountOwner: typing.Optional[str] = None
+    AccountNumber: typing.Optional[str] = None
+    Iban: typing.Optional[str] = None
+    Bic: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class IntDocDataType:
-    """International/customs documentation data."""
-
-    ConsignerCustomsID: typing.Optional[str] = None
-    Invoice: typing.Optional[int] = None
-    InvoiceNo: typing.Optional[str] = None
-    PrintInternationalDocuments: typing.Optional[int] = None
-    InternationalDocumentFormat: typing.Optional[InternationalDocFormatType] = jstruct.JStruct[InternationalDocFormatType]
-    ShipToRef: typing.Optional[str] = None
-    TotalWeightkg: typing.Optional[float] = None
-    Postage: typing.Optional[float] = None
-    ItemCategory: typing.Optional[int] = None
-    CustomDetails: typing.Optional[typing.List[CustomDetailType]] = jstruct.JList[CustomDetailType]
+class ShipmentAddressType:
+    Street: typing.Optional[str] = None
+    Streetno: typing.Optional[int] = None
+    PostalCode: typing.Optional[int] = None
+    City: typing.Optional[str] = None
+    District: typing.Optional[str] = None
+    State: typing.Optional[str] = None
+    Country: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentPackageType:
-    """Package within a shipment."""
-
-    PackageRef: typing.Optional[str] = None
-    PackageType: typing.Optional[str] = None
-    PackageWeight: typing.Optional[MeasurementType] = jstruct.JStruct[MeasurementType]
-    PackageDimensions: typing.Optional[DimensionsType] = jstruct.JStruct[DimensionsType]
-    PackageVolume: typing.Optional[MeasurementType] = jstruct.JStruct[MeasurementType]
-    Services: typing.Optional[typing.List[ShipmentServiceType]] = jstruct.JList[ShipmentServiceType]
-    IntDocData: typing.Optional[IntDocDataType] = jstruct.JStruct[IntDocDataType]
-    Remarks: typing.Optional[str] = None
+class ShipmentContactType:
+    Email: typing.Optional[str] = None
+    Phone: typing.Optional[str] = None
+    Mobile: typing.Optional[str] = None
+    Fax: typing.Optional[str] = None
+    Company: typing.Optional[str] = None
+    ContactPerson: typing.Optional[str] = None
+    AttentionName: typing.Optional[str] = None
+    Salutation: typing.Optional[str] = None
+    FirstName: typing.Optional[str] = None
+    LastName: typing.Optional[str] = None
+    BirthDate: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class CEPSpecialType:
-    """CEP-specific special options."""
-
-    Key: typing.Optional[str] = None
-    Value: typing.Optional[str] = None
+class ShipFromDataType:
+    Reference: typing.Optional[str] = None
+    Name1: typing.Optional[str] = None
+    Name2: typing.Optional[str] = None
+    Name3: typing.Optional[str] = None
+    ShipmentAddress: typing.Optional[ShipmentAddressType] = jstruct.JStruct[ShipmentAddressType]
+    ShipmentContact: typing.Optional[ShipmentContactType] = jstruct.JStruct[ShipmentContactType]
+    SalesTaxID: typing.Optional[str] = None
+    CustomsID: typing.Optional[str] = None
+    BankAccount: typing.Optional[BankAccountType] = jstruct.JStruct[BankAccountType]
 
 
 @attr.s(auto_attribs=True)
-class ShipmentType:
-    """Complete shipment registration request."""
+class ShipToDataType:
+    Reference: typing.Optional[str] = None
+    Name1: typing.Optional[str] = None
+    Name2: typing.Optional[str] = None
+    Name3: typing.Optional[str] = None
+    ShipmentAddress: typing.Optional[ShipmentAddressType] = jstruct.JStruct[ShipmentAddressType]
+    PrivateAddressIndicator: typing.Optional[int] = None
+    ShipmentContact: typing.Optional[ShipmentContactType] = jstruct.JStruct[ShipmentContactType]
+    SalesTaxID: typing.Optional[str] = None
+    CustomsID: typing.Optional[str] = None
+    BranchID: typing.Optional[str] = None
+    CEPCustID: typing.Optional[str] = None
+
 
+@attr.s(auto_attribs=True)
+class ShippingDataType:
+    ShipmentID: typing.Optional[str] = None
     ShipmentRef: typing.Optional[str] = None
+    TrackingID: typing.Optional[str] = None
     CEPID: typing.Optional[str] = None
     ProductID: typing.Optional[str] = None
-    MandatorID: typing.Optional[str] = None
-    ConsignerID: typing.Optional[str] = None
-    ShipToData: typing.Optional[ShipToType] = jstruct.JStruct[ShipToType]
-    ShipFromData: typing.Optional[ShipFromType] = jstruct.JStruct[ShipFromType]
+    CustomerID: typing.Optional[str] = None
+    MandatorID: typing.Optional[int] = None
+    ConsignerID: typing.Optional[int] = None
+    ShipToData: typing.Optional[ShipToDataType] = jstruct.JStruct[ShipToDataType]
+    ShipFromData: typing.Optional[ShipFromDataType] = jstruct.JStruct[ShipFromDataType]
     ReturnShipmentIndicator: typing.Optional[int] = None
     PrintLabel: typing.Optional[int] = None
     LabelFormat: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
     PrintDocuments: typing.Optional[int] = None
-    DocumentFormat: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
     ReturnCharges: typing.Optional[int] = None
-    MaxCharges: typing.Optional[AmountType] = jstruct.JStruct[AmountType]
+    MaxCharges: typing.Optional[MaxChargesType] = jstruct.JStruct[MaxChargesType]
+    DocumentFormat: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
     Software: typing.Optional[str] = None
-    Packages: typing.Optional[typing.List[ShipmentPackageType]] = jstruct.JList[ShipmentPackageType]
-    Services: typing.Optional[typing.List[ShipmentServiceType]] = jstruct.JList[ShipmentServiceType]
-    CEPSpecials: typing.Optional[typing.List[CEPSpecialType]] = jstruct.JList[CEPSpecialType]
+    Packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+    Services: typing.Optional[typing.List[ServiceType]] = jstruct.JList[ServiceType]
+    CEPSpecials: typing.Optional[typing.List[CepSpecialType]] = jstruct.JList[CepSpecialType]
     CostCenter: typing.Optional[str] = None
     Other1: typing.Optional[str] = None
     Other2: typing.Optional[str] = None
@@ -196,7 +196,5 @@ class ShipmentType:
 
 
 @attr.s(auto_attribs=True)
-class ShippingDataRequestType:
-    """Root shipping data request wrapper."""
-
-    ShippingData: typing.Optional[ShipmentType] = jstruct.JStruct[ShipmentType]
+class ShippingRequestType:
+    ShippingData: typing.Optional[ShippingDataType] = jstruct.JStruct[ShippingDataType]

karrio/schemas/parcelone/shipping_response.py

@@ -1,108 +1,90 @@
-"""ParcelOne Shipping REST API v1 - Response Types."""
-
 import attr
 import jstruct
 import typing
 
 
 @attr.s(auto_attribs=True)
-class FormatType:
-    """Document format."""
-
-    Type: typing.Optional[str] = None
-    Size: typing.Optional[str] = None
-    Unit: typing.Optional[str] = None
-    Orientation: typing.Optional[int] = None
-    Height: typing.Optional[str] = None
-    Width: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class AmountType:
-    """Monetary amount."""
-
-    Currency: typing.Optional[str] = None
-    Value: typing.Optional[str] = None
-    Description: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ShipmentErrorType:
-    """Error information."""
-
+class ErrorType:
     ErrorNo: typing.Optional[str] = None
     Message: typing.Optional[str] = None
-    StatusCode: typing.Optional[str] = None
+    StatusCode: typing.Optional[int] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentWarningType:
-    """Warning information."""
-
+class WarningType:
     WarningNo: typing.Optional[str] = None
     Message: typing.Optional[str] = None
-    StatusCode: typing.Optional[str] = None
+    StatusCode: typing.Optional[int] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentActionResultType:
-    """Result of shipment action with IDs and status."""
-
-    ShipmentID: typing.Optional[str] = None
+class ActionResultType:
+    ShipmentID: typing.Optional[int] = None
     ShipmentRef: typing.Optional[str] = None
     TrackingID: typing.Optional[str] = None
     Success: typing.Optional[int] = None
-    Errors: typing.Optional[typing.List[ShipmentErrorType]] = jstruct.JList[ShipmentErrorType]
-    Warnings: typing.Optional[typing.List[ShipmentWarningType]] = jstruct.JList[ShipmentWarningType]
+    Errors: typing.Optional[typing.List[ErrorType]] = jstruct.JList[ErrorType]
+    Warnings: typing.Optional[typing.List[WarningType]] = jstruct.JList[WarningType]
 
 
 @attr.s(auto_attribs=True)
-class ShipmentPackageResultType:
-    """Package result with label and tracking info."""
-
-    ShipmentID: typing.Optional[str] = None
-    PackageID: typing.Optional[int] = None
-    PackageRef: typing.Optional[str] = None
-    TrackingID: typing.Optional[str] = None
-    DocType: typing.Optional[str] = None
-    Format: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
-    Label: typing.Optional[str] = None
-    TrackingURL: typing.Optional[str] = None
-    CarrierTrackURL: typing.Optional[str] = None
-    Charges: typing.Optional[typing.List[AmountType]] = jstruct.JList[AmountType]
+class TotalChargesType:
+    Currency: typing.Optional[str] = None
+    Value: typing.Optional[str] = None
+    Description: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentDocumentsResultType:
-    """Document result (returns, customs docs, etc)."""
+class FormatType:
+    Type: typing.Optional[str] = None
+    Size: typing.Optional[str] = None
+    Unit: typing.Optional[str] = None
+    Orientation: typing.Optional[int] = None
+    Height: typing.Optional[int] = None
+    Width: typing.Optional[int] = None
+
 
-    ShipmentID: typing.Optional[str] = None
-    PackageID: typing.Optional[str] = None
+@attr.s(auto_attribs=True)
+class DocumentsResultType:
+    ShipmentID: typing.Optional[int] = None
+    PackageID: typing.Optional[int] = None
     TrackingID: typing.Optional[str] = None
     DocType: typing.Optional[str] = None
     Format: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
     Document: typing.Optional[str] = None
-    Charges: typing.Optional[typing.List[AmountType]] = jstruct.JList[AmountType]
+    Charges: typing.Optional[typing.List[TotalChargesType]] = jstruct.JList[TotalChargesType]
     PackageRef: typing.Optional[str] = None
     PackageTrackingID: typing.Optional[str] = None
-    ActionResult: typing.Optional[ShipmentActionResultType] = jstruct.JStruct[ShipmentActionResultType]
+    ActionResult: typing.Optional[ActionResultType] = jstruct.JStruct[ActionResultType]
     DocumentID: typing.Optional[str] = None
     Type: typing.Optional[str] = None
     Size: typing.Optional[str] = None
 
 
 @attr.s(auto_attribs=True)
-class ShipmentResultType:
-    """Complete shipment result with labels and documents."""
+class PackageResultType:
+    ShipmentID: typing.Optional[int] = None
+    PackageID: typing.Optional[int] = None
+    PackageRef: typing.Optional[str] = None
+    TrackingID: typing.Optional[str] = None
+    DocType: typing.Optional[str] = None
+    Format: typing.Optional[FormatType] = jstruct.JStruct[FormatType]
+    Label: typing.Optional[str] = None
+    TrackingURL: typing.Optional[str] = None
+    CarrierTrackURL: typing.Optional[str] = None
+    Charges: typing.Optional[typing.List[TotalChargesType]] = jstruct.JList[TotalChargesType]
+
 
-    YourShipmentID: typing.Optional[str] = None
-    ActionResult: typing.Optional[ShipmentActionResultType] = jstruct.JStruct[ShipmentActionResultType]
+@attr.s(auto_attribs=True)
+class ResultsType:
+    YourShipmentID: typing.Optional[int] = None
+    ActionResult: typing.Optional[ActionResultType] = jstruct.JStruct[ActionResultType]
     LabelURL: typing.Optional[str] = None
-    Charges: typing.Optional[typing.List[AmountType]] = jstruct.JList[AmountType]
-    TotalCharges: typing.Optional[AmountType] = jstruct.JStruct[AmountType]
-    PackageResults: typing.Optional[typing.List[ShipmentPackageResultType]] = jstruct.JList[ShipmentPackageResultType]
-    DocumentsResults: typing.Optional[typing.List[ShipmentDocumentsResultType]] = jstruct.JList[ShipmentDocumentsResultType]
-    InternationalDocumentsResults: typing.Optional[typing.List[ShipmentDocumentsResultType]] = jstruct.JList[ShipmentDocumentsResultType]
+    Charges: typing.Optional[typing.List[TotalChargesType]] = jstruct.JList[TotalChargesType]
+    TotalCharges: typing.Optional[TotalChargesType] = jstruct.JStruct[TotalChargesType]
+    PackageResults: typing.Optional[typing.List[PackageResultType]] = jstruct.JList[PackageResultType]
+    DocumentsResults: typing.Optional[typing.List[DocumentsResultType]] = jstruct.JList[DocumentsResultType]
+    InternationalDocumentsResults: typing.Optional[typing.List[DocumentsResultType]] = jstruct.JList[DocumentsResultType]
     LabelsAvailable: typing.Optional[int] = None
     DocumentsAvailable: typing.Optional[int] = None
     InternationalDocumentsAvailable: typing.Optional[int] = None
@@ -111,61 +93,10 @@ class ShipmentResultType:
 
 @attr.s(auto_attribs=True)
 class ShippingResponseType:
-    """Root shipping response wrapper."""
-
-    status: typing.Optional[int] = None
-    success: typing.Optional[int] = None
-    message: typing.Optional[str] = None
-    type: typing.Optional[str] = None
-    instance: typing.Optional[str] = None
-    results: typing.Optional[ShipmentResultType] = jstruct.JStruct[ShipmentResultType]
-    UniqId: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ShipmentStatusResultType:
-    """Shipment status result."""
-
-    ActionResult: typing.Optional[ShipmentActionResultType] = jstruct.JStruct[ShipmentActionResultType]
-    ShipmentStatusCode: typing.Optional[str] = None
-    ShipmentStatus: typing.Optional[str] = None
-    LastTrackingNo: typing.Optional[str] = None
-    LastCEP: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class ShipmentStatusResponseType:
-    """Shipment status API response."""
-
-    status: typing.Optional[int] = None
-    success: typing.Optional[int] = None
-    message: typing.Optional[str] = None
-    type: typing.Optional[str] = None
-    instance: typing.Optional[str] = None
-    results: typing.Optional[ShipmentStatusResultType] = jstruct.JStruct[ShipmentStatusResultType]
-    UniqId: typing.Optional[str] = None
-
-
-@attr.s(auto_attribs=True)
-class CancelShipmentResultType:
-    """Cancel shipment result."""
-
-    ShipmentID: typing.Optional[str] = None
-    ShipmentRef: typing.Optional[str] = None
-    TrackingID: typing.Optional[str] = None
-    Success: typing.Optional[int] = None
-    Errors: typing.Optional[typing.List[ShipmentErrorType]] = jstruct.JList[ShipmentErrorType]
-    Warnings: typing.Optional[typing.List[ShipmentWarningType]] = jstruct.JList[ShipmentWarningType]
-
-
-@attr.s(auto_attribs=True)
-class CancelShipmentResponseType:
-    """Cancel shipment API response."""
-
     status: typing.Optional[int] = None
     success: typing.Optional[int] = None
     message: typing.Optional[str] = None
     type: typing.Optional[str] = None
     instance: typing.Optional[str] = None
-    results: typing.Optional[CancelShipmentResultType] = jstruct.JStruct[CancelShipmentResultType]
     UniqId: typing.Optional[str] = None
+    results: typing.Optional[ResultsType] = jstruct.JStruct[ResultsType]

karrio/schemas/parcelone/tracking_response.py

@@ -1,14 +1,10 @@
-"""ParcelOne TrackLMC REST API v1 - Response Types."""
-
 import attr
 import jstruct
 import typing
 
 
 @attr.s(auto_attribs=True)
-class TrackingEventType:
-    """Single tracking event."""
-
+class EventType:
     DateTime: typing.Optional[str] = None
     Location: typing.Optional[str] = None
     Status: typing.Optional[str] = None
@@ -18,9 +14,7 @@ class TrackingEventType:
 
 
 @attr.s(auto_attribs=True)
-class TrackingResultType:
-    """Tracking result with events."""
-
+class ResultsType:
     TrackingID: typing.Optional[str] = None
     CarrierIDLMC: typing.Optional[str] = None
     CarrierTrackingID: typing.Optional[str] = None
@@ -29,17 +23,15 @@ class TrackingResultType:
     DeliveryDate: typing.Optional[str] = None
     EstimatedDelivery: typing.Optional[str] = None
     SignedBy: typing.Optional[str] = None
-    Events: typing.Optional[typing.List[TrackingEventType]] = jstruct.JList[TrackingEventType]
+    Events: typing.Optional[typing.List[EventType]] = jstruct.JList[EventType]
 
 
 @attr.s(auto_attribs=True)
 class TrackingResponseType:
-    """TrackLMC API response."""
-
     status: typing.Optional[int] = None
     success: typing.Optional[int] = None
     message: typing.Optional[str] = None
     type: typing.Optional[str] = None
     instance: typing.Optional[str] = None
-    results: typing.Optional[TrackingResultType] = jstruct.JStruct[TrackingResultType]
     UniqId: typing.Optional[str] = None
+    results: typing.Optional[ResultsType] = jstruct.JStruct[ResultsType]

{karrio_parcelone-2026.1.4.dist-info → karrio_parcelone-2026.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: karrio_parcelone
-Version: 2026.1.4
+Version: 2026.1.5
 Summary: Karrio - ParcelOne Shipping Extension
 Author-email: karrio <hello@karrio.io>
 License-Expression: LGPL-3.0

karrio_parcelone-2026.1.5.dist-info/RECORD

@@ -0,0 +1,27 @@
+karrio/mappers/parcelone/__init__.py,sha256=Hm9BZgD1F-cH6se9I5Lm9UbfPiN_QcdQ4A5ttNVN6Bo,155
+karrio/mappers/parcelone/mapper.py,sha256=Ykbr_l7VrHOK-AwRDkdYoz9yxkIDwOrnlr9YmmORlzA,1967
+karrio/mappers/parcelone/proxy.py,sha256=hzpB2eXCdB8Kf2PF6wbhYCuKOHwttM-Vuqruut1nWCE,3050
+karrio/mappers/parcelone/settings.py,sha256=pV7bY8h1r-f9MFO3YlOVz-HUM2CEmTY0wV7SMhxvSPM,1093
+karrio/plugins/parcelone/__init__.py,sha256=NgOrhNfRNOrM01LHrPXtbXiRYuK52NOzB1eW71ZQsys,1059
+karrio/providers/parcelone/__init__.py,sha256=rPdlLNi9BuIe-KvOGApmypWKXe6ed1OZdSk-iJ7mYEE,458
+karrio/providers/parcelone/error.py,sha256=S1eHg4Glhg4bJeUQQIrPa4Xqoc7aD0UpWnT4WRUHDwI,2680
+karrio/providers/parcelone/rate.py,sha256=K3VphVI_fsF23auRoMYi_0tS4q9zGf2l-aNyY09rPKY,6033
+karrio/providers/parcelone/tracking.py,sha256=XM3SfCNULOH5GOyTa0u_Yqbj7I7fjAXQjnh6Bk2yMV8,4857
+karrio/providers/parcelone/units.py,sha256=gUseSpPbmf9Yei85Q6z8JZSwQ0usUj3fKJ52guI4oMI,12227
+karrio/providers/parcelone/utils.py,sha256=RCFFMyvnzamRZozZPH9y1kaoI3cqqLhkTI52Tu9bIyk,1594
+karrio/providers/parcelone/shipment/__init__.py,sha256=PHnQyOCF2Nd7pJ2um51RBubPNBlN72w41Ialoz93qB4,411
+karrio/providers/parcelone/shipment/cancel.py,sha256=s53xX1bu6P6Wufht5zYpg_k3MgnegJXd-qf1nS6GGvk,2201
+karrio/providers/parcelone/shipment/create.py,sha256=_siw6FYpZ7xxHC4t38pa27Gch_gXmPrayitvgS02JSI,10338
+karrio/schemas/parcelone/__init__.py,sha256=JWQD0_qIcLhbrFDRIR_TROC25mCP9GN6VDfn8vBicmc,1975
+karrio/schemas/parcelone/cancel_response.py,sha256=emn2bClHL8bqh3w_1dOHGVbchq_2RHKoZBzcPBiTJcI,1101
+karrio/schemas/parcelone/error.py,sha256=wQ8UxZwuW-G9Wy3u1B-7AfPNrGy_AgFaFPcCXq1TT9E,588
+karrio/schemas/parcelone/shipping_request.py,sha256=HCHpQetWWeARWvr66_zAZrplK-NU1x_KbKsFp3N0DcY,7755
+karrio/schemas/parcelone/shipping_response.py,sha256=Hj_AsUU8vaigQGtlEfVmWawJftbCI4ujdEnLz8S_eu0,3890
+karrio/schemas/parcelone/tracking_response.py,sha256=TvfXW5XlplSUIWimpv_nADWhMduE1YOizFYxvEsZByU,1204
+modules/connectors/parcelone/karrio/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+modules/connectors/parcelone/karrio/schemas/parcelone/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+karrio_parcelone-2026.1.5.dist-info/METADATA,sha256=dkwJPzDlHY_iiKbZ7JzTBk-8i9FMB7Y23YHF7oIlhJY,1158
+karrio_parcelone-2026.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+karrio_parcelone-2026.1.5.dist-info/entry_points.txt,sha256=1OkpMf6SZ1OT_O_KDu2HDN1aAi53cZs7hKuEMZeBob0,63
+karrio_parcelone-2026.1.5.dist-info/top_level.txt,sha256=vW2vHMlcvPhowYde9HXvS4SbHP3s8Kk0TmJE1d4dfHE,35
+karrio_parcelone-2026.1.5.dist-info/RECORD,,

karrio_parcelone-2026.1.4.dist-info/RECORD

@@ -1,26 +0,0 @@
-karrio/mappers/parcelone/__init__.py,sha256=Hm9BZgD1F-cH6se9I5Lm9UbfPiN_QcdQ4A5ttNVN6Bo,155
-karrio/mappers/parcelone/mapper.py,sha256=Ykbr_l7VrHOK-AwRDkdYoz9yxkIDwOrnlr9YmmORlzA,1967
-karrio/mappers/parcelone/proxy.py,sha256=hzpB2eXCdB8Kf2PF6wbhYCuKOHwttM-Vuqruut1nWCE,3050
-karrio/mappers/parcelone/settings.py,sha256=pV7bY8h1r-f9MFO3YlOVz-HUM2CEmTY0wV7SMhxvSPM,1093
-karrio/plugins/parcelone/__init__.py,sha256=_HfYwz4S1WJ7slylNLWHgVdSiRRxLYG_HGcJ7_O1R-g,1016
-karrio/providers/parcelone/__init__.py,sha256=rPdlLNi9BuIe-KvOGApmypWKXe6ed1OZdSk-iJ7mYEE,458
-karrio/providers/parcelone/error.py,sha256=S1eHg4Glhg4bJeUQQIrPa4Xqoc7aD0UpWnT4WRUHDwI,2680
-karrio/providers/parcelone/rate.py,sha256=K3VphVI_fsF23auRoMYi_0tS4q9zGf2l-aNyY09rPKY,6033
-karrio/providers/parcelone/tracking.py,sha256=6K4PbYPM2KjgcmZZ1OxrcVrf9obSI9CAPlOvoq0mJqQ,4735
-karrio/providers/parcelone/units.py,sha256=522WoCocbz9I1Xzje7L1uC2wslLyd_C3-xk10-QWGf0,10415
-karrio/providers/parcelone/utils.py,sha256=RCFFMyvnzamRZozZPH9y1kaoI3cqqLhkTI52Tu9bIyk,1594
-karrio/providers/parcelone/shipment/__init__.py,sha256=PHnQyOCF2Nd7pJ2um51RBubPNBlN72w41Ialoz93qB4,411
-karrio/providers/parcelone/shipment/cancel.py,sha256=P4hufFBTOkyUFQgWqXR6SMS_grVWCuWwLb_cQvVRMLM,1995
-karrio/providers/parcelone/shipment/create.py,sha256=_siw6FYpZ7xxHC4t38pa27Gch_gXmPrayitvgS02JSI,10338
-karrio/schemas/parcelone/__init__.py,sha256=WfvAzf5Bf2YmkigHqWpsHgwfFZrRpBoDYojc2QMxjxY,250
-karrio/schemas/parcelone/error.py,sha256=Js8AAYR5m24C_anVYEhDUQ1e1wYI98HPVT8rCPn8eh0,718
-karrio/schemas/parcelone/shipping_request.py,sha256=cEmB5WMvWOAbzZPpPdLnKG0g8voWHkya7dKLWZkBF6c,6802
-karrio/schemas/parcelone/shipping_response.py,sha256=ufxUaLy_4ML05pADxIYHYOhxFapHbc18dgQ0UcEMoLQ,6205
-karrio/schemas/parcelone/tracking_response.py,sha256=emkJ4kcX3dnHPMCYz-CW6iCea0AlONdb_igba4UO-dQ,1413
-modules/connectors/parcelone/karrio/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-modules/connectors/parcelone/karrio/schemas/parcelone/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-karrio_parcelone-2026.1.4.dist-info/METADATA,sha256=-P0h2vl_lyQOxK6CC1Jhq0eSk266zH_crEDMskIlvpE,1158
-karrio_parcelone-2026.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-karrio_parcelone-2026.1.4.dist-info/entry_points.txt,sha256=1OkpMf6SZ1OT_O_KDu2HDN1aAi53cZs7hKuEMZeBob0,63
-karrio_parcelone-2026.1.4.dist-info/top_level.txt,sha256=vW2vHMlcvPhowYde9HXvS4SbHP3s8Kk0TmJE1d4dfHE,35
-karrio_parcelone-2026.1.4.dist-info/RECORD,,