Chuyển tới nội dung chính

Hướng dẫn cập nhật trạng thái đơn hàng thủ công trên Development Shop (Tài khoản đầy đủ)

Tổng quan tài liệu

Hướng dẫn này dành cho người bán, người kiểm thử và nhà phát triển làm việc trong môi trường development shop của Full Function Account. Tài liệu giải thích cách mô phỏng thủ công quá trình chuyển trạng thái đơn hàng cho các đơn thử nghiệm được đặt qua TikTok App, mà không cần dựa vào các thao tác hoàn tất đơn thực tế như nhập kho hay vận chuyển.

1. Tổng quan tính năng

Trong môi trường Development Shop, người bán thường không thể dựa vào các sự kiện hoàn tất đơn thực tế để điều khiển việc thay đổi trạng thái đơn hàng. Khả năng cập nhật trạng thái đơn hàng thủ công cho phép người kiểm thử kích hoạt quá trình chuyển trạng thái một cách thủ công trong Partner Center đối với các đơn thử nghiệm được tạo từ TikTok App. Tính năng này bao gồm cả luồng xuôi (đặt đơn → chờ giao hàng → đang vận chuyển → đã giao) và luồng ngược (hủy đơn / hoàn tiền), nhờ đó các nhóm có thể xác thực logic nghiệp vụ và hiển thị trạng thái ở giao diện người dùng một cách trọn vẹn trong sandbox.

DimensionDescription
Môi trường áp dụngDevelopment Shop (Full Function Account Development Shop)
Khu vực hỗ trợUS / EU / SEA
Luồng được hỗ trợLuồng xuôi và luồng ngược
Điểm truy cậpTrang quản lý đơn hàng Development Shop trong Partner Center
Người dùng mục tiêuNgười kiểm thử của người bán, kỹ sư gỡ lỗi phát triển và người đánh giá vận hành

2. Điều kiện tiên quyết

2.1 Yêu cầu về môi trường​

  • Môi trường development shop của Full Function Account
  • Tài khoản người mua dùng để đăng nhập TikTok App đã được liên kết với Development Shop

2.2 Chuẩn bị sản phẩm thử nghiệm​

Trước khi đặt đơn trong TikTok App, hãy đảm bảo một sản phẩm đã được đăng tải thành công trong development shop.

3. Tổng quan quy trình

Sơ đồ sau đây minh họa toàn bộ đường đi để điều khiển thủ công việc thay đổi trạng thái đơn hàng trong sandbox sau khi đặt đơn trong TikTok App, bao gồm cả luồng xuôi và luồng ngược.

Image

4. Các bước chi tiết

4.1 Bước 1: Đặt đơn trong TikTok App và xác nhận có thể tìm thấy đơn trong Partner Center​

Trước tiên, đặt đơn thông qua tài khoản người mua trong TikTok App, sau đó xác nhận đơn hàng đã được đồng bộ về backend của development shop.

  1. Dùng tài khoản người mua để mở trang chi tiết sản phẩm trong TikTok App.
  2. Hoàn thành toàn bộ quy trình: chọn SKU, thêm vào giỏ hàng, đặt đơn và hoàn tất thanh toán.
  3. Vào backend của development shop và mở Order Management.
  4. Tìm theo order ID hoặc lọc theo thời gian, sau đó xác nhận đơn hiển thị và có trạng thái On Hold.

Tiêu chí chấp nhận: Đơn đặt trong TikTok App có thể được tìm thấy trong Partner Center và trạng thái được đồng bộ chính xác, nghĩa là đường đặt đơn từ TikTok App đang hoạt động đúng như mong đợi.

4.2 Bước 2: Luồng xuôi — điều khiển thủ công quá trình chuyển trạng thái trong backend​

4.2.1 On Hold → Pending Shipment​

  1. Tìm đơn mục tiêu trong backend. Trạng thái hiện tại phải là On Hold.
  2. Mở trang chi tiết đơn và tìm nút thao tác manual status push.
  3. Chọn Pending Shipment và xác nhận gửi.
  4. Mở My Orders trong TikTok App và xác minh rằng trạng thái đơn đã được cập nhật thành Pending Shipment.

Lưu ý: Sau khi đẩy trạng thái thủ công ở backend, trạng thái trên TikTok App thường được đồng bộ trong vài giây. Nếu chưa thấy cập nhật, hãy đợi một chút và làm mới trang.

Image

Image

4.2.2 Pending Shipment → Awaiting Collection → In Transit​

  1. Xác nhận trạng thái đơn hiện tại là Pending Shipment.
  2. Nhấn Ship Order trong backend và điền thông tin vận chuyển mô phỏng. Tracking number có thể là giá trị thử nghiệm.
  3. Sau khi gửi, trạng thái đơn chuyển thành Awaiting Collection / Shipped, và bạn có thể tiếp tục đẩy thủ công sang In Transit.
  4. Xác minh rằng trạng thái đơn tương ứng trong My Orders trên TikTok App được cập nhật theo.

4.2.3 In Transit → Delivered​

  1. Xác nhận trạng thái đơn hiện tại là In Transit.
  2. Đẩy thủ công đơn sang Delivered trong backend.
  3. Xác minh trong TikTok App rằng trạng thái đơn được cập nhật thành Delivered. Luồng xuôi đã hoàn tất.

Tiêu chí chấp nhận: Sau mỗi lần đẩy trạng thái thủ công ở backend, trạng thái đơn trong TikTok App được cập nhật theo, điều này xác nhận rằng đường đồng bộ trạng thái xuôi đang hoạt động đúng.

Image

Image

4.3 Bước 3: Luồng ngược — khởi tạo hủy đơn hoặc hoàn tiền từ backend​

4.3.1 Luồng ngược: Hủy đơn​

  1. Tìm đơn mục tiêu trong backend khi trạng thái là On Hold hoặc Pending Shipment.
  2. Nhấn Cancel Order.
  3. Chọn lý do hủy và xác nhận gửi.
  4. Xác minh trong TikTok App rằng trạng thái đơn được cập nhật thành Cancelled.

4.3.2 Luồng ngược: Khởi tạo hoàn tiền​

  1. Tìm đơn mục tiêu trong backend và nhấn Initiate Refund.
  2. Điền lý do hoàn tiền và số tiền hoàn, sau đó gửi yêu cầu hoàn tiền.
  3. Trên trang quản lý hoàn tiền của Seller Center, tìm yêu cầu và nhấn Approve Refund.
  4. Sau khi phê duyệt hoàn tiền hoàn tất, xác minh trong TikTok App rằng trạng thái hoàn tiền đã được cập nhật.

Quan trọng: Luồng hoàn tiền yêu cầu hai thao tác ở backend: gửi yêu cầu hoàn tiền và phê duyệt hoàn tiền với vai trò người bán. Trạng thái trên TikTok App chỉ thay đổi sau khi bước phê duyệt được hoàn tất.

4.4 Bước 4: Luồng ngược khởi tạo trong TikTok App — hủy đơn đồng bộ ngược về backend​

Trường hợp kiểm thử này xác minh xem việc hủy đơn do người dùng khởi tạo trong TikTok App có được đồng bộ ngược về backend chính xác hay không.

  1. Dùng tài khoản thử nghiệm để đặt đơn trong TikTok App, và xác nhận trong backend rằng đơn đã được tạo với trạng thái On Hold.
  2. Trong My Orders trên TikTok App, tìm đơn và nhấn Cancel Order.
  3. Sau khi việc hủy hoàn tất, chuyển sang Seller Center.
  4. Làm mới danh sách đơn và xác nhận trạng thái đơn đã được cập nhật thành Cancelled.

Tiêu chí chấp nhận: Sau khi việc hủy được khởi tạo trong TikTok App, trạng thái đơn ở backend được cập nhật thành công, điều này xác nhận rằng đường callback trạng thái ngược từ TikTok App đang hoạt động đúng.

4.5 Bước 5: Kiểm thử hồi quy cho khả năng đang vận hành hiện tại​

Sau khi hoàn thành các trường hợp kiểm thử liên quan đến TikTok App ở trên, hãy chạy thêm kiểm thử hồi quy cho luồng xuôi và luồng ngược hiện có của các đơn được tạo từ backend, để đảm bảo tính năng mới không ảnh hưởng đến đường thao tác đơn hàng ban đầu.

  1. Dùng Create Order Manually trong backend để tạo một đơn thử nghiệm không được đặt qua TikTok App.
  2. Thực hiện toàn bộ luồng xuôi: On Hold → Pending Shipment → In Transit → Delivered.
  3. Tạo một đơn thử nghiệm khác và thực hiện luồng ngược: Cancel / Refund.
  4. Xác nhận rằng tất cả các chức năng hiện có vẫn hoạt động đúng và không có vấn đề hồi quy.

5. Tra cứu nhanh: Chuyển đổi trạng thái

Action typeStarting statusTarget statusEntry point
ForwardOn HoldPending ShipmentBackend → Order details → Manual status push
ForwardPending ShipmentAwaiting Collection / In TransitBackend → Ship Order
ForwardIn TransitDeliveredBackend → Manual progression
ReverseOn Hold / Pending ShipmentCancelledBackend → Cancel Order
ReverseAny statusRefunding / RefundedBackend → Initiate Refund → Approve Refund
Consumer-side reverseOn HoldCancelledTikTok App → My Orders → Cancel Order

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

Q1: Tôi không tìm thấy đơn trong backend sau khi đặt nó trong TikTok App. Tôi nên làm gì?​

  • Xác nhận rằng tài khoản development shop đã đăng nhập và shop dùng trong TikTok App là cùng một shop.
  • Xác nhận đã chọn đúng khu vực (US / EU / SEA). Đơn hàng không được chia sẻ giữa các khu vực.
  • Xác nhận rằng quy trình thanh toán trong TikTok App đã được hoàn tất đầy đủ, bao gồm cả xác nhận thanh toán. Các đơn chưa thanh toán sẽ không được đồng bộ về backend.
  • Đợi khoảng 30 giây, làm mới danh sách đơn trong backend và thử lại.

Q2: Trạng thái đơn trên TikTok App không cập nhật sau khi tôi đẩy trạng thái thủ công. Tôi nên xử lý thế nào?​

  • Đợi 10 đến 30 giây và làm mới thủ công My Orders trong TikTok App.
  • Kiểm tra xem việc đẩy trạng thái ở backend đã được gửi thành công chưa và trạng thái đơn ở backend đã thay đổi chưa.
  • Nếu trạng thái backend đã thay đổi nhưng TikTok App vẫn chưa cập nhật, điều này có thể do trễ trong việc phân phối trạng thái. Hãy đợi thêm một chút hoặc nhờ nhóm kỹ thuật kiểm tra message queue.

Q3: Các luồng kiểm thử cho EU / SEA có giống với khu vực US không?​

Có. Quy trình cốt lõi hoàn toàn giống với luồng của US. Khác biệt duy nhất là bạn cần dùng deeplink sản phẩm thử nghiệm và tài khoản shop cho khu vực tương ứng. Vui lòng xác nhận các tài nguyên thử nghiệm EU / SEA cần thiết với chủ sở hữu nghiệp vụ trước khi kiểm thử.

Q4: Tại sao trạng thái TikTok App không thay đổi trong luồng hoàn tiền?​

  • Luồng hoàn tiền yêu cầu hai thao tác trong Seller Center: gửi yêu cầu hoàn tiền và phê duyệt hoàn tiền.
  • Nếu chỉ gửi yêu cầu hoàn tiền, trạng thái TikTok App sẽ không thay đổi ngay.
  • Đảm bảo rằng yêu cầu đã được tìm thấy trên trang quản lý hoàn tiền và đã nhấn Approve Refund.

Q5: Khả năng đẩy trạng thái thủ công trên sandbox có ảnh hưởng đến dữ liệu production không?​

Sandbox và production hoàn toàn tách biệt. Môi trường development shop được cô lập khỏi production, và tất cả các thao tác thử nghiệm sẽ không ảnh hưởng đến đơn hàng thực hay dữ liệu người dùng thực.

Q6: Tính năng này có hỗ trợ đẩy trạng thái thủ công hàng loạt không?​

  • Tính năng hiện tại được thiết kế chủ yếu cho thao tác trên từng đơn. Nếu cần xác minh hàng loạt, hãy lặp lại quy trình cho từng đơn hoặc xác nhận với nhóm kỹ thuật xem có sẵn interface hàng loạt hay không.