Tạo đơn hàng với sản phẩm đã có SKU
Sau khi các developer của đối tác submit Sitemap trên Tini console. Tiki Mini App sẽ hỗ trợ đối tác để crawl các sản phẩm có trong Tini App của đối tác. Từ đó, các sản phẩm sẽ được đẩy trực tiếp lên hệ thống của Tiki với mỗi sản phẩm là một SKU xác định. API này sẽ giúp đối tác tạo đơn hàng với các sản phẩm đó
Thông tin HTTP
Key | Value |
---|---|
Content-Type | application/json |
Method | POST |
Base URL | https://api.tiki.vn/tiniapp-open-api |
Path | /order/multi-sku |
Request gửi đi phải kèm chữ ký điện tử nhằm đảm bảo tính xác thực. Tham khảo Cách tạo chữ ký điện tử.
HTTP Request
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
---|---|---|---|
customer_id | string | ✓ | ID người dùng Tiki, có thể lấy ở đây |
items | []Item | ✓ | Danh sách sản phẩm |
customer_info | CustomerInfo | ✕ | Thông tin khách hàng, dùng để hiện thị trên trang thanh toán Tiki (phần Thông tin khách hàng) |
extra | string | ✕ | Thông tin bổ sung theo định dạng key=value; key=value |
reference_id | string | ✕ | ID đơn hàng của đối tác |
Lưu ý
- Giá trị đơn hàng tối đa là mười triệu (10.000.000) đồng. Nếu muốn thay đổi thì cần yêu cầu ở Tini Console.
- Khi đối tác tạo đơn hàng với API này, đối tác cần truyền đầy đủ SKU của từng item mà đối tác nhận đặt từ khách hàng.
- Để sử dụng thử API ở sandbox đối tác vẫn cần liên kết tài khoản seller center và gửi yêu cầu mở tính năng thanh toán.
- Trường hợp đối tác chưa có sản phẩm được crawl: đối tác có thể sử dụng SKU được cấp cho app của đối tác để sử dụng thử API.
- Trường hợp đối tác đã có sản phẩm được crawl và đã xuất hiện trên Tiki: đối tác có thể sử dụng trực tiếp các sản phẩm có SKU này.
CustomerInfo
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Not Null | Mô tả |
---|---|---|---|---|
name | string | ✕ | ✓ | Tên khách hàng |
phone | string | ✕ | ✓ | Số điện thoại khách hàng |
string | ✕ | ✓ | Email khách hàng | |
street | string | ✕ | ✓ | Địa chỉ khách hàng |
Item
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
---|---|---|---|
name | string | ✓ | Tên sản phẩm |
sku | string | ✓ | SKU sản phẩm |
quantity | int64 | ✓ | Số lượng sản phẩm |
image_url | string | ✕ | Đường dẫn URL của ảnh sản phẩm |
extra | string | ✕ | Thông tin bổ sung theo định dạng key=value; key=value |
metadata | Metadata | ✕ | Các thông tin chi tiết liên quan đến sản phẩm |
Metadata
Metadata gồm nhiều section.
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
---|---|---|---|
sections | []Section | ✓ | Danh sách các section |
Section
Mỗi section sẽ gồm một header, một hoặc nhiều field.
Thuộc tính | Kiểu dữ liệu | Mô tả |
---|---|---|
header | string | Tiêu đề của section |
fields | []Field | Danh sách field nằm trong section đó |
Field
Field tương đương một thuộc tính tuỳ biến liên quan đến sản phẩm do đối tác định nghĩa. Sau đây là các thuộc tính của field:
Thuộc tính | Kiểu dữ liệu | Mô tả |
---|---|---|
type | string | Kiểu dữ liệu của field |
name | string | Tên field |
value | Any | Giá trị của field |
Ví dụ về metadata
{
"metadata": {
"sections": [
{
"header": "Thông tin bên gửi",
"fields": [
{
"type": "text",
"name": "Địa chỉ",
"value": "285 Cách Mạng Tháng 8, Phường 12 , Quận 10, TP Hồ Chí Minh."
},
{
"type": "text",
"name": "Người gửi",
"value": "Nguyễn Văn A"
},
{
"type": "text",
"name": "Số điện thoại",
"value": "0761234567"
}
]
},
{
"header": "Thông tin bên nhận",
"fields": [
{
"type": "text",
"name": "Địa chỉ",
"value": "52 Út Tịch, Phường 4, Quận Tân Bình, TP Hồ Chí Minh"
},
{
"type": "text",
"name": "Người nhận",
"value": "Trần Văn B"
},
{
"type": "text",
"name": "Số điện thoại",
"value": "0961234567"
}
]
},
{
"header": "Thông tin món hàng",
"fields": [
{
"type": "text",
"name": "Khối lượng",
"value": "4kg"
},
{
"type": "text",
"name": "Dài x Rộng x Cao",
"value": "12x30x49cm"
},
{
"type": "text",
"name": "Loại hàng hóa",
"value": "Thực phẩm, Quần áo"
},
{
"type": "text",
"name": "Giá trị gói hàng",
"value": "1.000.000 đ"
},
{
"type": "images",
"name": "Hình ảnh gói hàng",
"value": [
"https://salt.tikicdn.com/ts/tiniapp/f9/43/12/d49e6bcba1441f7f985e549e36ad7d83.png",
"https://salt.tikicdn.com/ts/tiniapp/1c/c5/06/a19549329bf09a63711bce03a0d58575.png",
"https://salt.tikicdn.com/ts/tiniapp/26/e2/08/fa7635a27d45fd3f9463a22645a2687b.png"
]
}
]
}
]
}
}

Ví dụ về metadata với type = action
{
"metadata": {
"sections": [
{
"header": "",
"fields": [
{
"type": "action",
"name": "Giấy chứng nhận điện tử",
"value": {
"button_name": "Xem",
"link": "https://salt.tikicdn.com/ts/tiniapp/b2/6e/d1/2ab2d72f0502596b32c10036a50b54dd.png:"
}
}
]
}
]
}
}

Ví dụ về yêu cầu tạo đơn hàng
curl --location --request POST 'https://api.tiki.vn/tiniapp-open-api/order' \
--header 'Content-Type: application/json' \
--header 'X-Tiniapp-Client-Id: 8GXqhWDK3EppMwf8IyQU1GHgfq2TPADe' \
--header 'X-Tiniapp-Signature: b1bf71b9519227be3c7cfe2ce7291d07efb7346d0b9917f3e665bd915e09bf3e' \
--header 'X-Tiniapp-Timestamp: 1647507922833' \
--data-raw '{"customer_id":"100102261","items":[{"name":"Dịch vụ Tini Ship","sku":"1234564431",image_url":"https://salt.tikicdn.com/ts/tiniapp/bb/ca/34/128ace153520571b94013f5fdf5fb982.png","quantity":1,"extra":"a=1;b=2","metadata":{"sections":[{"header":"Thông tin bên gửi","fields":[{"type":"text","name":"Địa chỉ","value":"285 Cách Mạng Tháng 8, phường 12, quận 10, TPHCM"},{"type":"text","name":"Người gửi","value":"Tú Bùi"},{"type":"text","name":"Số điện thoại","value":"0901020000"}]},{"header":"Thông tin bên nhận","fields":[{"type":"text","name":"Địa chỉ","value":"Chung cư Tôn Thất Thuyết, phường 1, quận 4, TPHCM"},{"type":"text","name":"Người nhận","value":"Long Nguyễn"},{"type":"text","name":"Số điện thoại","value":"0901021111"}]},{"header":"Thông tin món hàng","fields":[{"type":"text","name":"Khối lường","value":"1kg"},{"type":"text","name":"Dài x Rộng x Cao","value":"12 x 30 x 49 cm"},{"type":"text","name":"Loại hàng hóa","value":"Thực phẩm, Quần áo"},{"type":"text","name":"Giá trị món hàng","value":"1.000.000đ"},{"type":"images","name":"Hình ảnh","value":["https://salt.tikicdn.com/ts/tiniapp/96/ca/8a/f9ca90000a3417e9735a1866ce9f2472.png","https://salt.tikicdn.com/ts/tiniapp/38/e0/27/741bca845eff19cbabdb7588d648364c.png","https://salt.tikicdn.com/ts/tiniapp/e0/72/5d/2c6ff108b9ddec2902dfb47dea6e2695.png"]}]}]}}],"customer_info":{"name":"Tú Bùi","phone":"0901020000","email":"tu.bui@tiki.vn","street":"285 CMT8"},"shipping_fee":0,"extra":"coupon=ABC;note=test","reference_id":"51"}'
HTTP Response
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
---|---|---|---|
Data | []Data | ✓ |
Data
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Mô tả |
---|---|---|---|
order | Order | ✓ |
Order
Thuộc tính | Kiểu dữ liệu | Bắt buộc | Not Null | Mô tả |
---|---|---|---|---|
id | string | ✓ | ✓ | ID của đơn hàng ở hệ thống Tini App. Nó đc sinh ra khi khách hàng tạo đơn hàng. |
status | string | ✓ | ✓ | Trạng thái đơn hàng |
grand_total | int64 | ✓ | ✓ | Tổng số tiền mà khách hàng dùng cần thanh toán |
tiki_order_id | string | ✓ | ✓ | ID của đơn hàng nằm ở hệ thống Tiki |
tiki_order_code | string | ✓ | ✓ | Mã đơn hàng nằm ở hệ thống Tiki dùng cho mục đích đối soát. Nó được sinh ra khi khách hàng thanh toán online đơn hàng. |
extra | string | ✓ | ✓ | Thông tin bổ sung theo định dạng key=value;key=value |
reference_id | string | ✓ | ✓ | ID đơn hàng của đối tác |
Ví dụ về dữ liệu trả về
{
"data": {
"order": {
"id": "141857488587784201",
"extra": "",
"status": "canceled",
"grand_total": 35000,
"reference_id": "0",
"tiki_order_id": "1001059779",
"tiki_order_code": "308714458"
}
}
}
Lưu ý
- Trường thông tin tiki_order_id và tiki_order_code chỉ có giá trị khi khách hàng tiến hành thanh toán
Khi khách hàng thanh toán bắt đầu thanh toán đơn hàng, JS API my.makePayment sẽ được dùng để mở màn hình thanh toán cho đơn hàng với tham số truyền vào là order ID.