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

I. API của BigSeller là gì?

API của BigSeller là giao diện kết nối giúp liên kết BigSeller với các hệ thống bên ngoài. Thông qua API, bạn có thể kết nối dữ liệu đơn hàng, tồn kho, báo cáo và các dữ liệu kinh doanh khác trên BigSeller với phần mềm kế toán, website riêng, hệ thống tự xây dựng, công cụ phân tích dữ liệu hoặc công cụ AI, từ đó hỗ trợ đồng bộ dữ liệu và xử lý công việc giữa nhiều hệ thống.

Nếu bạn chỉ cần xem dữ liệu không thường xuyên, bạn có thể ưu tiên sử dụng các tính năng có sẵn trên BigSeller như xem dữ liệu hoặc xuất báo cáo. Nếu bạn cần đồng bộ dữ liệu định kỳ, kết nối nhiều hệ thống hoặc tự động phân tích dữ liệu kinh doanh, bạn có thể cân nhắc tích hợp API.

💡 Một số tình huống thường gặp

• Kết nối website riêng: Đồng bộ đơn hàng từ website về BigSeller để xử lý tập trung, đồng thời lấy dữ liệu tồn kho từ BigSeller để cập nhật số lượng có thể bán trên website. Để xem hướng dẫn chi tiết, bạn có thể tham khảo: Kết nối Website tự phát triển của bạn với BigSeller
• Kết nối phần mềm kế toán: Đồng bộ dữ liệu đơn hàng, sao kê và các dữ liệu liên quan từ BigSeller sang hệ thống kế toán, giảm thao tác xuất, tổng hợp và nhập dữ liệu thủ công.
• Kết nối công cụ AI: Lấy dữ liệu kinh doanh từ BigSeller để sử dụng AI tạo báo cáo, phân tích tình hình kinh doanh hoặc tổng hợp dữ liệu.

II. Quy trình đăng ký tích hợp API

Nếu bạn có nhu cầu tích hợp API, vui lòng thực hiện theo quy trình sau:

Bước 1: Xác định nhu cầu tích hợp

Trước khi liên hệ, bạn nên chuẩn bị trước các thông tin sau:

• Mục đích sử dụng: Bạn muốn giải quyết vấn đề gì thông qua API?
• Phạm vi dữ liệu: Cần kết nối cửa hàng, kho hàng, trạng thái đơn hàng, dữ liệu lịch sử và những trường dữ liệu nào?
• Hướng đồng bộ: Chỉ lấy dữ liệu từ BigSeller hay cần đẩy đơn hàng và dữ liệu khác vào BigSeller?
• Quy mô đồng bộ: Số lượng dữ liệu dự kiến mỗi ngày, tần suất gọi API và thời gian trễ có thể chấp nhận;
• Kế hoạch triển khai: Người phụ trách kỹ thuật, thời gian dự kiến đưa vào sử dụng và tiêu chí nghiệm thu.

Sau khi chuẩn bị các thông tin trên, bạn có thể liên hệ CSKH chính thức của BigSeller để được tư vấn và đánh giá phương án tích hợp.

Bước 2: Cung cấp thông tin tài khoản

Sau khi xác nhận nhu cầu, bạn cần cung cấp thông tin tài khoản BigSeller dùng để xác định đối tượng cần mở quyền tích hợp. Nhân viên phụ trách sẽ hướng dẫn bạn thực hiện các bước tiếp theo và cấp thông tin cần thiết cho việc kết nối API.

Bước 3: Nhận tài liệu API

Sau khi hoàn tất đăng ký, bạn sẽ nhận được tài liệu API tương ứng với tài khoản để đội ngũ kỹ thuật thực hiện phát triển và tích hợp.

Bước 4: Kiểm thử và kết nối

Đội ngũ kỹ thuật thực hiện tích hợp theo tài liệu API và tiến hành kiểm thử. Bạn nên kiểm tra các nội dung sau:

• Các trường dữ liệu cần thiết có đầy đủ hay không;
• Dữ liệu phân trang có được lấy đầy đủ hay không;
• Dữ liệu nhận được có khớp với dữ liệu trên BigSeller hay không;
• Gọi API nhiều lần có tạo dữ liệu trùng lặp hay không;
• Sau khi xảy ra lỗi, hệ thống có thể khôi phục và tiếp tục hoạt động bình thường hay không;
• API có hoạt động ổn định khi được gọi theo tần suất đã thống nhất hay không.

Nếu có liên quan đến việc đẩy đơn hàng hoặc đồng bộ dữ liệu kế toán, cần kiểm tra thêm trạng thái đơn hàng, cách tính số tiền, xử lý dữ liệu trùng lặp và kết quả trả về của hệ thống.

Bước 5: Xác nhận và đưa vào sử dụng

Sau khi kiểm thử hoàn tất và xác nhận hệ thống hoạt động bình thường, thực hiện thanh toán và các thủ tục mở dịch vụ theo thỏa thuận để chính thức sử dụng API.

 

III. Những điều cần lưu ý khi tích hợp API

1. Không phải tất cả dữ liệu đều được mở mặc định
Dữ liệu có thể lấy hoặc ghi vào BigSeller phụ thuộc vào khả năng của API và nhu cầu tích hợp thực tế. Đối với các nhu cầu liên quan đến đẩy đơn hàng, dữ liệu SKU hoặc dữ liệu kế toán, bạn nên xác nhận trước API tương ứng có được hỗ trợ hay không.

2. Cần thống nhất cách tính dữ liệu trước khi tích hợp
Nếu sử dụng API cho mục đích phân tích hoặc kết nối với phần mềm kế toán, bạn nên xác định trước cách tính và phạm vi dữ liệu, chẳng hạn như trạng thái đơn hàng, thời gian thống kê, loại tiền tệ, đơn hoàn tiền và các khoản chi phí.

3. Dữ liệu đồng bộ có thể có độ trễ
Nếu sử dụng API để lấy dữ liệu định kỳ, dữ liệu có thể không được cập nhật theo thời gian thực. Vì vậy, không nên mặc định rằng dữ liệu qua API luôn được đồng bộ ngay lập tức hoặc chỉ dựa vào cơ chế đồng bộ API để đảm bảo hoàn toàn không xảy ra tình trạng bán vượt tồn kho.

4. Cần xử lý dữ liệu trùng lặp khi có thao tác ghi dữ liệu
Nếu API được sử dụng để đẩy đơn hàng hoặc ghi dữ liệu vào BigSeller, bạn cần thiết lập cơ chế nhận diện và xử lý dữ liệu trùng lặp để tránh việc một yêu cầu được gửi nhiều lần dẫn đến tạo trùng đơn hàng hoặc bản ghi.

 

IV. Các câu hỏi thường gặp

Q1: Tích hợp API của BigSeller phù hợp với những trường hợp nào?

A: Nếu bạn muốn kết nối BigSeller với phần mềm kế toán, website riêng, hệ thống tự xây dựng, công cụ phân tích dữ liệu hoặc công cụ AI để đồng bộ dữ liệu định kỳ và xử lý công việc giữa nhiều hệ thống, bạn có thể cân nhắc tích hợp API.

Nếu chỉ cần xem dữ liệu không thường xuyên, bạn có thể ưu tiên sử dụng các tính năng xem dữ liệu và xuất báo cáo có sẵn trên BigSeller.

Q2: Khi lần đầu liên hệ để tư vấn tích hợp API, tôi cần chuẩn bị những gì?

A: Bạn nên chuẩn bị mục đích tích hợp, phạm vi dữ liệu cần kết nối, hướng đồng bộ, số lượng dữ liệu dự kiến, tần suất gọi API, người phụ trách kỹ thuật và thời gian dự kiến triển khai.

Thông tin càng cụ thể thì BigSeller càng dễ đánh giá và đề xuất phương án phù hợp.

Q3: Khi đăng ký tích hợp API, tôi có cần cung cấp mật khẩu BigSeller không?

A: Không cần cung cấp mật khẩu hoặc mã xác minh trong nội dung trao đổi thông thường. Khi đăng ký, bạn chỉ cần cung cấp thông tin tài khoản dùng để xác định đối tượng cần mở quyền. Cách thức cung cấp thông tin tài khoản và API Key cụ thể sẽ do nhân viên phụ trách hướng dẫn.

Sau khi nhận API Key, bạn cần bảo quản cẩn thận và không đặt API Key trong mã nguồn website công khai, kho mã nguồn công khai hoặc ảnh chụp màn hình được chia sẻ trong nhóm chat.

Q4: Từ lúc đăng ký đến khi có thể chính thức sử dụng API mất bao lâu?

A: Thời gian tích hợp phụ thuộc vào phạm vi API, điều kiện của hệ thống cần kết nối, độ phức tạp của việc ánh xạ dữ liệu và quá trình kiểm thử.

Các nhu cầu chỉ lấy dữ liệu để tạo báo cáo thường có yêu cầu triển khai khác với các nhu cầu có thêm thao tác đẩy đơn hàng hoặc xử lý dữ liệu kế toán.

Thời gian cụ thể sẽ được xác nhận sau khi hoàn tất đánh giá nhu cầu.

Q5: Làm thế nào để xác nhận tích hợp API đã thành công?

A: Không nên chỉ dựa vào việc một lần gọi API thành công để xác định việc tích hợp đã hoàn tất. Bạn nên kiểm tra ít nhất các nội dung sau:

• Các trường dữ liệu cần thiết đều đầy đủ;
• Dữ liệu nhận được khớp với dữ liệu trên BigSeller;
• Dữ liệu phân trang được lấy đầy đủ;
• Gọi lại API không tạo dữ liệu trùng lặp;
• Hệ thống có thể khôi phục bình thường sau khi xảy ra lỗi;
• API hoạt động ổn định khi chạy theo tần suất đã thống nhất.

Nếu có thao tác đẩy đơn hàng hoặc dữ liệu kế toán, cần kiểm tra thêm trạng thái đơn hàng, cách tính số tiền và cơ chế xử lý dữ liệu trùng lặp.

Q6: Tích hợp API có tính phí không?

A: Chi phí tích hợp API sẽ được đánh giá dựa trên nhu cầu thực tế. Giá, loại tiền tệ, thuế, nội dung gói dịch vụ và thời hạn sử dụng sẽ được xác nhận theo báo giá và thỏa thuận dịch vụ chính thức.

Bạn có thể liên hệ Quản lý khách hàng hoặc CSKH chính thức của BigSeller để được tư vấn chi tiết.