Active Parts Movements

Dashboard-style list: every trip that has been picked up and not yet dropped off. Not tied to a specific rego — a standalone lookup, e.g. for a "Return Trips In Progress" screen.

Endpoint

Same shared endpoint as every doc in this spec:

• Dev: https://www.zohoapis.com.au/creator/custom/clientportal/Mobile_Kratos_Incoming_handler_DEV?publickey=xxxxxxxxxxxxxxxxxxxx
• Method: POST

---

fetch_active_parts_movement

Payload

 {
    "payload": {
      "event_type": "fetch_active_parts_movement",
      "user_email": "{{userEmail}}"
    }
 }

Field	Required	Notes
movement_type	—	"direct" | "reverse"; omit for both

Criteria (server-side)

Movement_Status is a two-value picklist ("Parts Picked Up", "Parts Dropped off"), so "picked up, not yet dropped off" is a single, unambiguous filter:

active_movements = Parts_Movement[
		Picked_Up_By == user_id &&
		Movement_Status != "Parts Dropped off"
	] sort by Added_Time desc;

Response

{
  "result": {
    "data": {
      "movements": [
        {
          "picked_up_by": 10875000013945262,
          "pick_up_date_time": "2026-07-29 20:58:19.0",
          "parts_count": 2,
          "movement_type": "direct",
          "claim_id": "10875000027867880",
          "parts": [
            {
              "description": "",
              "pickup": true,
              "delivery": false,
              "parts_order_id": "10875000028057200"
            },
            {
              "description": "",
              "pickup": true,
              "delivery": false,
              "parts_order_id": "10875000028057202"
            }
          ],
          "movement_status": "Parts Picked Up",
          "delivery_location": {
            "name": "10875000020622521",
            "id": "10875000020622521"
          },
          "parts_movement_id": "10875000030266285",
          "rego": "TN38AU6602"
        }
      ]
    },
    "status": "success"
  },
  "code": 3000
}

Field	Notes
parts_movement_id	Not required to complete the trip via mobile — searching the rego again is the normal path. Returned for display/debugging
delivery_location	Repair_Shop for Direct, Crash_Claim_HQ for Reverse
parts_count	Count of Deliver_Parts linked to this movement with Pickup == true

An empty movements: [] is a valid success response ("nothing in transit right now"), not an error.

Error cases

Condition	result.text
Invalid movement_type value	"Invalid movement_type — must be 'direct' or 'reverse'."