Tow and Impound

This example connects an existing tow or impound resource to CAD. Requests created by an officer or another in-game system appear with the vehicle, plate, location, requester, and status. A dispatcher can accept or complete a request in CAD, and the resource applies that workflow change for in-game tow operators. Tow and Impound custom integration panel

Tow and Impound custom integration panel

How It Connects

Install or update the panel definition when the resource is configured.
On resource start, publish every pending and assigned request plus the current summary.
Publish again when an in-game request is created, assigned, cancelled, or completed.
Receive pushes for tow.accept and tow.complete actions. Apply them through the tow resource, acknowledge them, then publish the updated request list.

Game-Side Outline

Push is the primary delivery path. The scheduling and processPanelActionOnce functions below are pseudocode supplied by your integration; they are not SDK helpers. processPanelActionOnce records the completed result, acknowledges it, retries failed acknowledgements without repeating the effect, and returns true only after acknowledgement succeeds. Use one serial queue for both paths and keep the backup polling cursor separate from pushed actions. See Action Push Events for routing, deduplication, acknowledgement, and recovery rules. The following is server-side pseudocode. Adapt the events and function names to your tow resource and preferred API library.

onResourceStart(function()
  setIntegrationPanel("example.tow-requests", definition)
  publishPanelState(readCurrentTowRequests())
end)

-- Includes requests created or updated by officers and tow operators.
onTowRequestChanged(function()
  publishPanelState(readCurrentTowRequests())
end)

-- Shared serialized processing; the helper deduplicates in-flight/completed IDs,
-- retries acknowledgements without repeating effects, and rejects expired actions.
local function processAction(event)
  return processPanelActionOnce(event, function()
    local success

    if event.actionId == "tow.accept" then
      success = towResource.acceptRequest(event.values.requestId)
    elseif event.actionId == "tow.complete" then
      success = towResource.completeRequest(event.values.requestId)
    end

    if success then publishPanelState(readCurrentTowRequests()) end
    return success
  end)
end

AddEventHandler("SonoranCAD::pushevents:OtherEvent", function(eventType, event)
  if eventType == "EVENT_PANEL_EXAMPLE.TOW-REQUESTS" then
    processAction(event)
  end
end)

-- Backup only. Share three requests/minute across all panels and servers.
every20Seconds(function()
  local response = pollPanelActions({ after = cursor })
  for _, event in ipairs(response.events) do
    if not processAction(event) then return end
  end
  cursor = response.nextCursor -- Only after every polled action is acknowledged.
end)

See Set State, Poll Actions, and Acknowledge Action for copyable calls in every supported library.

Actions

Action ID	Purpose
`tow.accept`	Assign the selected request.
`tow.complete`	Mark an assigned request complete.

Definition JSON

Open the raw definition

Copy the complete definition

{
  "schemaVersion": 1,
  "key": "example.tow-requests",
  "name": "Tow & Impound",
  "icon": "fas fa-truck-pickup",
  "surfaces": ["dispatch", "police"],
  "body": [
    {
      "type": "row",
      "gap": "sm",
      "children": [
        { "type": "badge", "label": "Pending: {{state.summary.pending}}", "appearance": "primary" },
        { "type": "badge", "label": "Assigned: {{state.summary.assigned}}", "appearance": "info" },
        { "type": "badge", "label": "Completed today: {{state.summary.completed}}", "appearance": "positive" }
      ]
    },
    {
      "type": "repeat",
      "source": "$state.requests",
      "emptyText": "No tow requests",
      "layout": "grid",
      "minItemWidth": 300,
      "gap": "sm",
      "search": {
        "placeholder": "Search plate, vehicle, or location",
        "fields": ["plate", "vehicle", "location", "requester", "status"]
      },
      "sort": {
        "label": "Order",
        "default": "priority",
        "options": [
          {
            "label": "Pending first",
            "value": "priority",
            "rules": [
              { "path": "status", "order": ["PENDING", "ASSIGNED", "COMPLETED"] },
              { "path": "createdAt", "direction": "asc" }
            ]
          },
          {
            "label": "Newest first",
            "value": "newest",
            "rules": [{ "path": "createdAt", "direction": "desc" }]
          },
          {
            "label": "Plate A-Z",
            "value": "plate",
            "rules": [{ "path": "plate", "direction": "asc" }]
          }
        ]
      },
      "children": [
        {
          "type": "section",
          "style": {
            "borderColor": "$item.color",
            "borderStyle": "solid",
            "borderWidth": "1px",
            "borderRadius": "6px",
            "minHeight": "166px"
          },
          "children": [
            {
              "type": "row",
              "align": "center",
              "children": [
                { "type": "icon", "icon": "fas fa-truck-pickup", "color": "$item.color" },
                { "type": "text", "text": "$item.plate", "variant": "title", "grow": true },
                { "type": "badge", "label": "$item.status", "appearance": "$item.appearance" }
              ]
            },
            { "type": "text", "text": "$item.vehicle" },
            { "type": "text", "text": "$item.location", "appearance": "muted" },
            { "type": "text", "text": "Requested by {{item.requester}}", "variant": "caption", "appearance": "muted" },
            {
              "type": "button",
              "label": "Accept request",
              "icon": "fas fa-check",
              "appearance": "primary",
              "visibleWhen": { "path": "$item.pending", "equals": true },
              "action": {
                "id": "tow.accept",
                "values": { "requestId": "$item.id" }
              }
            },
            {
              "type": "button",
              "label": "Mark complete",
              "icon": "fas fa-flag-checkered",
              "appearance": "positive",
              "visibleWhen": { "path": "$item.assigned", "equals": true },
              "action": {
                "id": "tow.complete",
                "values": { "requestId": "$item.id" }
              }
            }
          ]
        }
      ]
    }
  ]
}

Example State

Open the raw state

Copy the example state

{
  "summary": { "pending": 2, "assigned": 1, "completed": 8 },
  "requests": [
    { "id": "tow-1042", "plate": "46EJX219", "vehicle": "Vapid Stanier · Black", "location": "Alta St / Vespucci Blvd", "requester": "1A-12", "status": "PENDING", "createdAt": "2026-08-25T18:12:00Z", "pending": true, "assigned": false, "color": "primary", "appearance": "primary" },
    { "id": "tow-1043", "plate": "83KLM550", "vehicle": "Bravado Bison · White", "location": "Route 68 / Joshua Rd", "requester": "2L-04", "status": "PENDING", "createdAt": "2026-08-25T18:16:00Z", "pending": true, "assigned": false, "color": "primary", "appearance": "primary" },
    { "id": "tow-1039", "plate": "29QRS118", "vehicle": "Karin Sultan · Blue", "location": "Mission Row Impound", "requester": "1B-31 · Tow 7", "status": "ASSIGNED", "createdAt": "2026-08-25T17:54:00Z", "pending": false, "assigned": true, "color": "blue", "appearance": "info" }
  ]
}

Start here

Tutorials

Integration Capabilities

Pricing

Roadmap

Other

How It Connects

Game-Side Outline

Actions

Definition JSON

Example State

​How It Connects

​Game-Side Outline

​Actions

​Definition JSON

​Example State

How It Connects

Game-Side Outline

Actions

Definition JSON

Example State