Shopee API: Tất tần tật thông tin bạn cần biết và cách kết nối Shopee API hiệu quả cho người bán hàng

Với khả năng tích hợp trực tiếp vào hệ thống, Shopee API giúp tự động hóa nhiều quy trình kinh doanh, từ quản lý đơn hàng, sản phẩm, đến theo dõi dữ liệu bán hàng. Bài viết này của FPT Shop sẽ giới thiệu chi tiết về Shopee API, các điều kiện và quy trình xét duyệt, cũng như hướng dẫn cụ thể về cách đăng ký. Hãy cùng khám phá nhé!

Shopee API là gì?

Shopee API là một giao diện lập trình ứng dụng (API) được cung cấp bởi Shopee, một trong những sàn thương mại điện tử lớn nhất Đông Nam Á. Shopee API cho phép các nhà phát triển và người bán hàng tích hợp trực tiếp với hệ thống của Shopee, từ đó có thể thực hiện các tác vụ như quản lý đơn hàng, sản phẩm, kho hàng, và các thông tin khác một cách tự động và hiệu quả.

Shopee API giúp tiết kiệm thời gian và giảm thiểu sai sót khi quản lý cửa hàng, đồng thời cung cấp các công cụ mạnh mẽ để phát triển các tính năng tùy chỉnh, tối ưu hóa quy trình kinh doanh và cải thiện trải nghiệm mua sắm cho khách hàng. Với Shopee API, người bán hàng có thể:

• Tự động hóa việc cập nhật thông tin sản phẩm và tồn kho.
• Xử lý đơn hàng nhanh chóng và chính xác.
• Theo dõi và phân tích dữ liệu bán hàng.
• Tích hợp với các hệ thống quản lý khác như ERP, CRM, và các ứng dụng Marketing.

Điều kiện sử dụng và quy trình xét duyệt Open API

Điều kiện sử dụng Open API

• Tài khoản được yêu cầu kết nối với API cần phải là Shop Yêu Thích hoặc thuộc Shopee Mall.
• Cần có đội ngũ lập trình viên chuyên nghiệp để hỗ trợ việc tích hợp API.
• Phải sở hữu một hệ thống quản lý đơn hàng và sản phẩm độc lập, được xây dựng và vận hành trên nền tảng web.
• Hệ thống này cần có khả năng tương tác và liên kết với các hệ thống bên ngoài.

Điều kiện dành cho đối tác 3rd Party

• Đối tác phải có giấy phép kinh doanh hợp lệ cùng với một trang web chính thức.
• Cần cung cấp thông tin tài khoản dùng thử và mật khẩu để Shopee có thể xác minh trước khi tiến hành phê duyệt.

Quy trình xét duyệt Shopee API

Bước 1: Đăng ký tài khoản API tại đây.

Bước 2: Chờ đợi xét duyệt

Sau khi đăng ký thành công, tài khoản của bạn sẽ được Shopee xét duyệt trong vòng:

• 3 ngày làm việc đối với người bán.
• 1 - 2 tuần làm việc đối với đối tác là bên thứ 3 (có thể lâu hơn tùy thuộc vào nội dung cần xác minh).

Shopee sẽ thông báo kết quả xét duyệt qua email.

Bước 3: Tiếp theo sau khi xét duyệt

Xét duyệt thành công bạn sẽ nhận được hướng dẫn để bắt đầu sử dụng API.

Xét duyệt không thành công bạn sẽ nhận được thông báo từ Shopee và hướng dẫn xử lý tùy theo trường hợp.

Hướng dẫn đăng ký Shopee Open Platform đơn giản

Bước 1: Đăng ký tài khoản

• Truy cập vào trang Shopee Open Platform tại địa chỉ: https://open.shopee.com để bắt đầu quá trình đăng ký.
• Nhập địa chỉ email của bạn để tạo tài khoản mới.

Lưu ý quan trọng:

• Địa chỉ email và tên của công ty/shop không thể thay đổi được sau khi hoàn tất đăng ký.
• Hãy đảm bảo rằng bạn cung cấp một địa chỉ email chính xác để nhận được các yêu cầu xác nhận từ Shopee.

Bước 2: Xác minh email

• Kiểm tra hộp thư đến của bạn và tìm email xác minh từ Shopee.
• Nhấp vào liên kết 'Verify your email' để xác nhận địa chỉ email của bạn.

Bước 3: Tạo mật khẩu

• Sau khi xác minh email, bạn sẽ được yêu cầu tạo một mật khẩu mới.
• Điền mật khẩu và chọn 'Create' để hoàn tất việc tạo tài khoản.

Bước 4: Cung cấp thông tin chi tiết

• Đăng nhập vào tài khoản của bạn và chọn 'Console' để điền thông tin cơ bản.
• Để dùng Open API, bạn cần được Shopee xét duyệt qua việc cung cấp thông tin cho tài khoản (Profile).
• Chọn loại ứng dụng bạn muốn tạo và cung cấp thông tin cần thiết.

Lưu ý quan trọng:

• Có bốn loại nhà phát triển khác nhau và mỗi loại chỉ có thể tạo những ứng dụng nhất định tương ứng.
• Hiện tại, Shopee Việt Nam không hỗ trợ nhà phát triển cá nhân thứ ba (Individual 3rd Party).

Bước 5: Hoàn tất đăng ký

• Nếu bạn là người bán hàng trên Shopee, bạn cần cung cấp tên đăng nhập của shop và email của người quản lý tài khoản chính (nếu có).
• Nếu bạn không chắc chắn về tên đăng nhập của mình, hãy truy cập vào banhang.shopee.vn để tìm hiểu.

Sau khi hoàn tất các bước trên, bạn đã sẵn sàng để liên kết với Open API. Shopee sẽ xem xét tài khoản của bạn và thông báo kết quả qua email đăng ký.

Cách tạo app (sau khi được duyệt tài khoản)

Bước 1: Truy cập danh sách ứng dụng 'App List'.

Bước 2: Tạo ứng dụng mới 'Create App'.

Bước 3: Nhập thông tin chi tiết cho ứng dụng:

• Loại ứng dụng (APP Type): Chọn loại phù hợp với nhu cầu sử dụng của bạn
• Tên ứng dụng (APP Name): Đặt tên cho ứng dụng.
• Khu vực dịch vụ (App Service Region): Lựa chọn khu vực là VietNam.
• Mô tả ứng dụng (App Description): Thêm mô tả chi tiết về ứng dụng.
• Logo ứng dụng (App Logo): Tải lên logo cho ứng dụng của bạn.

Bước 4: Xác nhận thông tin đã nhập và gửi yêu cầu 'Submit'. Sau khi gửi yêu cầu, ứng dụng của bạn sẽ được đăng ký trên môi trường thử nghiệm (Sandbox), nơi bạn có thể sử dụng Test partner_id và Test key.

Bước 5: Chuyển sang môi trường sản xuất 'Go-Live' để bắt đầu sử dụng API trên môi trường thực tế.

Bước 6: Điền thông tin cơ bản cần thiết.

Bước 7: Gửi yêu cầu 'Submit' và chờ đợi phản hồi trong vòng 24 giờ.

Lưu ý: Hãy kiểm tra cẩn thận tất cả thông tin trước khi chuyển sang môi trường sản xuất, vì mọi thao tác ở đây sẽ ngay lập tức có hiệu lực.

Cách xóa APP

Để xóa một ứng dụng trong Shopee Open Platform, bạn có thể làm theo các bước sau:

Bước 1: Truy cập vào danh sách ứng dụng ‘App List’.

Bước 2: Tìm và chọn ứng dụng bạn muốn gỡ bỏ khỏi hệ thống.

Bước 3: Nhấn vào nút 'Xóa' (Delete) để tiến hành gỡ bỏ ứng dụng.

Bước 4: Khi hệ thống hiển thị thông báo xác nhận, hãy chọn 'Xác nhận' (Confirm) để hoàn tất quá trình xóa ứng dụng.

Hướng dẫn sử dụng API

Dưới đây là một hướng dẫn chi tiết về cách sử dụng API, từ việc phân biệt các môi trường API đến việc thực hiện các yêu cầu xác thực.

Phân biệt các môi trường API

Khi ứng dụng của bạn đã được phê duyệt, bạn sẽ nhận được thông tin về hai môi trường API chính: Môi trường Live và Môi trường Sandbox.

• Môi trường Live: Đây là môi trường thực tế, nơi các giao dịch và hoạt động kinh doanh diễn ra. Khi bạn sử dụng API trong môi trường này, bạn đang tương tác với dữ liệu thực và ảnh hưởng đến hoạt động kinh doanh thực sự.
• Môi trường Sandbox: Đây là môi trường thử nghiệm, nơi bạn có thể an toàn thử nghiệm và gỡ lỗi mã của mình mà không ảnh hưởng đến dữ liệu thực. Môi trường Sandbox giúp bạn mô phỏng các hoạt động giống như môi trường Live mà không gặp rủi ro.

Sử dụng tài khoản test trong Môi trường Sandbox

Shopee cung cấp các tài khoản test để lập trình viên có thể mô phỏng hoạt động mua bán và kiểm tra các tính năng trong môi trường giả lập.

Tài khoản Seller: Bạn có thể truy cập vào tài khoản Seller test của mình thông qua trang  https://open.shopee.com. Tại đây, bạn đăng nhập, chọn 'Console', sau đó 'Tool', và cuối cùng là 'Test Account' và 'Create Test Account' để tạo tài khoản test mới.

• Lưu ý: Mỗi ứng dụng có thể tạo tối đa 9 tài khoản Local Shop, 9 tài khoản Cross Border Shop và 3 tài khoản Merchant. Mỗi tài khoản test bao gồm một cặp shop - buyer và có thể được sử dụng cho mục đích Seller & Buyer.

Tài khoản Buyer: Bạn có thể sử dụng tài khoản test đã tạo để thực hiện vai trò là Buyer và mô phỏng quy trình mua hàng như trong môi trường Live.

Ủy quyền cho Shop

Để ứng dụng của bạn có thể gọi API cho Shop, thì cần được ủy quyền bởi người bán. Quy trình ủy quyền Shop diễn ra như sau:

• Lập trình viên tạo ra một liên kết ủy quyền.
• Người bán nhấp vào liên kết và đăng nhập bằng tài khoản người bán.

Phương pháp xác thực yêu cầu

Để nâng cao độ an toàn cho API, Shopee đặt ra yêu cầu cho các nhà phát triển phải xác thực mọi yêu cầu trước khi thực hiện gọi API thành công, thông qua việc sử dụng chữ ký Authorization trong phần headers.

Các bước để tạo chữ ký Authorization:

• Tạo chuỗi cơ sở cho chữ ký.
• Sử dụng thuật toán HMAC-SHA256 để mã hóa chuỗi cơ sở chữ ký.

Kiểm tra Open API

Lập trình viên có thể dùng các công cụ như Postman, SoapUI, KarateDSL… để gọi và kiểm tra các chức năng của Shopee Open API.

Xem thêm: Ưu và nhược điểm mô hình kinh doanh của Shopee? Gợi ý phần mềm bán hàng phù hợp

Hướng dẫn cách yêu cầu hỗ trợ API

Dưới đây là hướng dẫn chi tiết về cách yêu cầu hỗ trợ (raise ticket) API trên Shopee Open Platform.

Bước 1: Truy cập và đăng nhập vào trang web Shopee Open Platform tại đây.

Bước 2: Sau khi đăng nhập, chọn mục ‘Support Center’ từ menu. Chọn tiếp ‘Raise Ticket’ để bắt đầu quá trình yêu cầu hỗ trợ.

Bước 3: Chọn vấn đề API cần hỗ trợ:

• Platform Onboarding: Các vấn đề liên quan đến đăng ký tài khoản nhà phát triển, kiểm tra và cập nhật hồ sơ.
• App Management: Các vấn đề liên quan đến việc tạo và quản lý ứng dụng, bao gồm hoạt động và các hạn chế.
• Seller Authorization: Các vấn đề liên quan đến quy trình ủy quyền người bán, liên kết ủy quyền và các vấn đề ủy quyền khác.
• Sandbox Test: Các vấn đề liên quan đến công cụ kiểm tra API, tài khoản kiểm tra và các vấn đề trong môi trường Sandbox.
• API Call: Các vấn đề liên quan đến quyền truy cập, sử dụng và gọi API.
• Feature Feedback: Các vấn đề liên quan đến phản hồi về tính năng của Shopee Open Platform và API.
• Other: Các vấn đề khác không thuộc các danh mục trên.

Bước 4: Xác định vấn đề cụ thể, khi chọn một vấn đề ví dụ Platform Onboarding, bạn sẽ thấy một trang với các thông tin liên quan. Để liên hệ với bộ phận chăm sóc khách hàng, chọn ‘Raise Ticket’.

Bước 5: Điền các thông tin cần thiết vào mẫu yêu cầu hỗ trợ. Chọn ‘Submit’ để hoàn tất việc gửi yêu cầu.

Thời gian phản hồi

Sau khi bạn hoàn tất quá trình raise ticket, Shopee cam kết sẽ phản hồi qua email trong khoảng thời gian như sau:

• 3 ngày đối với các vấn đề liên quan đến live issue.
• 5 ngày đối với các vấn đề non-live issue.

Do đó, hãy thường xuyên kiểm tra hộp thư email của bạn để không bỏ lỡ bất kỳ phản hồi nào từ Shopee.

Lời kết

Shopee API rất có ích trong việc giúp người bán hàng trên Shopee tối ưu hóa quy trình kinh doanh và cải thiện hiệu quả hoạt động. Bằng việc tuân thủ hướng dẫn và quy trình xét duyệt, người bán hàng có thể dễ dàng tích hợp và khai thác tối đa các lợi ích mà Shopee API mang lại.

Xem thêm:

• Các đơn vị vận chuyển của Shopee: Thông tin chi tiết và cách lựa chọn đơn vị vận chuyển
• Nên bán hàng trên Shopee hay Lazada? Top các sàn thương mại điện tử đang được ưa chuộng

Bạn đang tìm kiếm một chiếc laptop mạnh mẽ, bền bỉ và giá cả hợp lý để hỗ trợ công việc kinh doanh trên các sàn thương mại điện tử? FPT Shop chính là một trong những điểm đến lý tưởng dành cho bạn! Chúng tôi cung cấp đa dạng các mẫu laptop đến từ nhiều thương hiệu uy tín như Dell, HP, ASUS, Acer, Lenovo,... có cấu hình mạnh mẽ, đáp ứng mọi nhu cầu sử dụng, từ xử lý văn bản, soạn thảo email, quản lý kho hàng đến thiết kế đồ họa, lập trình,...

Xem thêm các sản phẩm laptop mới nhất đang có ở FPT Shop tại đây:

• Laptop giá tốt