API lấy danh sách hóa đơn

API Endpoint

GET

https://einvoice-api.sepay.vn/v1/invoices

API Request

pageinteger

Trang hiện tại (mặc định 1)

Mặc định: 1

per_pageinteger

Số bản ghi mỗi trang (mặc định 10)

Mặc định: 10

sourceenum

Lọc hóa đơn theo nguồn tạo. Nếu không truyền sẽ trả về tất cả.

manual: Chỉ lấy hóa đơn tạo thủ công trên giao diện
api: Chỉ lấy hóa đơn tạo qua API

Phân trang

Sử dụng page để chỉ định trang cần lấy (mặc định là 1).
Sử dụng per_page để giới hạn số bản ghi mỗi trang (mặc định là 10, tối đa 100).
Response trả về has_more: true nếu còn dữ liệu ở trang tiếp theo.

API Response

Response thành công (200)

{
  "data": {
    "paging": {
      "per_page": 1,
      "total": 20,
      "has_more": true,
      "current_page": 1,
      "page_count": 20
    },
    "items": [
      {
        "reference_code": "9735f09d-d970-11f0-aef4-52c7e9b4f41b",
        "invoice_number": "0",
        "issued_date": "2025-12-15",
        "pdf_url": "https://beta-portalv2.mifi.vn/DownloadPDFCA.aspx?...",
        "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",
        "source": "api"
      }
    ]
  }
}

dataobject

Lưu ý về invoice_number

invoice_number mặc định là "0" khi hóa đơn ở trạng thái nháp ("status": "draft"). Sau khi phát hành thành công, invoice_number sẽ được cập nhật thành số hóa đơn thực tế do nhà cung cấp cấp phát.

Xử lý lỗi

401Unauthorized

Thiếu hoặc sai Bearer token. Vui lòng kiểm tra lại token trong header Authorization.

Code mẫu

curl --request GET \
  --url 'https://einvoice-api.sepay.vn/v1/invoices?page=1&per_page=10&source=manual' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Sau khi có danh sách hóa đơn, bạn có thể:

Chi tiết hóa đơn - Sử dụng reference_code để xem thông tin chi tiết một hóa đơn cụ thể
Tải hóa đơn - Tải file PDF hoặc XML của hóa đơn đã phát hành

Với hóa đơn nháp

Nếu hóa đơn có status: "draft", bạn có thể Phát hành hóa đơn để phát hành chính thức.