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 tự phát triển, 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.

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

2.1 Kết nối website tự phát triển

Đồ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

Nhu cầu thường gặp
Website của thương hiệu phát sinh đơn hàng và cần chuyển về BigSeller để xử lý tập trung, đồng thời hiển thị tồn kho có thể bán của kho đã được thống nhất.

💡 Ví dụ
Sau khi khách hàng đặt hàng trên website, chương trình tích hợp sẽ kiểm tra thông tin sản phẩm và đơn hàng rồi chuyển đơn hàng vào BigSeller. Website định kỳ truy vấn tồn kho và điều chỉnh số lượng hiển thị dựa trên quy tắc tồn kho an toàn.

Cần xác nhận trước khi kết nối

• Quyền sử dụng API tạo đơn hàng
• Quy tắc ánh xạ SKU và kho hàng
• Cơ chế nhận diện đơn hàng trùng lặp
• Quy trình hủy đơn và hoàn tiền
• Quy tắc kích hoạt khóa và giải phóng tồn kho

Tiêu chí nghiệm thu

• Gửi cùng một đơn hàng nhiều lần không tạo ra nhiều đơn hàng trùng lặp; có thể xác định được SKU không hợp lệ; hệ thống cảnh báo khi phát hiện bất thường về tồn kho.
• Việc khóa tồn kho, giao kho và đồng bộ trạng thái đơn hàng cần tuân theo API thực tế và quy tắc nghiệp vụ đã thống nhất. Đồng bộ định kỳ vẫn có thể phát sinh độ trễ, vì vậy không thể đảm bảo hoàn toàn không xảy ra tình trạng bán vượt tồn kho.
   

2.2 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.

Nhu cầu thường gặp
Dữ liệu vận hành được quản lý trên BigSeller, trong khi việc ghi nhận kế toán và phân tích tài chính được thực hiện trên phần mềm kế toán Kingdee. Doanh nghiệp muốn giảm thao tác xuất dữ liệu, làm sạch dữ liệu và nhập liệu thủ công nhiều lần.


💡 Ví dụ
Hằng ngày, hệ thống lấy dữ liệu đơn hàng, hóa đơn thanh toán và giao dịch ví trong phạm vi đã thống nhất, sau đó tổng hợp theo gian hàng, loại tiền tệ và ngày nghiệp vụ để tạo danh sách dữ liệu cần đối soát và bảng chênh lệch.

Cần xác nhận trước khi kết nối

• Phiên bản Kingdee và khả năng phát triển tích hợp
• Loại chứng từ cần đồng bộ
• Quy tắc ánh xạ tài khoản kế toán
• Tỷ giá quy đổi tiền tệ
• Cách xác định số tiền hoàn trả và các khoản phí
• Cần xác định riêng doanh thu, hàng hoàn nhập kho và lợi nhuận; không sử dụng các chỉ tiêu này thay thế cho nhau

Tiêu chí nghiệm thu

• Có thể truy xuất nguồn gốc của từng bản ghi; đối chiếu được số tiền và số lượng bản ghi; chạy lại quy trình không tạo trùng chứng từ.
• Nếu cần dữ liệu khoản phải thu ở cấp SKU, vui lòng liên hệ CS BigSeller để xác nhận chức năng này đã được mở hay chưa và phạm vi áp dụng cụ thể.

2.3 Phân tích bằng AI Agent

Trợ lý phân tích kinh doanh: Từ câu hỏi đến báo cáo hằng ngày có thể truy xuất nguồn dữ liệu


Nhu cầu thường gặp
Người phụ trách muốn nắm bắt tình hình đơn hàng, hiệu quả hoạt động của các gian hàng trọng điểm và rủi ro tồn kho mỗi ngày mà không phải liên tục tổng hợp nhiều bảng dữ liệu thủ công.


💡 Ví dụ
Hằng ngày, hệ thống tổng hợp đơn hàng của ngày hôm trước, so sánh tình hình hoạt động gần đây theo gian hàng và loại tiền tệ, đồng thời liệt kê những gian hàng có biến động lớn về số lượng đơn hàng. Kết hợp dữ liệu tồn kho khả dụng và doanh số, hệ thống tạo danh sách SKU cần theo dõi.

Cần xác nhận trước khi kết nối

• Các trường dữ liệu có thể truy vấn
• Múi giờ dùng để thống kê
• Trạng thái đơn hàng
• Loại tiền tệ
• Cách xử lý đơn hàng hoàn trả
• Kênh nhận báo cáo
• Phạm vi sử dụng dữ liệu của nền tảng phân tích

Tiêu chí nghiệm thu

• Các chỉ số được tính toán bằng chương trình; báo cáo ghi rõ thời điểm lấy dữ liệu và quy tắc thống kê. Nếu lấy dữ liệu thất bại, hệ thống phải thông báo rõ phần dữ liệu còn thiếu, không mặc định dữ liệu thiếu là doanh số bằng 0.
• Nếu muốn tự động gửi báo cáo vào nhóm chat, cần cấu hình bổ sung kênh gửi tin nhắn và các quyền liên quan.

 

III. 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.
 

V. Chi phí và tư vấn kết nối

Nếu có nhu cầu tìm hiểu về dịch vụ kết nối API, vui lòng liên hệ trực tiếp với CSKH chính thức của BigSeller.

Vui lòng cung cấp thông tin về hệ thống cần kết nối, tình huống nghiệp vụ và dữ liệu cần sử dụng cho nhân viên CS. BigSeller sẽ căn cứ vào nhu cầu thực tế để tư vấn và xây dựng phương án API phù hợp. Giá cuối cùng, loại tiền tệ, thuế phí, nội dung gói dịch vụ và thời hạn sử dụng sẽ được xác định theo báo giá chính thức.

VI. 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 tự phát triển, 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.