# Update shipment asset loading status by track identifier

Updates every asset-loading record in the shipment whose WMS identifier matches {trackIdentifier}. When the same pallet is attached to multiple manifests in the shipment, all rows are updated (one audit + timeline entry per manifest).

Endpoint: PATCH /integration/rest/api/v1/shipment/{shipmentExternalId}/asset-loading/track/{trackIdentifier}/status
Version: v0
Security: X-AUTH-KEY

## Path parameters:

  - `shipmentExternalId` (string, required)
    Shipment external identifier (preferred) or uuid.
    Example: "SHIP-2024-001"

  - `trackIdentifier` (string, required)
    Track identifier (WMS id).
    Example: "TRACK-123456"

## Request fields (application/json):

  - `status` (string, required)
    Enum: "NOT_LOADED", "LOADED", "WRONGLY_LOADED", "UNKNOWN_LOADING", "UNLOADED", "OFFLOADED"

  - `gateExternalId` (string)

## Response 200 fields (*/*):

  - `createDate` (string)

  - `updateDate` (string)

  - `deepLink` (string)
    Deep link URL to open this entity in Ops.App.

  - `track` (object)
    Track associated with this loading record.

  - `track.trackCode` (string)
    Unique track code.

  - `track.wmsId` (string)
    External asset identifier provided by WMS.

  - `track.status` (string)
    Current status of the track.
    Enum: "SCHEDULED_FOR_RETIREMENT", "ACTIVE", "NOT_ACTIVE", "FLAGGED"

  - `track.sku` (string)
    Assigned SKU value, or null when unassigned or the SKU feature is disabled.

  - `track.client` (object)
    Assigned Client, or null when unassigned or the Client feature is disabled.

  - `track.client.id` (string)
    Internal Client UUID.

  - `track.client.displayName` (string)
    Client display name.

  - `track.client.externalId` (string)
    Client external ID.

  - `track.wmsLocation` (string)
    Pallet location as reported by the client's WMS, or null when unset or the WMS Location feature is disabled.

  - `track.wmsLocationUpdatedAt` (string)
    Timestamp of the last WMS Location change, or null when no value is set or the WMS Location feature is disabled.

  - `gate` (object)
    Gate where the loading action was performed.

  - `gate.name` (string)
    Human-readable gate name.

  - `gate.externalIdentifier` (string)
    External unique identifier of the gate.

  - `gate.status` (string)
    Current operational status of the gate.
    Enum: "AVAILABLE", "LOADING", "OUT_OF_SERVICE"

  - `gate.gateType` (string)
    Gate type. SINGLE_MANIFEST allows one active manifest at a time; MULTI_MANIFEST allows several manifests active simultaneously.
    Enum: "SINGLE_MANIFEST", "MULTI_MANIFEST"

  - `trackIdentifier` (string)
    Business identifier of the track linked to this record.

  - `markerValue` (string)
    Marker value captured during the loading operation.

  - `loadedDate` (string)
    Date and time when the asset was marked as loaded.

  - `loadingStatus` (string)
    Current loading status of the asset.
    Enum: "NOT_LOADED", "LOADED", "WRONGLY_LOADED", "UNKNOWN_LOADING", "UNLOADED", "OFFLOADED"

## Response 400 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 403 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 404 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 500 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id