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: standard, express, fast, tiktok
label_ship	url	Conditional	Nhãn giao hàng: Bắt buộc cho option tiktok
address1	string	Optional	Đị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	Optional	Mã bang / tỉnh
country	string	Optional	Quốc gia
country_code	string	Required	Mã quốc gia (ISO)
postal_code	string	Optional	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	Optional	SKU nội bộ hệ thống
quantity	number	Required	min > 0 và max < 1000
title	string	Optional	Tên sản phẩm
note	string	Optional	Ghi chú
mockup1..mockup4	url	Optional	URL hình mockup
design1..design4	url	Optional	URL file thiết kế
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
line_items	Tối đa 500 items
line_items[].quantity	min > 0 và max < 1000

---

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": "",
      "mockup1": "https://example.com/mockup1.png",
      "mockup2": "",
      "mockup3": "",
      "mockup4": "",
      "design1": "https://example.com/design1.png",
      "design2": "",
      "design3": "",
      "design4": "",
      "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
}

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ợ.