# Thêm phiếu trả nhà cung cấp

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

## Request

* Xem [common request params](https://apidocs.nhanh.vn/v3/readme#request-params).

```curl
curl --location --globoff 'https://pos.open.nhanh.vn/v3.0/inventory/exportsupplier?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": "",
      "price": 50000,
      "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 xuất 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](https://apidocs.nhanh.vn/v3/business/addsupplier) |
| products    | array                      | [Thông tin sản phẩm](#products)                                               |
| description | string                     | Ghi chú                                                                       |
| tagIds      | array                      | List ID nhãn muốn gắn cho phiếu xuất                                          |
| payment     | object                     | [Thông tin thanh toán](#payment)                                              |
| debtDueDate | string                     | Ngày hẹn thanh toán (Y-m-d)                                                   |

### 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                        | <p>Chiết khấu sản phẩm<br>- type: Loại chiết khấu (percent: %, cash: Tiền mặt)<br>- value: Giá trị chiết khấu</p> |
| vat         | object                        | <p>VAT sản phẩm<br>- type: Loại VAT (percent: %, cash: Tiền mặt)<br>- value: Giá trị VAT</p>                      |
| imei        | string                        | IMEI sản phẩm (bắt buộc nhập nếu sản phẩm loại IMEI)                                                              |
| unitId      | int                           | [ID đơn vị tính](https://apidocs.nhanh.vn/v3/product/unit) (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](https://apidocs.nhanh.vn/v3/product/batch) (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)                                                                                |
| 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 | <p>Thanh toán bằng hình thức tiền mặt<br>- accountId: Tài khoản tiền mặt trên Nhanh (nếu có dùng kế toán)<br>- value: Giá trị tiền mặt</p>             |
| transfer           | object | <p>Thanh toán bằng hình thức chuyển khoản<br>- accountId: Tài khoản chuyển khoản trên Nhanh (nếu có dùng kế toán)<br>- value: Giá trị chuyển khoản</p> |

## Response

* Xem cấu trúc chung [tại đây](https://apidocs.nhanh.vn/v3/readme#response).
*

### Failed response

* Xem các mã lỗi chung [tại đây](https://apidocs.nhanh.vn/v3/readme#failed-response).

### Successful response

```json
{
    "code": 1,
    "data": {
        "id": "(int) ID phiếu xuất kho vừa tạo",
        "totalAmount": "(double) Giá trị phiếu xuất kho"
    }
}
```