API theo dõi trạng thái phát hành hóa đơn

API Endpoint

GET

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

API Request

tracking_codestringrequired

Mã tracking trả về từ API phát hành hóa đơn

Lưu ý

tracking_code lấy từ response của API Phát hành hóa đơn điện tử.
Khi status là Success, object invoice sẽ chứa đầy đủ thông tin hóa đơn đã phát hành.
Khi status là Pending, nên gọi lại API sau vài giây để kiểm tra kết quả.

API Response

Response thành công (200)

{
  "success": true,
  "data": {
    "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
    "status": "Success",
    "message": "Xuất bán hóa đơn điện tử thành công",
    "invoice": {
      "reference_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
      "invoice_number": "589",
      "issued_date": "2026-01-26",
      "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?kk=1434747710&keyinv=...",
      "xml_url": null,
      "status": "issued",
      "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",
      "source": "api"
    }
  }
}

successboolean

dataobject

Xử lý lỗi

400Bad Request

Thiếu hoặc sai tracking_code.

401Unauthorized

Thiếu hoặc sai Bearer token.

404Not Found

Không tìm thấy yêu cầu phát hành theo tracking_code.

Code mẫu

curl --request GET \
  --url https://einvoice-api.sepay.vn/v1/invoices/issue/check/084e179d-d95a-11f0-aef4-52c7e9b4f41b \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Tùy vào kết quả trạng thái:

Nếu status là Success:

Tải hóa đơn - Tải file PDF hoặc XML của hóa đơn đã phát hành
Chi tiết hóa đơn - Xem thông tin chi tiết hóa đơn (số hóa đơn, ngày phát hành, URL file...)
Danh sách hóa đơn - Quản lý và tra cứu các hóa đơn đã phát hành

Nếu status là Failed:

Kiểm tra message để biết nguyên nhân lỗi, sửa thông tin và thử phát hành lại hoặc liên hệ SePay để được hỗ trợ