Tokopedia & Shop - Diễn tập di chuyển

Tổng quan

• Bạn có lo ngại về việc xuất hiện những vấn đề sau đây trong quá trình di chuyển không?

Liệu bạn có nên tiến hành gọi Tokopedia API để lấy đơn hàng hay không. Liệu người bán có thể bị giao hàng trùng lặp hay không. Bạn có lo ngại về việc xuất hiện những vấn đề sau đây trong quá trình di chuyển không? - Liệu bạn có nên tiến hành gọi Tokopedia API để lấy đơn hàng hay không.

• Liệu người bán có thể bị giao hàng trùng lặp hay không.

• Nhằm hỗ trợ các nhà phát triển Tokopedia cung cấp dịch vụ tốt hơn cho người bán và đảm bảo quá trình chuyển đổi suôn sẻ cho các hoạt động kinh doanh đa dạng trong giai đoạn di chuyển người bán, "Tokopedia & Shop Partner Center" đã giới thiệu một tính năng mới có tên "Migration Rehearsal" (Diễn tập di chuyển). Tính năng này cho phép các nhà phát triển chủ động dự đoán trước hiệu suất trả về của các lệnh gọi API thông thường trên cả nền tảng Tokopedia và nền tảng Tokopedia & Shop trong từng giai đoạn tích hợp các cửa hàng Tokopedia thuộc quyền quản lý của họ với các shop Tokopedia & Shop, bao gồm giai đoạn trước khi tích hợp, đang tích hợp và sau khi tích hợp.

• Điều thiết yếu là các nhà phát triển tận dụng toàn diện tính năng này để xác thực và tối ưu hóa hệ thống của chính mình.

• 📌 Do số lượng test shop có sẵn trên nền tảng bị giới hạn và đặc tính không thể đảo ngược của quá trình tích hợp, mỗi nhà phát triển được hưởng tối đa năm cơ hội diễn tập tích hợp shop. Khuyến nghị các nhà phát triển nên tuân theo trước các hướng dẫn được cung cấp trong Changelog và Tokopedia & Shop - ISV & Seller developer onboarding để hoàn tất việc phát triển và triển khai vào môi trường thử nghiệm. Sau đó, tính năng này nên được sử dụng cho mục đích kiểm thử và xác minh.

Hướng dẫn diễn tập

Quy trình diễn tập

Chuẩn bị

Tokopedia Open Platform: https://developer.tokopedia.com/

Tokopedia & Shop Partner Center: https://partner.tiktokshop.com/

1. Nhà phát triển cần phải sở hữu một tài khoản Tokopedia Developer.
2. Phải có ít nhất một test App trong tài khoản Tokopedia Developer.

3. Nhà phát triển nên đăng ký sự kiện "merge" cho test App Tokopedia của mình theo hướng dẫn trong phần "Registering a Webhook with Tokopedia" của [Changelog]. 4. Nhà phát triển nên đảm bảo rằng không có test shop nào trong test App của mình bật các tùy chọn sau đây.

5. Thị trường mục tiêu của Tokopedia & Shop App đã bao gồm Indonesia. 6. Nhà phát triển đã liên kết tài khoản Tokopedia & Shop Partner Center của mình với tài khoản Tokopedia Open Platform.

7. Nhà phát triển nên đã tạo mới ít nhất một development shop ở Indonesia.

8. Nhà phát triển nên đã thích ứng với phiên bản API mới ở thị trường Indonesia theo [Changelog] và tài liệu API tương ứng. 9. Nhà phát triển nên đã kiểm thử quy trình nghiệp vụ của hệ thống của mình trong development shop ở Indonesia theo "Step 5: Test your App and Publish" trong Tokopedia & Shop - ISV & Seller developer onboarding.

Bắt đầu diễn tập

1. Truy cập Tokopedia & Shop Partner Center - Development Shops.
2. Chọn một Development Shop có Target market là "Indonesia".

3. Nhấp vào nút "Setting". 4. Nhấp vào "Link Tokopedia test shop".

5. Chọn test app tương ứng với Tokopedia test shop mà bạn muốn liên kết.

6. Nhấp vào "Confirm".

Xác minh

• Khi mọi thứ đã đúng thứ tự, Tokopedia test shop sẽ thử tích hợp với Tokopedia & Shop Development Shop.

Xin lưu ý rằng quá trình tích hợp này không thể đảo ngược và không thể hủy liên kết sau khi tích hợp. Quá trình này có thể kéo dài từ vài giờ đến trọn một ngày. Khi mọi thứ đã đúng thứ tự, Tokopedia test shop sẽ thử tích hợp với Tokopedia & Shop Development Shop. - Xin lưu ý rằng quá trình tích hợp này không thể đảo ngược và không thể hủy liên kết sau khi tích hợp.

• Quá trình này có thể kéo dài từ vài giờ đến trọn một ngày.

• Trong quá trình di chuyển, nhà phát triển phải bao quát tối thiểu các kịch bản sau:

Đối với Tokopedia & Shop Test Shop:

Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia & Shop Development Shop có thể được thay đổi bằng Tokopedia & Shop Products API. Các thông tin khác không thể sửa đổi và không thể thêm sản phẩm mới. Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo trong Tokopedia & Shop Development Shop và truy xuất qua Tokopedia & Shop Orders API. Việc hoàn tất đơn hàng có thể được mô phỏng thông qua Tokopedia & Shop Fulfillment API.

Đối với Tokopedia test shop:

Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia test shop có thể được thay đổi qua Tokopedia Product API. Các chi tiết khác không thể sửa đổi và việc thêm sản phẩm mới bị cấm. Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo ở phía người tiêu dùng Tokopedia bằng một tài khoản người mua thử nghiệm. Đơn hàng có thể được lấy qua Tokopedia Order API và việc hoàn tất được mô phỏng qua Tokopedia Orders API.

Khi nhà phát triển nhận được webhook "merge" do Tokopedia gateway gửi đến máy chủ, điều đó cho thấy việc tích hợp đã thành công. Sau khi shop hợp nhất:

Nhà phát triển có thể ngay lập tức sử dụng Order API để lấy đơn hàng và thực hiện hoàn tất. Tuy nhiên, các API liên quan đến đăng sản phẩm và sửa đổi sản phẩm chỉ có thể được gọi thành công sau khi người bán xác nhận thủ công "product merge". Nhà phát triển nên:

Kiểm tra xem tts_seller_id và shop_id(toko_shop_id) thu được từ Tokopedia Get Shop Info API có nhất quán với tts_seller_id và shop_id(toko_shop_id) trong webhook hay không. Kiểm tra xem có thể lấy được product id của các sản phẩm Tokopedia gốc ở phía Tokopedia & Shop thông qua Tokopedia Get Product Info API hay không. Kiểm thử kỹ lưỡng việc sử dụng Tokopedia & Shop Product API cho các tác vụ quản lý sản phẩm tiếp theo (bao gồm thay đổi giá và tồn kho, sửa đổi mô tả, đăng sản phẩm, cũng như đăng và gỡ niêm yết trên cả hai nền tảng). Sử dụng một tài khoản người mua Tokopedia để tạo một đơn hàng ảo. Sau đó, truy xuất đơn hàng qua Tokopedia & Shop Orders API và mô phỏng việc hoàn tất qua TTS Fulfillment API. Sử dụng một tài khoản người mua Tokopedia để bắt đầu một cuộc trò chuyện chăm sóc khách hàng. Sau đó, truy xuất cuộc trò chuyện qua Tokopedia & Shop Customer Service API và kiểm thử nhiều loại tin nhắn khác nhau.

Nhà phát triển nên xác nhận "Product Merge" trong seller center trước khi kiểm thử bất kỳ Tokopedia & Shop Product API nào:

Trong quá trình di chuyển, nhà phát triển phải bao quát tối thiểu các kịch bản sau: - Đối với Tokopedia & Shop Test Shop:

Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia & Shop Development Shop có thể được thay đổi bằng Tokopedia & Shop Products API. Các thông tin khác không thể sửa đổi và không thể thêm sản phẩm mới. Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo trong Tokopedia & Shop Development Shop và truy xuất qua Tokopedia & Shop Orders API. Việc hoàn tất đơn hàng có thể được mô phỏng thông qua Tokopedia & Shop Fulfillment API. Đối với Tokopedia & Shop Test Shop: - Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia & Shop Development Shop có thể được thay đổi bằng Tokopedia & Shop Products API. Các thông tin khác không thể sửa đổi và không thể thêm sản phẩm mới. - Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo trong Tokopedia & Shop Development Shop và truy xuất qua Tokopedia & Shop Orders API. Việc hoàn tất đơn hàng có thể được mô phỏng thông qua Tokopedia & Shop Fulfillment API.

• Đối với Tokopedia test shop:

Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia test shop có thể được thay đổi qua Tokopedia Product API. Các chi tiết khác không thể sửa đổi và việc thêm sản phẩm mới bị cấm. Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo ở phía người tiêu dùng Tokopedia bằng một tài khoản người mua thử nghiệm. Đơn hàng có thể được lấy qua Tokopedia Order API và việc hoàn tất được mô phỏng qua Tokopedia Orders API. Đối với Tokopedia test shop: - Kiểm thử Sửa đổi Sản phẩm: Giá và tồn kho của sản phẩm trong Tokopedia test shop có thể được thay đổi qua Tokopedia Product API. Các chi tiết khác không thể sửa đổi và việc thêm sản phẩm mới bị cấm. - Kiểm thử Hoàn tất Đơn hàng: Có thể tạo một đơn hàng ảo ở phía người tiêu dùng Tokopedia bằng một tài khoản người mua thử nghiệm. Đơn hàng có thể được lấy qua Tokopedia Order API và việc hoàn tất được mô phỏng qua Tokopedia Orders API.

• Khi nhà phát triển nhận được webhook "merge" do Tokopedia gateway gửi đến máy chủ, điều đó cho thấy việc tích hợp đã thành công.
• Sau khi shop hợp nhất:

Nhà phát triển có thể ngay lập tức sử dụng Order API để lấy đơn hàng và thực hiện hoàn tất. Tuy nhiên, các API liên quan đến đăng sản phẩm và sửa đổi sản phẩm chỉ có thể được gọi thành công sau khi người bán xác nhận thủ công "product merge". Nhà phát triển nên:

Kiểm tra xem tts_seller_id và shop_id(toko_shop_id) thu được từ Tokopedia Get Shop Info API có nhất quán với tts_seller_id và shop_id(toko_shop_id) trong webhook hay không. Kiểm tra xem có thể lấy được product id của các sản phẩm Tokopedia gốc ở phía Tokopedia & Shop thông qua Tokopedia Get Product Info API hay không. Kiểm thử kỹ lưỡng việc sử dụng Tokopedia & Shop Product API cho các tác vụ quản lý sản phẩm tiếp theo (bao gồm thay đổi giá và tồn kho, sửa đổi mô tả, đăng sản phẩm, cũng như đăng và gỡ niêm yết trên cả hai nền tảng). Sử dụng một tài khoản người mua Tokopedia để tạo một đơn hàng ảo. Sau đó, truy xuất đơn hàng qua Tokopedia & Shop Orders API và mô phỏng việc hoàn tất qua TTS Fulfillment API. Sử dụng một tài khoản người mua Tokopedia để bắt đầu một cuộc trò chuyện chăm sóc khách hàng. Sau đó, truy xuất cuộc trò chuyện qua Tokopedia & Shop Customer Service API và kiểm thử nhiều loại tin nhắn khác nhau.

Nhà phát triển nên xác nhận "Product Merge" trong seller center trước khi kiểm thử bất kỳ Tokopedia & Shop Product API nào:

Sau khi shop hợp nhất:

- Nhà phát triển có thể ngay lập tức sử dụng Order API để lấy đơn hàng và thực hiện hoàn tất. Tuy nhiên, **các API liên quan đến đăng sản phẩm và sửa đổi sản phẩm chỉ có thể được gọi thành công sau khi người bán xác nhận thủ công "product merge"**.
- Nhà phát triển nên:

Kiểm tra xem tts_seller_id và shop_id(toko_shop_id) thu được từ Tokopedia Get Shop Info API có nhất quán với tts_seller_id và shop_id(toko_shop_id) trong webhook hay không. Kiểm tra xem có thể lấy được product id của các sản phẩm Tokopedia gốc ở phía Tokopedia & Shop thông qua Tokopedia Get Product Info API hay không. Kiểm thử kỹ lưỡng việc sử dụng Tokopedia & Shop Product API cho các tác vụ quản lý sản phẩm tiếp theo (bao gồm thay đổi giá và tồn kho, sửa đổi mô tả, đăng sản phẩm, cũng như đăng và gỡ niêm yết trên cả hai nền tảng). Sử dụng một tài khoản người mua Tokopedia để tạo một đơn hàng ảo. Sau đó, truy xuất đơn hàng qua Tokopedia & Shop Orders API và mô phỏng việc hoàn tất qua TTS Fulfillment API. Sử dụng một tài khoản người mua Tokopedia để bắt đầu một cuộc trò chuyện chăm sóc khách hàng. Sau đó, truy xuất cuộc trò chuyện qua Tokopedia & Shop Customer Service API và kiểm thử nhiều loại tin nhắn khác nhau. Nhà phát triển nên: - Kiểm tra xem tts_seller_id và shop_id(toko_shop_id) thu được từ Tokopedia Get Shop Info API có nhất quán với tts_seller_id và shop_id(toko_shop_id) trong webhook hay không. - Kiểm tra xem có thể lấy được product id của các sản phẩm Tokopedia gốc ở phía Tokopedia & Shop thông qua Tokopedia Get Product Info API hay không. - Kiểm thử kỹ lưỡng việc sử dụng Tokopedia & Shop Product API cho các tác vụ quản lý sản phẩm tiếp theo (bao gồm thay đổi giá và tồn kho, sửa đổi mô tả, đăng sản phẩm, cũng như đăng và gỡ niêm yết trên cả hai nền tảng). - Sử dụng một tài khoản người mua Tokopedia để tạo một đơn hàng ảo. Sau đó, truy xuất đơn hàng qua Tokopedia & Shop Orders API và mô phỏng việc hoàn tất qua TTS Fulfillment API. - Sử dụng một tài khoản người mua Tokopedia để bắt đầu một cuộc trò chuyện chăm sóc khách hàng. Sau đó, truy xuất cuộc trò chuyện qua Tokopedia & Shop Customer Service API và kiểm thử nhiều loại tin nhắn khác nhau.

- Nhà phát triển nên xác nhận "Product Merge" trong seller center trước khi kiểm thử bất kỳ **Tokopedia & Shop Product API** nào:

FAQ

1. Tôi có thể tích hợp với những API nào?

Vui lòng nhấp vào đây để truy cập API onepager để xem thêm về:

1. Truy cập dữ liệu qua API: Sử dụng API nào để truy cập dữ liệu mới và tích hợp dữ liệu lịch sử của những người bán di chuyển từ Tokopedia sang "Tokopedia & Shop"?
2. Các thay đổi đối với API "Tokopedia & Shop": Những thay đổi nào được thực hiện trong API "Tokopedia & Shop" để phù hợp với thị trường Indonesia?
3. Ánh xạ shop và sản phẩm: Các shop và sản phẩm mới từ "Tokopedia & Shop" sẽ được ánh xạ với các shop và sản phẩm từ Tokopedia như thế nào?

2. Nếu tôi có thắc mắc, tôi có thể liên hệ Tokopedia & Shop ở đâu?

Vui lòng truy cập Help Center https://partner.tiktokshop.com/ticket/landing

3. Làm thế nào để kiểm thử API / Tôi có thể sử dụng test shop không?

Có Sandbox (công cụ kiểm thử) trong Tokopedia & Shop Partner Center - Development Kits.

Tham khảo Step 5: Test your App and Publish để biết các bước chi tiết.

4. Tôi có thắc mắc về API, làm thế nào để giải quyết?

Vui lòng truy cập Help Center https://partner.tiktokshop.com/ticket/landing