# 收款单统计

## 概述

返回收款单的整体统计。

## 请求

```bash
curl -X POST https://api.bitsby.app/statistics/invoices \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
  -F "startDate=2000-01-01" \
  -F "endDate=2030-01-01"
```

## 请求参数

| 参数        | 数据类型 | 说明                             | 示例       | 是否必填 |
| ----------- | -------- | -------------------------------- | ---------- | -------- |
| `startDate` | String   | 收款单创建的起始日期，Y-m-d 格式 | 2000-01-01 | 否       |
| `endDate`   | String   | 收款单创建的结束日期，Y-m-d 格式 | 2030-01-01 | 否       |

## 响应示例

```json
{
    "result": "success",
    "data": {
        "invoicesTotalNum": 51,
        "invoicesPaidNum": 24,
        "invoicesTotalUSD": 335.03,
        "invoicesByProjects": {
            "9deea1e2-0c08-41a3-bdc2-a34eada3892d": 335.03
        },
        "invoicesByCurrencies": {
            "USD": 335.03
        },
        "invoicesByMonths": {
            "March-2024": 42,
            "February-2024": 293.03
        },
        "invoicesByDate": {
            "2024-03-04": {
                "date": 1709510400000,
                "value": 21
            },
            "2024-03-03": {
                "date": 1709424000000,
                "value": 10
            },
            "2024-03-01": {
                "date": 1709251200000,
                "value": 11
            },
            "2024-02-27": {
                "date": 1708992000000,
                "value": 12
            },
            "2024-02-26": {
                "date": 1708905600000,
                "value": 281.03
            }
        }
    }
}
```

## 响应参数

| 参数                   | 说明                                          |
| ---------------------- | --------------------------------------------- |
| `invoicesTotalNum`     | 收款单总数                                    |
| `invoicesPaidNum`      | 已支付收款单的数量（状态为 Paid）             |
| `invoicesTotalUSD`     | 所有已支付收款单的总额，以 USD 计             |
| `invoicesByProjects`   | 按项目统计的已支付收款单总额，以 USD 计       |
| `invoicesByCurrencies` | 按币种统计的已支付收款单总额                  |
| `invoicesByMonths`     | 按月份统计的已支付收款单总额，以 USD 计       |
| `invoicesByDate`       | 按日期统计的已支付收款单总额，以 USD 计       |
| `invoicesByDate.date`  | 日期，Unix 时间戳，以毫秒计                   |
| `invoicesByDate.value` | 该日期所有已支付收款单的总额，以 USD 计       |