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.
Yêu cầu gặp lỗi tạm thời được thử lại tự động nên có thể ở trạng thái Pending tới 2 giờ, không phải kết thúc trong vài giây. Dùng retry.next_retry_at trong response để giãn nhịp gọi, và chỉ dừng khi status chuyển sang Success hoặc Failed.
Nếu message là "Hệ thống chưa xác nhận được kết quả phát hành với nhà cung cấp hóa đơn", trạng thái hóa đơn chưa xác định. Không gửi lại yêu cầu - hãy liên hệ SePay để kiểm tra, tránh phát hành trùng hóa đơn.
Lịch retry, cách chẩn đoán và các bước kiểm tra trước khi gửi lại: xem Xử lý lỗi.

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"
      },
      "seller_store": {
        "xid": "8f14e45f-ceea-4b6d-9c1a-2b3c4d5e6f70",
        "code": "CN01",
        "name": "Chi nhánh 1"
      },
      "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ợ