API lấy danh sách tài khoản nhà cung cấp

API Endpoint

GET

https://einvoice-api.sepay.vn/v1/provider-accounts

API Request

pageinteger

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

Mặc định: 1

per_pageinteger

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

Mặc định: 20

API Response

Response thành công (200)

{
  "data": {
    "paging": {
      "per_page": 20,
      "total": 1,
      "has_more": false,
      "current_page": 1,
      "page_count": 1
    },
    "items": [
      {
        "id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
        "provider": "matbao",
        "active": true,
        "tax_authority_approved_date": "2026-04-20"
      }
    ]
  }
}

dataobject

Xử lý lỗi

401Unauthorized

Thiếu hoặc sai Bearer token.

Lưu ý

Sử dụng id từ danh sách tài khoản nhà cung cấp làm giá trị cho trường provider_account_id khi tạo hóa đơn điện tử.
Hỗ trợ phân trang với tham số page và per_page (tối đa 100 bản ghi mỗi trang).

Code mẫu

curl --request GET \
  --url 'https://einvoice-api.sepay.vn/v1/provider-accounts?page=1&per_page=20' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Sau khi có danh sách tài khoản nhà cung cấp, bạn có thể:

Xem chi tiết tài khoản - Lấy thông tin chi tiết (mẫu hóa đơn, ký hiệu) của tài khoản cụ thể
Xuất hóa đơn điện tử - Sử dụng id tài khoản để tạo hóa đơn với provider_account_id