Tổng quan HiTechPos API
HiTechPos: bộ REST API bán hàng đa kênh — quản lý cửa hàng, sản phẩm và biến thể, danh mục, tồn kho đa kho, đơn hàng, khách hàng, nhà cung cấp và bảng giá.
HiTechPos là nền tảng quản lý bán hàng và điểm bán (POS) của HiTechCloud. HiTechPos API là giao diện lập trình RESTful giúp bạn kết nối website, ứng dụng di động, phần mềm kế toán hoặc kênh thương mại điện tử trực tiếp vào dữ liệu bán hàng: đồng bộ sản phẩm, đẩy đơn hàng, cập nhật tồn kho theo thời gian thực và theo dõi khách hàng trên nhiều chi nhánh.
Luồng kết nối
Mọi tài nguyên đều truy cập theo đường dẫn lồng /api/v1/shops/{shop_id}/....
Đồng bộ đơn hàng, tồn kho từ các sàn và nhận thanh toán qua VietQR ngay trong HiTechPos.
Các nhóm tài nguyên chính
Mô hình tổ chức dữ liệu
Mỗi tài khoản HiTechPos có thể sở hữu nhiều cửa hàng (shop). Mọi tài nguyên nghiệp vụ (sản phẩm, đơn hàng, khách hàng, tồn kho...) đều thuộc về một cửa hàng và được truy cập theo đường dẫn lồng /{shop_id}/.... Trong mỗi cửa hàng có thể có nhiều kho / chi nhánh (warehouse); tồn kho luôn được tính theo từng kho.
Môi trường và Base URL
| Môi trường | Base URL | Mô tả |
|---|---|---|
| Production (Chính thức) | https://pos.hitechcloud.vn | Dữ liệu bán hàng thật |
| Sandbox (Thử nghiệm) | https://pos-sandbox.hitechcloud.vn | Môi trường test với dữ liệu mẫu độc lập |
| Webhook base | https://pos.hitechcloud.vn/webhook | Điểm phát sự kiện webhook ra ngoài |
Định dạng phản hồi Envelope
Mọi phản hồi của HiTechPos API đều tuân theo cấu trúc JSON Envelope thống nhất, giúp mã client chỉ cần một lớp xử lý chung:
{
"status": "success",
"data": [],
"meta": {
"pagination": {
"total": 240,
"page_size": 20,
"page_number": 1,
"total_pages": 12,
"has_more": true
}
}
}/api/v1. Ví dụ danh sách sản phẩm của một cửa hàng là GET /api/v1/shops/{shop_id}/products.HiTechPos là nền tảng quản lý bán hàng và điểm bán (POS) của HiTechCloud. HiTechPos API là giao diện lập trình RESTful giúp bạn kết nối website, ứng dụng di động, phần mềm kế toán hoặc kênh thương mại điện tử trực tiếp vào dữ liệu bán hàng: đồng bộ sản phẩm, đẩy đơn hàng, cập nhật tồn kho theo thời gian thực và theo dõi khách hàng trên nhiều chi nhánh.
Luồng kết nối
Mọi tài nguyên đều truy cập theo đường dẫn lồng /api/v1/shops/{shop_id}/....
Đồng bộ đơn hàng, tồn kho từ các sàn và nhận thanh toán qua VietQR ngay trong HiTechPos.
Các nhóm tài nguyên chính
Mô hình tổ chức dữ liệu
Mỗi tài khoản HiTechPos có thể sở hữu nhiều cửa hàng (shop). Mọi tài nguyên nghiệp vụ (sản phẩm, đơn hàng, khách hàng, tồn kho...) đều thuộc về một cửa hàng và được truy cập theo đường dẫn lồng /{shop_id}/.... Trong mỗi cửa hàng có thể có nhiều kho / chi nhánh (warehouse); tồn kho luôn được tính theo từng kho.
Môi trường và Base URL
| Môi trường | Base URL | Mô tả |
|---|---|---|
| Production (Chính thức) | https://pos.hitechcloud.vn | Dữ liệu bán hàng thật |
| Sandbox (Thử nghiệm) | https://pos-sandbox.hitechcloud.vn | Môi trường test với dữ liệu mẫu độc lập |
| Webhook base | https://pos.hitechcloud.vn/webhook | Điểm phát sự kiện webhook ra ngoài |
Định dạng phản hồi Envelope
Mọi phản hồi của HiTechPos API đều tuân theo cấu trúc JSON Envelope thống nhất, giúp mã client chỉ cần một lớp xử lý chung:
/api/v1. Ví dụ danh sách sản phẩm của một cửa hàng là GET /api/v1/shops/{shop_id}/products.{
"status": "success",
"data": [],
"meta": {
"pagination": {
"total": 240,
"page_size": 20,
"page_number": 1,
"total_pages": 12,
"has_more": true
}
}
}