# Create dealer order

**POST /orders**

Single entry point for dealer-app order creation (VTP, GHTK, J&T, Grab). Gọi bằng API key bị giới hạn 1 đơn / 2 phút mỗi đại lý (429 kèm `Retry-After`); phiên đăng nhập trên app không bị siết.


## Servers
- Production: https://api-dealer.dilisupplement.com/api (Production)



## Parameters



### Body: application/json (object)

- **sender_id** (string)
  Dealer sender profile UUID. Optional for PICKUP_AT_COMPANY (sender may be empty); required for other carriers.

- **customer_name** (string)
  Customer full name. Skipped for PICKUP_AT_COMPANY (backend fills from dealer).

- **customer_phone** (string)
  Customer phone. Skipped for PICKUP_AT_COMPANY.

- **customer_address** (string)
  Customer street address. Skipped for PICKUP_AT_COMPANY.

- **receiver_province_id** (number)
  VTP receiver province id

- **receiver_district_id** (number)
  VTP receiver district id

- **receiver_ward_id** (number)
  VTP receiver ward id

- **receiver_province** (string)
  Receiver province name

- **receiver_district** (string)
  Receiver district name

- **receiver_ward** (string)
  Receiver ward name

- **items** (array[object])
  Order line items (≥1)

- **carrier** (number)
  Shipping carrier. Defaults to VTP for backward compatibility.

- **order_service** (string)
  Carrier service code (e.g., VTP service)

- **order_payment** (number)
  Who pays ship fee

- **product_weight** (number)
  Product weight in grams

- **money_collection** (number)
  COD money to collect on delivery

- **prepaid_amount** (string)
  Prepaid amount (decimal string)

- **notes** (string)
  Internal note

- **order_service_add** (string)
  Extra carrier service options

- **is_draft** (boolean)
  Save as draft (skip carrier API submit)

- **is_use_carton** (boolean)
  Đơn có dùng thùng carton hay không. Bỏ trống → suy ra từ carrier (Grab / lấy tại công ty = không dùng).



## Responses
### 201
Order created with tracking number

### 429
Vượt hạn mức tạo đơn qua API key — `ORDER_CREATE_RATE_LIMIT_EXCEEDED`


[Powered by Bump.sh](https://bump.sh)