Import hóa đơn

Dùng để đẩy dữ liệu hóa đơn lên chương trình, có thể đẩy một hoặc danh sách nhiều hóa đơn

Phương thức

Đường dẫn

{{host}}/Invoice/Import

Request

Authorization

Type	Bearer Token
Token	{{access_token}}

Body

{
    "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

Tên	(*)	Kiểu	Diễn giải
api_code		string	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
so_ct		string	Số hóa đơn
ngay_ct		datetime	Ngày hóa đơn, định dạng ISO 8601
ma_nt		string	Mã ngoại tệ
ty_gia		numeric	Tỷ giá hóa đơn
ma_kh		string	Mã khách hàng mua
ma_nvbh		string	Mã nhân viên bán hàng

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

Tên	(*)	Kiểu	Diễn giải
api_code		string	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
ma_vt		string	Mã hàng hóa
dvt		string	Mã đơn vị tính
ma_kho		string	Mã kho xuất bán
so_luong		numeric	Số lượng bán
gia_nt2		numeric	Đơn giá xuất bán
tien_nt2		nuemric	Thành tiền

3. Thông tin thanh toán: 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

Tên	(*)	Kiểu	Diễn giải
api_code		string	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
ma_httt		string	Mã hình thức thanh toán cho hóa đơn
t_tt_nt		numeric	Tổng tiền thanh toán bằng phương thức này

Response

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

Mô tả kết quả

Tên	Diễn giải
code	Khi import thành công code là 200, Code khác ví dụ 401, 452,... là thực hiện thất bại kèm theo thông báo diễn giải kết quả
msg	Mô tả kết quả thực hiện API