# statements

> Sao kê hằng tháng (doanh thu và lượt nghe mỗi tháng), số dư và thanh toán. Khách hàng và nghệ sĩ/hãng đĩa trực tiếp: số dư tại HILLS và các lần rút tiền.

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Công cụ `statements` · Chỉ đọc · Mọi tài khoản có quyền truy cập MCP · Quyền vai trò: `royalties.view`, `payouts.view`

Sao kê hằng tháng (doanh thu và lượt nghe mỗi tháng), số dư và thanh toán. Khách hàng và nghệ sĩ/hãng đĩa trực tiếp: số dư tại HILLS và các lần rút tiền. Nghệ sĩ/hãng đĩa thuộc một khách hàng: số tiền khách hàng đã trả cho họ; phần của họ, các khoản thanh toán đang xử lý và số khách hàng còn nợ chỉ hiển thị khi khách hàng cho nghệ sĩ xem số dư. Nhân viên HILLS: sao kê của một tài khoản theo account_id (royalties.view; số dư và thanh toán với payouts.view), hoặc nếu không có account_id thì là các lần nhập sao kê nền tảng gần đây.

<a id="arguments"></a>

## Tham số

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `months` | integer (1–36) | Không | Số tháng lấy về trước (tối đa 36). Mặc định 12. |
| `account_id` | integer | Không | Chỉ dành cho nhân viên HILLS: tài khoản cần xem. |

<a id="example-call"></a>

## Ví dụ lệnh gọi

Trợ lý AI thực hiện lệnh gọi này thay bạn; đây là nội dung được gửi đến `https://mcp.hillsmusic.com` qua JSON-RPC.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "statements",
    "arguments": {
      "months": 12
    }
  }
}
```

<a id="result"></a>

## Kết quả

Một dòng tóm tắt dạng văn bản, sau đó là cùng dữ liệu đó dạng JSON trong `structuredContent`, với các trường sau:

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `currency` | `USD` |  |
| `account` | object hoặc null |  |
| `months` | mảng object |  |
| `balance` | object hoặc null |  |
| `payouts` | mảng object |  |
| `imports` | mảng object |  |
| `note` | string |  |

Một lời từ chối (không có quyền, không tìm thấy, dữ liệu đầu vào sai) được trả về dưới dạng lỗi công cụ (`isError: true`), kèm văn bản giải thích lý do.

Nguồn: https://developer.hillsmusic.com/vi/mcp/statements/