# สถิติใบแจ้งหนี้

## ภาพรวม

คืนสถิติโดยรวมของใบแจ้งหนี้ของคุณ

## คำขอ

```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 timestamp หน่วยมิลลิวินาที |
| `invoicesByDate.value` | ยอดรวมของใบแจ้งหนี้ที่ชำระแล้วทั้งหมดของวันนั้น เป็น USD |