Tham chiếu: Kho

Kho, tồn kho và phiếu nhập, xuất, kiểm kho. Mọi đường dẫn dưới https://danix.vn/api/open/v1. Đặc tả máy đọc: openapi.json.

Danh sách kho

GET /warehouses

Các kho hàng của shop.

Quyền cần có: khoá có quyền pos.inventory.read.

Ví dụ yêu cầu

curl -X GET "https://danix.vn/api/open/v1/warehouses" \
  -H "Authorization: Bearer dnx_live_…"

Phản hồi mẫu (200)

{
  "data": [
    {
      "id": "018f3b8e-1c2d-7a4b-9c3d-000000000001",
      "code": "KHO1",
      "name": "Kho chính",
      "phone": null,
      "addressLine": null,
      "provinceName": null,
      "districtName": null,
      "wardName": null,
      "isDefault": true
    }
  ]
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.

Tồn kho theo mẫu mã và kho

GET /inventory/stock

Mỗi dòng là tồn của một mẫu mã tại một kho. Không có giá vốn. Đồng bộ tăng dần bằng updatedSince (lật trang trong một lượt bằng nextCursor): có updatedSince thì chỉ trả dòng tồn đổi từ mốc ấy và đã qua khoảng trễ an toàn (bằng trần thời gian tua lại kho của shop cộng 15 giây, mặc định 2 phút 15 giây). Mốc của dòng tồn chỉ đổi khi số tồn hoặc inTransit đổi; giá, mã, mã vạch, tên và ảnh đi kèm lấy từ đồng bộ sản phẩm và danh sách kho.

Quyền cần có: khoá có quyền pos.inventory.read và quyền pos.products.read.

Tham số query

Ví dụ yêu cầu

curl -X GET "https://danix.vn/api/open/v1/inventory/stock" \
  -H "Authorization: Bearer dnx_live_…"

Phản hồi mẫu (200)

{
  "data": [
    {
      "variantId": "018f3b8e-1c2d-7a4b-9c3d-000000000601",
      "productId": "018f3b8e-1c2d-7a4b-9c3d-000000000701",
      "productName": "Áo thun cổ tròn",
      "variantName": "Áo thun - M",
      "code": "AO-THUN-M",
      "barcode": null,
      "warehouseId": "018f3b8e-1c2d-7a4b-9c3d-000000000001",
      "warehouseName": "Kho chính",
      "quantity": "18",
      "inTransit": "0",
      "price": "225000"
    }
  ],
  "nextCursor": null
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.

Tạo phiếu kho nháp

POST /inventory/documents

Tạo phiếu nhập, xuất hoặc kiểm kho ở trạng thái draft. Tồn kho chỉ đổi khi ghi sổ bằng POST /inventory/documents/{id}/post.

Quyền cần có: khoá có ít nhất một trong các quyền pos.inventory.receipt, pos.inventory.adjust và đủ các quyền pos.inventory.read, pos.products.read.

Thân yêu cầu (JSON)

Ví dụ yêu cầu

curl -X POST "https://danix.vn/api/open/v1/inventory/documents" \
  -H "Authorization: Bearer dnx_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "receipt",
  "warehouseId": "018f3b8e-1c2d-7a4b-9c3d-000000000001",
  "lines": [
    {
      "variantId": "018f3b8e-1c2d-7a4b-9c3d-000000000601",
      "quantity": "10",
      "unitCost": "120000"
    }
  ]
}'

Phản hồi mẫu (201)

{
  "id": "018f3b8e-1c2d-7a4b-9c3d-000000001201",
  "kind": "receipt",
  "code": "PN0001",
  "status": "draft",
  "warehouseId": "018f3b8e-1c2d-7a4b-9c3d-000000000001",
  "supplierId": null,
  "occurredAt": "2026-10-02T03:15:00.000Z",
  "postedAt": null,
  "costingMethod": null,
  "note": null,
  "lines": []
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.

Ghi sổ phiếu kho

POST /inventory/documents/{id}/post

Ghi sổ phiếu nháp: tồn kho đổi ngay. Ghi sổ lần hai trả document-already-posted. Quyền theo LOẠI phiếu: phiếu kiểm kho cần pos.inventory.adjust, phiếu nhập hay xuất cần pos.inventory.receipt — có quyền còn lại thôi thì insufficient-permission.

Quyền cần có: khoá có ít nhất một trong các quyền pos.inventory.receipt, pos.inventory.adjust và đủ các quyền pos.inventory.read, pos.products.read.

Tham số đường dẫn

Ví dụ yêu cầu

curl -X POST "https://danix.vn/api/open/v1/inventory/documents/{id}/post" \
  -H "Authorization: Bearer dnx_live_…"

Thay {id} trong địa chỉ bằng mã thật của bản ghi, và dnx_live_… bằng khoá của bạn.

Phản hồi mẫu (200)

{
  "id": "018f3b8e-1c2d-7a4b-9c3d-000000001201",
  "kind": "receipt",
  "code": "PN0001",
  "status": "posted",
  "warehouseId": "018f3b8e-1c2d-7a4b-9c3d-000000000001",
  "supplierId": null,
  "occurredAt": "2026-10-02T03:15:00.000Z",
  "postedAt": "2026-10-02T03:16:00.000Z",
  "costingMethod": "average",
  "note": null,
  "lines": []
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.