Chuyển tới nội dung chính

Kho

1. Tổng quan​

Các API nhóm Kho chỉ hỗ trợ đọc (GET): danh sách kho, chi tiết kho, báo cáo tồn theo thời điểm, phiếu nhập / xuất / chuyển / kiểm kho, thẻ kho.

  • Xác thực: header X-API-KEY (bắt buộc).
  • Prefix: /api/v6.1/
  • Tham số chung: fields, filtering, search, sort, direction, limit, offset — cú pháp và ví dụ tại Thông tin cần thiết.

2. Danh mục endpoint​

Tài liệuEndpoint
Danh sách khoGET /api/v6.1/warehouses
Chi tiết khoGET /api/v6.1/warehouse
Báo cáo tồn khoGET /api/v6.1/inventory_reports, GET /api/v6.1/inventory_reports/by_warehouse
Thẻ khoGET /api/v6.1/inventory_cards
Phiếu nhậpGET /api/v6.1/inventory_sheet_ins, GET /api/v6.1/inventory_sheet_in
Phiếu xuấtGET /api/v6.1/inventory_sheet_outs, GET /api/v6.1/inventory_sheet_out
Phiếu chuyểnGET /api/v6.1/inventory_sheet_transfers, GET /api/v6.1/inventory_sheet_transfer
Phiếu kiểm khoGET /api/v6.1/inventory_sheet_slips, GET /api/v6.1/inventory_sheet_slip

3. Liên quan​

  • Tồn kho theo sản phẩm (product/inventories, product/quantity, product/store_quantity): Tồn kho sản phẩm.
  • Webhook sự kiện kho: Webhook kho.
  • So sánh với v6.0 (URL chi tiết phiếu dạng path {id}): Kho v6.0.

4. Mã HTTP & lỗi thường gặp​

  • Bảng mã HTTP dùng chung toàn API: Errors.
  • 401 — thiếu hoặc sai X-API-KEY.
  • 400 — tham số không hợp lệ (ví dụ v6.1 gửi cả warehouse_id và warehouse_code; thiếu một trong hai khi gọi chi tiết kho / chi tiết phiếu; fields yêu cầu trường không được public API cho phép).
  • 404 — không tìm thấy kho / phiếu theo id hoặc mã đã truyền.