karrio-locate2u 2025.5rc1__py3-none-any.whl

karrio/mappers/locate2u/__init__.py

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

karrio/mappers/locate2u/mapper.py

@@ -0,0 +1,51 @@
+"""Karrio Locate2u client mapper."""
+
+import typing
+import karrio.lib as lib
+import karrio.api.mapper as mapper
+import karrio.core.models as models
+import karrio.providers.locate2u as provider
+import karrio.mappers.locate2u.settings as provider_settings
+import karrio.universal.providers.rating as universal_provider
+
+
+class Mapper(mapper.Mapper):
+    settings: provider_settings.Settings
+
+    def create_rate_request(self, payload: models.RateRequest) -> lib.Serializable:
+        return universal_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
+    ) -> 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
+    ) -> typing.Tuple[typing.List[models.RateDetails], typing.List[models.Message]]:
+        return universal_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/locate2u/proxy.py

@@ -0,0 +1,69 @@
+"""Karrio Locate2u client proxy."""
+
+import typing
+import karrio.lib as lib
+import karrio.api.proxy as proxy
+import karrio.providers.locate2u.error as provider_error
+import karrio.mappers.locate2u.settings as provider_settings
+import karrio.universal.mappers.rating_proxy as rating_proxy
+
+
+class Proxy(rating_proxy.RatingMixinProxy, proxy.Proxy):
+    settings: provider_settings.Settings
+
+    def get_rates(self, request: lib.Serializable) -> lib.Deserializable:
+        return super().get_rates(request)
+
+    def create_shipment(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        response = lib.request(
+            url=f"{self.settings.server_url}/api/v1/stops",
+            data=lib.to_json(request.serialize()),
+            trace=self.trace_as("json"),
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.settings.access_token}",
+            },
+            on_error=provider_error.parse_http_response,
+        )
+
+        return lib.Deserializable(response, lib.to_dict)
+
+    def cancel_shipment(self, request: lib.Serializable) -> lib.Deserializable[str]:
+        payload = request.serialize()
+        response = lib.request(
+            url=f"{self.settings.server_url}/api/v1/stops/{payload['stopId']}",
+            trace=self.trace_as("json"),
+            method="DELETE",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.settings.access_token}",
+            },
+            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(stop_id: str):
+            return stop_id, lib.request(
+                url=f"{self.settings.server_url}/api/v1/stops/{stop_id}?includeItems=false&includeLines=false",
+                trace=self.trace_as("json"),
+                method="GET",
+                headers={
+                    "Content-Type": "application/json",
+                    "Authorization": f"Bearer {self.settings.access_token}",
+                },
+                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(track)) for num, track in res if any(track.strip())
+            ],
+        )

karrio/mappers/locate2u/settings.py

@@ -0,0 +1,32 @@
+"""Karrio Locate2u client settings."""
+
+import attr
+import typing
+import jstruct
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.locate2u.utils as provider_utils
+import karrio.providers.locate2u.units as provider_units
+
+
+@attr.s(auto_attribs=True)
+class Settings(provider_utils.Settings):
+    """Locate2u connection settings."""
+
+    # required carrier specific properties
+    client_id: str = None
+    client_secret: str = None
+
+    id: str = None
+    test_mode: bool = False
+    carrier_id: str = "locate2u"
+    account_country_code: str = "AU"
+    services: typing.List[models.ServiceLevel] = jstruct.JList[models.ServiceLevel, False, dict(default=provider_units.DEFAULT_SERVICES)]  # type: ignore
+    metadata: dict = {}
+
+    @property
+    def shipping_services(self) -> typing.List[models.ServiceLevel]:
+        if any(self.services or []):
+            return self.services
+
+        return provider_units.DEFAULT_SERVICES

karrio/plugins/locate2u/__init__.py

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

karrio/providers/locate2u/__init__.py

@@ -0,0 +1,11 @@
+from karrio.providers.locate2u.utils import Settings
+from karrio.providers.locate2u.shipment import (
+    parse_shipment_cancel_response,
+    parse_shipment_response,
+    shipment_cancel_request,
+    shipment_request,
+)
+from karrio.providers.locate2u.tracking import (
+    parse_tracking_response,
+    tracking_request,
+)

karrio/providers/locate2u/error.py

@@ -0,0 +1,31 @@
+import typing
+import urllib.error
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.locate2u.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("error") is not None
+    ]
+
+    return [
+        models.Message(
+            carrier_id=settings.carrier_id,
+            carrier_name=settings.carrier_name,
+            code=error.get("code"),
+            message=error.get("error"),
+            details={**kwargs},
+        )
+        for error in errors
+    ]
+
+
+def parse_http_response(response: urllib.error.HTTPError) -> dict:
+    return lib.to_json(dict(code=str(response.code), error=response.reason))

karrio/providers/locate2u/shipment/__init__.py

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

karrio/providers/locate2u/shipment/cancel.py

@@ -0,0 +1,39 @@
+import typing
+import karrio.lib as lib
+import karrio.core.models as models
+import karrio.providers.locate2u.error as error
+import karrio.providers.locate2u.utils as provider_utils
+import karrio.providers.locate2u.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 = _response.deserialize()
+    messages = error.parse_error_response(response, settings)
+    success = response.get("error") is None
+
+    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(
+        stopId=payload.shipment_identifier,
+    )
+
+    return lib.Serializable(request)

karrio/providers/locate2u/shipment/create.py

@@ -0,0 +1,116 @@
+import karrio.schemas.locate2u.shipping_request as locate2u
+import karrio.schemas.locate2u.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.locate2u.error as error
+import karrio.providers.locate2u.utils as provider_utils
+import karrio.providers.locate2u.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.ShippingResponse, data)
+
+    return models.ShipmentDetails(
+        carrier_id=settings.carrier_id,
+        carrier_name=settings.carrier_name,
+        tracking_number=str(shipment.stopId),
+        shipment_identifier=str(shipment.stopId),
+        label_type="PDF",
+        docs=models.Documents(label="No label..."),
+        meta=dict(
+            shipmentId=shipment.shipmentId,
+            durationMinutes=shipment.durationMinutes,
+        ),
+    )
+
+
+def shipment_request(
+    payload: models.ShipmentRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    recipient = lib.to_address(payload.recipient)
+    package = lib.to_packages(payload.parcels).single
+    options = lib.to_shipping_options(
+        payload.options,
+        package_options=package.options,
+        option_type=provider_units.ShippingOption,
+    )
+
+    request = locate2u.ShippingRequest(
+        contact=locate2u.Contact(
+            name=recipient.contact,
+            phone=recipient.phone_number,
+            email=recipient.email,
+        ),
+        name=recipient.company_name or recipient.person_name,
+        address=lib.text(
+            recipient.address_line,
+            lib.text(recipient.city, recipient.postal_code, recipient.state_code),
+            recipient.country_name,
+            separator=", ",
+        ),
+        location=(
+            locate2u.Location(
+                latitude=options.latitude.state,
+                longitude=options.longitude.state,
+            )
+            if any([options.latitude.state, options.longitude.state])
+            else None
+        ),
+        appointmentTime=options.appointment_time.state,
+        timeWindowStart=options.time_window_start.state,
+        timeWindowEnd=options.time_window_end.state,
+        brandId=options.brand_id.state,
+        durationMinutes=options.duration_minutes.state,
+        tripDate=lib.fdatetime(
+            options.shipment_date.state,
+            current_format="%Y-%m-%d",
+            output_format="%Y-%m-%dT%H:%M:%S.%fZ",
+        ),
+        customFields=None,
+        assignedTeamMemberId=options.assigned_team_member_id.state,
+        source=options.source.state,
+        sourceReference=payload.reference,
+        load=locate2u.Load(
+            quantity=package.items.quantity,
+            volume=package.volume.m3,
+            weight=package.weight.KG,
+            length=package.length.CM,
+            width=package.width.CM,
+            height=package.height.CM,
+        ),
+        customerId=options.customer_id.state,
+        runNumber=options.run_number.state,
+        teamRegionId=options.team_region_id.state,
+        driverInstructions=options.driver_instructions.state,
+        notes=options.notes.state,
+        lines=[
+            locate2u.Line(
+                barcode=item.hs_code or item.sku,
+                description=item.title or item.description,
+                currentLocation=item.metadata.get("currentLocation"),
+                serviceId=None,
+                productVariantId=None,
+                quantity=item.quantity,
+            )
+            for item in package.items
+        ],
+    )
+
+    return lib.Serializable(request, lib.to_dict)

karrio/providers/locate2u/tracking.py

@@ -0,0 +1,73 @@
+import karrio.schemas.locate2u.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.locate2u.error as error
+import karrio.providers.locate2u.utils as provider_utils
+import karrio.providers.locate2u.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("error") is not None
+        ],
+        [],
+    )
+
+    tracking_details = [
+        _extract_details(response, settings)
+        for _, response in responses
+        if response.get("error") is None
+    ]
+
+    return tracking_details, messages
+
+
+def _extract_details(
+    data: dict,
+    settings: provider_utils.Settings,
+) -> models.TrackingDetails:
+    tracking = lib.to_object(locate2u.TrackingResponse, 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=str(tracking.stopId),
+        events=[
+            models.TrackingEvent(
+                date=lib.fdate(tracking.lastModifiedDate, "%Y-%m-%dT%H:%M:%S.%fZ"),
+                description=tracking.status,
+                code=tracking.status,
+                time=lib.flocaltime(tracking.lastModifiedDate, "%Y-%m-%dT%H:%M:%S.%fZ"),
+                latitude=tracking.location.latitude,
+                longitude=tracking.location.longitude,
+            )
+        ],
+        estimated_delivery=lib.fdate(tracking.arrivalDate, "%Y-%m-%dT%H:%M:%S%z"),
+        delivered=(status == "delivered"),
+    )
+
+
+def tracking_request(
+    payload: models.TrackingRequest,
+    settings: provider_utils.Settings,
+) -> lib.Serializable:
+    request = payload.tracking_numbers
+
+    return lib.Serializable(request)

karrio/providers/locate2u/units.py

@@ -0,0 +1,79 @@
+import karrio.lib as lib
+import karrio.core.units as units
+import karrio.core.models as models
+
+
+class PackagingType(lib.StrEnum):
+    """Carrier specific packaging type"""
+
+    PACKAGE = "PACKAGE"
+
+    """ Unified Packaging type mapping """
+    envelope = PACKAGE
+    pak = PACKAGE
+    tube = PACKAGE
+    pallet = PACKAGE
+    small_box = PACKAGE
+    medium_box = PACKAGE
+    your_packaging = PACKAGE
+
+
+class ShippingService(lib.StrEnum):
+    """Carrier specific services"""
+
+    locate2u_local_delivery = "Locate2u Local Delivery"
+
+
+class ShippingOption(lib.Enum):
+    """Carrier specific options"""
+
+    appointment_time = lib.OptionEnum("appointment_time")
+    time_window_start = lib.OptionEnum("time_window_start")
+    time_window_end = lib.OptionEnum("time_window_end")
+    brand_id = lib.OptionEnum("brand_id")
+    duration_minutes = lib.OptionEnum("duration_minutes", lib.to_int)
+    assigned_team_member_id = lib.OptionEnum("assigned_team_member_id")
+    source = lib.OptionEnum("source")
+    customer_id = lib.OptionEnum("customer_id")
+    run_number = lib.OptionEnum("run_number")
+    team_region_id = lib.OptionEnum("team_region_id")
+    driver_instructions = lib.OptionEnum("driver_instructions")
+    notes = lib.OptionEnum("notes")
+    latitude = lib.OptionEnum("latitude", float)
+    longitude = lib.OptionEnum("longitude", float)
+
+
+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 = ["On Hold"]
+    delivered = ["Complete"]
+    in_transit = ["Pending", "Enroute"]
+    delivery_failed = ["Failed", "Cancelled"]
+    delivery_delayed = ["Delayed"]
+    out_for_delivery = ["Arrived"]
+
+
+DEFAULT_SERVICES = [
+    models.ServiceLevel(
+        service_name="Locate2u Local Delivery",
+        service_code="locate2u_local_delivery",
+        currency="AUD",
+        zones=[models.ServiceZone(label="Zone 1", rate=0.0)],
+    ),
+]

karrio/providers/locate2u/utils.py

@@ -0,0 +1,88 @@
+import base64
+import jstruct
+import datetime
+import urllib.parse
+import karrio.lib as lib
+import karrio.core as core
+import karrio.core.errors as errors
+
+
+class Settings(core.Settings):
+    """Locate2u connection settings."""
+
+    client_id: str = None
+    client_secret: str = None
+
+    id: str = None
+    test_mode: bool = False
+    carrier_id: str = "locate2u"
+    account_country_code: str = "AU"
+    metadata: dict = {}
+
+    @property
+    def carrier_name(self):
+        return "locate2u"
+
+    @property
+    def server_url(self):
+        return "https://api.locate2u.com"
+
+    @property
+    def auth_server_url(self):
+        return "https://id.locate2u.com"
+
+    @property
+    def authorization(self):
+        pair = "%s:%s" % (self.client_id, self.client_secret)
+        return base64.b64encode(pair.encode("utf-8")).decode("ascii")
+
+    @property
+    def access_token(self):
+        """Retrieve the access_token using the client_id|client_secret pair
+        or collect it from the cache if an unexpired access_token exist.
+        """
+        cache_key = f"{self.carrier_name}|{self.client_id}|{self.client_secret}"
+        now = datetime.datetime.now() + datetime.timedelta(minutes=30)
+
+        auth = self.connection_cache.get(cache_key) or {}
+        token = auth.get("access_token")
+        expiry = lib.to_date(auth.get("expiry"), current_format="%Y-%m-%d %H:%M:%S")
+
+        if token is not None and expiry is not None and expiry > now:
+            return token
+
+        self.connection_cache.set(cache_key, lambda: login(self))
+        new_auth = self.connection_cache.get(cache_key)
+
+        return new_auth["access_token"]
+
+
+def login(settings: Settings):
+    import karrio.providers.locate2u.error as error
+
+    result = lib.request(
+        url=f"{settings.auth_server_url}/connect/token",
+        method="POST",
+        headers={
+            "content-Type": "application/x-www-form-urlencoded",
+            "Authorization": f"Basic {settings.authorization}",
+        },
+        data=urllib.parse.urlencode(
+            dict(
+                scope="locate2u.api",
+                grant_type="client_credentials",
+            )
+        ),
+    )
+
+    response = lib.to_dict(result)
+    messages = error.parse_error_response(response, settings)
+
+    if any(messages):
+        raise errors.ParsedMessagesError(messages)
+
+    expiry = datetime.datetime.now() + datetime.timedelta(
+        seconds=float(response.get("expires_in", 0))
+    )
+
+    return {**response, "expiry": lib.fdatetime(expiry)}

karrio/schemas/locate2u/shipping_request.py

@@ -0,0 +1,69 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class Contact:
+    name: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomFields:
+    custom1: typing.Optional[str] = None
+    custom2: typing.Optional[str] = None
+    custom3: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Line:
+    barcode: typing.Optional[int] = None
+    description: typing.Optional[str] = None
+    currentLocation: typing.Optional[str] = None
+    serviceId: typing.Optional[int] = None
+    productVariantId: typing.Optional[int] = None
+    quantity: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class Load:
+    quantity: typing.Optional[int] = None
+    volume: typing.Optional[int] = None
+    weight: typing.Optional[int] = None
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class Location:
+    latitude: typing.Optional[float] = None
+    longitude: typing.Optional[float] = None
+
+
+@attr.s(auto_attribs=True)
+class ShippingRequest:
+    contact: typing.Optional[Contact] = jstruct.JStruct[Contact]
+    name: typing.Optional[str] = None
+    address: typing.Optional[str] = None
+    location: typing.Optional[Location] = jstruct.JStruct[Location]
+    type: typing.Any = None
+    appointmentTime: typing.Optional[str] = None
+    timeWindowStart: typing.Any = None
+    timeWindowEnd: typing.Any = None
+    brandId: typing.Any = None
+    durationMinutes: typing.Optional[int] = None
+    notes: typing.Optional[str] = None
+    tripDate: typing.Optional[str] = None
+    customFields: typing.Optional[CustomFields] = jstruct.JStruct[CustomFields]
+    assignedTeamMemberId: typing.Optional[str] = None
+    source: typing.Any = None
+    sourceReference: typing.Any = None
+    load: typing.Optional[Load] = jstruct.JStruct[Load]
+    customerId: typing.Optional[int] = None
+    runNumber: typing.Optional[int] = None
+    teamRegionId: typing.Optional[int] = None
+    driverInstructions: typing.Any = None
+    lines: typing.Optional[typing.List[Line]] = jstruct.JList[Line]

karrio/schemas/locate2u/shipping_response.py

@@ -0,0 +1,88 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AssignedTo:
+    id: typing.Optional[str] = None
+    name: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Contact:
+    name: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomFields:
+    custom1: typing.Optional[str] = None
+    custom2: typing.Optional[str] = None
+    custom3: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Line:
+    lineId: typing.Optional[int] = None
+    itemId: typing.Optional[int] = None
+    serviceId: typing.Any = None
+    productVariantId: typing.Any = None
+    barcode: typing.Optional[int] = None
+    description: typing.Optional[str] = None
+    quantity: typing.Optional[int] = None
+    status: typing.Optional[str] = None
+    itemStatus: typing.Optional[str] = None
+    unitPriceExTax: typing.Optional[int] = None
+    priceCurrency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Load:
+    quantity: typing.Optional[int] = None
+    volume: typing.Optional[int] = None
+    weight: typing.Optional[int] = None
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class Location:
+    latitude: typing.Optional[float] = None
+    longitude: typing.Optional[float] = None
+
+
+@attr.s(auto_attribs=True)
+class ShippingResponse:
+    assignedTo: typing.Optional[AssignedTo] = jstruct.JStruct[AssignedTo]
+    stopId: typing.Optional[int] = None
+    status: typing.Optional[str] = None
+    brandId: typing.Any = None
+    contact: typing.Optional[Contact] = jstruct.JStruct[Contact]
+    name: typing.Optional[str] = None
+    address: typing.Optional[str] = None
+    location: typing.Optional[Location] = jstruct.JStruct[Location]
+    tripDate: typing.Optional[str] = None
+    appointmentTime: typing.Optional[str] = None
+    timeWindowStart: typing.Any = None
+    timeWindowEnd: typing.Any = None
+    durationMinutes: typing.Optional[int] = None
+    notes: typing.Optional[str] = None
+    lastModifiedDate: typing.Optional[str] = None
+    customFields: typing.Optional[CustomFields] = jstruct.JStruct[CustomFields]
+    type: typing.Any = None
+    shipmentId: typing.Optional[int] = None
+    load: typing.Optional[Load] = jstruct.JStruct[Load]
+    source: typing.Any = None
+    sourceReference: typing.Any = None
+    customerId: typing.Optional[int] = None
+    runNumber: typing.Optional[int] = None
+    teamRegionId: typing.Optional[int] = None
+    teamMemberInvoiceId: typing.Optional[int] = None
+    customerInvoiceId: typing.Optional[int] = None
+    arrivalDate: typing.Optional[str] = None
+    lines: typing.Optional[typing.List[Line]] = jstruct.JList[Line]
+    driverInstructions: typing.Any = None
+    oneTimePin: typing.Optional[str] = None

karrio/schemas/locate2u/tracking_response.py

@@ -0,0 +1,88 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AssignedTo:
+    id: typing.Optional[str] = None
+    name: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Contact:
+    name: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomFields:
+    custom1: typing.Optional[str] = None
+    custom2: typing.Optional[str] = None
+    custom3: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Line:
+    lineId: typing.Optional[int] = None
+    itemId: typing.Optional[int] = None
+    serviceId: typing.Any = None
+    productVariantId: typing.Any = None
+    barcode: typing.Optional[int] = None
+    description: typing.Optional[str] = None
+    quantity: typing.Optional[int] = None
+    status: typing.Optional[str] = None
+    itemStatus: typing.Optional[str] = None
+    unitPriceExTax: typing.Optional[int] = None
+    priceCurrency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Load:
+    quantity: typing.Optional[int] = None
+    volume: typing.Optional[int] = None
+    weight: typing.Optional[int] = None
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class Location:
+    latitude: typing.Optional[float] = None
+    longitude: typing.Optional[float] = None
+
+
+@attr.s(auto_attribs=True)
+class TrackingResponse:
+    assignedTo: typing.Optional[AssignedTo] = jstruct.JStruct[AssignedTo]
+    stopId: typing.Optional[int] = None
+    status: typing.Optional[str] = None
+    brandId: typing.Any = None
+    contact: typing.Optional[Contact] = jstruct.JStruct[Contact]
+    name: typing.Optional[str] = None
+    address: typing.Optional[str] = None
+    location: typing.Optional[Location] = jstruct.JStruct[Location]
+    tripDate: typing.Optional[str] = None
+    appointmentTime: typing.Optional[str] = None
+    timeWindowStart: typing.Any = None
+    timeWindowEnd: typing.Any = None
+    durationMinutes: typing.Optional[int] = None
+    notes: typing.Optional[str] = None
+    lastModifiedDate: typing.Optional[str] = None
+    customFields: typing.Optional[CustomFields] = jstruct.JStruct[CustomFields]
+    type: typing.Any = None
+    shipmentId: typing.Optional[int] = None
+    load: typing.Optional[Load] = jstruct.JStruct[Load]
+    source: typing.Any = None
+    sourceReference: typing.Any = None
+    customerId: typing.Optional[int] = None
+    runNumber: typing.Optional[int] = None
+    teamRegionId: typing.Optional[int] = None
+    teamMemberInvoiceId: typing.Optional[int] = None
+    customerInvoiceId: typing.Optional[int] = None
+    arrivalDate: typing.Optional[str] = None
+    lines: typing.Optional[typing.List[Line]] = jstruct.JList[Line]
+    driverInstructions: typing.Any = None
+    oneTimePin: typing.Optional[str] = None

karrio_locate2u-2025.5rc1.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: karrio_locate2u
+Version: 2025.5rc1
+Summary: Karrio - Locate2u 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.locate2u
+
+This package is a Locate2u extension of the [karrio](https://pypi.org/project/karrio) multi carrier shipping SDK.
+
+## Requirements
+
+`Python 3.7+`
+
+## Installation
+
+```bash
+pip install karrio.locate2u
+```
+
+## Usage
+
+```python
+import karrio.sdk as karrio
+from karrio.mappers.locate2u.settings import Settings
+
+
+# Initialize a carrier gateway
+locate2u = karrio.gateway["locate2u"].create(
+    Settings(
+        ...
+    )
+)
+```
+
+Check the [Karrio Mutli-carrier SDK docs](https://docs.karrio.io) for Shipping API requests

karrio_locate2u-2025.5rc1.dist-info/RECORD

@@ -0,0 +1,22 @@
+karrio/mappers/locate2u/__init__.py,sha256=GIqA5pU1RiPY4Pmo5rSFxMq-ge57gt5Y70MYMOcRt0Q,152
+karrio/mappers/locate2u/mapper.py,sha256=1fG0YzxaCbXiMvykeoyzkGEPiducxEF3SeFQH5Mj7EY,2042
+karrio/mappers/locate2u/proxy.py,sha256=TkCB2hTN4oa8a3EP3CIWL9g6Nv6hz_Ql0qXCf6vg6rw,2663
+karrio/mappers/locate2u/settings.py,sha256=YCPAfEv9DfyNcCET23qdQJ6KKxgoMxTLYcm-woN35B0,964
+karrio/plugins/locate2u/__init__.py,sha256=PWzbROuRfVuUeSiA_GFY_CsZKuPh8w7j5ViTVOPdc7k,480
+karrio/providers/locate2u/__init__.py,sha256=DD0GxkUX-CBVUApoRkl0Ue2j8Nx3mAottAxa-jej8bE,322
+karrio/providers/locate2u/error.py,sha256=4daLpSeCZKVfZhad7MSNV8JR3u2GIH4m5D-fEIaPY_I,930
+karrio/providers/locate2u/tracking.py,sha256=atAmnoeJIR9QJg3LKcyf_Quxnr9sI8q7X9TprcTXIdo,2394
+karrio/providers/locate2u/units.py,sha256=GdiA_95_8HfSW-r6UoMGPgW9_WmD4vo2ESAYvizITBw,2292
+karrio/providers/locate2u/utils.py,sha256=81Cl5K0wEq5CD9NbsA_uV7jMsVzWODBjrtIVYpOJGkA,2513
+karrio/providers/locate2u/shipment/__init__.py,sha256=8UpJ7BqZawO7zi4ziPDjeJw3QJZBYtp_u7nhRVkdAYE,233
+karrio/providers/locate2u/shipment/cancel.py,sha256=f0ZE78hSGG8cin0s4tmD5piAhrYYSmXwOwVMJszvPYQ,1128
+karrio/providers/locate2u/shipment/create.py,sha256=tel33d5Ue0sdN_4P5Kg8EgK-8X0IBwSex_qJoOPdNjk,4110
+karrio/schemas/locate2u/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+karrio/schemas/locate2u/shipping_request.py,sha256=WAQ5SZFnqI8rkAxZR3fIdEegk_sX2JMZvyJCs0Dyleg,2180
+karrio/schemas/locate2u/shipping_response.py,sha256=5WB5Zc36rMUT72BfDva4U73zG2gCc_v5f3ut01IE9iU,2879
+karrio/schemas/locate2u/tracking_response.py,sha256=WcZQWV952GnSijBw1XuK5xX_Q-cXTDo5kx2oRuFVlx8,2879
+karrio_locate2u-2025.5rc1.dist-info/METADATA,sha256=Awgk0xKsLkXn6dKYXydNEMR6aLjeP9FFdCCEe9iuejI,1000
+karrio_locate2u-2025.5rc1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+karrio_locate2u-2025.5rc1.dist-info/entry_points.txt,sha256=sxqKOEWh7elHsX05SNXUrJaJoqVFCIB0Wit6KsazyiA,61
+karrio_locate2u-2025.5rc1.dist-info/top_level.txt,sha256=FZCY8Nwft8oEGHdl--xku8P3TrnOxu5dETEU_fWpRSM,20
+karrio_locate2u-2025.5rc1.dist-info/RECORD,,

karrio_locate2u-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_locate2u-2025.5rc1.dist-info/entry_points.txt

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

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

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