Tạo hoá đơn

Mô tả và thông tin API

Endpoint: api/HDon/CreateInvoice

Phương thức: POST

Mô tả: API này cho phép người dùng tạo và thêm hóa đơn vào hệ thống.

Tham số Kiểu dữ liệu Ràng buộc Mô tả
TTChung (object) Bắt buộc Thông tin chung
MSTCNhanh (string) Không bắt buộc Mã số thuế chi nhánh
KHMSHDon (string) Bắt buộc Mẫu số hóa đơn
KHHDon (string) Bắt buộc Ký hiệu hóa đơn
SHDon (int) Không bắt buộc Số hóa đơn
NLap (datetime) Bắt buộc Ngày lập: yyyy-MM-ddThh:mm:ss
Ví dụ: 2021-12-20T00:00:00
DVTTe (string) Bắt buộc Đơn vị tiền tệ (VND,USD,EUR,JPY,CAD,AUD,SGD)
TGia (string) Bắt buộc Tỉ giá
HTTToan (string) Không bắt buộc Hình thức thanh toán
MBMat (string) Bắt buộc Mã bí mật (GuideId) là một mã duy nhất được sử dụng để định dạng hóa đơn đã tạo.
Mã này có thể được sử dụng để truy xuất lại hóa đơn khi cần thiết.
MNBo (string) Không bắt buộc Mã nội bộ (GuideCode)
MTCuu (string) Không bắt buộc Mã tra cứu
PTTToan (string) Không bắt buộc Phương thức thanh toán
NgayChungTu (string) Không bắt buộc Ngày chứng từ: yyyy-MM-ddThh:mm:ss
Ví dụ: 2021-12-20T00:00:00
Ten (string) Bắt buộc Tên đơn vị người mua
MST (string) Bắt buộc Mã số thuế người mua
DChi (string) Bắt buộc Địa chỉ
SDThoai (string) Không bắt buộc Số điện thoại
DCTDTu (string) Không bắt buộc Địa chỉ thư điện tử
HVTNMHang (string) Không bắt buộc Họ và tên người mua
STKNHang (string) Không bắt buộc Số tài khoản ngân hàng
TNHang (string) Không bắt buộc Tên ngân hàng
LDDanh (string) Không bắt buộc Loại định danh (1: Việt Nam, 2: Nước ngoài)
CMND (string) Không bắt buộc CMND/CCCD/HC của người mua.
Trường hợp LDDanh = 1: CMND/CCCD.
Trường hợp LDDanh = 2: HC.
MDVQHNSach (string) Không bắt buộc Mã đơn vị quan hệ ngân sách
HHDVu (object) Bắt buộc Hàng hóa dịch vụ
TChat (int) Bắt buộc Tính chất:
1: Hàng hóa dịch vụ
2: Khuyến mãi
3: Chiết khấu
4: Ghi chú
MHHDVu (string) Không bắt buộc Mã hàng hóa dịch vụ
THHDVu (string) Bắt buộc Tên hàng hóa dịch vụ
DVTinh (string) Không bắt buộc Đơn vị tính
SLuong (double) Không bắt buộc Số lượng
DGia (decimal) Không bắt buộc Đơn giá
TLCKhau (int) Không bắt buộc Tỉ lệ chiết khấu
STCKhau (int) Không bắt buộc Số tiền chiết khấu
ThTien (decimal) Bắt buộc Thành tiền
TSuat (int) Không bắt buộc Thuế suất:
-2: KKKNT (không kê khai nộp thuế)
-1: KCT (Không chịu thuế)
0: Thuế 0%
5: Thuế 5%
8: Thuế 8%
10: Thuế 10%
NDMTa (bool) Không bắt buộc True: Không hiển thị số thứ tự của dòng này trên mẫu hóa đơn
TgTTTKKKNThue (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (không kê khai nộp thuế)
TgTSKKKNThue (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế (không kê khai nộp thuế)
TgTTTKCThue (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (không nộp thuế)
TgTSKCThue (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế thuế (không nộp thuế)
TgTTTThue0 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (thuế 0%)
TgTSTCThue0 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế (thuế 0%)
TgTTTThue5 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (thuế 5%)
TgTThue5 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền thuế (thuế 5%)
TgTSTCThue5 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế (thuế 5%)
TgTTTThue8 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (thuế 8%)
TgTThue8 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền thuế (thuế 8%)
TgTSTCThue8 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế (thuế 8%)
TgTTTThue10 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền trước thuế (thuế 10%)
TgTThue10 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền thuế (thuế 10%)
TgTSTCThue10 (decimal) Bắt buộc (nếu HĐ nhiều thuế suất) Tổng tiền sau thuế (thuế 10%)
TSuat (int) Bắt buộc (nếu HĐ một thuế suất) Thuế suất:
-2: KKKNT (không kê khai nộp thuế)
-1: KCT (Không chịu thuế)
0: Thuế 0%
5: Thuế 5%
8: Thuế 8%
10: Thuế 10%
TgTCThue (decimal) Bắt buộc Tổng tiền chưa thuế
TgTThue (decimal) Bắt buộc Tổng tiêng thuế
TTCKTMai (decimal) Bắt buộc Tổng tiền chiết khấu thương mại
TgTTTBSo (decimal) Bắt buộc Tổng tiền bằng số
TgTTTBChu (string) Bắt buộc Số tiền bằng chữ

Mã nguồn ví dụ

								
var client = new HttpClient();
	var request = new HttpRequestMessage(HttpMethod.Post, "https://apiehd.smartsign.com.vn/api/HDon/CreateInvoice");
	request.Headers.Add("Authorization", "Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
string jsonData = @"{ ""TTChung"": {
                            ""MSTCNhanh"": """",
                            ""KHMSHDon"": 1,
                            ""KHHDon"": ""C23XXX"",
                            ""SHDon"": 0,
                            ""NLap"": ""2023-07-25T10:10:30"",
                            ""DVTTe"": ""VND"",
                            ""TGia"": ""1"",
                            ""HTTToan"": ""TM/CK"",
                            ""MBMat"": ""SmartVasTest01"",
                            ""MNBo"": ""SmartVasTest01"",
                            ""MTCuu"": null,
                            ""PTTToan"": """",
                            ""NgayChungTu"": ""2023-07-25T10:10:30""
                        },
                        ""NMua"": {
                            ""Ten"": ""Tên đơn vị người mua"",
                            ""MST"": ""MST người mua"",
                            ""DChi"": ""Địa chỉ người mua"",
                            ""SDThoai"": ""Số điện thoại người mua"",
                            ""DCTDTu"": ""Địa chỉ thư điện tử"",
                            ""HVTNMHang"": ""Tên người mua hàng"",
                            ""STKNHang"": ""Số tài khoản ngân hàng"",
                            ""TNHang"": ""Tên ngân hàng"",
                            ""CMND"": ""CCCD/CMND người mua hàng""
                        },
                        ""DSHHDVu"": {
                            ""HHDVu"": [
                                {
                                    ""TChat"": 1,
                                    ""MHHDVu"": ""SP01"",
                                    ""THHDVu"": ""Test sản phẩm 1"",
                                    ""DVTinh"": ""cái"",
                                    ""SLuong"": ""1"",
                                    ""DGia"": ""10000"",
                                    ""TLCKhau"": 0,
                                    ""STCKhau"": ""0.0"",
                                    ""ThTien"": ""10000"",
                                    ""TSuat"": -1
                                }
                            ]
                        },
                        ""TToan"": {
                            ""TgTTTKCThue"": ""0"",
                            ""TgTSKCThue"": ""0"",
                            ""TgTTTThue0"": ""0"",
                            ""TgTSTCThue0"": ""0"",
                            ""TgTTTThue5"": ""0"",
                            ""TgTThue5"": ""0"",
                            ""TgTSTCThue5"": ""0"",
                            ""TgTTTThue8"": ""0"",
                            ""TgTThue8"": ""0"",
                            ""TgTSTCThue8"": ""0"",
                            ""TgTTTThue10"": ""0"",
                            ""TgTThue10"": ""0"",
                            ""TgTSTCThue10"": ""0"",
                            ""TSuat"": ""-1"",
                            ""TgTCThue"": ""10000"",
                            ""TgTThue"": ""0"",
                            ""TTCKTMai"": ""0"",
                            ""TgTTTBSo"": ""10000"",
                            ""TgTTTBChu"": ""Mười nghìn đồng""
                        }
                    }";

	var content = new StringContent(jsonData, Encoding.UTF8, "application/json");
	request.Content = content;
var response = await client.SendAsync(request);
	response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

                        
								
var settings = {
        "url": "https://apiehd.smartsign.com.vn/api/HDon/CreateInvoice",
        "method": "POST",
        "timeout": 0,
        "headers": {
        "Authorization": "Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "Content-Type": "application/json"
    },
    "data": JSON.stringify({
        "TTChung": {
            "MSTCNhanh": "",
            "KHMSHDon": 1,
            "KHHDon": "C23XXX",
            "SHDon": 0,
            "NLap": "2023-07-25T10:10:30",
            "DVTTe": "VND",
            "TGia": "1",
            "HTTToan": "TM/CK",
            "MBMat": "SmartVasTest01",
            "MNBo": "SmartVasTest01",
            "MTCuu": null,
            "PTTToan": "",
            "NgayChungTu": "2023-07-25T10:10:30"
        },
        "NMua": {
            "Ten": "Tên đơn vị người mua",
            "MST": "MST người mua",
            "DChi": "Địa chỉ người mua",
            "SDThoai": "Số điện thoại người mua",
            "DCTDTu": "Địa chỉ thư điện tử",
            "HVTNMHang": "Tên người mua hàng",
            "STKNHang": null,
            "TNHang": null,
            "CMND": "CCCD/CMND người mua hàng"
        },
        "DSHHDVu": {
            "HHDVu": [
                {
                    "TChat": 1,
                    "THHDVu": "Test sản phẩm 1",
                    "DVTinh": "cái",
                    "SLuong": "1",
                    "DGia": "10000",
                    "TLCKhau": 0,
                    "STCKhau": "0.0",
                    "ThTien": "10000",
                    "TSuat": -1,
                    "MHHDVu": "SP01"
                }
            ]
        },
        "TToan": {
            "TgTTTKCThue": "0",
            "TgTSKCThue": "0",
            "TgTTTThue0": "0",
            "TgTSTCThue0": "0",
            "TgTTTThue5": "0",
            "TgTThue5": "0",
            "TgTSTCThue5": "0",
            "TgTTTThue8": "0",
            "TgTThue8": "0",
            "TgTSTCThue8": "0",
            "TgTTTThue10": "0",
            "TgTThue10": "0",
            "TgTSTCThue10": "0",
            "TSuat": "-1",
            "TgTCThue": "18000",
            "TgTThue": "0",
            "TTCKTMai": "0",
            "TgTTTBSo": "18000",
            "TgTTTBChu": "Mười nghìn đồng"
        }
    }),
};

$.ajax(settings).done(function (response) {
    console.log(response);
});

								
var request = require('request');
    var options = {
        'method': 'POST',
        'url': 'https://apiehd.smartsign.com.vn/api/HDon/CreateInvoice',
        'headers': {
        'Authorization': 'Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
    "TTChung": {
        "MSTCNhanh": "",
        "KHMSHDon": 1,
        "KHHDon": "C23XXX",
        "SHDon": 0,
        "NLap": "2023-07-25T10:10:30",
        "DVTTe": "VND",
        "TGia": "1",
        "HTTToan": "TM/CK",
        "MBMat": "SmartVasTest01",
        "MNBo": "SmartVasTest01",
        "MTCuu": null,
        "PTTToan": "",
        "NgayChungTu": "2023-07-25T10:10:30"
    },
    "NMua": {
        "Ten": "Tên đơn vị người mua",
        "MST": "MST người mua",
        "DChi": "Địa chỉ người mua",
        "SDThoai": "Số điện thoại người mua",
        "DCTDTu": "",
        "HVTNMHang": "Tên người mua hàng",
        "STKNHang": null,
        "TNHang": null,
        "CMND": "CCCD/CMND người mua hàng"
    },
    "DSHHDVu": {
        "HHDVu": [
            {
                "TChat": 1,
                "THHDVu": "Test sản phẩm 1",
                "DVTinh": "cái",
                "SLuong": "1",
                "DGia": "10000",
                "TLCKhau": 0,
                "STCKhau": "0.0",
                "ThTien": "10000",
                "TSuat": -1,
                "MHHDVu": "SP01"
            }
        ]
    },
    "TToan": {
            "TgTTTKCThue": "0",
            "TgTSKCThue": "0",
            "TgTTTThue0": "0",
            "TgTSTCThue0": "0",
            "TgTTTThue5": "0",
            "TgTThue5": "0",
            "TgTSTCThue5": "0",
            "TgTTTThue8": "0",
            "TgTThue8": "0",
            "TgTSTCThue8": "0",
            "TgTTTThue10": "0",
            "TgTThue10": "0",
            "TgTSTCThue10": "0",
            "TSuat": "-1",
            "TgTCThue": "18000",
            "TgTThue": "0",
            "TTCKTMai": "0",
            "TgTTTBSo": "18000",
            "TgTTTBChu": "Mười nghìn đồng"
        }
    })

};
request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});

Đối tượng trả về

Đối tượng Mô tả
Data

Object như thông tin gửi lên
TTHDLQuan

Thông tin hoá đơn liên quan
KHMSHDCLQuan

Ký hiệu mẫu số hoá đơn có liên quan
KHHDCLQuan

Ký hiệu hoá đơn có liên quan
SHDCLQuan

Số hoá đơn có liên quan
Ky

Ký
MCCQT

Mã của cơ quan thuế

Mã nguồn JSON ví dụ


{
    "TTChung": {
        "MSTCNhanh": null,
        "KHMSHDon": "1",
        "KHHDon": "C23XXX",
        "SHDon": 0,
        "NLap": "2023-07-25T10:10:30",
        "DVTTe": "VND",
        "TGia": 1.000000,
        "HTTToan": "TM/CK",
        "PTTToan": null,
        "MBMat": "SmartVasTest01",
        "MNBo": "SmartVasTest01",
        "MTCuu": null,
        "GChu": null,
        "XML": null,
        "LDDSo": null,
        "NDDong": null,
        "BPDDong": null,
        "DDVViec": null,
        "KNhap": null,
        "KXuat": null,
        "NNhap": null,
        "NXuat": null,
        "TNVChuyen": null,
        "PTVChuyen": null,
        "HDSo": null,
        "HDGiua": null,
        "HDVa": null,
        "SPCon": null,
        "NgayChungTu": null
    },
    "NMua": {
        "Ten": "Tên đơn vị người mua",
        "MST": "MST nguời mua",
        "DChi": "Địa chỉ người mua",
        "SDThoai": "Số điệnn thoại nguời mua",
        "DCTDTu": "Địa chỉ thư điện tử",
        "HVTNMHang": "Tên người mua hàng",
        "STKNHang": "Số tài khoản ngân hàng",
        "TNHang": "Tên ngân hàng",
        "CMND": "CCCD/CMND ngườii mua hàng"
    },
    "NBan": null,
    "DSHHDVu": {
        "HHDVu": [
            {
            "TChat": 1,
            "MHHDVu": "SP01",
            "THHDVu": "Test sản phẩm 1",
            "DVTinh": "cái",
            "SLuong": 1.0,
            "DGia": 10000.000000,
            "TLCKhau": 0,
            "STCKhau": 0.000000,
            "ThTien": 10000.000000,
            "TSuat": -1,
            "SLo": null,
            "HDung": null,
            "TThue": 0.000000,
            "ThTSThue": 0.000000
            }
        ]
    },
    "TToan": {
        "TSuat": -1,
        "TgTTTKKKNThue": 0.000000,
        "TgTSKKKNThue": 0.000000,
        "TgTTTKCThue": 0.000000,
        "TgTSKCThue": 0.000000,
        "TgTTTThue0": 0.000000,
        "TgTSTCThue0": 0.000000,
        "TgTTTThue5": 0.000000,
        "TgTThue5": 0.000000,
        "TgTSTCThue5": 0.000000,
        "TgTTTThue8": 0.000000,
        "TgTThue8": 0.000000,
        "TgTSTCThue8": 0.000000,
        "TgTTTThue10": 0.000000,
        "TgTThue10": 0.000000,
        "TgTSTCThue10": 0.000000,
        "TgTCThue": 18000.000000,
        "TgTThue": 0.000000,
        "TTCKTMai": 0.000000,
        "TgTTTBSo": 18000.000000,
        "TgTTTBChu": "Mười nghìn đồng"
    },
    "TTHDLQuan": {
        "KHMSHDCLQuan": null,
        "KHHDCLQuan": null,
        "SHDCLQuan": 0,
        "Ky": false
    },
    "MCCQT": null
}