Chi tiết tài khoản nhà cung cấp

API tra cứu chi tiết một tài khoản xuất hóa đơn điện tử trả về trạng thái và danh sách mẫu/ký hiệu hóa đơn được phép sử dụng

API Endpoint

GET

https://einvoice-api-sandbox.sepay.vn/v1/provider-accounts/{id}

API Request

idstringrequired

ID tài khoản nhà cung cấp (UUID)

API Response

Response thành công (200)

{
  "success": true,
  "data": {
    "id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
    "provider": "matbao",
    "active": true,
    "templates": [
      {
        "template_code": "1",
        "invoice_series": "C25TAT",
        "invoice_label": "1 - C25TAT - Hóa đơn giá trị gia tăng"
      },
      {
        "template_code": "2",
        "invoice_series": "C25TMB",
        "invoice_label": "2 - C25TMB - Hóa đơn bán hàng"
      }
    ]
  }
}

successboolean

dataobject

Xử lý lỗi

401Unauthorized

Thiếu hoặc sai Bearer token.

404Not Found

Không tồn tại tài khoản với ID cung cấp.

Lưu ý

Lấy id từ API danh sách tài khoản nhà cung cấp để tra cứu chi tiết.
Sử dụng template_code và invoice_series từ danh sách templates khi tạo hóa đơn điện tử.
Các mẫu hóa đơn phổ biến:
- Hóa đơn giá trị gia tăng (VAT invoice)
- Hóa đơn bán hàng (Sales invoice)
- Phiếu xuất kho kiêm vận chuyển nội bộ
- Biên lai điện tử

Code mẫu

curl --request GET \
  --url https://einvoice-api-sandbox.sepay.vn/v1/provider-accounts/0aea3134-da40-11f0-aef4-52c7e9b4f41b \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Sau khi có thông tin chi tiết tài khoản (bao gồm template_code và invoice_series), bạn có thể:

Xuất hóa đơn điện tử - Sử dụng thông tin mẫu hóa đơn và ký hiệu từ tài khoản này để tạo hóa đơn