Tổng quan về Order API

Tổng quan về Order API

Bối cảnh

Orders API giúp bạn lấy thông tin về các đơn hàng.

Bạn có thể lập trình để GET một Order List, và GET Order Details từ một Order cụ thể.

Ngoài ra, bạn cũng có thể đăng ký Order Status Webhook để được thông báo về các thay đổi trạng thái đơn hàng.

Các khái niệm quan trọng

Order

Một đơn hàng được tạo khi người mua nhấp vào nút Place Order. Xin lưu ý rằng khi đơn hàng được tạo, người mua vẫn chưa thanh toán, do đó trạng thái của đơn hàng là UNPAID. Khi một đơn hàng được tạo, người bán nên trừ hoặc giữ tồn kho từ hệ thống quản lý tồn kho của họ tương ứng.

Cấu trúc Order

1. Order ID: Order ID là một mã định danh duy nhất cho mỗi Order được tạo bởi một Buyer.
2. SKU ID: Một order line chứa 1 hoặc nhiều sản phẩm thuộc cùng một Stock Keeping Unit. Mỗi SKU được xác định bằng SKU ID duy nhất của nó. Một SKU có thể được xem như một "variant".
3. Order Line Item id: Mỗi sản phẩm đơn lẻ trong một line được xác định bằng order line item id duy nhất của nó.

Ví dụ- Một người mua đặt một đơn hàng gồm tổng cộng 5 sản phẩm: 2 áo thun Red Large, 2 áo thun Red Medium, và 1 đôi giày đen size 10:

Order	SKU	Line item
Order ID: 12345678	Red Large T Shirt	1x Red Large T Shirt (item 1)
		1x Red Large T Shirt (item 2)
	Red Medium t shirt	1x Red Medium t shirt (item 3)
		1x Red Medium t shirt (item 4)
	Size 10 Black Shoes	1 size 10 black shoes (item 5)

Order Status

Định nghĩa Order Status

Status	Mô tả
UNPAID	Đơn hàng đã được đặt nhưng việc thanh toán đã được ủy quyền.
ON_HOLD	Sau khi thanh toán hoàn tất cho đơn hàng, đơn hàng chuyển sang trạng thái ON_HOLD trong thời gian remorse. Thời gian remorse cho phép người mua hủy đơn hàng mà không cần sự chấp thuận của người bán. Các đơn hàng ON_HOLD không được phép thực hiện fulfillment.
AWAITING_SHIPMENT	Đang chờ người bán đặt một logistic order.
PARTIALLY_SHIPPING	Một hoặc nhiều (nhưng không phải tất cả) sản phẩm trong đơn hàng đã được giao vận chuyển.
AWAITING_COLLECTION	Logistics order đã được đặt. Ít nhất một sản phẩm trong đơn hàng vẫn đang chờ được đơn vị vận chuyển thu gom.
IN_TRANSIT	Tất cả sản phẩm đã được đơn vị vận chuyển thu gom. Ít nhất một kiện hàng vẫn chưa được giao đến người mua.
DELIVERED	Tất cả sản phẩm đã được giao đến người mua.
COMPLETED	Đơn hàng đã được hoàn tất. Các đơn hàng đã hoàn tất không thể được trả lại hoặc hoàn tiền nữa.
CANCELLED	Đơn hàng đã bị hủy. Đơn hàng có thể bị hủy bởi người mua, người bán, TikTok SYSTEM, hoặc một TikTok OPERATOR. * Buyer: Người mua có thể đổi ý và hủy trong vòng 1 giờ sau khi mua, được gọi là 1-hour remorse. Sau khoảng thời gian này, người mua vẫn có thể yêu cầu hủy, nhưng phải được sự chấp thuận của người bán. * Seller: Người bán có thể hủy một đơn hàng, ví dụ nếu họ hết hàng sản phẩm. * SYSTEM: Đơn hàng có thể bị hủy tự động bởi hệ thống TikTok dựa trên các chính sách của TikTok. Ví dụ, điều này có thể xảy ra nếu một kiện hàng bị thất lạc trong quá trình vận chuyển, và TikTok phát hiện rằng tracking ID không có tiến triển trong hơn 7 ngày. * OPERATOR: Đơn hàng cũng có thể bị hủy bởi bộ phận chăm sóc khách hàng của TikTok vì nhiều lý do. Để xem danh sách đầy đủ các lý do hủy được hỗ trợ, vui lòng truy cập trang này.

Chuyển đổi Order Status

1. Từ UNPAID sang ON_HOLD

Trigger: Khi đơn hàng được thanh toán, trạng thái đơn hàng cập nhật thành ON_HOLD. Trigger initiator: Buyer Lưu ý:

Đối với các đơn hàng ON_HOLD, địa chỉ người nhận và thông tin người mua không có sẵn qua Order API. Từ UNPAID sang ON_HOLD 1. Trigger: Khi đơn hàng được thanh toán, trạng thái đơn hàng cập nhật thành ON_HOLD. 2. Trigger initiator: Buyer 3. Lưu ý:

Đối với các đơn hàng ON_HOLD, địa chỉ người nhận và thông tin người mua không có sẵn qua Order API. Lưu ý: 1. Đối với các đơn hàng ON_HOLD, địa chỉ người nhận và thông tin người mua không có sẵn qua Order API.

2. Từ ON_HOLD sang AWAITING_SHIPMENT

Trigger: Sau cửa sổ remorse (1 giờ sau khi thanh toán), trạng thái đơn hàng thay đổi thành AWAITING_SHIPMENT. Trigger initiator: TiKTok Lưu ý: Bước này diễn ra tự động. Từ ON_HOLD sang AWAITING_SHIPMENT 1. Trigger: Sau cửa sổ remorse (1 giờ sau khi thanh toán), trạng thái đơn hàng thay đổi thành AWAITING_SHIPMENT. 2. Trigger initiator: TiKTok 3. Lưu ý: Bước này diễn ra tự động.

3. Từ AWAITING_SHIPMENT sang PARTIALLY_SHIPPING

Trigger: Khi một số (nhưng không phải tất cả) sản phẩm trong đơn hàng đã được giao vận chuyển. Trigger initiator: Seller Lưu ý: chỉ các lô hàng tách riêng mới có trạng thái này. Nếu người bán giao tất cả sản phẩm trong đơn hàng trong một kiện hàng, trạng thái này được bỏ qua. Từ AWAITING_SHIPMENT sang PARTIALLY_SHIPPING 1. Trigger: Khi một số (nhưng không phải tất cả) sản phẩm trong đơn hàng đã được giao vận chuyển. 2. Trigger initiator: Seller 3. Lưu ý: chỉ các lô hàng tách riêng mới có trạng thái này. Nếu người bán giao tất cả sản phẩm trong đơn hàng trong một kiện hàng, trạng thái này được bỏ qua.

4. Từ AWAITING_SHIPMENT hoặc PARTIALLY_SHIPPING sang AWAITING_COLLECTION

Kịch bản A (người bán giao tất cả sản phẩm trong một kiện hàng): AWAITING_SHIPMENT sang AWAITING_COLLECTION

Trigger: Người bán gọi API để giao tất cả sản phẩm trong đơn hàng. Trigger initiator: Seller

Kịch bản B (Người bán tách đơn hàng để giao): PARTIALLY_SHIPPING sang AWAITING_COLLECTION

Trigger: Người bán gọi API để giao sản phẩm chưa giao trong đơn hàng. Chỉ khi tất cả sản phẩm đã được sắp xếp vận chuyển, thì trạng thái đơn hàng mới được cập nhật thành AWAITING_COLLECTION. Trigger initiator: Seller

Lưu ý: Khi người bán sắp xếp vận chuyển, người mua không thể yêu cầu hủy mà không có sự chấp thuận của người bán. Từ AWAITING_SHIPMENT hoặc PARTIALLY_SHIPPING sang AWAITING_COLLECTION 1. Kịch bản A (người bán giao tất cả sản phẩm trong một kiện hàng): AWAITING_SHIPMENT sang AWAITING_COLLECTION

Trigger: Người bán gọi API để giao tất cả sản phẩm trong đơn hàng. Trigger initiator: Seller Kịch bản A (người bán giao tất cả sản phẩm trong một kiện hàng): AWAITING_SHIPMENT sang AWAITING_COLLECTION 1. Trigger: Người bán gọi API để giao tất cả sản phẩm trong đơn hàng. 2. Trigger initiator: Seller

2. Kịch bản B (Người bán tách đơn hàng để giao): PARTIALLY_SHIPPING sang AWAITING_COLLECTION

Trigger: Người bán gọi API để giao sản phẩm chưa giao trong đơn hàng. Chỉ khi tất cả sản phẩm đã được sắp xếp vận chuyển, thì trạng thái đơn hàng mới được cập nhật thành AWAITING_COLLECTION. Trigger initiator: Seller Kịch bản B (Người bán tách đơn hàng để giao): PARTIALLY_SHIPPING sang AWAITING_COLLECTION 1. Trigger: Người bán gọi API để giao sản phẩm chưa giao trong đơn hàng. Chỉ khi tất cả sản phẩm đã được sắp xếp vận chuyển, thì trạng thái đơn hàng mới được cập nhật thành AWAITING_COLLECTION. 2. Trigger initiator: Seller

3. Lưu ý: Khi người bán sắp xếp vận chuyển, người mua không thể yêu cầu hủy mà không có sự chấp thuận của người bán.

4. Từ AWAITING_COLLECTION sang IN_TRANSIT

Kịch bản A (Người bán giao tất cả sản phẩm trong một kiện hàng)

Trigger: Khi TikTok lấy được thông tin theo dõi lô hàng của các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION. Trigger initiator: TikTok

Kịch bản B (Người bán tách đơn hàng để giao)

Trigger: Khi Tiktok lấy được thông tin theo dõi lô hàng của tất cả các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION.

Lưu ý: TikTok lấy thông tin theo dõi lô hàng từ nhiều nhà cung cấp dữ liệu theo dõi khác nhau. Tùy thuộc vào hiệu suất của nhà cung cấp, thông tin theo dõi có thể bị trễ. Nếu thông tin theo dõi lô hàng bị trễ hơn 24 giờ, vui lòng liên hệ TikTok. Từ AWAITING_COLLECTION sang IN_TRANSIT 1. Kịch bản A (Người bán giao tất cả sản phẩm trong một kiện hàng)

Trigger: Khi TikTok lấy được thông tin theo dõi lô hàng của các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION. Trigger initiator: TikTok Kịch bản A (Người bán giao tất cả sản phẩm trong một kiện hàng) 1. Trigger: Khi TikTok lấy được thông tin theo dõi lô hàng của các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION. 2. Trigger initiator: TikTok

2. Kịch bản B (Người bán tách đơn hàng để giao)

Trigger: Khi Tiktok lấy được thông tin theo dõi lô hàng của tất cả các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION. Kịch bản B (Người bán tách đơn hàng để giao) 1. Trigger: Khi Tiktok lấy được thông tin theo dõi lô hàng của tất cả các kiện hàng từ hệ thống của đơn vị vận chuyển, trạng thái đơn hàng sẽ được cập nhật thành IN_TRANSIT từ AWAITING_COLLECTION.

3. Lưu ý: TikTok lấy thông tin theo dõi lô hàng từ nhiều nhà cung cấp dữ liệu theo dõi khác nhau. Tùy thuộc vào hiệu suất của nhà cung cấp, thông tin theo dõi có thể bị trễ. Nếu thông tin theo dõi lô hàng bị trễ hơn 24 giờ, vui lòng liên hệ TikTok.

4. Từ IN_TRANSIT sang DELIVERED

Trigger: Kiện hàng đã được giao thành công. Trigger initiator: TikTok Từ IN_TRANSIT sang DELIVERED 1. Trigger: Kiện hàng đã được giao thành công. 2. Trigger initiator: TikTok

7. Từ DELIVERED sang COMPLETED.

Kịch bản A (Người mua yêu cầu hoàn tiền hoặc trả hàng)

Trigger: Người mua có thể khởi tạo yêu cầu trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. Trigger initiator: Seller/TikTok

Kịch bản B (Người bán khởi tạo hoàn tiền hoặc trả hàng)

Trigger: Người bán có thể khởi tạo trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. Trigger initiator: Seller

Kịch bản C (TikTok)

Trigger: Số tiền hoàn lại khả dụng của đơn hàng được hoàn lại đầy đủ trước khi thời gian after-sales kết thúc. Trigger initiator: TikTok

Lưu ý: Các khu vực và mô hình kinh doanh khác nhau (Local to Local hoặc các mô hình cross border) có thời gian after-sales khác nhau. Vui lòng tham khảo seller academy để biết các chính sách after-sales áp dụng. Từ DELIVERED sang COMPLETED. 1. Kịch bản A (Người mua yêu cầu hoàn tiền hoặc trả hàng)

Trigger: Người mua có thể khởi tạo yêu cầu trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. Trigger initiator: Seller/TikTok Kịch bản A (Người mua yêu cầu hoàn tiền hoặc trả hàng) 1. Trigger: Người mua có thể khởi tạo yêu cầu trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. 2. Trigger initiator: Seller/TikTok

2. Kịch bản B (Người bán khởi tạo hoàn tiền hoặc trả hàng)

Trigger: Người bán có thể khởi tạo trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. Trigger initiator: Seller Kịch bản B (Người bán khởi tạo hoàn tiền hoặc trả hàng) 1. Trigger: Người bán có thể khởi tạo trả hàng hoặc hoàn tiền nhiều lần. Khi số tiền đơn hàng được hoàn lại đầy đủ cho người mua, trạng thái đơn hàng sẽ được cập nhật thành COMPLETED. 2. Trigger initiator: Seller

3. Kịch bản C (TikTok)

Trigger: Số tiền hoàn lại khả dụng của đơn hàng được hoàn lại đầy đủ trước khi thời gian after-sales kết thúc. Trigger initiator: TikTok Kịch bản C (TikTok) 1. Trigger: Số tiền hoàn lại khả dụng của đơn hàng được hoàn lại đầy đủ trước khi thời gian after-sales kết thúc. 2. Trigger initiator: TikTok

4. Lưu ý: Các khu vực và mô hình kinh doanh khác nhau (Local to Local hoặc các mô hình cross border) có thời gian after-sales khác nhau. Vui lòng tham khảo seller academy để biết các chính sách after-sales áp dụng.

5. Từ UNPAID sang CANCELLED

Kịch bản A (Người mua hủy đơn hàng)：

Trigger: Người mua hủy đơn hàng ở trạng thái UNPAID. Trigger initiator: Buyer

Kịch bản B (TikTok hủy đơn hàng)：

Trigger: Người mua chưa thanh toán đơn hàng trong thời gian quy định (mỗi khu vực có thiết lập khác nhau). Trigger initiator: TikTok Từ UNPAID sang CANCELLED 1. Kịch bản A (Người mua hủy đơn hàng)：

Trigger: Người mua hủy đơn hàng ở trạng thái UNPAID. Trigger initiator: Buyer Kịch bản A (Người mua hủy đơn hàng)： 1. Trigger: Người mua hủy đơn hàng ở trạng thái UNPAID. 2. Trigger initiator: Buyer

2. Kịch bản B (TikTok hủy đơn hàng)：

Trigger: Người mua chưa thanh toán đơn hàng trong thời gian quy định (mỗi khu vực có thiết lập khác nhau). Trigger initiator: TikTok Kịch bản B (TikTok hủy đơn hàng)： 1. Trigger: Người mua chưa thanh toán đơn hàng trong thời gian quy định (mỗi khu vực có thiết lập khác nhau). 2. Trigger initiator: TikTok

9. Từ ON_HOLD sang CANCELLED

Kịch bản A (Người mua hủy đơn hàng)

Trigger: Người mua hủy đơn hàng trong cửa sổ remorse. Trigger initiator: Buyer

Kịch bản B (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng do hết hàng. Trigger initiator: Seller

Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ ON_HOLD sang CANCELLED 1. Kịch bản A (Người mua hủy đơn hàng)

Trigger: Người mua hủy đơn hàng trong cửa sổ remorse. Trigger initiator: Buyer Kịch bản A (Người mua hủy đơn hàng) 1. Trigger: Người mua hủy đơn hàng trong cửa sổ remorse. 2. Trigger initiator: Buyer

2. Kịch bản B (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng do hết hàng. Trigger initiator: Seller Kịch bản B (Người bán hủy đơn hàng) 1. Trigger: Người bán hủy đơn hàng do hết hàng. 2. Trigger initiator: Seller

3. Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

4. Từ AWAITING_SHIPMENT sang CANCELLED

Kịch bản A (Người mua hủy đơn hàng)

Trigger: Người mua khởi tạo yêu cầu hủy và người bán chấp nhận. Trigger initiator: Buyer

Kịch bản B (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng do hết hàng. Trigger initiator: Seller

Kịch bản C (TikTok hủy đơn hàng)

Trigger: TikTok hủy đơn hàng, vì người bán không sắp xếp vận chuyển trước thời gian TikTok yêu cầu. Trigger initiator: TikTok

Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ AWAITING_SHIPMENT sang CANCELLED 1. Kịch bản A (Người mua hủy đơn hàng)

Trigger: Người mua khởi tạo yêu cầu hủy và người bán chấp nhận. Trigger initiator: Buyer Kịch bản A (Người mua hủy đơn hàng) 1. Trigger: Người mua khởi tạo yêu cầu hủy và người bán chấp nhận. 2. Trigger initiator: Buyer

2. Kịch bản B (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng do hết hàng. Trigger initiator: Seller Kịch bản B (Người bán hủy đơn hàng) 1. Trigger: Người bán hủy đơn hàng do hết hàng. 2. Trigger initiator: Seller

3. Kịch bản C (TikTok hủy đơn hàng)

Trigger: TikTok hủy đơn hàng, vì người bán không sắp xếp vận chuyển trước thời gian TikTok yêu cầu. Trigger initiator: TikTok Kịch bản C (TikTok hủy đơn hàng) 1. Trigger: TikTok hủy đơn hàng, vì người bán không sắp xếp vận chuyển trước thời gian TikTok yêu cầu. 2. Trigger initiator: TikTok

4. Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

5. Từ PARTIALLY_SHIPPING sang CANCELLED

Trigger: Người mua hủy sản phẩm chưa giao và Tiktok hủy sản phẩm đã giao Trigger initiator: Buyer and Tiktok Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ PARTIALLY_SHIPPING sang CANCELLED 1. Trigger: Người mua hủy sản phẩm chưa giao và Tiktok hủy sản phẩm đã giao 2. Trigger initiator: Buyer and Tiktok 3. Lưu ý: Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

12. Từ AWAITING_COLLECTION sang CANCELLED

Kịch bản A (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. Trigger initiator: seller

Kịch bản B (Tiktok hủy đơn hàng)

Trigger: Tiktok hủy đơn hàng vì TikTok không thể lấy thông tin theo dõi lô hàng từ nhiều nhà cung cấp dữ liệu theo dõi khác nhau trước thời gian TikTok yêu cầu. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. Trigger initiator: Tiktok

Lưu ý: Chỉ thị trường US cho phép người bán hủy đơn hàng ở trạng thái AWAITING_COLLECTION. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ AWAITING_COLLECTION sang CANCELLED 1. Kịch bản A (Người bán hủy đơn hàng)

Trigger: Người bán hủy đơn hàng. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. Trigger initiator: seller Kịch bản A (Người bán hủy đơn hàng) 1. Trigger: Người bán hủy đơn hàng. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. 2. Trigger initiator: seller

2. Kịch bản B (Tiktok hủy đơn hàng)

Trigger: Tiktok hủy đơn hàng vì TikTok không thể lấy thông tin theo dõi lô hàng từ nhiều nhà cung cấp dữ liệu theo dõi khác nhau trước thời gian TikTok yêu cầu. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. Trigger initiator: Tiktok Kịch bản B (Tiktok hủy đơn hàng) 1. Trigger: Tiktok hủy đơn hàng vì TikTok không thể lấy thông tin theo dõi lô hàng từ nhiều nhà cung cấp dữ liệu theo dõi khác nhau trước thời gian TikTok yêu cầu. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. 2. Trigger initiator: Tiktok

3. Lưu ý: Chỉ thị trường US cho phép người bán hủy đơn hàng ở trạng thái AWAITING_COLLECTION. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

4. Từ IN_TRANSIT sang CANCELLED

Trigger: Tiktok hủy đơn hàng. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. Trigger initiator: Tiktok Lưu ý: tình huống này thường xảy ra khi kiện hàng bị thất lạc trong quá trình vận chuyển hoặc người mua từ chối nhận kiện hàng. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ IN_TRANSIT sang CANCELLED 1. Trigger: Tiktok hủy đơn hàng. Nếu đơn hàng đã được tách, trạng thái đơn hàng sẽ cập nhật thành CANCELLED khi tất cả các đơn hàng tách đã bị hủy. 2. Trigger initiator: Tiktok 3. Lưu ý: tình huống này thường xảy ra khi kiện hàng bị thất lạc trong quá trình vận chuyển hoặc người mua từ chối nhận kiện hàng. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

14. Từ AWAITING_COLLECTION sang COMPLETED

Trigger: Người mua khởi tạo yêu cầu hoàn tiền và người bán chấp nhận Trigger initiator: Buyer Lưu ý: Khi số tiền đơn hàng được hoàn lại đầy đủ, trạng thái đơn hàng sẽ thay đổi thành COMPLETED. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ AWAITING_COLLECTION sang COMPLETED 1. Trigger: Người mua khởi tạo yêu cầu hoàn tiền và người bán chấp nhận 2. Trigger initiator: Buyer 3. Lưu ý: Khi số tiền đơn hàng được hoàn lại đầy đủ, trạng thái đơn hàng sẽ thay đổi thành COMPLETED. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

15. Từ IN_TRANSIT sang COMPLETED

Kịch bản A (Người mua khởi tạo yêu cầu hoàn tiền)

Trigger: Người mua khởi tạo yêu cầu hoàn tiền và người bán chấp nhận. Trigger initiator: Buyer

Kịch bản B (Tiktok tự động chấp thuận yêu cầu hoàn tiền của người mua)

Trigger: Người mua khởi tạo yêu cầu hoàn tiền. Khi thời gian vượt quá thời gian giao hàng ước tính muộn nhất, Tiktok sẽ tự động chấp thuận yêu cầu hoàn tiền của người mua. Trigger initiator: Tiktok

Lưu ý: Khi số tiền đơn hàng được hoàn lại đầy đủ, trạng thái đơn hàng sẽ thay đổi thành COMPLETED. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy. Từ IN_TRANSIT sang COMPLETED 1. Kịch bản A (Người mua khởi tạo yêu cầu hoàn tiền)

Trigger: Người mua khởi tạo yêu cầu hoàn tiền và người bán chấp nhận. Trigger initiator: Buyer Kịch bản A (Người mua khởi tạo yêu cầu hoàn tiền)

1. Trigger: Người mua khởi tạo yêu cầu hoàn tiền và người bán chấp nhận.

2. Trigger initiator: Buyer

3. Kịch bản B (Tiktok tự động chấp thuận yêu cầu hoàn tiền của người mua)

Trigger: Người mua khởi tạo yêu cầu hoàn tiền. Khi thời gian vượt quá thời gian giao hàng ước tính muộn nhất, Tiktok sẽ tự động chấp thuận yêu cầu hoàn tiền của người mua. Trigger initiator: Tiktok Kịch bản B (Tiktok tự động chấp thuận yêu cầu hoàn tiền của người mua)

1. Trigger: Người mua khởi tạo yêu cầu hoàn tiền. Khi thời gian vượt quá thời gian giao hàng ước tính muộn nhất, Tiktok sẽ tự động chấp thuận yêu cầu hoàn tiền của người mua.

2. Trigger initiator: Tiktok

3. Lưu ý: Khi số tiền đơn hàng được hoàn lại đầy đủ, trạng thái đơn hàng sẽ thay đổi thành COMPLETED. Trạng thái đơn hàng sẽ chỉ được cập nhật thành 'CANCELLED' khi tất cả sản phẩm trong đơn hàng đã bị hủy.

Các loại Fulfillment và tùy chọn giao hàng

Các loại Fulfillment

TikTok Shop cung cấp hai loại fulfillment:

1. FULFILLMENT_BY_SELLER: Người bán thực hiện đơn hàng trực tiếp từ kho của chính họ. Trong mô hình này, người bán chịu trách nhiệm lưu trữ, đóng gói, và vận chuyển sản phẩm đến khách hàng.
2. FULFILLMENT_BY_TIKTOK: Người bán lưu trữ sản phẩm của họ trong các trung tâm fulfillment của Tiktok. Tiktok chịu trách nhiệm lưu trữ, lấy hàng, đóng gói, và vận chuyển sản phẩm đến khách hàng.

Loại Shipping

Đối với FULFILLMENT_BY_SELLER, có hai loại shipping:

1. TikTok Shipping: Tiktok cung cấp dịch vụ vận chuyển. Người bán lấy shipping label từ Tiktok.
2. Seller Shipping: Người bán tự sắp xếp vận chuyển.

Địa chỉ người nhận

Che giấu thông tin người nhận

Trong các tình huống sau, địa chỉ và thông tin cá nhân của người nhận sẽ được che giấu.

1. Đơn hàng có fulfillment_type = FULFILLMENT_BY_TIKTOK
2. Đơn hàng có fulfillment_type = FULFILLMENT_BY_SELLER và shipping type = TikTok

Địa chỉ người nhận được bản địa hóa

Các quốc gia khác nhau có thể có cấu trúc phân cấp địa chỉ và quy ước đặt tên khác nhau. Để phù hợp với những khác biệt như vậy, sử dụng 'district_info_list' để lấy thông tin địa chỉ được biểu diễn theo cấu trúc phân cấp và quy ước đặt tên địa chỉ địa phương.

Thông tin Order SLA (Service Level Agreement)

Hiện tại, Tiktok shop có các khái niệm Service Level Agreement sau.

rts_sla: "RTS" là viết tắt của Ready To Ship. RTS đánh dấu thời điểm trạng thái đơn hàng chuyển sang AWAITING_COLLECTION. rts_sla cho biết khoảng thời gian mà TikTok yêu cầu người bán phải giao đơn hàng. Nếu trạng thái đơn hàng chưa chuyển sang AWAITING_COLLECTION trước khi rts_sla trôi qua, điều này cấu thành một late dispatch, sẽ làm tăng late dispatch rate của người bán.

tts_sla: "TTS" là viết tắt của Transfer To Ship. TTS đánh dấu thời điểm trạng thái đơn hàng chuyển sang IN_TRANSIT. tts_sla chỉ định khoảng thời gian mà TikTok yêu cầu các kiện hàng phải được đơn vị vận chuyển thu gom. Nếu trạng thái đơn hàng chưa chuyển sang IN_TRANSIT trước khi tts_sla trôi qua, điều này cấu thành một late dispatch, sẽ làm tăng late dispatch rate của người bán.

delivery_sla: Khoảng thời gian mà TikTok yêu cầu các kiện hàng phải được giao đến người mua.

cancel_order_sla: Nếu người bán không hoàn thành việc giao hàng trước thời điểm này, đơn hàng sẽ tự động bị hủy bởi nền tảng. TikTok có thể hủy đơn hàng, nếu đơn hàng không sắp xếp vận chuyển trước rts_sla hoặc đơn hàng không thể lấy được thông tin theo dõi trước tts_sla. Chi tiết chính sách, vui lòng xem Seller Academy.

Các chính sách của TikTok Shop Marketplace

Là một Marketplace, TikTok Shop áp đặt một số chính sách nhất định đối với người bán vì lợi ích của cả người mua và người bán.

Chính sách hủy

Người mua hủy đơn hàng trong vòng 1 giờ:

1. Người mua có thể hủy đơn hàng của họ trong vòng một giờ mà không bị tính phí: điều này được gọi là thời gian remorse 1 giờ. Điều này là bắt buộc đối với tất cả các shop. Chúng tôi chỉ khuyến nghị người bán nên đợi một giờ trước khi bắt đầu thực hiện fulfillment của Order, và tất cả các app và dịch vụ nên triển khai thời gian remorse 1 giờ này. Ở các thị trường có sẵn trạng thái ON_HOLD, cửa sổ remorse 1 giờ này chính là trạng thái ON_HOLD.

Người mua yêu cầu hủy sau 1 giờ:

1. Sau 1 giờ, yêu cầu hủy của người mua cần được người bán xem xét. Người bán có thể chấp nhận hoặc từ chối yêu cầu hủy.

Chính sách Order Fulfillment SLA (Service Level Agreement)

1. Người bán nên sắp xếp vận chuyển trước thời gian rts_sla.
2. Nhà cung cấp dịch vụ vận chuyển phải cập nhật thông tin theo dõi việc thu gom kiện hàng trước thời gian tts_sla.
3. Nếu Người bán không thể thực hiện một Order với một shipping ID hợp lệ trước cancel_order_sla, Order sẽ bị hủy và Người mua được hoàn tiền.

Câu hỏi thường gặp

1. Làm thế nào để tôi lấy order ID?

Để sử dụng Orders API, bạn phải đăng ký Orders Webhook. Nhấp vào đây để biết thêm chi tiết Làm thế nào để tôi lấy order ID? 1. Để sử dụng Orders API, bạn phải đăng ký Orders Webhook. Nhấp vào đây để biết thêm chi tiết

2. Sản phẩm của tôi hết hàng một phần. Tôi có thể chỉ giao một phần của Order không?

Hiện tại, chúng tôi không cung cấp chức năng này. Nếu đây là một yêu cầu bắt buộc phải có, hãy liên hệ với nhóm CST của chúng tôi và chúng tôi sẽ xem xét liệu có thể cấp cho bạn quyền truy cập vào một beta API có thể giải quyết vấn đề này hay không. Sản phẩm của tôi hết hàng một phần. Tôi có thể chỉ giao một phần của Order không? 1. Hiện tại, chúng tôi không cung cấp chức năng này. Nếu đây là một yêu cầu bắt buộc phải có, hãy liên hệ với nhóm CST của chúng tôi và chúng tôi sẽ xem xét liệu có thể cấp cho bạn quyền truy cập vào một beta API có thể giải quyết vấn đề này hay không.

3. Tôi có thể hủy hoàn toàn một đơn hàng không?

Có, bạn có thể gọi Cancel Order API để hủy đơn hàng. Tôi có thể hủy hoàn toàn một đơn hàng không? 1. Có, bạn có thể gọi Cancel Order API để hủy đơn hàng.

4. Làm thế nào để tôi giao một đơn hàng mới thay thế cho một đơn hàng hiện có (ví dụ kiện hàng bị thất lạc)?

Hiện tại, chúng tôi không có chức năng thay thế. Nếu đây là một yêu cầu bắt buộc phải có, vui lòng yêu cầu người mua hủy đơn hàng và đặt lại một đơn hàng. Làm thế nào để tôi giao một đơn hàng mới thay thế cho một đơn hàng hiện có (ví dụ kiện hàng bị thất lạc)? 1. Hiện tại, chúng tôi không có chức năng thay thế. Nếu đây là một yêu cầu bắt buộc phải có, vui lòng yêu cầu người mua hủy đơn hàng và đặt lại một đơn hàng.

5. Làm thế nào để tôi kiểm tra thông tin order line item?

Bạn có thể gọi Get Order Detail API để lấy nó từ line_items. Làm thế nào để tôi kiểm tra thông tin order line item? 1. Bạn có thể gọi Get Order Detail API để lấy nó từ line_items.

6. Làm thế nào để tôi biết đơn hàng có được fulfill bởi Tiktok hay không?

Bạn có thể gọi Get Order Detail API để lấy nó từ fulfillment_type. Làm thế nào để tôi biết đơn hàng có được fulfill bởi Tiktok hay không? 1. Bạn có thể gọi Get Order Detail API để lấy nó từ fulfillment_type.

7. Làm thế nào để tôi biết dịch vụ vận chuyển của đơn hàng được cung cấp bởi nền tảng hay người bán?

Bạn có thể gọi Get Order Detail API để lấy nó từ delivery_option_id. Làm thế nào để tôi biết dịch vụ vận chuyển của đơn hàng được cung cấp bởi nền tảng hay người bán? 1. Bạn có thể gọi Get Order Detail API để lấy nó từ delivery_option_id.

8. Làm thế nào để tôi biết order line item có phải là quà tặng hay không?

Bạn có thể gọi Get Order Detail API để lấy nó từ is_gift. Làm thế nào để tôi biết order line item có phải là quà tặng hay không? 1. Bạn có thể gọi Get Order Detail API để lấy nó từ is_gift.

9. Một Buyer có thể đặt đơn hàng từ nhiều shop không?

Có! Người mua có thể đặt đơn hàng từ nhiều shop cùng một lúc. Ví dụ, nếu tôi mua một số sản phẩm từ Shop A, và một số sản phẩm từ Shop B, TTS thực ra sẽ tạo 2 đơn hàng. Một Buyer có thể đặt đơn hàng từ nhiều shop không? 1. Có! Người mua có thể đặt đơn hàng từ nhiều shop cùng một lúc. Ví dụ, nếu tôi mua một số sản phẩm từ Shop A, và một số sản phẩm từ Shop B, TTS thực ra sẽ tạo 2 đơn hàng.

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext