Phát hành hóa đơn với chữ ký số HSM (softdream,cyber lotus)

Phương thức này cho phép phát hành hóa đơn lên hệ thống MISA và CQT.

Mô tả: gọi phương thức này để phát hành hóa đơn thì dữ liệu sẽ được đẩy lên MISA và MISA sẽ tạo XML thô sau đó gọi qua máy chủ HSM của nhà cung cấp mà công ty đã đăng ký và đăng nhập trên webapp : https://app.meinvoice.vn để ký số sau đó kiểm tra các thông tin và ghi nhận phát hành, hóa đơn sẽ được ghi nhận là đã phát hành và được đẩy qua CQT theo cách mà công ty đã được quy định.

1. Request

Kiểu doanh nghiệp	Method	<BaseURL&gt
Không mã	POST	<BaseURL>/itg/invoicepublishing/publishhsm
Có mã	POST	<BaseURL>/code/itg/invoicepublishing/publishhsm

1.1Header

Content-Type: application-json
Authorization: Bearer <token>
CompanyTaxCode: "Mã số thuế đăng nhập"

1.2Body parameter

[
 {
    "RefID": "ID hóa đơn",
    "OriginalInvoiceData": {thông tin hóa đơn gốc},
    "IsSendEmail":true/false {Gửi hóa đơn cho khách hàng sau khi phát hành},
    "ReceiverName":"Tên người nhận Email"        
    "ReceiverEmail":"Danh sách Email nhận (cách nhau bởi dấu ;)"    
    "IsInvoiceSummary":    true/false {Có phải hóa đơn lên bảng TH không}
 }
]

1.3Response

{
"Success": true,
"ErrorCode": "Mã lỗi (nếu có)",
"Errors": [],
"Data": "[
            {
                "RefID": "id hóa đơn",
                "TransactionID": "Mã tra cứu",
                "InvTemplateNo": "Mẫu số hóa đơn",
                "InvSeries": "Ký hiệu hóa đơn",
                "InvNo": "Số hóa đơn",
                "InvDate": "Ngày hóa đơn",
                "ErrorCode": "Mã lỗi (nếu có)"
            }
         ]",
"CustomData": null
}

1.4 Hóa đơn thay thế / điều chỉnh

Đối với háo đơn thay thế điều chỉnh phần thông tin master (OriginalInvoiceData) truyền thêm các field sau để đánh dấu hóa đơn gôc

    // nếu là hoa đơn thay thế hoặc điều chỉnh thì bổ sung đoạn sau
    "ReferenceType": null,//Tính chất hóa đơn (1: thay thế; 2: điều chỉnh)
    "OrgInvoiceType": null,//Loại hóa đơn bị thay thế/điều chỉnh  (1: Hóa đơn 123; 3: Hóa đơn 51)
    "OrgInvTemplateNo": null,//Ký hiệu mẫu hđ bị thay thế/điều chỉnh (ví dụ: 1)
    "OrgInvSeries": null,//Ký hiệu hđ bị thay thế/điều chỉnh (ví dụ: K21TAA)
    "OrgInvNo": null,//Số hđ bị thay thế/điều chỉnh (ví dụ: 00000001)
    "OrgInvDate": null,//Ngày hóa đơn bị thay thế/điều chỉnh   (ví dụ: 2022-01-01)

2.Ví dụ

2.1Request

https://testapi.meinvoice.vn/api/v3/itg/invoicepublishing/publishHSM

[
  {
        "RefID": "21E34AFA-38F3-4506-A222-7C3AFC55B8E2",
        "OriginalInvoiceData": {
        "RefID": "21E34AFA-38F3-4506-A222-7C3AFC55B8E2",
        "InvSeries": "1C21TYY",
        "InvoiceName": "HÓA ĐƠN GIÁ TRỊ GIA TĂNG",
        "InvDate": "2021-12-16T00:00:00+07:00",
        "CurrencyCode": "VND",
        "ExchangeRate": 1.0,
        "PaymentMethodName": "TM/CK",
        "IsInvoiceSummary": false,
        "BuyerLegalName": "Công ty cổ phần MISA (Test - 666)",
        "BuyerTaxCode": "0101243150-666",
        "BuyerAddress": "Hà Nội",
        "BuyerEmail": "meinvoiceemail@gmail.com",
        "DiscountRate": null,
        "TotalSaleAmountOC": 150000.0,
        "TotalSaleAmount": 150000.0,
        "TotalAmountWithoutVATOC": 150000.0,
        "TotalAmountWithoutVAT": 150000.0,
        "TotalVATAmountOC": 15000.0,
        "TotalVATAmount": 15000.0,
        "TotalDiscountAmountOC": null,
        "TotalDiscountAmount": null,
        "TotalAmountOC": 165000.0,
        "TotalAmount": 165000.0,
        "TotalAmountInWords": "Một triệu năm trăm hai mươi hai nghìn ba trăm hai mươi ba phẩy mười hai đồng.",
        "OriginalInvoiceDetail": [
            {
                "ItemType": 1,
                "LineNumber": 1,
                "SortOrder": 1,
                "ItemCode": "AO-NAM",
                "ItemName": "Áo nam",
                "UnitName": "Chiếc",
                "Quantity": 1.0,
                "UnitPrice": 150000.0,
                "DiscountRate": null,
                "DiscountAmountOC": null,
                "DiscountAmount": null,
                "AmountOC":150000.0,
                "Amount": 150000.0,
                "AmountWithoutVATOC": 150000.0,                                    
                "AmountWithoutVAT": 150000.0,
                "VATRateName": "10%",
                "VATAmountOC": 15000.0,
                "VATAmount": 15000.0    
            }
        ],
        "TaxRateInfo": [
            {
                "VATRateName": "10%",
                "AmountWithoutVATOC": 150000.0,
                "VATAmountOC": 15000.0
            }
        ],
        "FeeInfo": null,
        "OptionUserDefined": {
            "MainCurrency": "VND",
            "AmountDecimalDigits": "2",
            "AmountOCDecimalDigits": "2",
            "UnitPriceOCDecimalDigits": "2",
            "UnitPriceDecimalDigits": "2",
            "QuantityDecimalDigits": "3",
            "CoefficientDecimalDigits": "2",
            "ExchangRateDecimalDigits": "2",
            "ClockDecimalDigits": "4"
        }

    }
    }
]

2.1response

{
"Success":true,
"ErrorCode":null,
"Errors":[],
"Data":"[{
            \"RefID\":\"19d02e93-cb8b-4a60-8b06-4a7387cd44cc\",
            \"TransactionID\":\"QWIGTN63E_\",
            \"InvTemplateNo\":\"1\",
            \"InvSeries\":\"K21TAA\",
            \"InvNo\":\"00000321\",
            \"InvCode\":\"\",
            \"InvDate\":\"2022-09-22T00:00:00+07:00\",
            \"ErrorCode\":\"\",
            \"CustomData\":null
        }]",
"CustomData":null
}

3.Mô tả đối tượng

3.1OriginalInvoiceData (thông tin chung của hóa đơn)

/// <summary>
/// Thông tin hóa đơn gốc
/// </summary>
public class OriginalInvoiceData
{
    /// <summary>
    /// ID của hóa đơn trên Client App
    /// </summary>
    public string RefID { get; set; }

    /// <summary>
    /// Ký hiệu hóa đơn
    /// </summary>
    public string InvSeries { get; set; }

    /// <summary>
    /// Tên hóa đơn
    /// </summary>
    public string InvoiceName { get; set; }

    /// <summary>
    /// Ngày hóa đơn
    /// </summary>
    /// <returns></returns>
    public DateTime InvDate { get; set; }

    /// <summary>
    /// Mã loại tiền tệ
    /// </summary>
    public string CurrencyCode { get; set; }

    /// <summary>
    /// Tỷ giá
    /// </summary>
    public decimal? ExchangeRate { get; set; }

    /// <summary>
    /// Hình thức thanh toán
    /// </summary>
    public string PaymentMethodName { get; set; }

    /// <summary>
    /// Tính chất hóa đơn (1: thay thế; 2: điều chỉnh)
    /// </summary>
    public int? ReferenceType { get; set; }

    /// <summary>
    /// Là hóa đơn gửi dạng bảng tổng hợp
    /// </summary>
    public bool IsInvoiceSummary { get; set; }

    /// <summary>
    /// Loại hóa đơn bị thay thế/điều chỉnh (1: Hóa đơn 123; 2: Hóa đơn có mã; 3: Hóa đơn 51; 4: Hóa đơn đặt in 123)
    /// </summary>
    public int? OrgInvoiceType { get; set; }

    /// <summary>
    /// Ký hiệu mẫu hđ bị thay thế/điều chỉnh
    /// </summary>
    public string OrgInvTemplateNo { get; set; }

    /// <summary>
    /// Ký hiệu hđ bị thay thế/điều chỉnh
    /// </summary>
    public string OrgInvSeries { get; set; }

    /// <summary>
    /// Số hđ bị thay thế/điều chỉnh
    /// </summary>
    public string OrgInvNo { get; set; }

    /// <summary>
    /// Ngày hóa đơn bị thay thế/điều chỉnh
    /// </summary>
    public DateTime? OrgInvDate { get; set; }

    /// <summary>
    /// Ghi chú của hóa đơn
    /// </summary>
    public string InvoiceNote { get; set; }

    /// <summary>
    /// Tên người bán
    /// </summary>
    public string SellerLegalName { get; set; }

    /// <summary>
    /// MST người bán
    /// </summary>
    public string SellerTaxCode { get; set; }

    /// <summary>
    /// Địa chỉ người bán
    /// </summary>
    public string SellerAddress { get; set; }

    /// <summary>
    /// ĐT người bán
    /// </summary>
    public string SellerPhoneNumber { get; set; }

    /// <summary>
    /// Email người bán
    /// </summary>
    public string SellerEmail { get; set; }

    /// <summary>
    /// Số TK ngân hàng người bán
    /// </summary>
    public string SellerBankAccount { get; set; }

    /// <summary>
    /// Tên ngân hàng người bán
    /// </summary>
    public string SellerBankName { get; set; }

    /// <summary>
    /// Fax người bán
    /// </summary>
    public string SellerFax { get; set; }

    /// <summary>
    /// Website người bán
    /// </summary>
    public string SellerWebsite { get; set; }

    /// <summary>
    /// Tên (Tên người xuất hàng)
    /// </summary>
    public string StockOutLegalName { get; set; }

    /// <summary>
    /// Mã số thuế (MST người xuất hàng)
    /// </summary>
    public string StockOutTaxCode { get; set; }

    /// <summary>
    /// Lệnh điều động nội bộ
    /// </summary>
    public string InternalCommand { get; set; }

    /// <summary>
    /// Địa chỉ (Địa chỉ kho xuất hàng)
    /// </summary>
    public string StockOutAddress { get; set; }

    /// <summary>
    /// Họ và tên người xuất hàng
    /// </summary>
    public string StockOutFullName { get; set; }

    /// <summary>
    /// Tên người vận chuyển
    /// </summary>
    public string TransporterName { get; set; }

    /// <summary>
    /// Hợp đồng số (Hợp đồng vận chuyển)
    /// </summary>
    public string TransportContractCode { get; set; }

    /// <summary>
    /// Phương tiện vận chuyển
    /// </summary>
    public string Transport { get; set; }

    /// <summary>
    /// Tên (Tên người nhận hàng)
    /// </summary>
    public string StockInLegalName { get; set; }

    /// <summary>
    /// Mã số thuế (Mã số thuế người nhận hàng)
    /// </summary>
    public string StockInTaxCode { get; set; }

    /// <summary>
    /// Họ và tên người nhận hàng
    /// </summary>
    public string StockInFullName { get; set; }

    /// <summary>
    /// Địa chỉ (Địa chỉ kho nhận hàng)
    /// </summary>
    public string StockInAddress { get; set; }

    /// <summary>
    /// Mã số thuế (MST người xuất hàng)
    /// </summary>
    public string ContractCode { get; set; }

    /// <summary>
    /// Hợp đồng kinh tế ngày
    /// </summary>
    public DateTime? ContractDate { get; set; }

    /// <summary>
    /// Tên đơn vị mua
    /// </summary>
    public string BuyerLegalName { get; set; }

    /// <summary>
    /// MST người mua
    /// </summary>
    public string BuyerTaxCode { get; set; }

    /// <summary>
    /// Địa chỉ người mua
    /// </summary>
    public string BuyerAddress { get; set; }

    /// <summary>
    /// Mã khách hàng
    /// </summary>
    public string BuyerCode { get; set; }

    /// <summary>
    /// ĐT người mua
    /// </summary>
    public string BuyerPhoneNumber { get; set; }

    /// <summary>
    /// Email người mua
    /// </summary>
    public string BuyerEmail { get; set; }

    /// <summary>
    /// Tên người mua hàng
    /// </summary>
    public string BuyerFullName { get; set; }

    /// <summary>
    /// Số TK ngân hàng người mua
    /// </summary>
    public string BuyerBankAccount { get; set; }

    /// <summary>
    /// Tên ngân hàng người mua
    /// </summary>
    public string BuyerBankName { get; set; }

    /// <summary>
    /// tên người liên hệ
    /// </summary>
    public string ContactName { get; set; }

    /// <summary>
    /// Tỷ lệ chiết khấu cho hóa đơn chiết khấu theo giá trị hóa đơn
    /// </summary>
    public decimal? DiscountRate { get; set; }

    /// <summary>
    /// tổng tiền chưa thuế
    /// </summary>
    public decimal? TotalAmountWithoutVATOC { get; set; }

    /// <summary>
    /// Tổng tiền thuế
    /// </summary>
    public decimal? TotalVATAmountOC { get; set; }

    /// <summary>
    /// Tổng tiền CKTM
    /// </summary>
    public decimal? TotalDiscountAmountOC { get; set; }

    /// <summary>
    /// Tổng tiền bằng số
    /// </summary>
    public decimal? TotalAmountOC { get; set; }

    /// <summary>
    /// Tổng tiền bằng chữ
    /// </summary>
    public string TotalAmountInWords { get; set; }
    /// <summary>
    /// Chi tiết hóa đơn
    /// </summary>
    /// <returns></returns>
    public List<OriginalInvoiceDetail> OriginalInvoiceDetail { get; set; }

    /// <summary>
    /// Danh sách các loại thuế suất
    /// </summary>
    public List<TaxRateInfo> TaxRateInfo { get; set; }

    /// <summary>
    /// Danh sách các loại phí
    /// </summary>
    public List<FeeInfo> FeeInfo { get; set; }

    /// <summary>
    /// Định dạng số để hiển thị hóa đơn
    /// </summary>
    public OptionUserDefined OptionUserDefined { get; set; }

    /// <summary>
    /// ID mẫu hóa đơn
    /// </summary>
    public Guid? InvoiceTemplateID { get; set; }

    /// <summary>
    /// Trường mở rộng 1
    /// </summary>
    public string CustomField1 { get; set; }

    /// <summary>
    /// Trường mở rộng 2
    /// </summary>
    public string CustomField2 { get; set; }

    /// <summary>
    /// Trường mở rộng 3
    /// </summary>
    public string CustomField3 { get; set; }

    /// <summary>
    /// Trường mở rộng 4
    /// </summary>
    public string CustomField4 { get; set; }

    /// <summary>
    /// Trường mở rộng 5
    /// </summary>
    public string CustomField5 { get; set; }

    /// <summary>
    /// Trường mở rộng 6
    /// </summary>
    public string CustomField6 { get; set; }

    /// <summary>
    /// Trường mở rộng 7
    /// </summary>
    public string CustomField7 { get; set; }

    /// <summary>
    /// Trường mở rộng 8
    /// </summary>
    public string CustomField8 { get; set; }

    /// <summary>
    /// Trường mở rộng 9
    /// </summary>
    public string CustomField9 { get; set; }

    /// <summary>
    /// Trường mở rộng 10
    /// </summary>
    public string CustomField10 { get; set; }

    /// <summary>
    /// Tổng tiền bằng số quy đổi
    /// </summary>
    public decimal? TotalAmount { get; set; }

    /// <summary>
    /// tổng tiền chưa thuế quy đổi
    /// </summary>
    public decimal? TotalAmountWithoutVAT { get; set; }

    /// <summary>
    /// Tổng tiền thuế quy đổi
    /// </summary>
    public decimal? TotalVATAmount { get; set; }

    /// <summary>
    /// Tổng tiền CKTM quy đổi
    /// </summary>
    public decimal? TotalDiscountAmount { get; set; }

    /// <summary>
    /// Tổng tiền hàng
    /// </summary>
    public decimal? TotalSaleAmountOC { get; set; }

    /// <summary>
    /// Tổng tiền hàng quy đổi
    /// </summary>
    public decimal? TotalSaleAmount { get; set; }

    /// <summary>
    /// Tổng tiền xuất kho nguyên tệ
    /// </summary>
    public decimal? StockTotalAmountOC { get; set; }

    /// <summary>
    /// Tổng tiền xuất kho
    /// </summary>
    public decimal? StockTotalAmount { get; set; }

    /// <summary>
    /// Có giảm trừ thuế không
    /// </summary>
    public bool? IsTaxReduction { get; set; }

    /// <summary>
    /// Số tiền bằng chữ (VNĐ)
    /// </summary>
    public string TotalAmountInWordsVN { get; set; }

    /// <summary>
    /// Số tiền bằng chữ không dấu
    /// </summary>
    public string TotalAmountInWordsUnsignNormalVN { get; set; }

    /// <summary>
    /// Tên chi nhánh ngân hàng người bán
    /// </summary>
    public string CompanyBranchBankName { get; set; }

    /// <summary>
    /// Tên ngân hàng (kèm chi nhánh) của người bán
    /// </summary>
    public string CompanyBankNameWithBranch { get; set; }

    /// <summary>
    /// Phí hoàn vé máy bay
    /// </summary>
    public decimal? ReturnTicketAmount { get; set; }

    /// <summary>
    /// Phí hoàn vé máy bay nguyên tệ
    /// </summary>
    public decimal? ReturnTicketAmountOC { get; set; }

    /// <summary>
    /// Phần trăm thuế tiêu thụ đặc biệt
    /// </summary>
    public decimal? ExciseTaxRate { get; set; }

    /// <summary>
    /// Tiền thuế tiêu thụ đặc biệt
    /// </summary>
    public decimal? ExciseTaxAmount { get; set; }

    /// <summary>
    /// Thuế tiêu thụ ĐB nguyên tệ
    /// </summary>
    public decimal? ExciseTaxAmountOC { get; set; }

    /// <summary>
    /// Số hợp đồng
    /// </summary>
    public string TrsContractNo { get; set; }

    /// <summary>
    /// Vận đơn
    /// </summary>
    public string TrsBLNo { get; set; }

    /// <summary>
    /// Tên tàu
    /// </summary>
    public string TrsNameVessel { get; set; }

    /// <summary>
    /// Quốc tịch
    /// </summary>
    public string TrsFlag { get; set; }

    /// <summary>
    /// Ngày đến
    /// </summary>
    public DateTime? TrsArrival { get; set; }

    /// <summary>
    /// Ngày đi
    /// </summary>
    public DateTime? TrsDeparture { get; set; }

    /// <summary>
    /// Phòng số
    /// </summary>
    public string RoomNo { get; set; }

    /// <summary>
    /// Ngày đến
    /// </summary>
    public string CheckIn { get; set; }

    /// <summary>
    /// Ngày đi
    /// </summary>
    public string CheckOut { get; set; }

    /// <summary>
    /// Toán tử tỷ giá
    /// </summary>
    public string ExchangeRateOperation { get; set; }

    /// <summary>
    /// Ds kho
    /// </summary>
    public string ListStockName { get; set; }

    /// <summary>
    /// Ds địa chỉ kho
    /// </summary>
    public string ListStockAddress { get; set; }

    /// <summary>
    /// Mã kho đi
    /// </summary>
    public string ListFromStockCode { get; set; }

    /// <summary>
    /// Mã kho đến
    /// </summary>
    public string ListToStockCode { get; set; }

    /// <summary>
    /// Địa chỉ kho đi
    /// </summary>
    public string FromStockAddress { get; set; }

    /// <summary>
    /// Địa chỉ kho đến
    /// </summary>
    public string ToStockAddress { get; set; }

    /// <summary>
    /// Lệnh điều động số
    /// </summary>
    public string InternalCommandNo { get; set; }

    /// <summary>
    /// Lệnh điều động của
    /// </summary>
    public string InternalCommandOwner { get; set; }

    /// <summary>
    /// Lệnh điều động ngày
    /// </summary>
    public DateTime? InternalCommandDate { get; set; }

    /// <summary>
    /// Về việc
    /// </summary>
    public string JournalMemo { get; set; }

    /// <summary>
    /// Kỳ thu
    /// </summary>
    public string PeriodName { get; set; }

    /// <summary>
    ///Từ ngày
    /// </summary>
    public DateTime? PeriodFromDate { get; set; }

    /// <summary>
    /// Đến ngày
    /// </summary>
    public DateTime? PeriodToDate { get; set; }

    /// <summary>
    /// Số nước truy thu
    /// </summary>
    public decimal? WaterArrearage { get; set; }

    /// <summary>
    /// Số nước khuyến mại
    /// </summary>
    public decimal? WaterPromotion { get; set; }

    /// <summary>
    /// Số nước tiêu thụ
    /// </summary>
    public decimal? WaterUsed { get; set; }

    /// <summary>
    /// Mức % Phí bảo vệ môi trường
    /// </summary>
    public int EnvironmmentFeeRate { get; set; }

    /// <summary>
    /// Tiền phí bảo vệ môi trường
    /// </summary>
    public decimal? EnvironmmentFeeAmount { get; set; }

    /// <summary>
    /// Phí đăng kiểm
    /// </summary>
    public decimal? RegistrationFee { get; set; }

    /// <summary>
    /// Tổng chỉ số của các đồng hồ - Điện năng tiêu thụ
    /// </summary>
    public decimal? SumOfClockIndex { get; set; }

    /// <summary>
    /// Danh sách đồng hồ
    /// </summary>
    public List<ClockInfo> ClockInfos { get; set; }
}

3.2OriginalInvoiceDetail (thông tin hàng hóa dịch vụ của háo đơn)

/// <summary>
/// Thông tin chi tiết hóa đơn gốc
/// </summary>
public class OriginalInvoiceDetail
{
    /// <summary>
    /// Tính chất (1: HHDV; 2: khuyến mại; 3: chiết khẩu; 4: ghi chú/diễn giải)
    /// </summary>
    public int ItemType { get; set; }

    /// <summary>
    /// STT dòng mặt hàng (bắt đầu từ 1)
    /// </summary>
    public int LineNumber { get; set; }

    /// <summary>
    /// Mã mặt hàng
    /// </summary>
    public string ItemCode { get; set; }

    /// <summary>
    /// Tên mặt hàng
    /// </summary>
    public string ItemName { get; set; }

    /// <summary>
    /// Đơn vị tính
    /// </summary>
    public string UnitName { get; set; }

    /// <summary>
    /// Số lượng mặt hàng
    /// </summary>
    public decimal? Quantity { get; set; }

    /// <summary>
    /// Đơn giá
    /// </summary>
    public decimal? UnitPrice { get; set; }

    /// <summary>
    /// Tỷ lệ chiết khấu
    /// </summary>
    public decimal? DiscountRate { get; set; }

    /// <summary>
    /// Tiền chiết khấu
    /// </summary>
    public decimal? DiscountAmountOC { get; set; }

    /// <summary>
    /// Tiền chiết khấu quy đổi
    /// </summary>
    public decimal? DiscountAmount { get; set; }

    /// <summary>
    /// Thành tiền
    /// </summary>
    public decimal? AmountOC { get; set; }

    /// <summary>
    /// Thành tiền quy đổi
    /// </summary>
    public decimal? Amount { get; set; }

    /// <summary>
    /// Thành tiền chưa thuế
    /// </summary>
    public decimal? AmountWithoutVATOC { get; set; }

    /// <summary>
    /// Đơn giá sau thuế
    /// </summary>
    public decimal? UnitPriceAfterTax { get; set; }

    /// <summary>
    /// Thành tiền sau thuế quy đổi
    /// </summary>
    public decimal? AmountAfterTax { get; set; }

    /// <summary>
    /// Tên loại thuế suất
    /// </summary>
    public string VATRateName { get; set; }

    /// <summary>
    /// Tiền thuế
    /// </summary>
    public decimal? VATAmountOC { get; set; }

    /// <summary>
    /// Tiền thuế quy đổi
    /// </summary>
    public decimal? VATAmount { get; set; }

    /// <summary>
    /// Trường mở rộng 1
    /// </summary>
    public string CustomField1Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 2
    /// </summary>
    public string CustomField2Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 3
    /// </summary>
    public string CustomField3Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 4
    /// </summary>
    public string CustomField4Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 5
    /// </summary>
    public string CustomField5Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 6
    /// </summary>
    public string CustomField6Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 7
    /// </summary>
    public string CustomField7Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 8
    /// </summary>
    public string CustomField8Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 9
    /// </summary>
    public string CustomField9Detail { get; set; }

    /// <summary>
    /// Trường mở rộng 10
    /// </summary>
    public string CustomField10Detail { get; set; }

    /// <summary>
    /// Thứ tự hiển thị lên mẫu
    /// </summary>
    public int? SortOrder { get; set; }

    /// <summary>
    /// Diễn giải hàng hóa
    /// </summary>
    public string InventoryItemNote { get; set; }

    /// <summary>
    /// Số lô
    /// </summary>
    public string LotNo { get; set; }

    /// <summary>
    /// Hạn sử dụng
    /// </summary>
    public DateTime? ExpiryDate { get; set; }

    /// <summary>
    /// Mã ĐVT
    /// </summary>
    public string UnitCode { get; set; }

    /// <summary>
    /// Tiền thuế đc giảm nguyên tệ (406)
    /// </summary>
    public decimal? TaxReductionAmountOC { get; set; }

    /// <summary>
    /// Tiền thuế được giảm quy đổi (406)
    /// </summary>
    public decimal? TaxReductionAmount { get; set; }

    ///// <summary>
    ///// Số lượng thực nhập
    ///// </summary>
    public decimal? InWards { get; set; }

    /// <summary>
    /// Số khung
    /// </summary>
    public string ChassisNumber { get; set; }

    /// <summary>
    /// Số khung
    /// </summary>
    public string EngineNumber { get; set; }

    /// <summary>
    /// Xuất bản phí
    /// </summary>
    public string PublishFee { get; set; }
}

3.3ClockInfo (đối tượng đồng hồ trong hóa đơn điện/nước)

/// <summary>
/// Thông tin đồng hồ đối với hóa đơn điện nước
/// </summary>
public class ClockInfo
{
    /// <summary>
    /// STT dòng mặt hàng (bắt đầu từ 1)
    /// </summary>
    public int ClockOrder { get; set; }

    /// <summary>
    /// Mã đồng hồ
    /// </summary>
    public string ClockCode { get; set; }

    /// <summary>
    /// Seri đồng hồ
    /// </summary>
    public string ClockSeri { get; set; }

    /// <summary>
    /// Chỉ số mới
    /// </summary>
    public decimal LastIndex { get; set; }

    /// <summary>
    /// Chỉ số cũ
    /// </summary>
    public decimal FirstIndex { get; set; }

    /// <summary>
    /// Hệ số của đồng hồ
    /// </summary>
    public decimal Coefficient { get; set; } = 1;

    /// <summary>
    /// Mã đồng hồ cũ
    /// </summary>
    public string ClockCodeOld { get; set; }

    /// <summary>
    /// Seri đồng hồ cũ
    /// </summary>
    public string ClockSeriOld { get; set; }

    /// <summary>
    /// Chỉ số mới của đồng hồ cũ
    /// </summary>
    public decimal? LastIndexOld { get; set; }

    /// <summary>
    /// Chỉ số cũ của đồng hồ cũ
    /// </summary>
    public decimal? FirstIndexOld { get; set; }

    /// <summary>
    /// Hệ số của đồng hồ cũ
    /// </summary>
    public decimal? CoefficientOld { get; set; }

    /// <summary>
    /// Trạng thái của đồng hồ
    /// 0 là đang sử dụng
    /// 1 là thay mới đồng hồ => truyền thêm thông tin đồng hồ cũ vào các trường có Old
    /// </summary>
    public int ClockStatus { get; set; } = 0;

    /// <summary>
    /// Xe tra nạp
    /// </summary>
    public string RefuelerNo { get; set; }

    /// <summary>
    /// Số lô
    /// </summary>
    public string QualityControlNo { get; set; }

    /// <summary>
    /// Số công tơ đầu
    /// </summary>
    public decimal? StartMeter { get; set; }

    /// <summary>
    /// Số công tơ cuối
    /// </summary>
    public decimal? EndMeter { get; set; }

    /// <summary>
    /// Nhiệt độ thực tế
    /// </summary>
    public decimal? ActualTemperature { get; set; }

    /// <summary>
    /// Tỉ trọng thực tế
    /// </summary>
    public decimal? ActualDensity { get; set; }

    /// <summary>
    /// Gallon thực tế
    /// </summary>
    public decimal? ObservedGallon { get; set; }

    /// <summary>
    /// Lít thực tế
    /// </summary>
    public decimal? ObservedLiters { get; set; }
}

3.4TaxRateInfo (Thông tin các loại thuế suất)

/// <summary>
/// Thông tin các loại thuế suất
/// </summary>
public class TaxRateInfo
{
    /// <summary>
    /// Tên loại thuế suất
    /// </summary>
    public string VATRateName { get; set; }

    /// <summary>
    /// Tiền chưa thuế
    /// </summary>
    public decimal? AmountWithoutVATOC { get; set; }

    /// <summary>
    /// Tiền thuế
    /// </summary>
    public decimal? VATAmountOC { get; set; }
}

3.5FeeInfo (Thông tin các loại phí)

/// <summary>
/// Thông tin các loại phí
/// </summary>
public class FeeInfo
{
    /// <summary>
    /// Tên loại phí
    /// </summary>
    public string FeeName { get; set; }

    /// <summary>
    /// Tiền phí
    /// </summary>
    public decimal? FeeAmountOC { get; set; }
}

3.6OptionUserDefined (Định dạng số, đồng tiền hạch toán của háo đơn)

/// <summary>
/// Class chứa các tùy chọn cần dùng để hiển thị hóa đơn:
/// Định dạng số, đồng tiền hạch toán
/// </summary>
public class OptionUserDefined
{
    /// <summary>
    /// Đồng tiền hạch toán
    /// </summary>
    public string MainCurrency { get; set; }

    /// <summary>
    /// Định dạng số tiền quy dổi
    /// </summary>
    public string AmountDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng số tiền nguyên tệ
    /// </summary>
    public string AmountOCDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng đơn giá nguyên tệ
    /// </summary>
    public string UnitPriceOCDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng đơn giá quy đổi
    /// </summary>
    public string UnitPriceDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng số lượng
    /// </summary>
    public string QuantityDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng tỷ lệ
    /// </summary>
    public string CoefficientDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng tỷ giá
    /// </summary>
    public string ExchangRateDecimalDigits { get; set; }

    /// <summary>
    /// Định dạng tham số decimal trong ClockInfo
    /// </summary>
    public string ClockDecimalDigits { get; set; }
}