# Import hóa đơn

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>Phương thức</td><td><a data-footnote-ref href="#user-content-fn-1"><mark style="color:green;"><strong>POST</strong></mark></a></td></tr><tr><td>Đường dẫn</td><td><mark style="color:orange;"><strong>{{host}}/Invoice/Import</strong></mark></td></tr></tbody></table>

{% tabs %}
{% tab title="Request" %}

## Authorization

<table data-header-hidden><thead><tr><th width="183"></th><th></th></tr></thead><tbody><tr><td>Type</td><td><mark style="color:blue;">Bearer Token</mark></td></tr><tr><td>Token</td><td><mark style="color:orange;">{{access_token}}</mark></td></tr></tbody></table>

## Body

```json
{
    "memvars": {
        "master": [
            {
                "api_code": 1,
                "so_ct": "API-001",
                "ngay_ct": "2023-05-23T00:00:00.000Z",
                "ma_nt": "VND",
                "ty_gia": 1,
                "ma_kh": "API-KH0001",
                "ma_nvbh": ""
            }
        ],
        "detail": [
            {
                "api_code": 1,
                "ma_vt": "API-VT0001",
                "dvt": "CAI",
                "ma_kho": "BAR2",
                "so_luong": 10,
                "gia_nt2": 20000,
                "tien_nt2": 200000
            },
            {
                "api_code": 1,
                "ma_vt": "API-VT0001",
                "dvt": "CAI",
                "ma_kho": "KTP",
                "so_luong": 5,
                "gia_nt2": 10000,
                "tien_nt2": 50000
            }
        ],
        "payment": [
            {
                "api_code": 1,
                "ma_httt": "TIENMAT",
                "t_tt_nt": 150000
            },
            {
                "api_code": 1,
                "ma_httt": "VISA",
                "t_tt_nt": 100000
            }
        ]
    }
}
```

## Mô tả tham số

1. Thông tin chung trên hóa đơn: **memvars.master**

<table><thead><tr><th width="144">Tên</th><th width="59" data-type="checkbox">(*)</th><th width="102">Kiểu</th><th>Diễn giải</th></tr></thead><tbody><tr><td>api_code</td><td>true</td><td>string</td><td>Là khóa duy nhất của mỗi hóa đơn, Trong cùng một secret kết nối tới api thì api_code này không được phép trùng lại</td></tr><tr><td>so_ct</td><td>true</td><td>string</td><td>Số hóa đơn</td></tr><tr><td>ngay_ct</td><td>true</td><td>datetime</td><td>Ngày hóa đơn, định dạng ISO 8601</td></tr><tr><td>ma_nt</td><td>false</td><td>string</td><td>Mã ngoại tệ</td></tr><tr><td>ty_gia</td><td>false</td><td>numeric</td><td>Tỷ giá hóa đơn</td></tr><tr><td>ma_kh</td><td>true</td><td>string</td><td>Mã khách hàng mua</td></tr><tr><td>ma_nvbh</td><td>false</td><td>string</td><td>Mã nhân viên bán hàng</td></tr></tbody></table>

2. Thông tin chi tiết hóa đơn: **memvars.detail**

*Dữ liệu chi tiết này không được phép để trống*

<table><thead><tr><th width="143">Tên</th><th width="63" data-type="checkbox">(*)</th><th width="103">Kiểu</th><th>Diễn giải</th></tr></thead><tbody><tr><td>api_code</td><td>true</td><td>string</td><td>Là khóa của hóa đơn, khóa này được đặt giống với chuỗi api_code ở master. Trong cùng hóa đơn thì chuỗi này giống nhau</td></tr><tr><td>ma_vt</td><td>true</td><td>string</td><td>Mã hàng hóa</td></tr><tr><td>dvt</td><td>true</td><td>string</td><td>Mã đơn vị tính</td></tr><tr><td>ma_kho</td><td>true</td><td>string</td><td>Mã kho xuất bán</td></tr><tr><td>so_luong</td><td>false</td><td>numeric</td><td>Số lượng bán</td></tr><tr><td>gia_nt2</td><td>false</td><td>numeric</td><td>Đơn giá xuất bán</td></tr><tr><td>tien_nt2</td><td>true</td><td>nuemric</td><td>Thành tiền</td></tr></tbody></table>

3. Thông tin thanh toá&#x6E;**: memvars.payment**

*Dữ liệu thanh toán được phép để trống nếu hóa đơn không theo dõi theo phương thức thanh toán*

<table><thead><tr><th width="146">Tên</th><th width="64" data-type="checkbox">(*)</th><th width="104">Kiểu</th><th>Diễn giải</th></tr></thead><tbody><tr><td>api_code</td><td>true</td><td>string</td><td>Là khóa của hóa đơn, khóa này được đặt giống với chuỗi api_code ở master. Trong cùng hóa đơn thì chuỗi này giống nhau</td></tr><tr><td>ma_httt</td><td>true</td><td>string</td><td>Mã hình thức thanh toán cho hóa đơn</td></tr><tr><td>t_tt_nt</td><td>true</td><td>numeric</td><td>Tổng tiền thanh toán bằng phương thức này</td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

```json
{
    "code": 200,
    "msg": "Ok",
    "value": null,
    "data": null
}
```

## Mô tả kết quả

<table><thead><tr><th width="159">Tên</th><th>Diễn giải</th></tr></thead><tbody><tr><td>code</td><td>Khi import thành công code là <mark style="background-color:green;">200</mark>, Code khác ví dụ <mark style="background-color:red;">401, 452,...</mark> là thực hiện thất bại kèm theo thông báo diễn giải kết quả</td></tr><tr><td>msg</td><td>Mô tả kết quả thực hiện API</td></tr></tbody></table>

{% endtab %}
{% endtabs %}

[^1]:
