Thêm phiếu nhập nhà cung cấp

• API này dùng để thêm phiếu nhập hàng từ nhà cung cấp

Request

• Xem common request params.

curl --location --globoff 'https://pos.open.nhanh.vn/v3.0/inventory/importsupplier?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
  "depotId": 31010,
  "supplierId": 40827,
  "description": "test api V3",
  "products": [
    {
      "id": 1231275955,
      "discount": {"type": "cash", "value": 0},
      "imeis": ["TestImei1", "TestImei2"],
      "quantity": 2,
      "description": "",
      "expiredDate": "",
      "price": 50000,
      "weight": 0,
      "unitId": 0,
      "batchId": 0,
      "vat": {
        "type": "cash",
        "value": 0
      }
    }
  ],
  "payment": {
    "manualDiscountType": "percent",
    "manualDiscount": 10,
    "cash": {
      "value": 0,
      "accountId": 0
    },
    "transfer": {
      "value": 500000,
      "accountId": 263475
    }
  }
}'

• Thông tin nhập nhà cung cấp:

Key	Type	Description
depotId	int $^{{\color{red}*}}$	ID kho hàng
supplierId	int $^{{\color{red}*}}$	ID nhà cung cấp. Thêm mới
products	array	Thông tin sản phẩm
description	string	Ghi chú
tagIds	array	List ID nhãn muốn gắn cho phiếu nhập
payment	object	Thông tin thanh toán
debtDueDate	string	Ngày hẹn thanh toán (Y-m-d)
updateImportPrice	int	Cập nhật giá nhập của sản phẩm theo giá trong lần nhập này (1: Có cập nhật, 0: Không cập nhật)

products

• Thông tin sản phẩm

Key	Type	Description
id	int $^{{\color{red}*}}$	ID sản phẩm
quantity	double $^{{\color{red}*}}$	Số lượng sản phẩm
price	double	Giá bán sản phẩm
discount	object	Chiết khấu sản phẩm - type: Loại chiết khấu (percent: %, cash: Tiền mặt) - value: Giá trị chiết khấu
vat	object	VAT sản phẩm - type: Loại VAT (percent: %, cash: Tiền mặt) - value: Giá trị VAT
imeis	array	Danh sách IMEI nhập kho (Bắt buộc nhập nếu sản phẩm là loại bán theo IMEI)
unitId	int	ID đơn vị tính (bắt buộc nếu sản phẩm loại nhiều đơn vị tính)
batchId	int	ID lô sản phẩm (bắt buộc nếu sản phẩm bán theo lô)
weight	int	Cân nặng sản phẩm (Tính theo Gram)
expiredDate	string	Ngày hết hạn (Áp dụng cho những sản phẩm có ngày hết hạn Y-m-d)
priorWarningDays	int	Cảnh báo hết hạn trước bao nhiêu ngày?
description	string	Ghi chú sản phẩm

payment

• Thông tin thanh toán

Key	Type	Description
manualDiscountType	string	Loại chiết khấu tổng đơn
manualDiscount	double	Giá trị chiết khấu tổng đơn (Nếu nhập cả chiết khấu tổng đơn và chiết khấu sản phẩm sẽ ưu tiên chiết khấu tổng đơn, không tính chiết khấu sản phẩm)
cash	object	Thanh toán bằng hình thức tiền mặt - accountId: Tài khoản tiền mặt trên Nhanh (nếu có dùng kế toán) - value: Giá trị tiền mặt
transfer	object	Thanh toán bằng hình thức chuyển khoản - accountId: Tài khoản chuyển khoản trên Nhanh (nếu có dùng kế toán) - value: Giá trị chuyển khoản

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,
    "data": {
        "id": "(int) ID phiếu nhập kho vừa tạo",
        "totalAmount": "(double) Giá trị phiếu nhập kho"
    }
}