Kho
1. Tổng quan
API nhóm Kho chỉ đọc (GET): danh sách kho, chi tiết kho theo ID, báo cáo tồn, phiếu nhập/xuất/chuyển/kiểm, thẻ kho.
- Xác thực:
X-API-KEY - Prefix:
/api/v6/ - Tham số:
fields,filtering,search,sort,direction,limit,offset— Thông tin cần thiết.
2. Danh mục endpoint
| Tài liệu | Endpoint |
|---|---|
| Danh sách kho | GET /api/v6/warehouses |
| Chi tiết kho | GET /api/v6/warehouses/{id} |
| Báo cáo tồn kho | GET /api/v6/inventory_reports, GET /api/v6/inventory_reports/by_warehouse |
| Thẻ kho | GET /api/v6/inventory_cards |
| Phiếu nhập | GET /api/v6/inventory_sheet_ins, GET /api/v6/inventory_sheet_ins/{id} |
| Phiếu xuất | GET /api/v6/inventory_sheet_outs, GET /api/v6/inventory_sheet_outs/{id} |
| Phiếu chuyển | GET /api/v6/inventory_sheet_transfers, GET /api/v6/inventory_sheet_transfers/{id} |
| Phiếu kiểm kho | GET /api/v6/inventory_sheet_slips, GET /api/v6/inventory_sheet_slips/{id} |
3. Liên quan
- Tồn kho sản phẩm: product/inventory (nếu triển khai trên môi trường của bạn).
- Webhook kho: webhook/inventory.
- v6.1 (chi tiết kho bằng
warehouse_code, phiếu bằng query..._code): Kho v6.1.
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ụ
fieldsyêu cầu trường không được public API cho phép). - 404 — không tìm thấy kho theo
{id}trên URL hoặc không tìm thấy phiếu theo{id}.
📄️ Danh sách kho
1. Thông tin API
📄️ Chi tiết kho
1. Thông tin API
📄️ Báo cáo tồn kho
API trả về tồn kho theo sản phẩm tại thời điểm (hoặc theo một kho cụ thể). Dữ liệu domain InventoryReport.
📄️ Phiếu nhập kho
Domain InventorySheetIn — chỉ đọc (GET).
📄️ Phiếu xuất kho
Domain InventorySheetOut — chỉ đọc (GET).
📄️ Phiếu chuyển kho
Domain InventorySheetTransfer — chỉ đọc (GET).
📄️ Phiếu kiểm kho (đầu kỳ / kiểm kho)
Domain InventorySheetSlip — chỉ đọc (GET).
📄️ Thẻ kho
Theo dõi biến động tồn (nhập/xuất/…) của một sản phẩm trong khoảng thời gian. Domain InventoryCard.