Tạo PDF hóa đơn nháp (Không lưu lên hệ thống)

Mô tả và thông tin API

Endpoint: api/HDon/GetPDFDraft

Method: POST

Mô tả: API này cho phép người dùng tạo PDF nháp từ thông tin hóa đơn.

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ữ

Mã nguồn ví dụ

								
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://apiehd.smartsign.com.vn/api/HDon/GetPDFDraft");
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/GetPDFDraft",
        "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/GetPDFDraft',
        '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ả
File PDF Nội dung hoá đơn được hiện trên file PDF

Mẫu hoá đơn

Mô tả lỗi

Đối tượng Mô tả
Status Mã lỗi:
406: Không tìm thấy hóa đơn
Error Mô tả lỗi

Mã nguồn JSON ví dụ


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