Create Consolidation for Customer

Overview

{
  "name": "Create Consolidation",
  "route": "POST /customer/consolidation",
  "description": "Create a consolidation request.",
  "parameters": [],
  "body": {
    "schema": {
      "from_parcels": "number[]"
    },
    "example": {
      "from_parcels": [1, 2, 3]
    }
  },
  "response": {
    "success": {
      "code": 200,
      "description": "Returns the created consolidation object"
    },
    "error": [
      {
        "code": 400,
        "description": "Bad Request - Invalid input (e.g., less than 2 parcels, parcels from different warehouses)"
      },
      {
        "code": 401,
        "description": "Unauthorized - User is not authenticated"
      },
      {
        "code": 403,
        "description": "Forbidden - User does not have permission to create a consolidation"
      },
      {
        "code": 404,
        "description": "Not Found - One or more parcels not found or don't belong to the customer"
      }
    ]
  },
  "notes": [
    "This endpoint requires authentication (InternalGuard and AuthorizationGuard).",
    "All parcels must be from the same warehouse and in 'Received' status."
  ]
}