POST /api/order/create-order HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "customerId": 1,
  "orderStatusId": 1,
  "paymentStatusId": 2,
  "productList": [
    {
      "productId": 1,
      "skuId": 1,
      "quantity": 1,
      "price": "79.99"
    }
  ]
}

{
  "status": 1,
  "message": "Resource created successfully",
  "data": {
    "orderId": 1,
    "orderPrefixId": "ORD-0001",
    "orderStatusId": 1,
    "total": "79.99"
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Orders

Create or process Order Create Order

Post /api/order/create-order

Authentication: Vendor bearer token required for protected operations; verify exact permission decorator in controller.

Feature area: Orders

Implementation source: src/api/vendor/controllers/OrderController.ts

Request example provenance: Illustrative order body; actual create-order validation may require customer, address, shipping and payment fields.

Response example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.

Example status: Illustrative. The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.

POST

api

order

create-order

POST /api/order/create-order HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "customerId": 1,
  "orderStatusId": 1,
  "paymentStatusId": 2,
  "productList": [
    {
      "productId": 1,
      "skuId": 1,
      "quantity": 1,
      "price": "79.99"
    }
  ]
}

{
  "status": 1,
  "message": "Resource created successfully",
  "data": {
    "orderId": 1,
    "orderPrefixId": "ORD-0001",
    "orderStatusId": 1,
    "total": "79.99"
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Authorizations

Authorization

string

header

required

Paste the JWT access token returned by the corresponding login endpoint.

Body

application/json

Sample request body. Illustrative order body; actual create-order validation may require customer, address, shipping and payment fields. Treat this as an illustrative example, not a complete DTO contract.

customerId

integer

orderStatusId

integer

paymentStatusId

integer

productList

object[]

Show child attributes

Response

Successful response. Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema. Example is illustrative and does not guarantee a stable response contract.

status

integer

message

string

data

object

Show child attributes

Store API

Vendor API

Create or process Order Create Order

Authorizations

Body

Response