Theo dõi trạng thái tạo hóa đơn

API theo dõi trạng thái hóa đơn nhận mã giao dịch, trả về trạng thái xử lý của hóa đơn tương ứng với mã giao dịch.

GET

https://einvoice-api-sandbox.sepay.vn/v1/invoices/create/check/{tracking_code}

  -H "Authorization: Bearer <ACCESS_TOKEN>"

Tham số đường dẫn:

Tên	Loại	Bắt buộc	Mô tả
`tracking_code`	string	Bắt buộc	Mã tracking_code trả về khi gọi API xuất hóa đơn.

Lưu ý

Sử dụng tracking_code trả về từ API Xuất hóa đơn điện tử.

400	Bad Request Thiếu hoặc sai tracking_code.	—
401	Unauthorized Thiếu hoặc sai Bearer token.	—
404	Not Found Không tìm thấy yêu cầu tương ứng với tracking_code.	—

bash

RESPONSE

{
  "success": true,
  "data": {
    "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
    "status": "Success",
    "message": "Xuất hóa đơn điện tử thành công",
    "invoice": {
      "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
      "invoice_number": "0",
      "issued_date": "2025-12-15",
      "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?kk=1434747710&keyinv=mfMWlMdFpIemk5Q2c9&coid=MWNuWGNKQkk0MjA9&p=5&c=0&publishDomain=https://demo.matbao.in",
      "xml_url": null,
      "status": "draft",
      "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"
      },
      "total_before_tax": 200000,
      "tax_amount": 20000,
      "total_amount": 220000,
      "notes": "Ghi chú hóa đơn"
    }
  }
}

successboolean

Trạng thái gọi API.

data.reference_codestring

Mã tham chiếu yêu cầu xuất hóa đơn.

data.statusstring

Trạng thái xử lý hóa đơn (ví dụ: Pending, Success, Failed).

data.messagestring

Thông điệp mô tả trạng thái.

data.invoiceobject

Thông tin hóa đơn nếu đã có kết quả.