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

Hướng dẫn tích hợp CNSC API

1. CNSC là gì?

Tên đầy đủ của CNSC là China Seller Center (Trung tâm người bán Trung Quốc), là giao diện quản lý dành riêng cho người bán xuyên biên giới Trung Quốc bao gồm cả người bán Hồng Kông, thông qua đó người bán có thể quản lý sản phẩm, đơn hàng, marketing, v.v. cho nhiều cửa hàng. Để xem hướng dẫn vận hành cơ bản và giới thiệu về CNSC, vui lòng truy cập đây.

Quan trọng: Người bán CNSC và các nhà phát triển ERP (ISV) quản lý cửa hàng CNSC cần chú ý rằng khi nâng cấp lên CNSC, API sản phẩm cần được thay thế bằng các API khác. Các API cần phát triển bao gồm Global Product API và Merchant API. Và đảm bảo rằng bạn đã sử dụng ủy quyền cửa hàng V2.0.

Nếu CNSC API - Global Product API và Merchant API không được tích hợp, các cửa hàng đã nâng cấp lên CNSC không thể sử dụng các lần gọi API cho các module liên quan đến đăng sản phẩm.

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

Hỏi: Làm thế nào để biết một cửa hàng đã được nâng cấp lên CNSC?

Đáp: Bạn có thể truy vấn API v2.shop.get_shop_info và nếu API trả về tham số merchant_id, sau đó truy vấn v2.merchant.get_merchant_info với merchant_region=CN hoặc HK, điều đó có nghĩa cửa hàng đã được nâng cấp lên CNSC.

Hỏi: Nếu hệ thống của tôi không có chức năng liên quan đến sản phẩm, tức là không bao gồm chức năng tạo và cập nhật sản phẩm, tôi có cần thực hiện điều chỉnh gì không?

Đáp: Không cần. Chẳng hạn như API liên quan đến đơn hàng, không có thay đổi nào đối với luồng gọi API.

2. Cách tích hợp CNSC API

2.1 Đăng ký làm nhà phát triển (Nếu bạn đã có tài khoản nhà phát triển, có thể bỏ qua bước này)​

a. Nhấp "Đăng ký" và đọc "Thỏa thuận", đăng ký tài khoản Shopee Open Platform bằng email. https://open.shopee.com/

b. Bạn sẽ nhận được email xác minh, vui lòng xác minh email và đặt mật khẩu.

c. Đăng nhập bằng tài khoản của bạn.

2.2 Hoàn thiện thông tin tài khoản (Nếu bạn đã có tài khoản nhà phát triển được phê duyệt, có thể bỏ qua bước này)​

a. Vui lòng tham khảo bài viết này để tìm hiểu loại tài khoản nhà phát triển của bạn.

Đăng nhập vào Open Platform >> Console >> Danh sách ứng dụng >> Chọn loại nhà phát triển >> Thêm

*Các loại nhà phát triển khác nhau sẽ có các loại ứng dụng khác nhau. Để biết chi tiết, vui lòng tham khảo trang Quản lý ứng dụng.

b. Hoàn thiện hồ sơ phù hợp theo loại nhà phát triển bạn chọn. Thông tin cần được nền tảng Shopee xem xét.

2.3 Tạo ứng dụng​

Để gọi Shopee OpenAPI, trước tiên bạn cần tạo một ứng dụng. Bạn có thể tạo ứng dụng sau khi hồ sơ nhà phát triển được phê duyệt.

Lưu ý

*Loại APP gốc không hỗ trợ API v2.0. Nếu ứng dụng hiện có của bạn là loại gốc, vui lòng hoàn tất nâng cấp ứng dụng theo thông báo này.

*Đối với các loại ứng dụng khác, vui lòng kiểm tra quyền API theo bài viết này.

Nếu bạn chưa có ứng dụng, bạn có thể tạo theo đường dẫn này

Đường dẫn: Open Platform >> Console >> Danh sách ứng dụng >> + Tạo ứng dụng >> Điền thông tin >> Gửi

2.4 Phát hành ứng dụng​

Bạn phải đảm bảo trạng thái ứng dụng của mình là online. Nhấp "Go-Live" để yêu cầu sử dụng API môi trường thực.

Open Platform >> Console >> Danh sách ứng dụng >> Chọn ứng dụng cần phát hành >> Nhấp Go live >> Điền thông tin >> Gửi

Ứng dụng sẽ tự động hoàn tất xem xét sau 24 giờ và trạng thái APP sẽ chuyển sang Online, nhà phát triển sẽ nhận được Live Partner id và Partner Key của môi trường thực.

2.5 Bắt đầu kiểm thử API​

  1. Để bắt đầu kiểm thử, bạn nên tạo một China merchant trên Console

  1. Đăng nhập vào https://seller.test-stable.shopee.cn. Lưu ý rằng mã OTP là 123456.

** Lưu ý: Vui lòng sử dụng Google Translate để dịch sang tiếng Anh hoặc tiếng Hàn nếu cần.

  1. Thiết lập tiền tệ sau khi đăng nhập.

** Lưu ý: Khi kiểm thử trong sandbox CNSC, chỉ có tiền tệ CNY.

Trong CNSC thực (môi trường thực), các tùy chọn tiền tệ sẽ là USD hoặc CNY hiện tại và hỗ trợ HKD trong tương lai.

  1. Thiết lập tỷ giá thị trường. Nếu bạn nhập sai số, chúng tôi sẽ thông báo phạm vi số đúng như trong ảnh chụp màn hình.

  1. Sau đó, bạn có thể đặt ngôn ngữ giao diện trong trang cài đặt Merchant sang tiếng Anh.

  1. Kiểm tra trang Global SKU. Vui lòng hoàn tất cài đặt và nhấp nút "Start to upgrade to Global SKU"

Sau đó bạn có thể bắt đầu kiểm thử open api. Để biết thêm chi tiết, bạn có thể xem bài viết Kiểm thử Sandbox.

b. Khi người bán đăng nhập vào CNSC và hoàn tất nâng cấp sản phẩm cho từng cửa hàng, v2.shop.get_shop_info sẽ trả về merchant_id. Sau đó có thể truy vấn v2.merchant.get_merchant_info để kiểm tra.

c. Kiểm thử Global Product API và Merchant API. Bạn có thể xem luồng gọi API từ đây.

2.6 Ủy quyền Merchant & Cửa hàng​

Vì sau khi tài khoản cửa hàng được nâng cấp lên CNSC, nhiều cửa hàng sẽ thuộc về các merchant, bạn có thể tìm hiểu thêm về mối quan hệ giữa Merchant và cửa hàng qua Câu hỏi thường gặp này.

Do đó, để bạn gọi GlobalProduct API bình thường, vui lòng ủy quyền lại các cửa hàng của bạn và chuyển trang tài khoản phụ khi ủy quyền.

Vui lòng sử dụng tài khoản chính để ủy quyền. Tài khoản phụ không thể hoàn tất ủy quyền. Định dạng tài khoản chính là ***.main

Sau khi đăng nhập thành công vào tài khoản, bạn sẽ thấy trang Ủy quyền, trước tiên chọn cửa hàng bạn muốn ủy quyền rồi chọn Auth Merchant. Nếu bạn không chọn Auth Merchant, bạn sẽ không thể gọi Global Product API liên quan hoặc lấy thông tin Merchant. Nếu một số cửa hàng không được chọn, sản phẩm không thể được xuất bản lên cửa hàng liên quan qua API. Vì vậy hãy đảm bảo bạn chọn đầy đủ Merchant và cửa hàng bạn quản lý.

Sau khi ủy quyền thành công, địa chỉ callback sẽ trả về main_account_id thay vì shop id. Main_account_id sẽ được dùng để lấy AccessToken sau đó.

Sau đó vui lòng làm mới token theo tài liệu này.

Thông qua GetAccesstoken API, bạn sẽ nhận được danh sách tất cả merchant id và shop id đã được ủy quyền thành công tại thời điểm đó.

Lưu ý rằng token của mỗi merchant và mỗi cửa hàng là độc lập và bạn cần lưu chúng riêng biệt. Khi hoàn tất ủy quyền, refresh token và access token ban đầu bạn lấy được có thể được chia sẻ bởi merchant id và shop id được ủy quyền hiện tại, và sau đó khi bạn gọi RefreshAccessToken API, các merchant id hoặc shop id khác nhau sẽ trả về các refresh token và access token khác nhau, vì vậy hãy lưu token của chúng riêng biệt.

Nếu bạn muốn lấy mối quan hệ giữa merchant id và shop id, vui lòng gọi API get_shop_list_by_merchant. Bạn có thể lấy thông tin mỗi merchant bằng cách gọi get_merchant_info, và gọi get_shop_info để lấy thông tin mỗi cửa hàng.

3. Tóm tắt

  1. Khi bạn tạo ứng dụng hoặc sử dụng ứng dụng hiện có, hãy đảm bảo rằng loại ứng dụng của bạn có thể gọi Global Product API v2.0.

  2. Cửa hàng cần được người bán ủy quyền lại để cung cấp dịch vụ API liên quan đến sản phẩm CNSC cho người bán.

  3. Cần đảm bảo trạng thái APP là Online để người dùng người bán có thể sử dụng CNSC API trong môi trường thực. Nhấp Go Live trong Console Open Platform và gửi thông tin. APP sẽ tự động được phê duyệt sau 24 giờ.

  4. Người bán cần đăng nhập vào CNSC và hoàn tất các cài đặt liên quan trước khi nâng cấp sản phẩm CNSC thành công. Chỉ khi sản phẩm được nâng cấp thành công, Global Product API mới có thể được gọi bình thường.

  5. Bạn có thể tìm hiểu thêm về Câu hỏi thường gặp CNSC API tại đây: API FAQ

Nếu bạn gặp bất kỳ vấn đề kết nối kỹ thuật nào không được đề cập trong tài liệu này, vui lòng liên hệ Shopee Open Platform thông qua hệ thống ticket.​