karrio-usps 2025.5rc1__py3-none-any.whl

karrio/providers/usps/utils.py

@@ -0,0 +1,320 @@
+"""USPS connection settings."""
+
+import re
+import typing
+import datetime
+import karrio.lib as lib
+import karrio.core as core
+import karrio.core.errors as errors
+
+AccountType = lib.units.create_enum(
+    "AccountType",
+    ["EPS", "PERMIT", "METER"],
+)
+
+
+class Settings(core.Settings):
+    """USPS connection settings."""
+
+    # Add carrier specific api connection properties here
+    client_id: str
+    client_secret: str
+    account_number: str = None
+    account_type: AccountType = "EPS"  # type: ignore
+    manifest_MID: str = None
+    CRID: str = None
+    MID: str = None
+
+    @property
+    def carrier_name(self):
+        return "usps"
+
+    @property
+    def server_url(self):
+        return "https://api-cat.usps.com" if self.test_mode else "https://apis.usps.com"
+
+    @property
+    def tracking_url(self):
+        return "https://tools.usps.com/go/TrackConfirmAction?tLabels={}"
+
+    @property
+    def connection_config(self) -> lib.units.Options:
+        return lib.to_connection_config(
+            self.config or {},
+            option_type=ConnectionConfig,
+        )
+
+    @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"access|{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: oauth2_login(self))
+        new_auth = self.connection_cache.get(cache_key)
+
+        return new_auth["access_token"]
+
+    @property
+    def payment_token(self):
+        """Retrieve the paymentAuthorizationToken using the client_id|client_secret pair
+        or collect it from the cache if an unexpired paymentAuthorizationToken exist.
+        """
+        cache_key = f"payment|{self.carrier_name}|{self.client_id}|{self.client_secret}"
+        now = datetime.datetime.now() + datetime.timedelta(minutes=45)
+
+        auth = self.connection_cache.get(cache_key) or {}
+        token = auth.get("paymentAuthorizationToken")
+        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: payment_auth(self))
+        new_auth = self.connection_cache.get(cache_key)
+
+        return new_auth["paymentAuthorizationToken"]
+
+
+class ConnectionConfig(lib.Enum):
+    permit_ZIP = lib.OptionEnum("permit_ZIP")
+    permit_number = lib.OptionEnum("permit_number")
+    shipping_options = lib.OptionEnum("shipping_options", list)
+    shipping_services = lib.OptionEnum("shipping_services", list)
+
+
+def oauth2_login(settings: Settings):
+    import karrio.providers.usps.error as error
+
+    API_SCOPES = [
+        "addresses",
+        "international-prices",
+        "subscriptions",
+        "payments",
+        "pickup",
+        "tracking",
+        "labels",
+        "scan-forms",
+        "companies",
+        "service-delivery-standards",
+        "locations",
+        "international-labels",
+        "prices",
+        "shipments",
+    ]
+    result = lib.request(
+        url=f"{settings.server_url}/oauth2/v3/token",
+        method="POST",
+        headers={"content-Type": "application/x-www-form-urlencoded"},
+        data=lib.to_query_string(
+            dict(
+                grant_type="client_credentials",
+                client_id=settings.client_id,
+                client_secret=settings.client_secret,
+                scope=" ".join(API_SCOPES),
+            )
+        ),
+    )
+
+    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)}
+
+
+def payment_auth(settings: Settings):
+    import karrio.providers.usps.error as error
+
+    result = lib.request(
+        url=f"{settings.server_url}/payments/v3/payment-authorization",
+        method="POST",
+        headers={
+            "content-Type": "application/json",
+            "Authorization": f"Bearer {settings.access_token}",
+        },
+        data=lib.to_json(
+            {
+                "roles": [
+                    {
+                        "roleName": "LABEL_OWNER",
+                        "CRID": settings.CRID,
+                        "MID": settings.MID,
+                        "accountType": settings.account_type or "EPS",
+                        "accountNumber": settings.account_number,
+                        "manifestMID": settings.manifest_MID,
+                        # "permitNumber": settings.connection_config.permit_number.state,
+                        # "permitZIP": settings.connection_config.permit_ZIP.state,
+                    },
+                    {
+                        "roleName": "PAYER",
+                        "CRID": settings.CRID,
+                        "MID": settings.MID,
+                        "accountType": settings.account_type or "EPS",
+                        "accountNumber": settings.account_number,
+                        # "permitNumber": settings.connection_config.permit_number.state,
+                        # "permitZIP": settings.connection_config.permit_zip.state,
+                    },
+                ]
+            }
+        ),
+    )
+
+    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(minutes=50)
+
+    return {**response, "expiry": lib.fdatetime(expiry)}
+
+
+def normalize_multipart_response(response: str) -> str:
+    """Normalize a multipart response string to have consistent formatting"""
+    # Find boundary
+    boundary_match = re.search(r"--[a-zA-Z0-9\+/=_-]+", response)
+    if not boundary_match:
+        return response
+
+    boundary = boundary_match.group(0)
+
+    # Split into parts using boundary
+    parts = response.split(boundary)
+
+    # Format each part
+    formatted_parts = []
+    for part in parts:
+        if (
+            not part.strip() or part.strip() == "--"
+        ):  # Skip empty parts and end boundary
+            continue
+
+        # Remove excess whitespace and normalize line endings
+        part = part.strip().replace("\r\n", "\n").replace("\n\n\n", "\n\n")
+
+        # Extract headers and content
+        if "Content-Type" in part:
+            # Split headers and content
+            headers = []
+            content = ""
+
+            # Process line by line
+            lines = part.split("\n")
+            in_headers = True
+
+            for line in lines:
+                if in_headers:
+                    if line.startswith("Content-"):
+                        headers.append(line)
+                    elif not line.strip():
+                        in_headers = False
+                    continue
+                content += line + "\n"
+
+            # Reconstruct part with proper formatting
+            formatted_part = "\n".join(headers) + "\n\n" + content.strip()
+            formatted_parts.append(formatted_part)
+
+    # Reconstruct full response
+    formatted_response = f"\n{boundary}\n".join([""] + formatted_parts + ["--"])
+
+    return formatted_response
+
+
+def parse_response(response) -> dict:
+    json_data = lib.failsafe(lambda: lib.to_dict(response))
+
+    if json_data:
+        return json_data
+
+    # Normalize response format first
+    normalized_response = normalize_multipart_response(response)
+
+    # Extract boundary dynamically
+    boundary_match = re.search(r"--[a-zA-Z0-9\-]+", normalized_response)
+    if not boundary_match:
+        return dict(
+            error=dict(
+                code="SHIPPING_SDK_ERROR",
+                message="Failed to parse multipart response",
+            )
+        )
+
+    boundary = boundary_match.group(0).strip()
+
+    # Handle multipart form-data
+    parts = normalized_response.split(boundary)
+    data = {}
+
+    for part in parts:
+        if not part.strip() or part.strip() == "--":
+            continue  # Skip empty parts and the final boundary marker
+
+        part_data = {}
+        headers_content, content = (
+            part.split("\n\n", 1) if "\n\n" in part else (part, "")
+        )
+        headers: typing.List[str] = headers_content.strip().split("\n")
+
+        # Extract Content-Disposition and Content-Type
+        for header in headers:
+            if "Content-Type" in header:
+                part_data["content_type"] = header.split(":")[1].strip()
+            elif "Content-Disposition" in header:
+                disposition = header.split(":")[1].strip()
+                if "filename=" in disposition:
+                    filename = re.search(r'filename="([^"]+)"', disposition)
+                    if filename:
+                        part_data["filename"] = filename.group(1)
+                if "name=" in disposition:
+                    name = re.search(r' name="([^"]+)"', disposition)
+                    if name:
+                        part_data["name"] = name.group(1)
+
+        # Parse content based on type
+        if part_data.get("content_type") == "application/json":
+            data[part_data["name"]] = {**lib.to_dict(content.strip())}
+        elif part_data.get("filename"):
+            data[part_data["name"]] = content.strip()  # type: ignore
+
+    return data
+
+
+def parse_error_response(response) -> dict:
+    # Check if the response is JSON
+    content = lib.failsafe(lambda: response.read())
+    json_data = lib.failsafe(lambda: lib.to_dict(content))
+
+    if json_data:
+        return json_data
+
+    # the response is plain text
+    return dict(
+        error=dict(
+            code=response.code,
+            message=response.strip(),
+        )
+    )
+
+def parse_phone_number(number: str) -> typing.Optional[str]:
+    if number is None:
+        return None
+
+    return number.replace(" ", "").replace("-", "").replace("+", "")[-10:]

karrio/schemas/usps/error_response.py

@@ -0,0 +1,31 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class SourceType:
+    parameter: typing.Optional[str] = None
+    example: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ErrorElementType:
+    status: typing.Optional[str] = None
+    code: typing.Optional[str] = None
+    title: typing.Optional[str] = None
+    detail: typing.Optional[str] = None
+    source: typing.Optional[SourceType] = jstruct.JStruct[SourceType]
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponseErrorType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    errors: typing.Optional[typing.List[ErrorElementType]] = jstruct.JList[ErrorElementType]
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponseType:
+    apiVersion: typing.Optional[str] = None
+    error: typing.Optional[ErrorResponseErrorType] = jstruct.JStruct[ErrorResponseErrorType]

karrio/schemas/usps/label_request.py

@@ -0,0 +1,142 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ContentType:
+    itemDescription: typing.Optional[str] = None
+    itemQuantity: typing.Optional[int] = None
+    itemValue: typing.Optional[int] = None
+    itemTotalValue: typing.Optional[int] = None
+    weightUOM: typing.Optional[str] = None
+    itemWeight: typing.Optional[float] = None
+    itemTotalWeight: typing.Optional[float] = None
+    HSTariffNumber: typing.Optional[str] = None
+    countryofOrigin: typing.Optional[str] = None
+    itemCategory: typing.Optional[str] = None
+    itemSubcategory: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomsFormType:
+    contentComments: typing.Optional[str] = None
+    restrictionType: typing.Optional[str] = None
+    restrictionComments: typing.Optional[str] = None
+    AESITN: typing.Optional[str] = None
+    invoiceNumber: typing.Optional[str] = None
+    licenseNumber: typing.Optional[str] = None
+    certificateNumber: typing.Optional[str] = None
+    customsContentType: typing.Optional[str] = None
+    importersReference: typing.Optional[str] = None
+    importersContact: typing.Optional[str] = None
+    exportersReference: typing.Optional[str] = None
+    exportersContact: typing.Optional[str] = None
+    contents: typing.Optional[typing.List[ContentType]] = jstruct.JList[ContentType]
+
+
+@attr.s(auto_attribs=True)
+class AddressType:
+    streetAddress: typing.Optional[str] = None
+    secondaryAddress: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    ZIPCode: typing.Optional[str] = None
+    ZIPPlus4: typing.Optional[str] = None
+    urbanization: typing.Optional[str] = None
+    firstName: typing.Optional[str] = None
+    lastName: typing.Optional[str] = None
+    firm: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+    ignoreBadAddress: typing.Optional[bool] = None
+    platformUserId: typing.Optional[str] = None
+    parcelLockerDelivery: typing.Optional[bool] = None
+    holdForPickup: typing.Optional[bool] = None
+    facilityId: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ImageInfoType:
+    imageType: typing.Optional[str] = None
+    labelType: typing.Optional[str] = None
+    shipInfo: typing.Optional[bool] = None
+    receiptOption: typing.Optional[str] = None
+    suppressPostage: typing.Optional[bool] = None
+    suppressMailDate: typing.Optional[bool] = None
+    returnLabel: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomerReferenceType:
+    referenceNumber: typing.Optional[str] = None
+    printReferenceNumber: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class DestinationEntryFacilityAddressType:
+    streetAddress: typing.Optional[str] = None
+    secondaryAddress: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    ZIPCode: typing.Optional[str] = None
+    ZIPPlus4: typing.Optional[str] = None
+    urbanization: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ContainerType:
+    containerID: typing.Optional[str] = None
+    sortType: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class OriginalPackageType:
+    originalTrackingNumber: typing.Optional[str] = None
+    originalConstructCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PackageOptionsType:
+    packageValue: typing.Optional[int] = None
+    nonDeliveryOption: typing.Optional[str] = None
+    redirectAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    contentType: typing.Optional[str] = None
+    generateGXEvent: typing.Optional[bool] = None
+    containers: typing.Optional[typing.List[ContainerType]] = jstruct.JList[ContainerType]
+    ancillaryServiceEndorsements: typing.Optional[str] = None
+    originalPackage: typing.Optional[OriginalPackageType] = jstruct.JStruct[OriginalPackageType]
+
+
+@attr.s(auto_attribs=True)
+class PackageDescriptionType:
+    weightUOM: typing.Optional[str] = None
+    weight: typing.Optional[int] = None
+    dimensionsUOM: typing.Optional[str] = None
+    length: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    girth: typing.Optional[int] = None
+    mailClass: typing.Optional[str] = None
+    rateIndicator: typing.Optional[str] = None
+    processingCategory: typing.Optional[str] = None
+    destinationEntryFacilityType: typing.Optional[str] = None
+    destinationEntryFacilityAddress: typing.Optional[DestinationEntryFacilityAddressType] = jstruct.JStruct[DestinationEntryFacilityAddressType]
+    packageOptions: typing.Optional[PackageOptionsType] = jstruct.JStruct[PackageOptionsType]
+    customerReference: typing.Optional[typing.List[CustomerReferenceType]] = jstruct.JList[CustomerReferenceType]
+    extraServices: typing.Optional[typing.List[int]] = None
+    mailingDate: typing.Optional[str] = None
+    carrierRelease: typing.Optional[bool] = None
+    physicalSignatureRequired: typing.Optional[bool] = None
+    inductionZIPCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class LabelRequestType:
+    imageInfo: typing.Optional[ImageInfoType] = jstruct.JStruct[ImageInfoType]
+    toAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    fromAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    senderAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    returnAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    packageDescription: typing.Optional[PackageDescriptionType] = jstruct.JStruct[PackageDescriptionType]
+    customsForm: typing.Optional[CustomsFormType] = jstruct.JStruct[CustomsFormType]

karrio/schemas/usps/label_response.py

@@ -0,0 +1,84 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class CommitmentType:
+    name: typing.Optional[str] = None
+    scheduleDeliveryDate: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ExtraServiceType:
+    name: typing.Optional[str] = None
+    SKU: typing.Optional[str] = None
+    price: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class InductionTypeObjectType:
+    pass
+
+
+@attr.s(auto_attribs=True)
+class LabelAddressType:
+    streetAddress: typing.Optional[str] = None
+    streetAddressAbbreviation: typing.Optional[str] = None
+    secondaryAddress: typing.Optional[str] = None
+    cityAbbreviation: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    ZIPCode: typing.Optional[str] = None
+    ZIPPlus4: typing.Optional[str] = None
+    urbanization: typing.Optional[str] = None
+    firstName: typing.Optional[str] = None
+    lastName: typing.Optional[str] = None
+    firm: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+    ignoreBadAddress: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class LinkType:
+    rel: typing.Optional[typing.List[str]] = None
+    title: typing.Optional[str] = None
+    href: typing.Optional[str] = None
+    method: typing.Optional[str] = None
+    submissionMediaType: typing.Optional[str] = None
+    targetMediaType: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class LabelMetadataType:
+    labelAddress: typing.Optional[LabelAddressType] = jstruct.JStruct[LabelAddressType]
+    routingInformation: typing.Optional[str] = None
+    trackingNumber: typing.Optional[str] = None
+    constructCode: typing.Optional[str] = None
+    SKU: typing.Optional[str] = None
+    postage: typing.Optional[int] = None
+    extraServices: typing.Optional[typing.List[ExtraServiceType]] = jstruct.JList[ExtraServiceType]
+    zone: typing.Optional[str] = None
+    commitment: typing.Optional[CommitmentType] = jstruct.JStruct[CommitmentType]
+    weightUOM: typing.Optional[str] = None
+    weight: typing.Optional[int] = None
+    dimensionalWeight: typing.Optional[int] = None
+    fees: typing.Optional[typing.List[ExtraServiceType]] = jstruct.JList[ExtraServiceType]
+    permitHolderName: typing.Optional[str] = None
+    inductionType: typing.Optional[InductionTypeObjectType] = jstruct.JStruct[InductionTypeObjectType]
+    labelBrokerID: typing.Optional[str] = None
+    links: typing.Optional[typing.List[LinkType]] = jstruct.JList[LinkType]
+    bannerText: typing.Optional[str] = None
+    retailDistributionCode: typing.Optional[str] = None
+    serviceTypeCode: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class LabelResponseType:
+    labelMetadata: typing.Optional[LabelMetadataType] = jstruct.JStruct[LabelMetadataType]
+    returnLabelMetadata: typing.Optional[LabelMetadataType] = jstruct.JStruct[LabelMetadataType]
+    labelImage: typing.Optional[str] = None
+    receiptImage: typing.Optional[str] = None
+    returnLabelImage: typing.Optional[str] = None
+    returnReceiptImage: typing.Optional[str] = None

karrio/schemas/usps/pickup_request.py

@@ -0,0 +1,49 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PackageType:
+    packageType: typing.Optional[str] = None
+    packageCount: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class AddressType:
+    streetAddress: typing.Optional[str] = None
+    secondaryAddress: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    ZIPCode: typing.Optional[str] = None
+    ZIPPlus4: typing.Optional[str] = None
+    urbanization: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ContactType:
+    email: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupAddressType:
+    firstName: typing.Optional[str] = None
+    lastName: typing.Optional[str] = None
+    firm: typing.Optional[str] = None
+    address: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    contact: typing.Optional[typing.List[ContactType]] = jstruct.JList[ContactType]
+
+
+@attr.s(auto_attribs=True)
+class PickupLocationType:
+    packageLocation: typing.Optional[str] = None
+    specialInstructions: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupRequestType:
+    pickupDate: typing.Optional[str] = None
+    pickupAddress: typing.Optional[PickupAddressType] = jstruct.JStruct[PickupAddressType]
+    packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+    estimatedWeight: typing.Optional[int] = None
+    pickupLocation: typing.Optional[PickupLocationType] = jstruct.JStruct[PickupLocationType]

karrio/schemas/usps/pickup_response.py

@@ -0,0 +1,58 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PackageType:
+    packageType: typing.Optional[str] = None
+    packageCount: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class AddressType:
+    streetAddress: typing.Optional[str] = None
+    streetAddressAbbreviation: typing.Optional[str] = None
+    secondaryAddress: typing.Optional[str] = None
+    cityAbbreviation: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    ZIPCode: typing.Optional[str] = None
+    ZIPPlus4: typing.Optional[str] = None
+    urbanization: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ContactType:
+    email: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupAddressType:
+    firstName: typing.Optional[str] = None
+    lastName: typing.Optional[str] = None
+    firm: typing.Optional[str] = None
+    address: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    contact: typing.Optional[typing.List[ContactType]] = jstruct.JList[ContactType]
+
+
+@attr.s(auto_attribs=True)
+class PickupLocationType:
+    packageLocation: typing.Optional[str] = None
+    specialInstructions: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CarrierPickupRequestType:
+    pickupDate: typing.Optional[str] = None
+    pickupAddress: typing.Optional[PickupAddressType] = jstruct.JStruct[PickupAddressType]
+    packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+    estimatedWeight: typing.Optional[int] = None
+    pickupLocation: typing.Optional[PickupLocationType] = jstruct.JStruct[PickupLocationType]
+
+
+@attr.s(auto_attribs=True)
+class PickupResponseType:
+    confirmationNumber: typing.Optional[str] = None
+    pickupDate: typing.Optional[str] = None
+    carrierPickupRequest: typing.Optional[CarrierPickupRequestType] = jstruct.JStruct[CarrierPickupRequestType]