Tạo hoá đơn điều chỉnh

Mô tả và thông tin API

Endpoint: api/HDon/AdjustedInvoice

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 điều chỉnh 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
CMND (string) Không bắt buộc CMND/CCCD của người mua
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%
TgTTTKCThue (decimal) Bắt buộc Tổng tiền trước khi chịu thuế
TgTSKCThue (decimal) Bắt buộc Tổng tiền sau khi chịu thuế
TgTTTThue0 (decimal) Bắt buộc Tổng tiền trước thuế (thuế 0%)
TgTSTCThue0 (decimal) Bắt buộc Tổng tiền sau thuế (thuế 0%)
TgTTTThue5 (decimal) Bắt buộc Tổng tiền trước thuế (thuế 5%)
TgTThue5 (decimal) Bắt buộc Tổng tiền thuế (thuế 5%)
TgTSTCThue5 (decimal) Bắt buộc Tổng tiền sau thuế (thuế 5%)
TgTTTThue8 (decimal) Bắt buộc Tổng tiền trước thuế (thuế 8%)
TgTThue8 (decimal) Bắt buộc Tổng tiền thuế (thuế 8%)
TgTSTCThue8 (decimal) Bắt buộc Tổng tiền sau thuế (thuế 8%)
TgTTTThue10 (decimal) Bắt buộc Tổng tiền trước thuế (thuế 10%)
TgTThue10 (decimal) Bắt buộc Tổng tiền thuế (thuế 10%)
TgTSTCThue10 (decimal) Bắt buộc Tổng tiền sau thuế (thuế 10%)
TSuat (int) 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%
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ữ
KHMSHDCLQuan (string) Bắt buộc

Ký hiệu mẫu số hoá đơn có liên quan
KHHDCLQuan (string) Bắt buộc

Ký hiệu hoá đơn có liên quan
SHDCLQuan (int) Bắt buộc

Số hoá đơn có liên quan
Ky (bool) Bắt buộc

Ký

Mã nguồn ví dụ

								
var client = new HttpClient();
	var request = new HttpRequestMessage(HttpMethod.Post, "https://apiehd.smartsign.com.vn/api/HDon/AdjustedInvoice");
	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""
                        },
                        ""TTHDLQuan"": {
                            ""KHMSHDCLQuan"": ""1"",
                            ""KHHDCLQuan"": ""C23XXX"",
                            ""SHDCLQuan"": 1,
                            ""Ky"": false
                        }
                    }";

	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/AdjustedInvoice",
        "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"
        },
        "TTHDLQuan": {
            "KHMSHDCLQuan": "1",
            "KHHDCLQuan": "C23XXX",
            "SHDCLQuan": 1,
            "Ky": false
        }
    }),
};

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

								
var request = require('request');
    var options = {
        'method': 'POST',
        'url': 'https://apiehd.smartsign.com.vn/api/HDon/AdjustedInvoice',
        '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"
    },
    "TTHDLQuan": {
        "KHMSHDCLQuan": "1",
        "KHHDCLQuan": "C23XXX",
        "SHDCLQuan": 1,
        "Ky": false
        }
    })

};
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": "",
        "KHMSHDon": 1,
        "KHHDon": "C23XXX",
        "SHDon": 1,
        "NLap": "2023-07-25T10:10:30",
        "DVTTe": "VND",
        "TGia": "1",
        "HTTToan": "TM/CK",
        "PTTToan": "",
        "MBMat": "SmartVasTest01",
        "MNBo": "SmartVasTest01",
        "MTCuu": null,
        "GChu": null,
        "XML": null,
        "NgayChungTu": "2023-07-25T10:10:30"
        (Các thông tin khác)...
    },
    "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"
    },
    "TTHDLQuan": {
        "KHMSHDCLQuan": "1",
        "KHHDCLQuan": "C23XXX",
        "SHDCLQuan": 0,
        "Ky": false
    },
    "MCCQT": null
}

Mô tả lỗi

Đối tượng Mô tả
Status Mã lỗi:
204: Không tìm thấy hóa đơn bị điều chỉnh
406: Lỗi ký hoá đơn hoặc không tạo được hoá đơn điều chỉnh
500: Lỗi xử lý, xem mô tả để biết thêm chi tiết
Error Mô tả lỗi

Mã nguồn JSON ví dụ


{"error":"Không tìm thấy hóa đơn!"}