Tổng quan Fulfillment API
Tổng quan Fulfillment API
Bối cảnh
Fulfillment API cho phép người bán thực hiện việc giao hàng (fulfill) cho các đơn hàng TikTok Shop.
TikTok Shop cung cấp hai loại hình fulfillment:
- Fulfilled by TikTok (FULFILLMENT_BY_TIKTOK): TikTok sẽ tự động xử lý đơn hàng thay mặt cho người bán. Người bán không cần quản lý quy trình fulfillment.
- Fulfilled by Seller (FULFILLMENT_BY_SELLER): Với loại hình fulfillment này, có hai loại hình vận chuyển:
a) TikTok shipping (TIKTOK): Đôi khi còn được gọi là "platform shipping" hoặc "shipped via platform." Với loại hình vận chuyển này, người bán mua nhãn vận chuyển thông qua TikTok Shop, và lên lịch lấy hàng từ đơn vị vận chuyển của TikTok Shop, hoặc gửi gói hàng tại các điểm gửi hàng của đơn vị vận chuyển TikTok Shop. Người bán có thể lấy loại hình vận chuyển từ Get Order Detail hoặc Get Order List.
b) Seller shipping (SELLER): Đôi khi còn được gọi là "shipped via seller." Người bán quản lý việc vận chuyển thông qua kênh của riêng họ. Với loại hình vận chuyển này, người bán gọi Fulfillment API để cung cấp thông tin vận chuyển trở lại cho TikTok Shop. Người bán có thể lấy loại hình vận chuyển từ Get Order Detail hoặc Get Order List.
Fulfillment API cũng cung cấp cả tùy chọn vận chuyển gói tách (split-package) và gói gộp (consolidated-package, đôi khi còn được gọi là combined package) để hỗ trợ các nhu cầu vận chuyển linh hoạt hơn. Người bán có thể lấy loại hình fulfillment từ Get Order Detail hoặc Get Order List.
Tổng quan API
TikTok shipping
Với platform shipping, tùy thuộc vào thị trường cụ thể, người bán có thể sắp xếp việc vận chuyển bằng cách mua nhãn vận chuyển từ TikTok, hoặc lên lịch bàn giao gói hàng với các đơn vị vận chuyển của TikTok.
Mua vận chuyển (US, UK và JP）
Lên lịch vận chuyển (SEA, EMEA, và LATAM）
Mua vận chuyển từ TikTok (US, UK và JP)
Người bán có thể mua nhãn từ TikTok dựa trên kích thước và trọng lượng của gói hàng, theo yêu cầu.
- Sử dụng API Get Eligible Shipping Service để truy xuất dịch vụ vận chuyển khả dụng (US và JP);
- Sử dụng API Create Package để mua dịch vụ vận chuyển, và tạo nhãn vận chuyển.
- Sử dụng API Get Package Shipping Document để truy xuất nhãn vận chuyển.
Lưu ý:
Trước khi gọi API Create Package, vui lòng đảm bảo rằng đơn hàng chưa bị hủy và không có yêu cầu hủy nào đang chờ người bán phê duyệt.
- Trong thời gian remorse period (1 giờ sau khi thanh toán đơn hàng), người mua có thể hủy đơn hàng mà không cần sự phê duyệt của người bán.
- Sau thời gian remorse period, người mua có thể yêu cầu hủy đơn hàng, chờ người bán phê duyệt.
Vui lòng đảm bảo rằng sau khi gọi API Create Package để hoàn tất việc mua nhãn thành công, sau đó sử dụng API Get Package Shipping Document để lấy nhãn vận chuyển.
Thị trường UK cũng có thể sử dụng API Ship Package khi kích thước gói hàng không khả dụng
Lên lịch vận chuyển từ TikTok (SEA, EMEA, LATAM)
Người bán có thể lên lịch thời gian và phương thức bàn giao gói hàng với nhà cung cấp dịch vụ vận chuyển.
- Sử dụng API Ship Package để lên lịch thời gian và phương thức bàn giao gói hàng.
- Sử dụng API Get Package Shipping Document để lấy nhãn vận chuyển.
Lưu ý:
Trước khi gọi API Ship Package để vận chuyển gói hàng, vui lòng đảm bảo rằng đơn hàng chưa bị hủy hoặc có yêu cầu hủy đang chờ phản hồi.
- Trong thời gian remorse period (1 giờ sau khi thanh toán đơn hàng), người mua có thể hủy đơn hàng mà không cần sự phê duyệt của người bán.
- Sau thời gian remorse period, người mua có thể yêu cầu hủy đơn hàng, chờ người bán phê duyệt.
- Riêng với thị trường BR, người bán phải tải lên tài liệu hóa đơn trước khi vận chuyển. Vui lòng sử dụng endpoint POST Upload Invoice. Sau khi nhận được thông tin tải hóa đơn thành công thông qua webhook [invoice status change], bạn có thể vận chuyển gói hàng.
Vui lòng đảm bảo rằng sau khi gọi API Ship Package để lên lịch vận chuyển thành công, sau đó sử dụng API Get Package Shipping Document để lấy nhãn vận chuyển.
Seller shipping
Với seller shipping, người bán sắp xếp việc vận chuyển trực tiếp với các đơn vị vận chuyển, và tải lên mã theo dõi vận chuyển (tracking number) để thông báo cho TikTok rằng gói hàng đã được gửi đi.
Quy trình cho thị trường US và EMEA:
- Người bán vận chuyển gói hàng và lấy mã theo dõi vận chuyển từ đơn vị vận chuyển.
- Sử dụng endpoint Get Shipping Providers để truy xuất các ID nhà cung cấp dịch vụ vận chuyển được TikTok Shop hỗ trợ thông qua delivery_option_id (người bán có thể lấy delivery_option_id trong Get Order Detail API / Get Order List API).
- Sử dụng endpoint Mark Package As Shipped để tải lên mã theo dõi vận chuyển và ID nhà cung cấp dịch vụ vận chuyển.
Quy trình cho thị trường SEA và LATAM:
- Người bán vận chuyển gói hàng và lấy mã theo dõi vận chuyển từ đơn vị vận chuyển.
- Sử dụng endpoint Get Shipping Providers để truy xuất các ID nhà cung cấp dịch vụ vận chuyển được TikTok Shop hỗ trợ thông qua delivery_option_id (người bán có thể lấy delivery_option_id trong Get Order Detail API / Get Order List API).
- Sử dụng endpoint Ship Package để tải lên mã theo dõi vận chuyển và ID nhà cung cấp dịch vụ vận chuyển.
Lưu ý:
Trước khi gọi API Mark Package As Shipped/Ship Package để vận chuyển gói hàng, vui lòng đảm bảo rằng đơn hàng chưa bị hủy hoặc có yêu cầu hủy đang chờ phản hồi.
- Trong thời gian remorse period (1 giờ sau khi thanh toán đơn hàng), người mua có thể hủy đơn hàng mà không cần sự phê duyệt của người bán.
- Sau thời gian remorse period, người mua có thể yêu cầu hủy đơn hàng, chờ người bán phê duyệt.
Để đảm bảo trải nghiệm mua sắm và dịch vụ của người mua, TikTok đo lường mức độ dịch vụ vận chuyển bằng cách sử dụng thông tin theo dõi vận chuyển dựa trên mã theo dõi. Khi TikTok không thể xác thực mã theo dõi, hoặc thời gian xử lý vận chuyển vượt quá thỏa thuận mức dịch vụ (service level agreement) của TikTok, TikTok có thể hủy đơn hàng và hoàn tiền cho người mua. Để ngăn đơn hàng bị TikTok hủy, vui lòng xác minh rằng nhà cung cấp dịch vụ vận chuyển được TikTok hỗ trợ.
Fulfillment đơn hàng tách (split order)
Fulfillment đơn hàng gộp (consolidated order)
Gộp trước khi vận chuyển (SEA và LATAM)
- Gọi API Search Combinable Packages để lấy đơn hàng có thể được gộp.
- Gọi API Combine Package để xác nhận đơn hàng đã được gộp.
- (tùy chọn): Nếu bạn muốn gỡ bỏ đơn hàng đã được gộp. Vui lòng sử dụng API Uncombine Packages để gỡ bỏ đơn hàng cụ thể.
- Gọi API Ship Package để vận chuyển gói hàng.
Gộp trong khi vận chuyển
- Người bán gộp các đơn hàng, và vận chuyển các gói hàng bằng quy trình vận chuyển hiện có của họ.
- Đối với đơn hàng 4PL（US, UK và JP）：Gọi API Create Packages để gộp khi đang vận chuyển.
- Đối với đơn hàng 3PL（US, EMEA và JP）：Gọi API Mark Package As Shipped để tải lên mã theo dõi cho mỗi đơn hàng đã được gộp.
Chính sách marketplace của TikTok Shop
Chính sách fulfillment đơn hàng tách
Đối với thị trường SEA, một đơn hàng không thể được tách dưới mức dòng đơn hàng (order line level, còn được gọi là mức SKU). Ví dụ, nếu người mua mua hai chiếc quần jeans và một chiếc áo sơ mi, cả hai chiếc quần jeans phải được vận chuyển trong cùng một gói hàng, trong khi chiếc áo sơ mi có thể được tách thành một gói hàng riêng.
Đối với US, EMEA, LATAM và JP，Không có hạn chế. Tất cả các mặt hàng trong đơn hàng có thể được tách thành các gói hàng khác nhau một cách tùy ý.
Chính sách fulfillment đơn hàng gộp
- Tất cả các đơn hàng sử dụng cùng một mã theo dõi để vận chuyển phải có cùng tên người nhận và địa chỉ vận chuyển.
- Một mã theo dõi duy nhất có thể được sử dụng để vận chuyển tối đa 20 đơn hàng cho việc vận chuyển gộp.
Chính sách xác minh mã theo dõi
Nếu người bán sử dụng chế độ seller shipping, TikTok sẽ xác minh mã theo dõi.
- Nhà cung cấp dịch vụ vận chuyển mà người bán sử dụng phải được TikTok hỗ trợ. Vui lòng sử dụng API Get Shipping Providers để truy xuất các nhà cung cấp dịch vụ vận chuyển khả dụng.
- TikTok sẽ xác minh xem mã theo dõi có khớp với nhà cung cấp dịch vụ vận chuyển đã chọn hay không. Nếu mã theo dõi không được xác minh bởi nhà cung cấp dịch vụ vận chuyển đã chọn, một lỗi sẽ được trả về.
Câu hỏi thường gặp
- Tôi có thể sử dụng nhà cung cấp dịch vụ vận chuyển ngoài danh sách của nền tảng không?
Không. Điều đó sẽ khiến TikTok không thể lấy được thông tin theo dõi vận chuyển. Nếu TikTok không thể lấy được thông tin theo dõi vận chuyển trong thời gian quy định tại cancel_sla_time, đơn hàng có thể bị TikTok hủy. Tôi có thể sử dụng nhà cung cấp dịch vụ vận chuyển ngoài danh sách của nền tảng không? - Không. Điều đó sẽ khiến TikTok không thể lấy được thông tin theo dõi vận chuyển. Nếu TikTok không thể lấy được thông tin theo dõi vận chuyển trong thời gian quy định tại cancel_sla_time, đơn hàng có thể bị TikTok hủy.
- Tôi có cần xử lý các thao tác vận chuyển cho đơn hàng có 'FULFILL_BY_TIKTOK' không?
Không. TikTok sẽ thực hiện fulfillment cho đơn hàng. Tôi có cần xử lý các thao tác vận chuyển cho đơn hàng có 'FULFILL_BY_TIKTOK' không? - Không. TikTok sẽ thực hiện fulfillment cho đơn hàng.
- Tôi có thể lấy nhãn vận chuyển từ TikTok bất cứ lúc nào không?
Không. Nhãn vận chuyển chỉ khả dụng sau khi việc vận chuyển đã được sắp xếp cho một gói hàng, và trước khi gói hàng được bàn giao cho đơn vị vận chuyển. Tôi có thể lấy nhãn vận chuyển từ TikTok bất cứ lúc nào không? - Không. Nhãn vận chuyển chỉ khả dụng sau khi việc vận chuyển đã được sắp xếp cho một gói hàng, và trước khi gói hàng được bàn giao cho đơn vị vận chuyển.
- Nếu tôi đã bàn giao gói hàng cho nhà cung cấp dịch vụ vận chuyển, nhưng trạng thái đơn hàng trên nền tảng vẫn chưa chuyển sang 'IN_TRANSIT', tôi nên làm gì?
Trước tiên, bạn cần xác nhận rằng nhà cung cấp dịch vụ vận chuyển bạn đang sử dụng được nền tảng hỗ trợ. Nếu được xác nhận là được hỗ trợ, vui lòng liên hệ với nhà cung cấp dịch vụ vận chuyển để đảm bảo rằng gói hàng đã được quét vào hệ thống của họ. Nếu bạn đã theo dõi thông tin theo dõi trên trang web logistics chính thức nhưng nền tảng vẫn không hiển thị bất kỳ chi tiết theo dõi nào, vui lòng liên hệ với TikTok để được hỗ trợ. Nếu tôi đã bàn giao gói hàng cho nhà cung cấp dịch vụ vận chuyển, nhưng trạng thái đơn hàng trên nền tảng vẫn chưa chuyển sang 'IN_TRANSIT', tôi nên làm gì? - Trước tiên, bạn cần xác nhận rằng nhà cung cấp dịch vụ vận chuyển bạn đang sử dụng được nền tảng hỗ trợ. Nếu được xác nhận là được hỗ trợ, vui lòng liên hệ với nhà cung cấp dịch vụ vận chuyển để đảm bảo rằng gói hàng đã được quét vào hệ thống của họ. Nếu bạn đã theo dõi thông tin theo dõi trên trang web logistics chính thức nhưng nền tảng vẫn không hiển thị bất kỳ chi tiết theo dõi nào, vui lòng liên hệ với TikTok để được hỗ trợ.
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
Trước đóTiếp theo