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

API theo dõi trạng thái xử lý của yêu cầu xuất hóa đơn điện tử dựa trên mã tracking_code

API Endpoint

GET

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

API Request

tracking_codestringrequired

Mã tracking trả về khi gọi API xuất hóa đơn

API Response

Response thành công (200)

{
  "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=...",
      "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

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 tương ứng với tracking_code.

Lưu ý

Sử dụng tracking_code trả về từ API Xuất hóa đơn điện tử.
Khi status là Success, đối tượng invoice sẽ chứa thông tin chi tiết hóa đơn bao gồm pdf_url để tải file PDF.
Nếu status là Failed, kiểm tra trường message để biết nguyên nhân lỗi và xử lý phù hợp.
Nên sử dụng cơ chế polling với khoảng thời gian hợp lý (ví dụ: 2-5 giây) để kiểm tra trạng thái.

Code mẫu

curl --request GET \
  --url https://einvoice-api-sandbox.sepay.vn/v1/invoices/create/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 và loại hóa đơn đã tạo:

Nếu status là Success và hóa đơn nháp (is_draft=true):

Phát hành hóa đơn điện tử - Sử dụng reference_code để phát hành chính thức

Nếu status là Success và hóa đơn chính thức (is_draft=false):

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

Nếu status là Failed:

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