Hướng dẫn tích hợp hóa đơn bán hàng theo Nghị quyết số 174/2024/QH15

🔔THÔNG BÁO ĐẶC BIỆT QUAN TRỌNG 🔔

Triển khai hóa đơn bán hàng và ưu đãi thuế GTGT cho hộ kinh doanh

Căn cứ Nghị quyết số 174/2024/QH15, từ thời điểm hiện tại, các hộ kinh doanh (HKD) sử dụng hóa đơn bán hàng ký hiệu 2xxxxx sẽ được giảm 20% mức tỷ lệ % để tính thuế giá trị gia tăng (GTGT) theo quy định của pháp luật.

Các HKD khi xuất hóa đơn bắt buộc phải áp dụng mức thuế GTGT đã giảm đối với các hàng hóa thuộc danh mục được giảm thuế.

👉 Quý đối tác vui lòng thực hiện theo tài liệu kỹ thuật do M-invoice cung cấp tại Mục 3 (Thêm/Sửa/Xóa hóa đơn).

📌 Danh mục hàng hóa được giảm thuế GTGT tra cứu tại:

🔗 Tra cứu giảm thuế

Công thức giảm thuế mẫu

THÔNG TIN TRONG CHI TIẾT HÀNG HÓA
Tên hàng Số lượng Đơn giá Thành tiền
Món ăn 1 1 1,000,000 1,000,000
Món ăn 2 1 560,000 560,000
Bia Heineken 10 50,000 500,000
Rượu Chivas 24 1 5,000,000 5,000,000
...
TỔNG CỘNG TRÊN ĐẦU PHIẾU
Tổng tiền hàng (inv_totalAmount): 7,060,000
% Thuế GTGT theo Doanh thu (tlptdoanhthu20): 2
Tổng thuế GTGT được giảm (tgtck20): 28,240
Tổng tiền thanh toán (inv_TotalAmount): 7,031,760

Cách trường thông tin cần truyền

🔹 Trường hợp 1: Các thông tin trường cần thêm để giảm trên cả hóa đơn

Các trường thông tin:

Tên trường Kiểu dữ liệu Độ dài Bắt buộc Ghi chú
tlptdoanhthu20 int (CHỈ ÁP DỤNG CHO HÓA ĐƠN BÁN HÀNG có giảm thuế GTGT theo NQ101-2023/QH15)
Tỷ lệ % thuế GTGT trên doanh thu của mặt hàng đang sử dụng, nhận giá trị:
1 - Phân phối, cung cấp hàng hóa dịch vụ
2 - Hoạt động kinh doanh khác
3 - Sản xuất, vận tải, dịch vụ có gắn với hàng hóa, xây dựng có bao thầu nguyên vật liệu
5 - Dịch vụ xây dựng không bao thầu nguyên vật liệu
tgtck20 decimal 21,6 (CHỈ ÁP DỤNG CHO HÓA ĐƠN BÁN HÀNG có giảm thuế GTGT theo NQ101-2023/QH15)
Tổng tiền thuế GTGT được giảm đối với HÓA ĐƠN BÁN HÀNG theo NQ101/2023/QH15
isDeductionNQ43 boolean (CHỈ ÁP DỤNG CHO HÓA ĐƠN BÁN HÀNG có giảm thuế GTGT theo NQ101-2023/QH15)
Có Áp dụng giảm thuế cho HÓA ĐƠN BÁN HÀNG theo NQ 101/2023/NĐ-CP không?
true: có
false: không

json mẫu 

{
"editmode": 1,
"data": [
    {
  "inv_invoiceSeries": "2C25MAC",
  "inv_invoiceIssuedDate": "2025-05-28",
  "inv_currencyCode": "VND",
  "inv_exchangeRate": 1,
  "so_benh_an": "A123DE64",
  "inv_buyerDisplayName": "Nguyễn Văn A",
  "inv_buyerLegalName": "CÔNG TY M-INVOICE",
  "inv_buyerTaxCode": "0106026495-999",
  "inv_buyerAddressLine": "Giáp Bát, Hoàng Mai, Hà Nội",
  "inv_buyerEmail": "abc@gmail.com",
  "inv_buyerBankAccount": "100003131",
  "inv_buyerBankName": "Ngân hàng TMCP Á Châu - ACB",
  "inv_paymentMethodName": "TM/CK",
  "nonTaxZone": 0,
  "tlptdoanhthu20": 2,
  "isDeductionNQ43": true,
  "tgtck20": 5000,
  "inv_discountAmount": 0,
  "inv_TotalAmount": 606340,
  "key_api": "",
  "details": [
    {
      "data": [
        {
          "tchat": 1,
          "stt_rec0": 1,
          "inv_itemCode": "HH001",
          "inv_itemName": "Hàng hóa 001",
          "inv_unitCode": "Phần",
          "inv_quantity": 1,
          "inv_unitPrice": 120000,
          "inv_discountPercentage": 0,
          "inv_discountAmount": 0,
          "inv_TotalAmountWithoutVat": 118800
        },
        {
          "tchat": 1,
          "stt_rec0": 2,
          "inv_itemCode": "HH002",
          "inv_itemName": "Hàng hóa 002",
          "inv_unitCode": "Phần",
          "inv_quantity": 2,
          "inv_unitPrice": 245000,
          "inv_discountPercentage": 0,
          "inv_discountAmount": 0,
          "inv_TotalAmountWithoutVat": 490000
        }
      ]
    }
  ]
    }
    ]
    }
Kết quả mong muốn:

Hình 1

🔹 Trường hợp 2: Các thông tin trường cần thêm để giảm trên từng dòng hàng (dùng cho các trường hợp hóa đơn có cả hàng hóa giảm và không giảm)

Các trường thông tin:

Tên trường Kiểu dữ liệu Độ dài Bắt buộc Ghi chú
inv_vatRateDeduction int (CHỈ ÁP DỤNG CHO HÓA ĐƠN BÁN HÀNG có giảm thuế GTGT theo NQ101-2023/QH15)
Tỷ lệ % thuế GTGT trên doanh thu của mặt hàng đang sử dụng, nhận giá trị:
  • 1 - Phân phối, cung cấp hàng hóa dịch vụ
  • 2 - Hoạt động kinh doanh khác
  • 3 - Sản xuất, vận tải, dịch vụ có gắn với hàng hóa, xây dựng có bao thầu nguyên vật liệu
  • 5 - Dịch vụ xây dựng không bao thầu nguyên vật liệu
inv_vatAmountDeduction decimal 21,6 (CHỈ ÁP DỤNG CHO HÓA ĐƠN BÁN HÀNG có giảm thuế GTGT theo NQ101-2023/QH15)
Tổng số tiền thuế GTGT được giảm
Xem công thức tại đây

json mẫu 

{
"editmode": 1,
"data": [
{
  "inv_invoiceSeries": "2C25MAC",
  "inv_invoiceIssuedDate": "2025-05-28",
  "inv_currencyCode": "VND",
  "inv_exchangeRate": 1,
  "so_benh_an": "A123DE64",
  "inv_buyerDisplayName": "Nguyễn Văn A",
  "inv_buyerLegalName": "CÔNG TY M-INVOICE",
  "inv_buyerTaxCode": "0106026495-999",
  "inv_buyerAddressLine": "Giáp Bát, Hoàng Mai, Hà Nội",
  "inv_buyerEmail": "abc@gmail.com",
  "inv_buyerBankAccount": "100003131",
  "inv_buyerBankName": "Ngân hàng TMCP Á Châu - ACB",
  "inv_paymentMethodName": "TM/CK",
  "nonTaxZone": 0,
  "tlptdoanhthu20": 2,
  "isDeductionNQ43": true,
  "inv_discountAmount": 0,
  "inv_TotalAmount": 606340,
  "key_api": "",
  "details": [
    {
      "data": [
        {
          "tchat": 1,
          "stt_rec0": 1,
          "inv_itemCode": "HH001",
          "inv_itemName": "Hàng hóa 001",
          "inv_unitCode": "Phần",
          "inv_quantity": 1,
          "inv_unitPrice": 120000,
          "inv_discountPercentage": 0,
          "inv_discountAmount": 0,
          "inv_vatRateDeduction": 5,
          "inv_vatAmountDeduction": 1200,
          "inv_TotalAmountWithoutVat": 118800
        },
        {
          "tchat": 1,
          "stt_rec0": 2,
          "inv_itemCode": "HH002",
          "inv_itemName": "Hàng hóa 002",
          "inv_unitCode": "Phần",
          "inv_quantity": 2,
          "inv_unitPrice": 245000,
          "inv_discountPercentage": 0,
          "inv_discountAmount": 0,
          "inv_TotalAmountWithoutVat": 490000
        }
      ]
    }
  ]
}
]
}
Kết quả mong muốn:

Hình 2