karrio-aramex 2025.5.6__py3-none-any.whl → 2026.1__py3-none-any.whl

karrio/providers/aramex/tracking.py

@@ -22,6 +22,7 @@ from karrio.core.models import (
 from karrio.providers.aramex.utils import Settings
 from karrio.providers.aramex.error import parse_error_response
 import karrio.lib as lib
+import karrio.providers.aramex.units as provider_units
 
 
 def parse_tracking_response(
@@ -70,6 +71,15 @@ def _extract_detail(node: Element, settings: Settings) -> TrackingDetails:
                 location=detail.UpdateLocation,
                 code=detail.UpdateCode,
                 time=DF.ftime(detail.UpdateDateTime, "%Y-%m-%dT%H:%M:%S"),
+                timestamp=lib.fiso_timestamp(detail.UpdateDateTime, current_format="%Y-%m-%dT%H:%M:%S"),
+                reason=next(
+                    (
+                        r.name
+                        for r in list(provider_units.TrackingIncidentReason)
+                        if detail.UpdateCode in r.value
+                    ),
+                    None,
+                ),
             )
         ],
     )

karrio/providers/aramex/units.py

@@ -1,5 +1,33 @@
 """ Aramex Native Types """
 
+import karrio.lib as lib
+
+
+class TrackingIncidentReason(lib.Enum):
+    """Maps Aramex exception codes to normalized TrackingIncidentReason."""
+    carrier_damaged_parcel = ["DMG", "DAMAGE", "DAMAGED"]
+    carrier_sorting_error = ["MISROUTE"]
+    carrier_parcel_lost = ["LOST"]
+    carrier_vehicle_issue = ["DELAY", "VEHICLE"]
+
+    consignee_refused = ["REFUSED", "REF", "REJECT"]
+    consignee_business_closed = ["CLOSED", "BUSINESS_CLOSED"]
+    consignee_not_home = ["NOTHOME", "NH", "NOT_HOME"]
+    consignee_incorrect_address = ["BADADDR", "INCORRECT", "WRONG_ADDRESS"]
+    consignee_access_restricted = ["NOACCESS", "RESTRICTED"]
+
+    customs_delay = ["CUSTOMS", "CUSTOMSHOLD", "CUSTOMS_DELAY"]
+    customs_documentation = ["CUSTOMSDOC", "CUSTOMS_DOCUMENTS"]
+    customs_duties_unpaid = ["CUSTOMS_UNPAID", "DUTIES"]
+
+    weather_delay = ["WEATHER"]
+
+    delivery_exception_hold = ["HOLD", "ONHOLD", "HELD"]
+    delivery_exception_undeliverable = ["UNDELIVERABLE", "UNABLE"]
+
+    unknown = []
+
+
 # import karrio.lib as lib
 # from karrio.core.utils import Enum, Flag
 #
@@ -44,3 +72,4 @@
 #     carrier_signature = "SIGNATURE CODE"
 #     carrier_saturday_delivery = "SATURDAY DELIVERY CODE"
 #     carrier_dry_ice = "DRY ICE CODE"
+#

{karrio_aramex-2025.5.6.dist-info → karrio_aramex-2026.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: karrio_aramex
-Version: 2025.5.6
+Version: 2026.1
 Summary: Karrio - Aramex Shipping extension
 Author-email: karrio <hello@karrio.io>
 License-Expression: LGPL-3.0

{karrio_aramex-2025.5.6.dist-info → karrio_aramex-2026.1.dist-info}/RECORD

@@ -5,8 +5,8 @@ karrio/mappers/aramex/settings.py,sha256=AiZqzV4EdkyCxesd4_5P12PhpPwHJTKss0NZLep
 karrio/plugins/aramex/__init__.py,sha256=j8em87e7q4zE2nzqLCgYNBOLqw6F1xhqeXGlFkz930w,738
 karrio/providers/aramex/__init__.py,sha256=BvDtqrLi7p1-b3snGShCe1_t0VweA4wETUPUPYu5bn0,763
 karrio/providers/aramex/error.py,sha256=VDP-lXuvjpJpi6tuOlnnb3vjJQGAEi_FVsuALr3PlqM,785
-karrio/providers/aramex/tracking.py,sha256=JzlnT0ugA4xuhMIjQoGdd-iAYeuLIzA6sZDUsTtOf6E,3225
-karrio/providers/aramex/units.py,sha256=LTr8McraaOI7NcQrjGnkxgt0MdGRpqsogpF7a_P9oPY,1372
+karrio/providers/aramex/tracking.py,sha256=dz-FtOTevBbf-hnBwj7-4qgYHwNTM_XghMdjPR-n-XU,3668
+karrio/providers/aramex/units.py,sha256=3ukNweec1X60kwM3BVtKufIezhMYeuR-_b180NUKm98,2372
 karrio/providers/aramex/utils.py,sha256=VDhZPqtmARxE85nAMgzCwNlb88mh4LeMxFyzhafkZV0,1419
 karrio/schemas/aramex/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 karrio/schemas/aramex/array_of_string.py,sha256=Y2AkB07s520YDOriN-1uHdYpbBXvjinzPkhF4gwuCk8,166211
@@ -15,8 +15,8 @@ karrio/schemas/aramex/location.py,sha256=hqbZoII1TxqPOu6lr9IQFoCiKj4t0uujTCDe2wd
 karrio/schemas/aramex/rates.py,sha256=eamY44eEN6E1R4MJbQaHl8m8iZB7skr_1Ikap9vBqgk,271093
 karrio/schemas/aramex/shipping.py,sha256=1CLQBZvXXhpPX3X_2Db5LmgmeI6N_oMZzfM2_iBgAIE,587577
 karrio/schemas/aramex/tracking.py,sha256=8hD1EtXkY8OVn3W-LbMIjaAL_85IE381dtiX1Xk1vGw,200865
-karrio_aramex-2025.5.6.dist-info/METADATA,sha256=cxUbPi7_KBlycnvGiDM9ABtAB50TOynuNqi-R3rgPxQ,984
-karrio_aramex-2025.5.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-karrio_aramex-2025.5.6.dist-info/entry_points.txt,sha256=I7amJuU5RsCm02LEQamkDdguaGqV7C9Hmi2IkhQwTg8,57
-karrio_aramex-2025.5.6.dist-info/top_level.txt,sha256=FZCY8Nwft8oEGHdl--xku8P3TrnOxu5dETEU_fWpRSM,20
-karrio_aramex-2025.5.6.dist-info/RECORD,,
+karrio_aramex-2026.1.dist-info/METADATA,sha256=xOXlT1IQb9Aal02l-4Gg06Fxj-fqL9RToh8Vn6fgR8o,982
+karrio_aramex-2026.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+karrio_aramex-2026.1.dist-info/entry_points.txt,sha256=I7amJuU5RsCm02LEQamkDdguaGqV7C9Hmi2IkhQwTg8,57
+karrio_aramex-2026.1.dist-info/top_level.txt,sha256=FZCY8Nwft8oEGHdl--xku8P3TrnOxu5dETEU_fWpRSM,20
+karrio_aramex-2026.1.dist-info/RECORD,,