Bắt đầu nhanh với HiTechPos API

Bắt đầu nhanh HiTechPos: tạo khoá API, lấy ID cửa hàng và gọi yêu cầu đầu tiên để liệt kê sản phẩm cùng đẩy một đơn hàng thử trong vài phút.

Xem Markdown

Hướng dẫn từng bước giúp bạn kết nối HiTechPos API: từ việc cấp API Key tới khi lấy được danh sách sản phẩm và tạo đơn hàng đầu tiên.

Bước 1: Tạo API Key

  1. Đăng nhập cổng quản trị HiTechPos tại https://pos.hitechcloud.vn.
  2. Vào Cấu hình → API & Tích hợp → API Key.
  3. Nhấn + Tạo API Key mới, đặt tên ứng dụng và chọn phạm vi cửa hàng áp dụng.
  4. Sao chép mã API Key (chỉ hiển thị một lần) và lưu trong biến môi trường.
API Key cho phép đọc và ghi dữ liệu bán hàng của bạn. Tuyệt đối không nhúng trong mã frontend (JavaScript, mobile) hay commit lên kho mã công khai.

Bước 2: Lấy danh sách cửa hàng

cURL lấy danh sách cửa hàng
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Phản hồi (200 OK)
{
  "status": "success",
  "data": [
    {
      "id": "shop_0a1b2c3d",
      "name": "HiTech Store Quan 1",
      "currency": "VND",
      "timezone": "Asia/Ho_Chi_Minh",
      "active": true
    }
  ]
}

Bước 3: Liệt kê sản phẩm của cửa hàng

cURL lấy danh sách sản phẩm
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/products?page_number=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Lấy sản phẩm bằng Python
import os, requests

key = os.getenv("HITECHPOS_API_KEY")
shop = "shop_0a1b2c3d"
headers = {"Authorization": f"Bearer {key}"}

r = requests.get(
    f"https://pos.hitechcloud.vn/api/v1/shops/{shop}/products",
    headers=headers,
    params={"page_number": 1, "page_size": 20},
)
for p in r.json()["data"]:
    print(p["id"], p["name"], p["retail_price"])

Bước 4: Tạo đơn hàng đầu tiên

cURL tạo đơn hàng
curl -X POST "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "warehouse_id": "wh_main",
    "items": [
      { "variation_id": "var_1001", "quantity": 2 }
    ],
    "customer": { "name": "Nguyen Van A", "phone": "0901234567" },
    "payment_method": "cash"
  }'
Nên thử toàn bộ các bước trên môi trường Sandbox (pos-sandbox.hitechcloud.vn) trước khi chuyển sang Production.