Import an Inspection Task Group

Import a JSON representation of an Inspection task group.

Direction WMS → WCS

HTTP Method POST

Path /api/task/inspection/import

Request Body

Field notes:

Field Name	Data Type	Description	Notes
externalReference	String	A reference ID for the task group	Must not be null and contain at least 1 non-whitespace character
taskCategory	String	Category of inspection task group	Allowed values: inspection, count
expectedCompletionTime	String	Expected completion date/time in format yyyy-MM-dd HH:mm	Not required; if present, expected format is yyyy-MM-dd HH:mm
timeZone	String	Time zone for the expectedCompletionTime	Not required; if present, values can be "GMT", "UTC" etc
inspectionTasks	Object Array	Inspection data, this list contains all of the sub-bins that should be inspected
inspectionTasks.subBinId	String	The location identifier for the physical bin-compartment (sub-bin) within the Autostore to be inspected	Required, Inspection tasks must be completed against a particular SubBin
inspectionTasks.productId	String	A Unique product identifier for the product to be inspected	Can be null
inspectionTasks.batchId	String	The batch identifier for a specific batch-managed product that is to be inspected	Can be null
inspectionTasks.expiry	String	The expiry date for a specific date-managed product that is to be inspected	Can be null
inspectionTasks.stockOwner	String	The stock owner identifier for a specific owner-managed product that is to be inspected	Can be null
inspectionTasks.flagged	String	Flag/reason for inspection	Can be null

Example Request Body

{
  "externalReference": "fab1c6cc-4f32-4a34-a73c-94c9e83eb838",
  "taskCategory": "200",
  "expectedCompletionTime": "2026-01-31 14:30",
  "timeZone": "Europe/London",
  "inspectionTasks": {
    "binId": "BIN-12345",
    "subBinId": "SB-12345-11",
    "productId": "PROD12345",
    "batchId": "BATCH12345",
    "expiry": "2027-01-01",
    "stockOwner": "OWNER12345",
    "flagged": "QC Check Required",
  }
}

Responses

202: Inspection task group import request accepted

{
  "message": "Accepted"
}

400: Inspection task group import failed validation

{
  "message": "Bad Request",
  "errors": [
    {
      "message": "Task field externalReference must not be null and contain at least 1 non-whitespace character",
      "path": "externalReference"
    },
    {
      "message": "Inspection taskCategory must not be null and contain at least 1 non-whitespace character",
      "path": "taskCategory"
    },
    {
      "message": "Task field inspectionTasks must not be empty",
      "path": "inspectionTasks"
    }
  ]
}

401: Access denied, Invalid Authentication

{
  "message": "Unauthorized"
}