karrio-mydhl 2025.5rc7__py3-none-any.whl

karrio/providers/mydhl/utils.py

@@ -0,0 +1,92 @@
+
+import base64
+import datetime
+import karrio.lib as lib
+import karrio.core as core
+import karrio.core.errors as errors
+
+
+class Settings(core.Settings):
+    """MyDHL provider settings."""
+
+    username: str
+    password: str
+    account_number: str
+
+    @property
+    def carrier_name(self):
+        return "mydhl"
+
+    @property
+    def server_url(self):
+        return "https://express.api.dhl.com"
+
+    @property
+    def authorization(self):
+        """Basic Authentication header for DHL Express API."""
+        pair = f"{self.username}:{self.password}"
+        return base64.b64encode(pair.encode("utf-8")).decode("ascii")
+
+    @property
+    def connection_config(self) -> lib.units.Options:
+        return lib.to_connection_config(
+            self.config or {},
+            option_type=ConnectionConfig,
+        )
+
+#     """uncomment the following code block to implement the oauth login."""
+#     @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"]
+
+# """uncomment the following code block to implement the oauth login."""
+# def login(settings: Settings):
+#     import karrio.providers.mydhl.error as error
+
+#     result = lib.request(
+#         url=f"{settings.server_url}/oauth/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,
+#             )
+#         ),
+#     )
+
+#     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)}
+
+
+class ConnectionConfig(lib.Enum):
+    """MyDHL connection configuration options."""
+    label_type = lib.OptionEnum("label_type", str, "PDF")
+    label_template = lib.OptionEnum("label_template", str, "ECOM26_84_A4_001")
+    shipping_options = lib.OptionEnum("shipping_options", list)
+    shipping_services = lib.OptionEnum("shipping_services", list)

karrio/schemas/mydhl/address_validation_request.py

@@ -0,0 +1,13 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AddressValidationRequestType:
+    type: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    postalCode: typing.Optional[int] = None
+    cityName: typing.Optional[str] = None
+    countyName: typing.Optional[str] = None
+    strictValidation: typing.Optional[bool] = None

karrio/schemas/mydhl/address_validation_response.py

@@ -0,0 +1,25 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ServiceAreaType:
+    code: typing.Optional[str] = None
+    description: typing.Optional[str] = None
+    GMTOffset: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class AddressType:
+    countryCode: typing.Optional[str] = None
+    postalCode: typing.Optional[int] = None
+    cityName: typing.Optional[str] = None
+    countyName: typing.Optional[str] = None
+    serviceArea: typing.Optional[ServiceAreaType] = jstruct.JStruct[ServiceAreaType]
+
+
+@attr.s(auto_attribs=True)
+class AddressValidationResponseType:
+    warnings: typing.Optional[typing.List[str]] = None
+    address: typing.Optional[typing.List[AddressType]] = jstruct.JList[AddressType]

karrio/schemas/mydhl/error_response.py

@@ -0,0 +1,13 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponseType:
+    instance: typing.Optional[str] = None
+    detail: typing.Optional[str] = None
+    title: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    status: typing.Optional[int] = None
+    additionalDetails: typing.Optional[typing.List[str]] = None

karrio/schemas/mydhl/pickup_cancel_request.py

@@ -0,0 +1,10 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PickupCancelRequestType:
+    dispatchConfirmationNumber: typing.Optional[str] = None
+    requestorName: typing.Optional[str] = None
+    reason: typing.Optional[str] = None

karrio/schemas/mydhl/pickup_cancel_response.py

@@ -0,0 +1,8 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PickupCancelResponseType:
+    message: typing.Optional[str] = None

karrio/schemas/mydhl/pickup_create_request.py

@@ -0,0 +1,108 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AccountType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class ContactInformationType:
+    email: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    mobilePhone: typing.Optional[str] = None
+    companyName: typing.Optional[str] = None
+    fullName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PostalAddressType:
+    postalCode: typing.Optional[int] = None
+    cityName: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    provinceCode: typing.Optional[str] = None
+    addressLine1: typing.Optional[str] = None
+    addressLine2: typing.Optional[str] = None
+    addressLine3: typing.Optional[str] = None
+    countyName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class RegistrationNumberType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[str] = None
+    issuerCountryCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DetailsType:
+    postalAddress: typing.Optional[PostalAddressType] = jstruct.JStruct[PostalAddressType]
+    contactInformation: typing.Optional[ContactInformationType] = jstruct.JStruct[ContactInformationType]
+    registrationNumbers: typing.Optional[typing.List[RegistrationNumberType]] = jstruct.JList[RegistrationNumberType]
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomerDetailsType:
+    shipperDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    receiverDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    bookingRequestorDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    pickupDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+
+
+@attr.s(auto_attribs=True)
+class DimensionsType:
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class PackageType:
+    typeCode: typing.Optional[str] = None
+    weight: typing.Optional[float] = None
+    dimensions: typing.Optional[DimensionsType] = jstruct.JStruct[DimensionsType]
+
+
+@attr.s(auto_attribs=True)
+class ValueAddedServiceType:
+    serviceCode: typing.Optional[str] = None
+    localServiceCode: typing.Optional[str] = None
+    value: typing.Optional[int] = None
+    currency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentDetailType:
+    productCode: typing.Optional[str] = None
+    localProductCode: typing.Optional[str] = None
+    accounts: typing.Optional[typing.List[AccountType]] = jstruct.JList[AccountType]
+    valueAddedServices: typing.Optional[typing.List[ValueAddedServiceType]] = jstruct.JList[ValueAddedServiceType]
+    isCustomsDeclarable: typing.Optional[bool] = None
+    declaredValue: typing.Optional[int] = None
+    declaredValueCurrency: typing.Optional[str] = None
+    unitOfMeasurement: typing.Optional[str] = None
+    shipmentTrackingNumber: typing.Optional[int] = None
+    packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+
+
+@attr.s(auto_attribs=True)
+class SpecialInstructionType:
+    value: typing.Optional[str] = None
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupCreateRequestType:
+    plannedPickupDateAndTime: typing.Optional[str] = None
+    closeTime: typing.Optional[str] = None
+    location: typing.Optional[str] = None
+    locationType: typing.Optional[str] = None
+    accounts: typing.Optional[typing.List[AccountType]] = jstruct.JList[AccountType]
+    specialInstructions: typing.Optional[typing.List[SpecialInstructionType]] = jstruct.JList[SpecialInstructionType]
+    remark: typing.Optional[str] = None
+    customerDetails: typing.Optional[CustomerDetailsType] = jstruct.JStruct[CustomerDetailsType]
+    shipmentDetails: typing.Optional[typing.List[ShipmentDetailType]] = jstruct.JList[ShipmentDetailType]

karrio/schemas/mydhl/pickup_create_response.py

@@ -0,0 +1,11 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PickupCreateResponseType:
+    dispatchConfirmationNumbers: typing.Optional[typing.List[str]] = None
+    readyByTime: typing.Optional[str] = None
+    nextPickupDate: typing.Optional[str] = None
+    warnings: typing.Optional[typing.List[str]] = None

karrio/schemas/mydhl/pickup_update_request.py

@@ -0,0 +1,110 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AccountType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class ContactInformationType:
+    email: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    mobilePhone: typing.Optional[str] = None
+    companyName: typing.Optional[str] = None
+    fullName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PostalAddressType:
+    postalCode: typing.Optional[int] = None
+    cityName: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    provinceCode: typing.Optional[str] = None
+    addressLine1: typing.Optional[str] = None
+    addressLine2: typing.Optional[str] = None
+    addressLine3: typing.Optional[str] = None
+    countyName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class RegistrationNumberType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[str] = None
+    issuerCountryCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DetailsType:
+    postalAddress: typing.Optional[PostalAddressType] = jstruct.JStruct[PostalAddressType]
+    contactInformation: typing.Optional[ContactInformationType] = jstruct.JStruct[ContactInformationType]
+    registrationNumbers: typing.Optional[typing.List[RegistrationNumberType]] = jstruct.JList[RegistrationNumberType]
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomerDetailsType:
+    shipperDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    receiverDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    bookingRequestorDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+    pickupDetails: typing.Optional[DetailsType] = jstruct.JStruct[DetailsType]
+
+
+@attr.s(auto_attribs=True)
+class DimensionsType:
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class PackageType:
+    typeCode: typing.Optional[str] = None
+    weight: typing.Optional[float] = None
+    dimensions: typing.Optional[DimensionsType] = jstruct.JStruct[DimensionsType]
+
+
+@attr.s(auto_attribs=True)
+class ValueAddedServiceType:
+    serviceCode: typing.Optional[str] = None
+    localServiceCode: typing.Optional[str] = None
+    value: typing.Optional[int] = None
+    currency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentDetailType:
+    productCode: typing.Optional[str] = None
+    localProductCode: typing.Optional[str] = None
+    accounts: typing.Optional[typing.List[AccountType]] = jstruct.JList[AccountType]
+    valueAddedServices: typing.Optional[typing.List[ValueAddedServiceType]] = jstruct.JList[ValueAddedServiceType]
+    isCustomsDeclarable: typing.Optional[bool] = None
+    declaredValue: typing.Optional[int] = None
+    declaredValueCurrency: typing.Optional[str] = None
+    unitOfMeasurement: typing.Optional[str] = None
+    shipmentTrackingNumber: typing.Optional[int] = None
+    packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+
+
+@attr.s(auto_attribs=True)
+class SpecialInstructionType:
+    value: typing.Optional[str] = None
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupUpdateRequestType:
+    dispatchConfirmationNumber: typing.Optional[str] = None
+    originalShipperAccountNumber: typing.Optional[int] = None
+    plannedPickupDateAndTime: typing.Optional[str] = None
+    closeTime: typing.Optional[str] = None
+    location: typing.Optional[str] = None
+    locationType: typing.Optional[str] = None
+    accounts: typing.Optional[typing.List[AccountType]] = jstruct.JList[AccountType]
+    specialInstructions: typing.Optional[typing.List[SpecialInstructionType]] = jstruct.JList[SpecialInstructionType]
+    remark: typing.Optional[str] = None
+    customerDetails: typing.Optional[CustomerDetailsType] = jstruct.JStruct[CustomerDetailsType]
+    shipmentDetails: typing.Optional[typing.List[ShipmentDetailType]] = jstruct.JList[ShipmentDetailType]

karrio/schemas/mydhl/pickup_update_response.py

@@ -0,0 +1,11 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class PickupUpdateResponseType:
+    dispatchConfirmationNumber: typing.Optional[str] = None
+    readyByTime: typing.Optional[str] = None
+    nextPickupDate: typing.Optional[str] = None
+    warnings: typing.Optional[typing.List[str]] = None

karrio/schemas/mydhl/rate_request.py

@@ -0,0 +1,114 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class AccountType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class ContactInformationType:
+    email: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    mobilePhone: typing.Optional[str] = None
+    companyName: typing.Optional[str] = None
+    fullName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PostalAddressType:
+    postalCode: typing.Optional[int] = None
+    cityName: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    provinceCode: typing.Optional[str] = None
+    addressLine1: typing.Optional[str] = None
+    addressLine2: typing.Optional[str] = None
+    addressLine3: typing.Optional[str] = None
+    countyName: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class RegistrationNumberType:
+    typeCode: typing.Optional[str] = None
+    number: typing.Optional[str] = None
+    issuerCountryCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ErDetailsType:
+    postalAddress: typing.Optional[PostalAddressType] = jstruct.JStruct[PostalAddressType]
+    contactInformation: typing.Optional[ContactInformationType] = jstruct.JStruct[ContactInformationType]
+    registrationNumbers: typing.Optional[typing.List[RegistrationNumberType]] = jstruct.JList[RegistrationNumberType]
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomerDetailsType:
+    shipperDetails: typing.Optional[ErDetailsType] = jstruct.JStruct[ErDetailsType]
+    receiverDetails: typing.Optional[ErDetailsType] = jstruct.JStruct[ErDetailsType]
+
+
+@attr.s(auto_attribs=True)
+class EstimatedDeliveryDateType:
+    isRequested: typing.Optional[bool] = None
+    typeCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class MonetaryAmountType:
+    typeCode: typing.Optional[str] = None
+    value: typing.Optional[int] = None
+    currency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DimensionsType:
+    length: typing.Optional[int] = None
+    width: typing.Optional[int] = None
+    height: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class PackageType:
+    typeCode: typing.Optional[str] = None
+    weight: typing.Optional[float] = None
+    dimensions: typing.Optional[DimensionsType] = jstruct.JStruct[DimensionsType]
+
+
+@attr.s(auto_attribs=True)
+class ValueAddedServiceType:
+    serviceCode: typing.Optional[str] = None
+    value: typing.Optional[int] = None
+    currency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ProductsAndServiceType:
+    productCode: typing.Optional[str] = None
+    localProductCode: typing.Optional[str] = None
+    valueAddedServices: typing.Optional[typing.List[ValueAddedServiceType]] = jstruct.JList[ValueAddedServiceType]
+
+
+@attr.s(auto_attribs=True)
+class RateRequestType:
+    customerDetails: typing.Optional[CustomerDetailsType] = jstruct.JStruct[CustomerDetailsType]
+    accounts: typing.Optional[typing.List[AccountType]] = jstruct.JList[AccountType]
+    productCode: typing.Optional[str] = None
+    localProductCode: typing.Optional[str] = None
+    valueAddedServices: typing.Optional[typing.List[ValueAddedServiceType]] = jstruct.JList[ValueAddedServiceType]
+    productsAndServices: typing.Optional[typing.List[ProductsAndServiceType]] = jstruct.JList[ProductsAndServiceType]
+    payerCountryCode: typing.Optional[str] = None
+    plannedShippingDateAndTime: typing.Optional[str] = None
+    unitOfMeasurement: typing.Optional[str] = None
+    isCustomsDeclarable: typing.Optional[bool] = None
+    monetaryAmount: typing.Optional[typing.List[MonetaryAmountType]] = jstruct.JList[MonetaryAmountType]
+    requestAllValueAddedServices: typing.Optional[bool] = None
+    returnStandardProductsOnly: typing.Optional[bool] = None
+    nextBusinessDay: typing.Optional[bool] = None
+    productTypeCode: typing.Optional[str] = None
+    packages: typing.Optional[typing.List[PackageType]] = jstruct.JList[PackageType]
+    estimatedDeliveryDate: typing.Optional[EstimatedDeliveryDateType] = jstruct.JStruct[EstimatedDeliveryDateType]
+    getAdditionalInformation: typing.Optional[typing.List[EstimatedDeliveryDateType]] = jstruct.JList[EstimatedDeliveryDateType]

karrio/schemas/mydhl/rate_response.py

@@ -0,0 +1,143 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ExchangeRateType:
+    currentExchangeRate: typing.Optional[float] = None
+    currency: typing.Optional[str] = None
+    baseCurrency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DeliveryCapabilitiesType:
+    deliveryTypeCode: typing.Optional[str] = None
+    estimatedDeliveryDateAndTime: typing.Optional[str] = None
+    destinationServiceAreaCode: typing.Optional[str] = None
+    destinationFacilityAreaCode: typing.Optional[str] = None
+    deliveryAdditionalDays: typing.Optional[int] = None
+    deliveryDayOfWeek: typing.Optional[int] = None
+    totalTransitDays: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class PriceBreakdownType:
+    priceType: typing.Optional[str] = None
+    typeCode: typing.Optional[str] = None
+    price: typing.Optional[int] = None
+    rate: typing.Optional[int] = None
+    basePrice: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class BreakdownType:
+    name: typing.Optional[str] = None
+    serviceCode: typing.Optional[str] = None
+    localServiceCode: typing.Optional[str] = None
+    typeCode: typing.Optional[str] = None
+    serviceTypeCode: typing.Optional[str] = None
+    price: typing.Optional[float] = None
+    priceCurrency: typing.Optional[str] = None
+    isCustomerAgreement: typing.Optional[bool] = None
+    isMarketedService: typing.Optional[bool] = None
+    isBillingServiceIndicator: typing.Optional[bool] = None
+    priceBreakdown: typing.Optional[typing.List[PriceBreakdownType]] = jstruct.JList[PriceBreakdownType]
+    tariffRateFormula: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DetailedPriceBreakdownType:
+    currencyType: typing.Optional[str] = None
+    priceCurrency: typing.Optional[str] = None
+    breakdown: typing.Optional[typing.List[BreakdownType]] = jstruct.JList[BreakdownType]
+
+
+@attr.s(auto_attribs=True)
+class PickupCapabilitiesType:
+    nextBusinessDay: typing.Optional[bool] = None
+    localCutoffDateAndTime: typing.Optional[str] = None
+    GMTCutoffTime: typing.Optional[str] = None
+    pickupEarliest: typing.Optional[str] = None
+    pickupLatest: typing.Optional[str] = None
+    originServiceAreaCode: typing.Optional[str] = None
+    originFacilityAreaCode: typing.Optional[str] = None
+    pickupAdditionalDays: typing.Optional[int] = None
+    pickupDayOfWeek: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class ServiceCodeType:
+    serviceCode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class DependencyRuleGroupType:
+    dependencyRuleName: typing.Optional[str] = None
+    dependencyDescription: typing.Optional[str] = None
+    dependencyCondition: typing.Optional[str] = None
+    requiredServiceCodes: typing.Optional[typing.List[ServiceCodeType]] = jstruct.JList[ServiceCodeType]
+
+
+@attr.s(auto_attribs=True)
+class ServiceCodeDependencyRuleGroupType:
+    dependentServiceCode: typing.Optional[str] = None
+    dependencyRuleGroup: typing.Optional[typing.List[DependencyRuleGroupType]] = jstruct.JList[DependencyRuleGroupType]
+
+
+@attr.s(auto_attribs=True)
+class ServiceCodeMutuallyExclusiveGroupType:
+    serviceCodeRuleName: typing.Optional[str] = None
+    description: typing.Optional[str] = None
+    serviceCodes: typing.Optional[typing.List[ServiceCodeType]] = jstruct.JList[ServiceCodeType]
+
+
+@attr.s(auto_attribs=True)
+class TotalPriceType:
+    currencyType: typing.Optional[str] = None
+    priceCurrency: typing.Optional[str] = None
+    price: typing.Optional[float] = None
+
+
+@attr.s(auto_attribs=True)
+class TotalPriceBreakdownType:
+    currencyType: typing.Optional[str] = None
+    priceCurrency: typing.Optional[str] = None
+    priceType: typing.Optional[str] = None
+    price: typing.Optional[int] = None
+    rate: typing.Optional[int] = None
+    basePrice: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class WeightType:
+    volumetric: typing.Optional[int] = None
+    provided: typing.Optional[float] = None
+    unitOfMeasurement: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ProductType:
+    productName: typing.Optional[str] = None
+    productCode: typing.Optional[str] = None
+    localProductCode: typing.Optional[str] = None
+    localProductCountryCode: typing.Optional[str] = None
+    networkTypeCode: typing.Optional[str] = None
+    isCustomerAgreement: typing.Optional[bool] = None
+    weight: typing.Optional[WeightType] = jstruct.JStruct[WeightType]
+    totalPrice: typing.Optional[typing.List[TotalPriceType]] = jstruct.JList[TotalPriceType]
+    totalPriceBreakdown: typing.Optional[typing.List[TotalPriceBreakdownType]] = jstruct.JList[TotalPriceBreakdownType]
+    detailedPriceBreakdown: typing.Optional[typing.List[DetailedPriceBreakdownType]] = jstruct.JList[DetailedPriceBreakdownType]
+    serviceCodeMutuallyExclusiveGroups: typing.Optional[typing.List[ServiceCodeMutuallyExclusiveGroupType]] = jstruct.JList[ServiceCodeMutuallyExclusiveGroupType]
+    serviceCodeDependencyRuleGroups: typing.Optional[typing.List[ServiceCodeDependencyRuleGroupType]] = jstruct.JList[ServiceCodeDependencyRuleGroupType]
+    pickupCapabilities: typing.Optional[PickupCapabilitiesType] = jstruct.JStruct[PickupCapabilitiesType]
+    deliveryCapabilities: typing.Optional[DeliveryCapabilitiesType] = jstruct.JStruct[DeliveryCapabilitiesType]
+    items: typing.Optional[typing.List[typing.Any]] = None
+    pricingDate: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class RateResponseType:
+    products: typing.Optional[typing.List[ProductType]] = jstruct.JList[ProductType]
+    exchangeRates: typing.Optional[typing.List[ExchangeRateType]] = jstruct.JList[ExchangeRateType]
+    warnings: typing.Optional[typing.List[str]] = None