Product Picked

Notify WMS when a product has been picked from the WCS.

Direction WCS → WMS

HTTP Method POST

Path /pickTaskGroup/productPicked

Request Body

{
  "externalReferenceId": "8b2795a9-0c6c-4991-a764-5b9eb03c9d82",
  "externalCustomerBatchId": "BATCH12345",
  "externalCustomerOrderId": "ORDER12345",
  "externalGroupReference": "781b991b-b9f9-47e8-9292-9c172e436a1d",
  "externalReference": {
    "allocationReference": "ORDER12345_REF12345",
    "externalCustomerOrderId": "ORDER12345",
    "instructionGroupId": "781b991b-b9f9-47e8-9292-9c172e436a1d",
    "instructionId": "8b2795a9-0c6c-4991-a764-5b9eb03c9d82",
    "sku": "SKU12345"
  },
  "metadata": {"ALLOCATION_REFERENCE": "REF12345", "SKU": "SKU12345"},
  "taskId": "TASK12345",
  "taskGroupId": "TASKGROUP12345",
  "shipmentType": "Pick-Pack",
  "subBinId": "12345-11",
  "productId": "PROD12345",
  "barcode": "SKU12345",
  "sku": "SKU12345",
  "batch": "BATCH12345",
  "batchId": "BATCH12345",
  "expiry": "01-02-2027",
  "stockOwner": "OWNER12345",
  "pickedQuantity": 5,
  "allocationReference": "REF12345",
  "locationTo": "SHIP123456789",
  "unitIdentifiers": ["UNIT-0001", "UNIT-0002"],
  "operator": "User1",
  "port": "1",
  "pickedFromTime": "2026-06-19T10:05:42.490548421Z",
  "pickedToTime": "2026-06-19T10:05:52.520268716Z"
}

Field notes:

• metadata (object, optional): Key-value map of supplementary data. Not validated as required; WMS should expect it to be null or empty when nothing is set.
• unitIdentifiers (array of strings, optional): Serial numbers for unitary (individually tracked) products. Not validated as required; WMS should expect it to be null or empty for non-unitary stock.

Expected Responses

200: Product picked accepted

{
  "message": "Success"
}

400: Invalid request data

{
  "message": "Bad Request"
}

401: Authentication failed

{
  "message": "Unauthorized"
}