Tổng quan HiTechPos SDK
HiTechPos SDK là thư viện client chính thức, đa ngôn ngữ (JS/TS, PHP, Python, Go, Java) bọc toàn bộ API HiTechPos — nền tảng bán lẻ / point-of-sale đa kênh: đơn hàng, sản phẩm, tồn kho, kho đa chi nhánh, khách hàng, khuyến mãi, sổ quỹ, báo cáo, sàn TMĐT và hoá đơn điện tử.
HiTechPos SDK là thư viện client mã nguồn mở, bọc toàn bộ API của HiTechPos — hệ thống bán lẻ / point-of-sale đa kênh (omnichannel) — trong một giao diện lập trình nhất quán. Thay vì tự dựng HTTP request, tự xử lý phân trang page_number/page_size, tự gắn Bearer token hay tự parse envelope status/data/meta, bạn cài một gói cho ngôn ngữ của mình rồi gọi phương thức theo từng nghiệp vụ: đơn hàng, sản phẩm & biến thể, tồn kho, kho/chi nhánh, khách hàng, khuyến mãi, sổ quỹ/công nợ, báo cáo, sàn TMĐT và hoá đơn điện tử.
Vì sao dùng SDK thay vì gọi HTTP trực tiếp
- Một client, mọi nghiệp vụ — cùng một đối tượng
clienttruy cập đơn hàng, sản phẩm, tồn kho, khách hàng… theo không gian tên (client.orders,client.products,client.inventory). - Xác thực tự động — gắn Bearer token vào header
Authorizationở mọi yêu cầu. - Bền vững — thử lại có backoff theo cấp số nhân, idempotency key cho thao tác tạo đơn/nhập kho, timeout cấu hình được.
- An toàn kiểu — định nghĩa kiểu TypeScript, type hint Python, struct Go, generic Java.
- Phân trang & webhook — bộ lặp tự động gom hết trang và một hàm xác minh chữ ký webhook dùng chung.
Kiến trúc tổng thể
SDK định tuyến mỗi lời gọi tới host HiTechPos; bạn chỉ làm việc với các phương thức theo không gian tên, mỗi lời gọi gắn với một shop_id.
Các nhóm nghiệp vụ được hỗ trợ
HiTechPos hợp nhất đơn hàng và tồn kho giữa cửa hàng và các sàn TMĐT.
Ngôn ngữ được hỗ trợ
| Ngôn ngữ | Gói | Cài đặt |
|---|---|---|
| JavaScript / TypeScript | @hitechcloud/hitechpos-sdk | npm i @hitechcloud/hitechpos-sdk |
| PHP | hitechcloud/hitechpos-sdk | composer require hitechcloud/hitechpos-sdk |
| Python | hitechpos | pip install hitechpos |
| Go | .../hitechpos-sdk/go | go get github.com/hitechcloudvn/hitechpos-sdk/go |
| Java | vn.hitechcloud:hitechpos-sdk | Maven / Gradle |