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

API theo dõi trạng thái phát hành hóa đơn điện tử theo mã tracking_code trả về từ bước tạo yêu cầu phát hành.

GET

https://einvoice-api-sandbox.sepay.vn/v1/invoices/issue/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 trả về từ API Phát hành hóa đơn điện tử.

Lưu ý

tracking_code lấy từ response của API Phát hành 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 phát hành theo tracking_code.	—

bash

RESPONSE 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": "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": "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"
    }
  }
}

successboolean

Trạng thái gọi API.

data.reference_codestring

Mã tham chiếu yêu cầu phát hành.

data.statusstring

Trạng thái xử lý (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ả.