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

Xem Markdown

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

Mã nguồn mở tại github.com/hitechcloudvn/hitechpos-sdk. Mỗi ngôn ngữ nằm trong thư mục con riêng và phát hành lên kho gói chính thức (npm, Packagist, PyPI, pkg.go.dev, Maven Central).

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 client truy 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ể

Ứng dụng của bạn gọi HiTechPos qua một SDK duy nhất
Ứng dụng của bạnBackend · POS · ERP · Cron
HiTechPos SDKclient.orders · client.products · client.inventory…
HiTechPos APIpos.hitechcloud.vn · REST /api/v1

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ợ

Kênh bán được đồng bộ
ShopeeShopeeLazadaLazadaTikTok ShopTikTok ShopVietQRVietQR

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óiCài đặt
JavaScript / TypeScript@hitechcloud/hitechpos-sdknpm i @hitechcloud/hitechpos-sdk
PHPhitechcloud/hitechpos-sdkcomposer require hitechcloud/hitechpos-sdk
Pythonhitechpospip install hitechpos
Go.../hitechpos-sdk/gogo get github.com/hitechcloudvn/hitechpos-sdk/go
Javavn.hitechcloud:hitechpos-sdkMaven / Gradle

Bước tiếp theo