Sản phẩm xuất nhập kho nháp

• Tính năng này dùng để lấy danh sách sản phẩm xuất nhập kho nhấp của doanh nghiệp.

Request

• Xem các common request params

curl --location 'http://pos.open.nhanh.vn/v3.0/bill/imexrequirement?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json'
--data '{
    "filters": {
        "fromDate": "2025-05-01",
        "toDate": "2025-05-31"
    },
    "paginator": {
        "size": 50
    }
}'

Filters

Key	Type	Description
id	int	ID bản ghi sản phẩm xuất nhập kho nháp
fromDate	date	Thời gian từ ngày định dạng (yyyy-mm-dd). VD: 2022-09-25
toDate	date	Thời gian đến ngày (yyyy-mm-dd). VD: 2022-09-25
billId	int	ID hóa đơn xuất nhập kho nháp
type	int	Loại xuất nhập kho
mode	int	Kiểu xuất nhập kho
fromDepotId	int	ID kho hàng xuất đi
toDepotId	int	ID kho hàng xuất đến
requiredById	int	ID người tạo phiếu nháp
approvedById	int	ID người duyệt phiếu
orderId	int	ID đơn hàng
status	int	Trạng thái phiếu
supplierId	int	ID nhà cung cấp
product	array	Mảng thông tin sản phẩm (xem ở bảng bên dưới)

• Thông tin product

Key	Type	Description
id	int	ID sản phẩm
categoryId	int	ID danh mục
internalCategoryId	int	ID danh mục nội bộ
brandId	int	ID thương hiệu
typeId	int	Loại sản phẩm
imei	int	IMEI sản phẩm
imeiId	int	ID IMEI sản phẩm

Response

• Xem cấu trúc chung tại đây.

Failed response

• Xem các mã lỗi chung tại đây.

Successful response

{
  "code": 1,
  "paginator": {
    "next": "Dùng để lấy dữ liệu trang tiếp theo"
  },
  "data": [
    {
      "id": "(int) ID bản ghi sản phẩm xuất nhập kho nháp",
      "billId": "(int) ID hóa đơn xuất nhập kho nháp",
      "type": "(int) Loại xuất nhập kho",
      "mode": "(int) Kiểu xuất nhập kho",
      "status": "(int) Trạng thái",
      "damagedQuantity": "(int) Số lượng hỏng",
      "discount": "(int) Chiết khấu",
      "fromDepot": {
        "id": "(int) ID kho hàng",
        "name": "(string) Tên kho hàng"
      },
      "toDepot": {
        "id": "(int) Id kho hàng",
        "name": "(string) Tên kho hàng"
      },
      "supplier": {
        "id": "(int) ID nhà cung cấp",
        "name": "(string) Tên nhà cung cấp",
        "mobile": "(string) Số điện thoại nhà cung cấp"
      },
      "product": {
        "id": "(int) ID sản phẩm",
        "code": "(string) Mã sản phẩm",
        "barcode": "(string) Mã vạch sản phẩm",
        "name": "(string) Tên sản phẩm",
        "prices": {
          "retail": "(double) Giá bán",
          "import": "(double) Giá nhập",
          "avgCost": "(double) Giá vốn"
        },
        "batchId": "(int) ID lô sản phẩm",
        "imeiId": "(int) ID IMEI",
        "imei": "(string) Số IMEI"
      },
      "required": {
        "quantity": "(int) Số lượng yêu cầu",
        "price": "(int) Giá yêu cầu",
        "description": "(string) Ghi chú",
        "userId": "(int) ID người yêu cầu",
        "userName": "(string) Tên người yêu cầu",
        "datetime": "(string) Thời gian yêu cầu"
      },
      "approved": {
        "quantity": "(int) Số lượng duyệt",
        "price": "(int) Giá duyệt",
        "description": "(string) Ghi chú",
        "userId": "(int) ID người duyệt",
        "userName": "(string) Tên người duyệt",
        "approvedAt": "(int) Thời gian duyệt (định dạng timestamp)"
      },
      "confirmed": {
        "quantity": "(int) Số lượng xác nhận",
        "confirmedAt": "(int) Thời gian xác nhận (định dạng timestamp)"
      }
    }
  ]
}