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

Xem Markdown

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

Ứng dụng của bạn gọi HiTechPos API để đồng bộ dữ liệu bán hàng
Ứng dụng / POSWebsite · Mobile · Kế toán
HiTechPos APIREST `/api/v1`
Đơn hàng · Tồn kho · KhoDữ liệu bán hàng đa chi nhánh

Mọi tài nguyên đều truy cập theo đường dẫn lồng /api/v1/shops/{shop_id}/....

Kết nối sàn thương mại điện tử & thanh toán
ShopeeShopeeLazadaLazadaTikTok ShopTikTok ShopVietQRVietQR

Đồ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ườngBase URLMô tả
Production (Chính thức)https://pos.hitechcloud.vnDữ liệu bán hàng thật
Sandbox (Thử nghiệm)https://pos-sandbox.hitechcloud.vnMôi trường test với dữ liệu mẫu độc lập
Webhook basehttps://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:

Cấu trúc phản hồi tiêu chuẩn
{
  "status": "success",
  "data": [],
  "meta": {
    "pagination": {
      "total": 240,
      "page_size": 20,
      "page_number": 1,
      "total_pages": 12,
      "has_more": true
    }
  }
}
Toàn bộ endpoint nghiệp vụ dùng tiền tố /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.