Tạo hóa đơn điện tử

API tạo hóa đơn điện tử nhận dữ liệu hóa đơn, ký số và gửi lên CQT, trả về mã tra cứu. Dùng mã tra cứu để kiểm tra trạng thái hóa đơn.

POST
https://einvoice-api-sandbox.sepay.vn/v1/invoices/create
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json"
  • Tham số:
TênLoạiBắt buộcMô tả
reference_code
stringKhông bắt buộc
Mã tham chiếu hóa đơn, phải là duy nhất
template_code
stringBắt buộc
Mã mẫu hóa đơn.
invoice_series
stringBắt buộc
Ký hiệu hóa đơn.
issued_date
stringBắt buộc
Ngày lập hóa đơn (yyyy-MM-dd HH:mm:ss). (Không được lớn hơn ngày hiện tại)
currency
stringBắt buộc
Mã tiền tệ, ví dụ VND.
provider_account_id
stringBắt buộc
ID tài khoản được cung cấp
buyer
objectBắt buộc
Thông tin người mua.
items
arrayBắt buộc
Danh sách dòng hàng.
seller_store_code
stringKhông bắt buộc
Mã cửa hàng người bán
seller_store_name
stringKhông bắt buộc
Tên cửa hàng người bán
notes
stringKhông bắt buộc
Ghi chú hóa đơn.
is_draft
booleanBắt buộc
Lưu nháp (true) hoặc phát hành (false).
Thông tin thuế suất
  • tax_rate chỉ bắt buộc truyền khi dùng cho công ty (không cần truyền nếu sử dụng hoá đơn bán hàng)
  • Trường tax_rate trong items truyền dữ liệu theo như bên dưới:
    • -2 (Không chịu thuế)
    • -1 (Không kê khai, tính nộp thuế GTGT)
    • 0 (0% thuế suất)
    • 5 (5% thuế suất)
    • 8 (8% thuế suất)
    • 10 (10% thuế suất)
Lưu ý
  • Để phát hành, gửi is_draft=false. Nếu chỉ lưu nháp để xem trước, gửi is_draft=true (Nếu chỉ xuất hóa đơn nháp thì sẽ không bị tính vào hạn ngạch hóa đơn điện tử của bạn).
  • provider_account_id được cung cấp từ API danh sách tài khoản hóa đơn điện tử
  • Sau khi gửi yêu cầu xuất hóa đơn thành công, sử dụng endpoint được cung cấp qua tracking_url để gọi api theo dõi trạng thái xuất hóa đơn

Tham số mẫu cho các loại hoá đơn

Mẫu hoá đơn bán hàng
{
  "template_code": "2",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn bán hàng có chiết khấu trên tổng đơn
{
  "template_code": "2",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000
    },
    {
      "line_number": 2,
      "line_type": 3,
      "item_name": "Chiết khấu thương mại",
      "amount": 4500000
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn bán hàng có chiết khấu trên sản phẩm
{
  "template_code": "2",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000,
      "discount_tax": 2
    }
  ],
  "notes": "Giảm giá 2%",
  "is_draft": true
}
Mẫu hóa đơn bán hàng có khuyến mãi
{
  "template_code": "2",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000
    },
    {
      "line_number": 2,
      "line_type": 2,
      "item_code": "KM001",
      "item_name": "Hàng KM",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 0
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn giá trị gia tăng
{
  "template_code": "5",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "type": "company",
    "name": "Nguyễn Văn A",
    "legal_name": "CÔNG TY TNHH ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000,
      "tax_rate": 0
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn giá trị gia tăng có chiết khấu trên tổng đơn
{
  "template_code": "5",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000,
      "tax_rate": 10
    },
    {
      "line_number": 1,
      "line_type": 3,
      "item_name": "Chieest khau thuong mai",
      "tax_rate": 10
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn giá trị gia tăng có chiết khấu trên sản phẩm
{
  "template_code": "5",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000,
      "tax_rate": 0,
      "discount_tax": 2
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
Mẫu hóa đơn giá trị gia tăng có chiết khấu trên sản phẩm
{
  "template_code": "5",
  "invoice_series": "C25HTV",
  "issued_date": "2025-12-11 08:00:00",
  "currency": "VND",
  "provider_account_id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
  "buyer": {
    "name": "Công ty ABC",
    "tax_code": "0101234567",
    "address": "123 Đường A, Quận B, Hà Nội",
    "email": "buyer@example.com",
    "phone": "0900000000"
  },
  "items": [
    {
      "line_number": 1,
      "line_type": 1,
      "item_code": "SP001",
      "item_name": "Sản phẩm A",
      "unit": "cái",
      "quantity": 1,
      "unit_price": 4500000,
      "tax_rate": 0
    },
    {
      "line_number": 1,
      "line_type": 2,
      "item_code": "KM001",
      "item_name": "Sản phẩm B",
      "unit": "cái",
      "quantity": 1,
      "tax_rate": 0
    }
  ],
  "notes": "Ghi chú hóa đơn",
  "is_draft": true
}
400
Bad Request
Thiếu hoặc sai định dạng trường bắt buộc.
—
401
Unauthorized
Thiếu hoặc sai Bearer token.
—
500
Internal Server Error
Lỗi hệ thống khi xuất hóa đơn điện tử
—
Trước
—
Tiếp theo
—