karrio-zoom2u 2025.5rc1__py3-none-any.whl

karrio/mappers/zoom2u/__init__.py

@@ -0,0 +1,3 @@
+from karrio.mappers.zoom2u.mapper import Mapper
+from karrio.mappers.zoom2u.proxy import Proxy
+from karrio.mappers.zoom2u.settings import Settings

karrio/mappers/zoom2u/mapper.py

@@ -0,0 +1,55 @@
+
+"""Karrio Zoom2u client mapper."""
+
+import typing
+import karrio.lib as lib
+import karrio.api.mapper as mapper
+import karrio.core.models as models
+import karrio.providers.zoom2u as provider
+import karrio.mappers.zoom2u.settings as provider_settings
+
+
+class Mapper(mapper.Mapper):
+    settings: provider_settings.Settings
+
+    def create_rate_request(
+        self, payload: models.RateRequest
+    ) -> lib.Serializable:
+        return provider.rate_request(payload, self.settings)
+    
+    def create_tracking_request(
+        self, payload: models.TrackingRequest
+    ) -> lib.Serializable:
+        return provider.tracking_request(payload, self.settings)
+    
+    def create_shipment_request(
+        self, payload: models.ShipmentRequest
+    ) -> lib.Serializable:
+        return provider.shipment_request(payload, self.settings)
+    
+    def create_cancel_shipment_request(
+        self, payload: models.ShipmentCancelRequest
+    ) -> lib.Serializable[str]:
+        return provider.shipment_cancel_request(payload, self.settings)
+    
+    
+    def parse_cancel_shipment_response(
+        self, response: lib.Deserializable[str]
+    ) -> typing.Tuple[models.ConfirmationDetails, typing.List[models.Message]]:
+        return provider.parse_shipment_cancel_response(response, self.settings)
+    
+    def parse_rate_response(
+        self, response: lib.Deserializable[str]
+    ) -> typing.Tuple[typing.List[models.RateDetails], typing.List[models.Message]]:
+        return provider.parse_rate_response(response, self.settings)
+    
+    def parse_shipment_response(
+        self, response: lib.Deserializable[str]
+    ) -> typing.Tuple[models.ShipmentDetails, typing.List[models.Message]]:
+        return provider.parse_shipment_response(response, self.settings)
+    
+    def parse_tracking_response(
+        self, response: lib.Deserializable[str]
+    ) -> typing.Tuple[typing.List[models.TrackingDetails], typing.List[models.Message]]:
+        return provider.parse_tracking_response(response, self.settings)
+    

karrio/mappers/zoom2u/proxy.py

@@ -0,0 +1,87 @@
+"""Karrio Zoom2u client proxy."""
+
+import typing
+import karrio.lib as lib
+import karrio.api.proxy as proxy
+import karrio.providers.zoom2u.error as provider_error
+import karrio.providers.zoom2u.utils as provider_utils
+import karrio.mappers.zoom2u.settings as provider_settings
+
+
+class Proxy(proxy.Proxy):
+    settings: provider_settings.Settings
+
+    def get_rates(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        response = lib.request(
+            url=f"{self.settings.server_url}/api/v1/delivery/quote",
+            data=lib.to_json(request.serialize()),
+            trace=self.trace_as("json"),
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.settings.api_key}",
+            },
+            on_error=provider_error.parse_http_response,
+        )
+
+        return lib.Deserializable(response, lib.to_dict)
+
+    def create_shipment(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        response = lib.request(
+            url=f"{self.settings.server_url}/api/v1/delivery/create",
+            data=lib.to_json(request.serialize()),
+            trace=self.trace_as("json"),
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.settings.api_key}",
+            },
+            on_error=provider_error.parse_http_response,
+        )
+
+        return lib.Deserializable(
+            response,
+            lambda _: lib.to_dict(provider_utils.clean_response(_)),
+        )
+
+    def cancel_shipment(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        payload = request.serialize()
+        response = lib.request(
+            url=f"{self.settings.server_url}/api/v1/delivery/cancel/{payload['reference']}",
+            trace=self.trace_as("json"),
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.settings.api_key}",
+            },
+            on_error=provider_error.parse_http_response,
+            decoder=lambda _: dict(ok=True),
+        )
+
+        return lib.Deserializable(response, lib.to_dict)
+
+    def get_tracking(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        def _get_tracking(reference: str):
+            return reference, lib.request(
+                url=f"{self.settings.server_url}/api/v1/delivery/status/{reference}",
+                trace=self.trace_as("json"),
+                method="GET",
+                headers={
+                    "Content-Type": "application/json",
+                    "Authorization": f"Bearer {self.settings.api_key}",
+                },
+                on_error=provider_error.parse_http_response,
+            )
+
+        responses: typing.List[typing.Tuple[str, str]] = lib.run_concurently(
+            _get_tracking, request.serialize()
+        )
+
+        return lib.Deserializable(
+            responses,
+            lambda res: [
+                (num, lib.to_dict(provider_utils.clean_response(track)))
+                for num, track in res
+                if any(track.strip())
+            ],
+        )

karrio/mappers/zoom2u/settings.py

@@ -0,0 +1,20 @@
+"""Karrio Zoom2u client settings."""
+
+import attr
+import karrio.providers.zoom2u.utils as provider_utils
+
+
+@attr.s(auto_attribs=True)
+class Settings(provider_utils.Settings):
+    """Zoom2u connection settings."""
+
+    # required carrier specific properties
+    api_key: str
+
+    # generic properties
+    id: str = None
+    test_mode: bool = False
+    carrier_id: str = "zoom2u"
+    account_country_code: str = "AU"
+    metadata: dict = {}
+    config: dict = {}

karrio/plugins/zoom2u/__init__.py

@@ -0,0 +1,19 @@
+import karrio.core.metadata as metadata
+import karrio.mappers.zoom2u as mappers
+import karrio.providers.zoom2u.units as units
+
+
+METADATA = metadata.PluginMetadata(
+    status="beta",
+    id="zoom2u",
+    label="Zoom2u",
+    # Integrations
+    Mapper=mappers.Mapper,
+    Proxy=mappers.Proxy,
+    Settings=mappers.Settings,
+    # Data Units
+    is_hub=False,
+    services=units.ShippingService,
+    options=units.ShippingOption,
+)
+

karrio/providers/zoom2u/__init__.py

@@ -0,0 +1,13 @@
+
+from karrio.providers.zoom2u.utils import Settings
+from karrio.providers.zoom2u.rate import parse_rate_response, rate_request
+from karrio.providers.zoom2u.shipment import (
+    parse_shipment_cancel_response,
+    parse_shipment_response,
+    shipment_cancel_request,
+    shipment_request,
+)
+from karrio.providers.zoom2u.tracking import (
+    parse_tracking_response,
+    tracking_request,
+)

karrio/providers/zoom2u/error.py

@@ -0,0 +1,46 @@
+import typing
+import urllib.error
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.zoom2u.utils as provider_utils
+
+
+def parse_error_response(
+    responses: typing.Union[typing.List[dict], dict],
+    settings: provider_utils.Settings,
+    **kwargs,
+) -> typing.List[models.Message]:
+    results = responses if isinstance(responses, list) else [responses]
+    errors: typing.List[dict] = [
+        error for error in results if error.get("message") is not None
+    ]
+
+    return [
+        models.Message(
+            carrier_id=settings.carrier_id,
+            carrier_name=settings.carrier_name,
+            code=error.get("error-code"),
+            message=error.get("message"),
+            details=lib.to_dict(
+                {
+                    **kwargs,
+                    "modelState": error.get("modelState"),
+                }
+            ),
+        )
+        for error in errors
+    ]
+
+
+def parse_http_response(response: urllib.error.HTTPError) -> dict:
+    try:
+        return lib.decode(response.read())
+    except Exception:
+        pass
+
+    return lib.to_json(
+        {
+            "error-code": response.code,
+            "message": response.reason,
+        }
+    )

karrio/providers/zoom2u/rate.py

@@ -0,0 +1,109 @@
+import karrio.schemas.zoom2u.rate_request as zoom2u
+import karrio.schemas.zoom2u.rate_response as rating
+import typing
+import karrio.lib as lib
+import karrio.core.units as units
+import karrio.core.models as models
+import karrio.providers.zoom2u.error as error
+import karrio.providers.zoom2u.utils as provider_utils
+import karrio.providers.zoom2u.units as provider_units
+
+
+def parse_rate_response(
+    _response: lib.Deserializable[dict],
+    settings: provider_utils.Settings,
+) -> typing.Tuple[typing.List[models.RateDetails], typing.List[models.Message]]:
+    _responses = _response.deserialize()
+    responses = _responses if isinstance(_responses, list) else [_responses]
+
+    messages = error.parse_error_response(responses, settings)
+    rates = [
+        _extract_details(rate, settings)
+        for rate in responses
+        if rate.get("message") is None
+    ]
+
+    return rates, messages
+
+
+def _extract_details(
+    data: dict,
+    settings: provider_utils.Settings,
+) -> models.RateDetails:
+    rate = lib.to_object(rating.RateResponseElementType, data)
+    service = provider_units.ShippingService.map(rate.deliverySpeed)
+
+    return models.RateDetails(
+        carrier_id=settings.carrier_id,
+        carrier_name=settings.carrier_name,
+        service=service.name_or_key,
+        total_charge=lib.to_money(rate.price),
+        currency=settings.connection_config.currency.state or "AUD",
+        transit_days=1,
+        estimated_delivery=lib.fdate(rate.deliveredBy, "%Y-%m-%dT%H:%M:%S%z"),
+        meta=dict(
+            service_name=service.value_or_key,
+            earliestPickupEta=rate.earliestPickupEta,
+            earliestDropEta=rate.earliestDropEta,
+        ),
+    )
+
+
+def rate_request(
+    payload: models.RateRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    shipper = lib.to_address(payload.shipper)
+    recipient = lib.to_address(payload.recipient)
+    package = lib.to_packages(payload.parcels).single
+    service = lib.to_services(payload.services, provider_units.ShippingService).first
+    options = lib.to_shipping_options(
+        payload.options,
+        package_options=package.options,
+        option_type=provider_units.ShippingOption,
+    )
+
+    request = zoom2u.RateRequestType(
+        PurchaseOrderNumber=options.purchase_order_number.state or payload.reference,
+        PackageDescription=package.description,
+        DeliverySpeed=getattr(service, "value", None),
+        ReadyDateTime=lib.fdatetime(
+            options.ready_datetime.state,
+            current_format="%Y-%m-%d %H:%M:%S",
+            output_format="%Y-%m-%dT%H:%M:%S.%fZ",
+        ),
+        VehicleType=provider_units.VehiculeType.map(
+            options.vehicle_type.state or "Car"
+        ).value,
+        PackageType=provider_units.PackagingType.map(
+            package.packaging_type or "Box"
+        ).value,
+        Pickup=zoom2u.DropoffType(
+            ContactName=shipper.contact,
+            Email=shipper.email,
+            Phone=shipper.phone_number,
+            UnitNumber=None,
+            StreetNumber=shipper.street_number,
+            Street=shipper.street_name,
+            Suburb=shipper.city,
+            State=shipper.state_code,
+            Postcode=shipper.postal_code,
+            Country=shipper.country_name,
+            Notes=options.pickup_notes.state,
+        ),
+        Dropoff=zoom2u.DropoffType(
+            ContactName=recipient.contact,
+            Email=recipient.email,
+            Phone=recipient.phone_number,
+            UnitNumber=None,
+            StreetNumber=recipient.street_number,
+            Street=recipient.street_name,
+            Suburb=recipient.city,
+            State=recipient.state_code,
+            Postcode=recipient.postal_code,
+            Country=recipient.country_name,
+            Notes=options.dropoff_notes.state,
+        ),
+    )
+
+    return lib.Serializable(request, lib.to_dict)

karrio/providers/zoom2u/shipment/__init__.py

@@ -0,0 +1,9 @@
+
+from karrio.providers.zoom2u.shipment.create import (
+    parse_shipment_response,
+    shipment_request,
+)
+from karrio.providers.zoom2u.shipment.cancel import (
+    parse_shipment_cancel_response,
+    shipment_cancel_request,
+)

karrio/providers/zoom2u/shipment/cancel.py

@@ -0,0 +1,37 @@
+import typing
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.zoom2u.error as error
+import karrio.providers.zoom2u.utils as provider_utils
+import karrio.providers.zoom2u.units as provider_units
+
+
+def parse_shipment_cancel_response(
+    response: lib.Deserializable[dict],
+    settings: provider_utils.Settings,
+) -> typing.Tuple[models.ConfirmationDetails, typing.List[models.Message]]:
+    response_messages: list = []  # extract carrier response errors and messages
+    messages = error.parse_error_response(response_messages, settings)
+    success = len(messages) == 0
+
+    confirmation = (
+        models.ConfirmationDetails(
+            carrier_id=settings.carrier_id,
+            carrier_name=settings.carrier_name,
+            operation="Cancel Shipment",
+            success=success,
+        )
+        if success
+        else None
+    )
+
+    return confirmation, messages
+
+
+def shipment_cancel_request(
+    payload: models.ShipmentCancelRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    request = dict(reference=payload.shipment_identifier)
+
+    return lib.Serializable(request)

karrio/providers/zoom2u/shipment/create.py

@@ -0,0 +1,100 @@
+import karrio.schemas.zoom2u.shipping_request as zoom2u
+import karrio.schemas.zoom2u.shipping_response as shipping
+import typing
+import karrio.lib as lib
+import karrio.core.units as units
+import karrio.core.models as models
+import karrio.providers.zoom2u.error as error
+import karrio.providers.zoom2u.utils as provider_utils
+import karrio.providers.zoom2u.units as provider_units
+
+
+def parse_shipment_response(
+    _response: lib.Deserializable[dict],
+    settings: provider_utils.Settings,
+) -> typing.Tuple[typing.List[models.RateDetails], typing.List[models.Message]]:
+    response = _response.deserialize()
+    messages = error.parse_error_response(response, settings)
+    shipment = _extract_details(response, settings) if len(messages) == 0 else None
+
+    return shipment, messages
+
+
+def _extract_details(
+    data: dict,
+    settings: provider_utils.Settings,
+) -> models.ShipmentDetails:
+    shipment = lib.to_object(shipping.ShippingResponseType, data)
+
+    return models.ShipmentDetails(
+        carrier_id=settings.carrier_id,
+        carrier_name=settings.carrier_name,
+        tracking_number=shipment.reference,
+        shipment_identifier=shipment.reference,
+        label_type="PDF",
+        docs=models.Documents(label="No label..."),
+        meta=dict(
+            trackingCode=shipment.trackingCode,
+            carrier_tracking_link=shipment.trackinglink,
+        ),
+    )
+
+
+def shipment_request(
+    payload: models.ShipmentRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    shipper = lib.to_address(payload.shipper)
+    recipient = lib.to_address(payload.recipient)
+    package = lib.to_packages(payload.parcels).single
+    service = provider_units.ShippingService.map(payload.service).value_or_key
+    options = lib.to_shipping_options(
+        payload.options,
+        package_options=package.options,
+        option_type=provider_units.ShippingOption,
+    )
+
+    request = zoom2u.ShippingRequestType(
+        PurchaseOrderNumber=options.purchase_order_number.state or payload.reference,
+        PackageDescription=package.description,
+        DeliverySpeed=service,
+        ReadyDateTime=lib.fdatetime(
+            options.ready_datetime.state,
+            current_format="%Y-%m-%d %H:%M:%S",
+            output_format="%Y-%m-%dT%H:%M:%S.%fZ",
+        ),
+        VehicleType=provider_units.VehiculeType.map(
+            options.vehicle_type.state or "Car"
+        ).value,
+        PackageType=provider_units.PackagingType.map(
+            package.packaging_type or "Box"
+        ).value,
+        Pickup=zoom2u.DropoffType(
+            ContactName=shipper.contact,
+            Email=shipper.email,
+            Phone=shipper.phone_number,
+            UnitNumber=None,
+            StreetNumber=shipper.street_number,
+            Street=shipper.street_name,
+            Suburb=shipper.city,
+            State=shipper.state_code,
+            Postcode=shipper.postal_code,
+            Country=shipper.country_name,
+            Notes=options.pickup_notes.state,
+        ),
+        Dropoff=zoom2u.DropoffType(
+            ContactName=recipient.contact,
+            Email=recipient.email,
+            Phone=recipient.phone_number,
+            UnitNumber=None,
+            StreetNumber=recipient.street_number,
+            Street=recipient.street_name,
+            Suburb=recipient.city,
+            State=recipient.state_code,
+            Postcode=recipient.postal_code,
+            Country=recipient.country_name,
+            Notes=options.dropoff_notes.state,
+        ),
+    )
+
+    return lib.Serializable(request, lib.to_dict)

karrio/providers/zoom2u/tracking.py

@@ -0,0 +1,79 @@
+import karrio.schemas.zoom2u.tracking_response as locate2u
+import typing
+import karrio.lib as lib
+import karrio.core.units as units
+import karrio.core.models as models
+import karrio.providers.zoom2u.error as error
+import karrio.providers.zoom2u.utils as provider_utils
+import karrio.providers.zoom2u.units as provider_units
+
+
+def parse_tracking_response(
+    _responses: lib.Deserializable[typing.List[typing.Tuple[str, dict]]],
+    settings: provider_utils.Settings,
+) -> typing.Tuple[typing.List[models.TrackingDetails], typing.List[models.Message]]:
+    responses = _responses.deserialize()
+    messages: typing.List[models.Message] = sum(
+        [
+            error.parse_error_response(response, settings, tracking_number=_)
+            for _, response in responses
+            if response.get("message") is not None
+        ],
+        [],
+    )
+
+    tracking_details = [
+        _extract_details(response, settings)
+        for _, response in responses
+        if response.get("message") is None
+    ]
+
+    return tracking_details, messages
+
+
+def _extract_details(
+    data: dict,
+    settings: provider_utils.Settings,
+) -> models.TrackingDetails:
+    tracking = lib.to_object(locate2u.TrackingResponseType, data)
+    status = next(
+        (
+            status.name
+            for status in list(provider_units.TrackingStatus)
+            if tracking.status in status.value
+        ),
+        provider_units.TrackingStatus.in_transit.name,
+    )
+
+    return models.TrackingDetails(
+        carrier_id=settings.carrier_id,
+        carrier_name=settings.carrier_name,
+        tracking_number=tracking.reference,
+        events=[
+            models.TrackingEvent(
+                date=lib.fdate(tracking.statusChangeDateTime, "%Y-%m-%dT%H:%M:%S.%fZ"),
+                description=tracking.status,
+                code=tracking.status,
+                time=lib.flocaltime(
+                    tracking.statusChangeDateTime, "%Y-%m-%dT%H:%M:%S.%fZ"
+                ),
+            )
+        ],
+        delivered=(status == "delivered"),
+        info=models.TrackingInfo(
+            carrier_tracking_link=tracking.trackinglink,
+        ),
+        meta=dict(
+            proofOfDeliveryPhotoUrl=data.get("proofOfDeliveryPhotoUrl"),
+            signatureUrl=data.get("signatureUrl"),
+        ),
+    )
+
+
+def tracking_request(
+    payload: models.TrackingRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    request = payload.tracking_numbers
+
+    return lib.Serializable(request)

karrio/providers/zoom2u/units.py

@@ -0,0 +1,81 @@
+import enum
+import karrio.lib as lib
+import karrio.core.units as units
+
+
+class PackagingType(lib.StrEnum):
+    """Carrier specific packaging type"""
+
+    zoom2u_documents = "Documents"
+    zoom2u_bag = "Bag"
+    zoom2u_box = "Box"
+    zoom2u_flowers = "Flowers"
+    zoom2u_custom = "Custom"
+
+    """ Unified Packaging type mapping """
+    envelope = zoom2u_documents
+    pak = zoom2u_bag
+    tube = zoom2u_custom
+    pallet = zoom2u_custom
+    small_box = zoom2u_box
+    medium_box = zoom2u_box
+    your_packaging = zoom2u_custom
+
+
+class ConnectionConfig(lib.Enum):
+    currency = lib.OptionEnum(
+        "currency", lib.units.create_enum("Currency", ["AUD", "USD"])
+    )
+    shipping_options = lib.OptionEnum("shipping_options", list)
+    shipping_services = lib.OptionEnum("shipping_services", list)
+
+
+class VehiculeType(lib.StrEnum):
+    """Zoom2u vehicule type"""
+
+    zoom2u_bike = "Bike"
+    zoom2u_car = "Car"
+    zoom2u_van = "Van"
+
+
+class ShippingService(lib.StrEnum):
+    """Carrier specific services"""
+
+    zoom2u_VIP = "VIP"
+    zoom2u_3_hour = "3 hour"
+    zoom2u_same_day = "Same day"
+
+
+class ShippingOption(lib.Enum):
+    """Carrier specific options"""
+
+    purchase_order_number = lib.OptionEnum("purchase_order_number")
+    ready_datetime = lib.OptionEnum("ready_datetime")
+    vehicle_type = lib.OptionEnum("vehicle_type")
+    pickup_notes = lib.OptionEnum("pickup_notes")
+    dropoff_notes = lib.OptionEnum("dropoff_notes")
+
+
+def shipping_options_initializer(
+    options: dict,
+    package_options: units.ShippingOptions = None,
+) -> units.ShippingOptions:
+    """
+    Apply default values to the given options.
+    """
+
+    if package_options is not None:
+        options.update(package_options.content)
+
+    def items_filter(key: str) -> bool:
+        return key in ShippingOption  # type: ignore
+
+    return units.ShippingOptions(options, ShippingOption, items_filter=items_filter)
+
+
+class TrackingStatus(lib.Enum):
+    on_hold = ["Unassigned", "Accepted", "On Hold - With Courier"]
+    delivered = ["Dropped Off"]
+    in_transit = ["On Route to Pickup", "Picked up"]
+    delivery_failed = ["Cancelled", "Returning", "Returned"]
+    out_for_delivery = ["On Route to Dropoff", "Tried to deliver"]

karrio/providers/zoom2u/utils.py

@@ -0,0 +1,33 @@
+import karrio.lib as lib
+import karrio.core as core
+
+
+class Settings(core.Settings):
+    """Zoom2u connection settings."""
+
+    api_key: str
+
+    account_country_code: str = "AU"
+    metadata: dict = {}
+    config: dict = {}
+
+    @property
+    def carrier_name(self):
+        return "zoom2u"
+
+    @property
+    def server_url(self):
+        return "https://api.zoom2u.com"
+
+    @property
+    def connection_config(self) -> lib.units.Options:
+        from karrio.providers.zoom2u.units import ConnectionConfig
+
+        return lib.to_connection_config(
+            self.config or {},
+            option_type=ConnectionConfig,
+        )
+
+
+def clean_response(response: str):
+    return response.replace("tracking-link", "trackinglink")

karrio/schemas/zoom2u/error_response.py

@@ -0,0 +1,16 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ModelStateType:
+    getQuoteRequestPickupSuburb: typing.Optional[typing.List[str]] = None
+    getQuoteRequestPickupPostcode: typing.Optional[typing.List[str]] = None
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponseType:
+    errorcode: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    modelState: typing.Optional[ModelStateType] = jstruct.JStruct[ModelStateType]

karrio/schemas/zoom2u/rate_request.py

@@ -0,0 +1,30 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class DropoffType:
+    ContactName: typing.Optional[str] = None
+    Email: typing.Optional[str] = None
+    Phone: typing.Optional[str] = None
+    UnitNumber: typing.Optional[str] = None
+    StreetNumber: typing.Optional[int] = None
+    Street: typing.Optional[str] = None
+    Suburb: typing.Optional[str] = None
+    State: typing.Optional[str] = None
+    Postcode: typing.Optional[int] = None
+    Country: typing.Optional[str] = None
+    Notes: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class RateRequestType:
+    PurchaseOrderNumber: typing.Optional[str] = None
+    PackageDescription: typing.Optional[str] = None
+    DeliverySpeed: typing.Optional[str] = None
+    ReadyDateTime: typing.Optional[str] = None
+    VehicleType: typing.Optional[str] = None
+    PackageType: typing.Optional[str] = None
+    Pickup: typing.Optional[DropoffType] = jstruct.JStruct[DropoffType]
+    Dropoff: typing.Optional[DropoffType] = jstruct.JStruct[DropoffType]

karrio/schemas/zoom2u/rate_response.py

@@ -0,0 +1,12 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class RateResponseElementType:
+    deliverySpeed: typing.Optional[str] = None
+    price: typing.Optional[int] = None
+    deliveredBy: typing.Optional[str] = None
+    earliestPickupEta: typing.Optional[str] = None
+    earliestDropEta: typing.Optional[str] = None

karrio/schemas/zoom2u/shipping_request.py

@@ -0,0 +1,30 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class DropoffType:
+    ContactName: typing.Optional[str] = None
+    Email: typing.Optional[str] = None
+    Phone: typing.Optional[str] = None
+    UnitNumber: typing.Optional[str] = None
+    StreetNumber: typing.Optional[int] = None
+    Street: typing.Optional[str] = None
+    Suburb: typing.Optional[str] = None
+    State: typing.Optional[str] = None
+    Postcode: typing.Optional[int] = None
+    Country: typing.Optional[str] = None
+    Notes: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShippingRequestType:
+    PurchaseOrderNumber: typing.Optional[str] = None
+    PackageDescription: typing.Optional[str] = None
+    DeliverySpeed: typing.Optional[str] = None
+    ReadyDateTime: typing.Optional[str] = None
+    VehicleType: typing.Optional[str] = None
+    PackageType: typing.Optional[str] = None
+    Pickup: typing.Optional[DropoffType] = jstruct.JStruct[DropoffType]
+    Dropoff: typing.Optional[DropoffType] = jstruct.JStruct[DropoffType]

karrio/schemas/zoom2u/shipping_response.py

@@ -0,0 +1,11 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ShippingResponseType:
+    reference: typing.Optional[str] = None
+    price: typing.Optional[float] = None
+    trackinglink: typing.Optional[str] = None
+    trackingCode: typing.Optional[str] = None

karrio/schemas/zoom2u/tracking_response.py

@@ -0,0 +1,22 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class CourierType:
+    id: typing.Optional[int] = None
+    name: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class TrackingResponseType:
+    reference: typing.Optional[str] = None
+    status: typing.Optional[str] = None
+    statusChangeDateTime: typing.Optional[str] = None
+    purchaseOrderNumber: typing.Optional[str] = None
+    trackinglink: typing.Optional[str] = None
+    proofOfDeliveryPhotoUrl: typing.Any = None
+    signatureUrl: typing.Any = None
+    courier: typing.Optional[CourierType] = jstruct.JStruct[CourierType]

karrio_zoom2u-2025.5rc1.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: karrio_zoom2u
+Version: 2025.5rc1
+Summary: Karrio - Zoom2u Shipping Extension
+Author-email: karrio <hello@karrio.io>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/karrioapi/karrio
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: karrio
+
+
+# karrio.zoom2u
+
+This package is a Zoom2u extension of the [karrio](https://pypi.org/project/karrio) multi carrier shipping SDK.
+
+## Requirements
+
+`Python 3.7+`
+
+## Installation
+
+```bash
+pip install karrio.zoom2u
+```
+
+## Usage
+
+```python
+import karrio.sdk as karrio
+from karrio.mappers.zoom2u.settings import Settings
+
+
+# Initialize a carrier gateway
+zoom2u = karrio.gateway["zoom2u"].create(
+    Settings(
+        ...
+    )
+)
+```
+
+Check the [Karrio Mutli-carrier SDK docs](https://docs.karrio.io) for Shipping API requests

karrio_zoom2u-2025.5rc1.dist-info/RECORD

@@ -0,0 +1,26 @@
+karrio/mappers/zoom2u/__init__.py,sha256=Mt_JDxjJtR4DbgqSjnBl4n3HARPHL90TJK8d92p8VGI,146
+karrio/mappers/zoom2u/mapper.py,sha256=sqj3ngo2Lx3v871RE-yJ8njY3U-ErktqRY5jU1ljwyw,2016
+karrio/mappers/zoom2u/proxy.py,sha256=vP7SwlJD4wLecI0HD_fH7McsTedyWcmb1DBLCj5eFew,3212
+karrio/mappers/zoom2u/settings.py,sha256=MlLgw7qTJO-hSyoTRKhON4MXP-pYPKkJyEy2xNSbUNo,461
+karrio/plugins/zoom2u/__init__.py,sha256=HB-FWZu1weeKkYgij0P9Sv-08v2BC1ul0MW_CaieLfU,430
+karrio/providers/zoom2u/__init__.py,sha256=PeRbCr6K--JSfSqXocP_ARXftILCkaz-L8xAWpvs03M,392
+karrio/providers/zoom2u/error.py,sha256=_V3OReCkDXSDTYyTXFik6p5c2u4Rd4MU772KDBQwJxo,1221
+karrio/providers/zoom2u/rate.py,sha256=Ot3Fs4ESS2LYltT99a7l2CejwhTbmivIAZoR0jV78-E,3889
+karrio/providers/zoom2u/tracking.py,sha256=G_Y69pNK647fgJf7mb6e1DmNH8ZXMCOhtEWmrcZsALk,2503
+karrio/providers/zoom2u/units.py,sha256=dHAvrXTXsxLgXjDjzmoMWpcruyGs3cfNVsRTVI4rZfw,2221
+karrio/providers/zoom2u/utils.py,sha256=8r3E5PjGlx7uSd3KYxafrQQHOKAu4rGmfzA2AM8Gd10,732
+karrio/providers/zoom2u/shipment/__init__.py,sha256=M6fY2Koib_HDcY3fMKH3OU6MTSMEXQOWnOwsiQa-i2c,229
+karrio/providers/zoom2u/shipment/cancel.py,sha256=KCWHM63qkDLHGIXoPalItH1poWZy87yqus600b8qEBk,1149
+karrio/providers/zoom2u/shipment/create.py,sha256=C2fTpV0ti2QojWsbLXzsJkOkZZNu0GVzr0gWldiDSZ4,3570
+karrio/schemas/zoom2u/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+karrio/schemas/zoom2u/error_response.py,sha256=MQZfMjQzmcXzfddTe6jbN5aB6WJXPoXhEq9ZAnHrLTU,462
+karrio/schemas/zoom2u/rate_request.py,sha256=cNzlD1s2Fo0rgVQywdJrIpLw8iAlpymK5NKjSfdRLUY,1029
+karrio/schemas/zoom2u/rate_response.py,sha256=A7tUlD6yAhsLT2LImD2nXWxiNhepyNIRPIroRpmwNsA,332
+karrio/schemas/zoom2u/shipping_request.py,sha256=qB0FzpYBVJiyeo61DqhvcQkHFN5lCQ7grSx5t4fBHp0,1033
+karrio/schemas/zoom2u/shipping_response.py,sha256=tUoz5nX-UXpet9bh8pUeq3_42SryYKli9ujE4KFql3Y,274
+karrio/schemas/zoom2u/tracking_response.py,sha256=23aEGIMlDRu7bjZxsh2UgLd85Vwhs-nIuq0GA9UUAms,651
+karrio_zoom2u-2025.5rc1.dist-info/METADATA,sha256=F6eRy7P-23XR0CdE34gS0_TcxsLSpM58R2Bia6hIzCM,984
+karrio_zoom2u-2025.5rc1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+karrio_zoom2u-2025.5rc1.dist-info/entry_points.txt,sha256=ItGT5y_xC6B_LSYJuSOMDMPeQ8t8LSavustGfFXbGIY,57
+karrio_zoom2u-2025.5rc1.dist-info/top_level.txt,sha256=FZCY8Nwft8oEGHdl--xku8P3TrnOxu5dETEU_fWpRSM,20
+karrio_zoom2u-2025.5rc1.dist-info/RECORD,,

karrio_zoom2u-2025.5rc1.dist-info/WHEEL

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

karrio_zoom2u-2025.5rc1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[karrio.plugins]
+zoom2u = karrio.plugins.zoom2u:METADATA

karrio_zoom2u-2025.5rc1.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+dist
+karrio
+schemas