Đối soát sử dụng

Tổng hợp mức sử dụng theo tháng cho một tài khoản, gồm số request (mọi endpoint khách gọi) và số hóa đơn (cơ sở tính phí). Endpoint này miễn phí.

GET /tax-accounts/{accountId}/usage?month=YYYY-MM

Ví dụ response

{
  "accountId": "cf00eea0-af08-4e84-9aa3-e12d23b3a568",
  "month": "2025-03",
  "invoices": {
    "jobs": 3, "syncJobs": 2, "detailJobs": 1,
    "windows": 2, "invoicesNew": 1200, "billableInvoices": 2160.0
  },
  "requests": {
    "total": 84,
    "byEndpoint": [
      { "method": "GET", "route": ".../invoices", "count": 40 },
      { "method": "POST", "route": ".../sync", "count": 2 }
    ]
  }
}

Trường	Ý nghĩa
invoices.windows	Số cửa sổ ≤31 ngày (dùng cho phí lượt/cửa sổ khi đồng bộ)
invoices.invoicesNew	Số hóa đơn mới (đã chống trùng) — cơ sở tính phí
invoices.billableInvoices	Hóa đơn tính phí có trọng số (×1.5 nếu lấy chi tiết)
requests.total	Tổng số request khách gọi trong tháng
requests.byEndpoint	Đếm request theo endpoint — dùng để tính phí đọc (danh sách / chi tiết = 10% phí lượt đồng bộ mỗi request)

Xem cách quy ra tiền tại Tính giá theo API request.