karrio-hermes 2026.1__py3-none-any.whl

karrio/schemas/hermes/__init__.py

@@ -0,0 +1,43 @@
+from karrio.schemas.hermes.error_response import (
+    ErrorResponseType,
+    ListOfResultCodeType,
+)
+from karrio.schemas.hermes.shipment_request import (
+    ShipmentRequestType,
+    ErAddressType as ReceiverAddressType,
+    ErNameType as ReceiverNameType,
+    ReceiverContactType,
+    ParcelType,
+    ServiceType,
+    CustomsAndTaxesType,
+    ItemType,
+    ClientType,
+    FiscalRepresentationAddressType,
+    ShipmentOriginAddressType,
+    CashOnDeliveryServiceType,
+    CustomerAlertServiceType,
+    IdentServiceType,
+    MultipartServiceType,
+    ParcelShopDeliveryServiceType,
+    StatedDayServiceType,
+    StatedTimeServiceType,
+)
+from karrio.schemas.hermes.shipment_response import (
+    ShipmentResponseType,
+    ShipmentLabelDataType,
+    AddressType as LabelAddressType,
+    CarrierType,
+    OriginType,
+    ServiceDescriptionType,
+    EntityType,
+    HintType,
+)
+from karrio.schemas.hermes.pickup_create_request import (
+    PickupCreateRequestType,
+    PickupAddressType,
+    PickupNameType,
+    ParcelCountType,
+)
+from karrio.schemas.hermes.pickup_create_response import PickupCreateResponseType
+from karrio.schemas.hermes.pickup_cancel_request import PickupCancelRequestType
+from karrio.schemas.hermes.pickup_cancel_response import PickupCancelResponseType

karrio/schemas/hermes/error_response.py

@@ -0,0 +1,14 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ListOfResultCodeType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponseType:
+    listOfResultCodes: typing.Optional[typing.List[ListOfResultCodeType]] = jstruct.JList[ListOfResultCodeType]

karrio/schemas/hermes/pickup_cancel_request.py

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

karrio/schemas/hermes/pickup_cancel_response.py

@@ -0,0 +1,15 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ListOfResultCodeType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupCancelResponseType:
+    listOfResultCodes: typing.Optional[typing.List[ListOfResultCodeType]] = jstruct.JList[ListOfResultCodeType]
+    pickupOrderID: typing.Optional[str] = None

karrio/schemas/hermes/pickup_create_request.py

@@ -0,0 +1,41 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ParcelCountType:
+    pickupParcelCountXS: typing.Optional[int] = None
+    pickupParcelCountS: typing.Optional[int] = None
+    pickupParcelCountM: typing.Optional[int] = None
+    pickupParcelCountL: typing.Optional[int] = None
+    pickupParcelCountXL: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupAddressType:
+    street: typing.Optional[str] = None
+    houseNumber: typing.Optional[str] = None
+    zipCode: typing.Optional[str] = None
+    town: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    addressAddition: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupNameType:
+    title: typing.Optional[str] = None
+    gender: typing.Optional[str] = None
+    firstname: typing.Optional[str] = None
+    middlename: typing.Optional[str] = None
+    lastname: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupCreateRequestType:
+    pickupAddress: typing.Optional[PickupAddressType] = jstruct.JStruct[PickupAddressType]
+    pickupName: typing.Optional[PickupNameType] = jstruct.JStruct[PickupNameType]
+    phone: typing.Optional[str] = None
+    pickupDate: typing.Optional[str] = None
+    pickupTimeSlot: typing.Optional[str] = None
+    parcelCount: typing.Optional[ParcelCountType] = jstruct.JStruct[ParcelCountType]

karrio/schemas/hermes/pickup_create_response.py

@@ -0,0 +1,15 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ListOfResultCodeType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PickupCreateResponseType:
+    listOfResultCodes: typing.Optional[typing.List[ListOfResultCodeType]] = jstruct.JList[ListOfResultCodeType]
+    pickupOrderID: typing.Optional[str] = None

karrio/schemas/hermes/shipment_request.py

@@ -0,0 +1,195 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class FiscalRepresentationAddressType:
+    company: typing.Optional[str] = None
+    street: typing.Optional[str] = None
+    houseNumber: typing.Optional[str] = None
+    zipCode: typing.Optional[str] = None
+    town: typing.Optional[str] = None
+    addressAddition: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    mobile: typing.Optional[str] = None
+    mail: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ClientType:
+    eoriNumber: typing.Optional[str] = None
+    iossId: typing.Optional[str] = None
+    vatId: typing.Optional[str] = None
+    zazAccount: typing.Optional[str] = None
+    fiscalRepresentationAddress: typing.Optional[FiscalRepresentationAddressType] = jstruct.JStruct[FiscalRepresentationAddressType]
+
+
+@attr.s(auto_attribs=True)
+class ItemType:
+    sku: typing.Optional[str] = None
+    category: typing.Optional[str] = None
+    countryCodeOfManufacture: typing.Optional[str] = None
+    value: typing.Optional[int] = None
+    weight: typing.Optional[int] = None
+    quantity: typing.Optional[int] = None
+    description: typing.Optional[str] = None
+    exportDescription: typing.Optional[str] = None
+    exportHsCode: typing.Optional[str] = None
+    hsCode: typing.Optional[str] = None
+    url: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentOriginAddressType:
+    title: typing.Optional[str] = None
+    firstname: typing.Optional[str] = None
+    lastname: typing.Optional[str] = None
+    company: typing.Optional[str] = None
+    street: typing.Optional[str] = None
+    houseNumber: typing.Optional[str] = None
+    zipCode: typing.Optional[str] = None
+    town: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    addressAddition: typing.Optional[str] = None
+    addressAddition2: typing.Optional[str] = None
+    addressAddition3: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    fax: typing.Optional[str] = None
+    mobile: typing.Optional[str] = None
+    mail: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomsAndTaxesType:
+    currency: typing.Optional[str] = None
+    shipmentCost: typing.Optional[int] = None
+    items: typing.Optional[typing.List[ItemType]] = jstruct.JList[ItemType]
+    invoiceReferences: typing.Optional[typing.List[str]] = None
+    value: typing.Optional[int] = None
+    exportCustomsClearance: typing.Optional[bool] = None
+    client: typing.Optional[ClientType] = jstruct.JStruct[ClientType]
+    shipmentOriginAddress: typing.Optional[ShipmentOriginAddressType] = jstruct.JStruct[ShipmentOriginAddressType]
+
+
+@attr.s(auto_attribs=True)
+class ParcelType:
+    parcelClass: typing.Optional[str] = None
+    parcelHeight: typing.Optional[int] = None
+    parcelWidth: typing.Optional[int] = None
+    parcelDepth: typing.Optional[int] = None
+    parcelWeight: typing.Optional[int] = None
+    parcelVolume: typing.Optional[int] = None
+    productType: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ErAddressType:
+    street: typing.Optional[str] = None
+    houseNumber: typing.Optional[str] = None
+    zipCode: typing.Optional[str] = None
+    town: typing.Optional[str] = None
+    countryCode: typing.Optional[str] = None
+    addressAddition: typing.Optional[str] = None
+    addressAddition2: typing.Optional[str] = None
+    addressAddition3: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ReceiverContactType:
+    phone: typing.Optional[str] = None
+    mobile: typing.Optional[str] = None
+    mail: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ErNameType:
+    title: typing.Optional[str] = None
+    gender: typing.Optional[str] = None
+    firstname: typing.Optional[str] = None
+    middlename: typing.Optional[str] = None
+    lastname: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CashOnDeliveryServiceType:
+    currency: typing.Optional[str] = None
+    amount: typing.Optional[float] = None
+    bankTransferAmount: typing.Optional[float] = None
+    bankTransferCurrency: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomerAlertServiceType:
+    notificationType: typing.Optional[str] = None
+    notificationEmail: typing.Optional[str] = None
+    notificationNumber: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class IdentServiceType:
+    identID: typing.Optional[str] = None
+    identType: typing.Optional[str] = None
+    identVerifyFsk: typing.Optional[str] = None
+    identVerifyBirthday: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class MultipartServiceType:
+    partNumber: typing.Optional[int] = None
+    numberOfParts: typing.Optional[int] = None
+    parentShipmentOrderID: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ParcelShopDeliveryServiceType:
+    psCustomerFirstName: typing.Optional[str] = None
+    psCustomerLastName: typing.Optional[str] = None
+    psID: typing.Optional[str] = None
+    psSelectionRule: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class StatedDayServiceType:
+    statedDay: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class StatedTimeServiceType:
+    timeSlot: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ServiceType:
+    tanService: typing.Optional[bool] = None
+    multipartService: typing.Optional[MultipartServiceType] = jstruct.JStruct[MultipartServiceType]
+    limitedQuantitiesService: typing.Optional[bool] = None
+    cashOnDeliveryService: typing.Optional[CashOnDeliveryServiceType] = jstruct.JStruct[CashOnDeliveryServiceType]
+    bulkGoodService: typing.Optional[bool] = None
+    statedTimeService: typing.Optional[StatedTimeServiceType] = jstruct.JStruct[StatedTimeServiceType]
+    householdSignatureService: typing.Optional[bool] = None
+    customerAlertService: typing.Optional[CustomerAlertServiceType] = jstruct.JStruct[CustomerAlertServiceType]
+    parcelShopDeliveryService: typing.Optional[ParcelShopDeliveryServiceType] = jstruct.JStruct[ParcelShopDeliveryServiceType]
+    compactParcelService: typing.Optional[bool] = None
+    identService: typing.Optional[IdentServiceType] = jstruct.JStruct[IdentServiceType]
+    statedDayService: typing.Optional[StatedDayServiceType] = jstruct.JStruct[StatedDayServiceType]
+    nextDayService: typing.Optional[bool] = None
+    signatureService: typing.Optional[bool] = None
+    redirectionProhibitedService: typing.Optional[bool] = None
+    excludeParcelShopAuthorization: typing.Optional[bool] = None
+    lateInjectionService: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentRequestType:
+    clientReference: typing.Optional[str] = None
+    clientReference2: typing.Optional[str] = None
+    receiverName: typing.Optional[ErNameType] = jstruct.JStruct[ErNameType]
+    receiverAddress: typing.Optional[ErAddressType] = jstruct.JStruct[ErAddressType]
+    receiverContact: typing.Optional[ReceiverContactType] = jstruct.JStruct[ReceiverContactType]
+    senderName: typing.Optional[ErNameType] = jstruct.JStruct[ErNameType]
+    senderAddress: typing.Optional[ErAddressType] = jstruct.JStruct[ErAddressType]
+    parcel: typing.Optional[ParcelType] = jstruct.JStruct[ParcelType]
+    service: typing.Optional[ServiceType] = jstruct.JStruct[ServiceType]
+    customsAndTaxes: typing.Optional[CustomsAndTaxesType] = jstruct.JStruct[CustomsAndTaxesType]

karrio/schemas/hermes/shipment_response.py

@@ -0,0 +1,97 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class ListOfResultCodeType:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CarrierType:
+    id: typing.Optional[str] = None
+    name: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class AddressType:
+    title: typing.Optional[str] = None
+    addressLine1: typing.Optional[str] = None
+    addressLine2: typing.Optional[str] = None
+    addressLine3: typing.Optional[str] = None
+    addressLine4: typing.Optional[str] = None
+    addressLine5: typing.Optional[str] = None
+    addressLine6: typing.Optional[str] = None
+    addressLine7: typing.Optional[str] = None
+    addressLine8: typing.Optional[str] = None
+    addressLine9: typing.Optional[str] = None
+    addressLine10: typing.Optional[str] = None
+    postcode: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class EntityType:
+    title: typing.Optional[str] = None
+    value: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class HintType:
+    type: typing.Optional[str] = None
+    text: typing.Optional[str] = None
+    line1: typing.Optional[str] = None
+    line2: typing.Optional[str] = None
+    line3: typing.Optional[str] = None
+    line4: typing.Optional[str] = None
+    line5: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class OriginType:
+    line01: typing.Optional[str] = None
+    line02: typing.Optional[str] = None
+    line03: typing.Optional[str] = None
+    line04: typing.Optional[str] = None
+    line05: typing.Optional[str] = None
+    line06: typing.Optional[str] = None
+    line07: typing.Optional[str] = None
+    line08: typing.Optional[str] = None
+    line09: typing.Optional[str] = None
+    line10: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ServiceDescriptionType:
+    serviceDescriptionText: typing.Optional[str] = None
+    serviceLogoRef: typing.Optional[str] = None
+    servicePosition: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentLabelDataType:
+    clientAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    senderAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    destinationAddress: typing.Optional[AddressType] = jstruct.JStruct[AddressType]
+    carrier1: typing.Optional[CarrierType] = jstruct.JStruct[CarrierType]
+    carrier2: typing.Optional[CarrierType] = jstruct.JStruct[CarrierType]
+    origin: typing.Optional[OriginType] = jstruct.JStruct[OriginType]
+    serviceDescriptions: typing.Optional[typing.List[ServiceDescriptionType]] = jstruct.JList[ServiceDescriptionType]
+    entities: typing.Optional[typing.List[EntityType]] = jstruct.JList[EntityType]
+    customerReference1: typing.Optional[str] = None
+    customerReference2: typing.Optional[str] = None
+    clientLogoRef: typing.Optional[str] = None
+    hint: typing.Optional[HintType] = jstruct.JStruct[HintType]
+    weightLogoRef: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentResponseType:
+    listOfResultCodes: typing.Optional[typing.List[ListOfResultCodeType]] = jstruct.JList[ListOfResultCodeType]
+    shipmentID: typing.Optional[str] = None
+    shipmentOrderID: typing.Optional[str] = None
+    labelImage: typing.Optional[str] = None
+    commInvoiceImage: typing.Optional[str] = None
+    labelMediatype: typing.Optional[str] = None
+    shipmentLabelData: typing.Optional[ShipmentLabelDataType] = jstruct.JStruct[ShipmentLabelDataType]

karrio_hermes-2026.1.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: karrio_hermes
+Version: 2026.1
+Summary: Karrio - Hermes Shipping Extension
+Author-email: karrio <hello@karrio.io>
+License-Expression: LGPL-3.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.11
+Description-Content-Type: text/markdown
+Requires-Dist: karrio
+
+# karrio.hermes
+
+This package is a Hermes extension of the [karrio](https://pypi.org/project/karrio) multi carrier shipping SDK.
+
+## Requirements
+
+`Python 3.11+`
+
+## Installation
+
+```bash
+pip install karrio.hermes
+```
+
+## Usage
+
+```python
+import karrio.sdk as karrio
+from karrio.mappers.hermes.settings import Settings
+
+
+# Initialize a carrier gateway
+hermes = karrio.gateway["hermes"].create(
+    Settings(
+        ...
+    )
+)
+```
+
+Check the [Karrio Mutli-carrier SDK docs](https://docs.karrio.io) for Shipping API requests

karrio_hermes-2026.1.dist-info/RECORD

@@ -0,0 +1,27 @@
+karrio/mappers/hermes/__init__.py,sha256=3WcvIpOkQAy1p54BhLGfmi1hyY9Dhe0qSG2yZY9mPes,145
+karrio/mappers/hermes/mapper.py,sha256=0fZbXPHGg5R4bbhRyJbzfEGNiKXSINW1FJQnhz-4MRM,2258
+karrio/mappers/hermes/proxy.py,sha256=FG_OcaMEXiZxZp37m25pgrOtcdCziVk3Kft9HjoEnT8,2858
+karrio/mappers/hermes/settings.py,sha256=4BTM7ncSQqTBP6J_oJTksBDGhaFHOWoHDnpq0iOWHVo,1151
+karrio/plugins/hermes/__init__.py,sha256=zUfOhtzuErd1H1ICL4rQt68e6BWRQf_B6_kW5UVzd9M,1020
+karrio/providers/hermes/__init__.py,sha256=lwP0P714ipPISsbd_6xXZ4oaCK32yTEHktP8yxmF4NQ,490
+karrio/providers/hermes/error.py,sha256=YWmYC_l7_nyJCxiqM0Kgf6yV9IpJ04tkdZyyMT7QnkY,2974
+karrio/providers/hermes/units.py,sha256=MO1ap8ItQUlwfTTx7_CqxJqx96KY-FyLm4pMSIXRg8g,8665
+karrio/providers/hermes/utils.py,sha256=84N70gICmOmP2vjYmnzJbjzLhFaEHvXLKgHALZiE-2k,3077
+karrio/providers/hermes/pickup/__init__.py,sha256=E59ks-qJAsNmfQgaZ7X0tZuBetITsdRSMJUAZnqxabg,307
+karrio/providers/hermes/pickup/cancel.py,sha256=JYVGL9decPB0QOHsjrYU5cwT_4vzrpsaEjapC9F3t7A,1587
+karrio/providers/hermes/pickup/create.py,sha256=q4AbBqI-_oXglD2DffJpqBp93zZo2hz-gf32DtX5lg8,3556
+karrio/providers/hermes/shipment/__init__.py,sha256=B_zc5eaS4st1bnIyB_RwYY9XJJ9DyjB1Tb0SaIEJRJ8,209
+karrio/providers/hermes/shipment/create.py,sha256=UcKTavylyrdbeFmzXY7pqCUI1lfOxmMO2Cr07xoB1YY,13046
+karrio/schemas/hermes/__init__.py,sha256=yw5kUm6WMQ_UJEVW-LQUY-916m7Y-qxp0yLbqIMb2b4,1272
+karrio/schemas/hermes/error_response.py,sha256=BJhI7P8wursdYsYACfDLT8cs-bsnKlJDs0OzurYMPR4,343
+karrio/schemas/hermes/pickup_cancel_request.py,sha256=rZgm3BpL3iziO_TC_y-cAELMsWjXyvRYWmXYyExhdR0,148
+karrio/schemas/hermes/pickup_cancel_response.py,sha256=9-STL_Aq0EvXWrNMfvc4DiPK658e1JPp0uhW695XOGI,397
+karrio/schemas/hermes/pickup_create_request.py,sha256=0V14LMl0XVLOZ_zXRzoTLUZ8nB_TZHCmr2G03NPl4tw,1375
+karrio/schemas/hermes/pickup_create_response.py,sha256=sAgq92J0TZOUolhMcvDkp6qSRvxOqWCIZHNQWQN7KeU,397
+karrio/schemas/hermes/shipment_request.py,sha256=FMqrSlCDG4eGDkuqPDc_DDCbtV_vGRyrRBFCiNTFkmM,7415
+karrio/schemas/hermes/shipment_response.py,sha256=BI2kUemG-wTzAFpok9KEnlwjm6eK_LemBA_Cyga_e6A,3477
+karrio_hermes-2026.1.dist-info/METADATA,sha256=yF6_59XBxGBqORO5gj9Gjp5TJTdk4GOUJ_TxlGzA4eE,980
+karrio_hermes-2026.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+karrio_hermes-2026.1.dist-info/entry_points.txt,sha256=R8XDrYBqWXTPqaO0iTi4Buz8iQiiBiuHkJVNtZIXTkU,57
+karrio_hermes-2026.1.dist-info/top_level.txt,sha256=9Nasa6abG7pPPG8MGzlemnqw1ohIqgouzQ7HGBnOFLg,27
+karrio_hermes-2026.1.dist-info/RECORD,,

karrio_hermes-2026.1.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_hermes-2026.1.dist-info/entry_points.txt

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

karrio_hermes-2026.1.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+dist
+karrio
+schemas
+vendor