API tạo đơn hàng

Tạo đơn hàng thủ công

API : /api/integration/orders.json

Method: POST

Request Header

key	value
X-pawdo-access-token	API KEY

---

Request Body (JSON - raw)

• Content-Type: application/json

key	type	required	note
order_number	string	Required	Mã đơn hàng, phải unique
external_transaction_id	string	Optional	ID giao dịch từ hệ thống ngoài
skip_verify_address	boolean	Optional	Bỏ qua bước verify địa chỉ
line_items	array object	Required	Danh sách sản phẩm, tối đa 500 items
address	object	Required	Thông tin địa chỉ giao hàng

---

Chi tiết field

address

key	type	required	note
name	string	Required	Tên người nhận
option_ship	string	Required	Phương thức vận chuyển. Danh sách giá trị do hệ thống Pawdo cấu hình (động), phổ biến gồm: standard, express, fast, tiktok, saving.
label_ship	url	Conditional	Nhãn giao hàng. Bắt buộc cho option tiktok
address1	string	Required	Địa chỉ dòng 1
address2	string	Optional	Địa chỉ dòng 2
city	string	Optional	Thành phố
state	string	Optional	Bang /Tỉnh
province_code	string	Required	Mã bang / tỉnh
country	string	Optional	Quốc gia
country_code	string	Required	Mã quốc gia (ISO)
postal_code	string	Required	Mã bưu điện
email	string	Optional	Email người nhận
phone	string	Optional	Số điện thoại

---

line_items

key	type	required	note
sku	string	Optional	SKU từ hệ thống ngoài
system_sku	string	Required	SKU nội bộ hệ thống, phải khớp với 1 SKU đang active trong catalog của store
quantity	number	Required	min > 0 và max < 1000
title	string	Optional	Tên sản phẩm
note	string	Optional	Ghi chú
designs	array object	Optional	Danh sách thiết kế/mockup của line item, tối đa 15 phần tử. Mỗi phần tử gồm: key (string, định danh slot, ví dụ design1, design2...), design (url, optional — file thiết kế), mockup (url, optional — hình mockup)
option1..option3	string	Optional	Tùy chọn sản phẩm
external_line_item_id	string	Optional	ID line item từ hệ thống ngoài

---

Ràng buộc / Validation

key	rule
order_number	Phải unique, dùng như idempotency key. Nếu đã tồn tại, API trả lỗi 409 Conflict với message order existed
line_items	Tối đa 500 items
line_items[].system_sku	Bắt buộc, phải khớp SKU đang active trong catalog
line_items[].quantity	min > 0 và max < 1000
address.address1, address.province_code, address.postal_code, address.country_code, address.name, address.option_ship	Bắt buộc

---

Example (Request)

{
  "order_number": "#ORDER-056487",
  "external_transaction_id": "TS-9283023921",
  "skip_verify_address": true,
  "line_items": [
    {
      "sku": "QTR-XS2",
      "system_sku": "QTR-XS2",
      "quantity": 5,
      "title": "",
      "note": "",
      "designs": [ 
        { 
          "key": "design1",
          "design": "https://example.com/design1.png", 
          "mockup": "https://example.com/mockup1.png"
        } 
      ], 
      "option1": "",
      "option2": "",
      "option3": "",
      "external_line_item_id": "LI-1048273842"
    }
  ],
  "address": {
    "name": "John Doe",
    "option_ship": "standard",
    "label_ship": "",
    "address1": "123 Main Street",
    "address2": "Apartment 4B",
    "city": "Los Angeles",
    "province_code": "CA",
    "country": "United States",
    "country_code": "US",
    "postal_code": "90001",
    "email": "[email protected]",
    "phone": ""
  }
}

Example (Response thành công)

{
  "data": {
    "order_id": "d33e0745-***-9fb1-01ac3e5135c3"
  },
  "message": "ok",
  "status": true
}

Example (Response lỗi)

status code	message	note
400	bad request	body sai định dạng hoặc thiếu field required (order_number, line_items, address.name, address.option_ship, address.address1, address.province_code, address.country_code, address.postal_code, line_items[].system_sku, line_items[].quantity)
400	unsupported shipping option	option_ship không khớp option nào đang active trong hệ thống
409	order existed	order_number đã tồn tại trong store
422	invalid system sku: <giá trị>	system_sku không khớp SKU nào đang active trong catalog của store

Nếu có bất kỳ vấn đề nào liên quan đến api đơn hàng, vui lòng liên hệ với bộ phận support của Pawdo qua Facebook để được hỗ trợ.