External Customer Order Cancelled

Notify WMS when an external customer order has been cancelled.

Direction WCS → WMS

HTTP Method POST

Path /order/cancelled

Request Body

{
  "externalCustomerOrderId": "CUST-ORDER-789",
  "externalCustomerBatchId": "BATCH-ABC-001",
  "cancelledAt": "2024-12-01T16:30:00Z",
  "cancelledBy": "customer.service",
  "cancellationReason": "CUSTOMER_REQUEST",
  "source": "WCS",
  "affectedTaskGroups": [
    {
      "taskGroupId": "TG-2024-001",
      "externalReference": "ORDER-2024-001",
      "status": "CANCELLED"
    }
  ],
  "notes": "Customer requested cancellation due to delivery address change"
}

Responses

200: Order cancellation notification accepted

400: Invalid request data

401: Authentication failed

Success Response (200)

{
  "message": "External customer order cancellation processed",
  "externalCustomerOrderId": "CUST-ORDER-789",
  "affectedTaskGroups": 1,
  "status": "SUCCESS"
}

Error Response (400)

{
  "message": "Validation failed",
  "errors": [
    "externalCustomerOrderId is required",
    "cancellationReason must be valid"
  ]
}