karrio-postat 2026.1__py3-none-any.whl

karrio/providers/postat/utils.py

@@ -0,0 +1,54 @@
+"""Karrio PostAT provider utilities."""
+
+import attr
+import karrio.lib as lib
+import karrio.core as core
+
+
+@attr.s(auto_attribs=True)
+class Settings(core.Settings):
+    """PostAT connection settings."""
+
+    # Required credentials (from Austrian Post onboarding)
+    client_id: str
+    org_unit_id: str
+    org_unit_guid: str
+
+    # Generic settings
+    id: str = None
+    test_mode: bool = False
+    carrier_id: str = "postat"
+    account_country_code: str = "AT"
+    metadata: dict = {}
+    config: dict = {}
+
+    @property
+    def carrier_name(self):
+        return "postat"
+
+    @property
+    def server_url(self):
+        """Return the server URL.
+
+        Note: Austrian Post provides the URL during customer onboarding.
+        This should be configured via connection settings.
+        """
+        return (
+            self.connection_config.server_url.state
+            or "https://plc.post.at/Post.Webservice/ShippingService.svc"
+        )
+
+    @property
+    def tracking_url(self):
+        """Return the public tracking URL template for end users."""
+        return "https://www.post.at/sv/sendungssuche?snr={}"
+
+    @property
+    def connection_config(self) -> lib.units.Options:
+        """Return connection configuration options."""
+        from karrio.providers.postat.units import ConnectionConfig
+
+        return lib.to_connection_config(
+            self.config or {},
+            option_type=ConnectionConfig,
+        )