# bill 1.3 release note

## 修改
1. 對帳api /v1.3/bills/reconciliation修改

{
  "datacenterCodes": [
    "string"
  ],
  "endTime": 0,
  "items": [
    {
      "accountId": "string",
      "prorated": 0,
      "proratedList": 0
    }
  ],
  "month": 0,
  "onlyRenewAndPAYG": true,
  "startTime": 0,
  "year": 0
}

新增以下三個欄位：

| 欄位 | 型態 | 說明 |
| -------- | -------- | -------- |
| onlyRenewAndPAYG | boolean | 預設false，只統計PAYG與Renew的帳，其它帳如Subscribe不統計 |
|year|int|扣款的年份|
|month|int|1~12，扣款的月份|

1. （因PAYG改為日扣，不建議使用）：
startTime與endTime未帶，並且未帶year與month，預設區間為上個月1號至當下時間。
例如：當下為6/20 10:00，則比對區間為5/1 0：00 ~ 6/20 10：00
2. 只帶startTime與endTime
與1.2版的api功能相同，查詢該區間的費用，不論orderType

3. 帶startTime與endTime，並且onlyRenewAndPAYG為true
查詢該區間費用，並且orderType為Renew或PAYG

4. 只帶year與month
startTime與endTime自動設為month的上個月1號0：00，endTime為month的月底23：59：59。PAYG的帳款會計算month的上個月，其餘則計算該月.
這情況表示，事後要查詢某個月的帳。
例如：六月要查四月的帳，這時mkp匯出四月的帳會包含所有類型，包含PAYG，Renew，Subscribe...等，所以要指定年、月。

5. 帶year與month，並且onlyRenewAndPAYG為true
startTime與endTime自動設為month的上個月1號0：00，endTime為month的月底23：59：59。PAYG的帳款會計算month的上個月，Renew帳款則計算該月，其餘Type的帳，如：Subscribe則不列入
onlyRenewAndPAYG的用途，扣完帳當下，marketplace匯出的對帳單會只有此次的扣款，意即只有PAYG與Renew，Subscribe這類型的帳不會在此次的對帳單出現

帳務扣款的邏輯為扣當月Renew與上個月的PAYG。
例如： year為2022，month為6，表示要扣六月的帳款，其中包含了年為2022，月為5月（PAYG要取上個月）的費用與6月份非PAYG的帳，startTime會被設為5/1 0：00，endTime則被設為6/30 23：59：59。
由於有帶year與month，所以不會扣到6月的PAYG。

6. 帶startTime與endTime，並且有帶year與month
此情境與4.5相同，差別在於startTime與endTime是以代入的為主，而非由year與month算出

建議使用方式：
正常扣帳時，startTime與endTime可不填，直接填year與month即可。除非補單的特殊情況才要帶startTime與endTime。

2. 扣款API修改
新增以下二個欄位：

| 欄位 | 型態 | 說明 |
| -------- | -------- | -------- |
|year|int|扣款的年份|
|month|int|1~12，扣款的月份|

時間的組合說明：
Case 1：
startTime與endTime未帶，並且未帶year與month，預設區間為當月1號至當月底23：59：59。
例如：當下為6/20調用api，startTime與endTime會自動設為6/1 0：00，endTime設為6/30 23：59：59

Case 2：
startTime與endTime未帶，但有帶year與month。
startTime與endTime的區間會設定為上個月的1號0：00至當月月底23：59：59。
這情況表示，要扣該月份的帳，帳務扣款的邏輯為扣當月Renew與上個月的PAYG。
例如： year為2022，month為6，表示要扣六月的帳款，其中包含了年為2022，月為5月（PAYG要取上個月）的費用與6月份非PAYG的帳，startTime會被設為5/1 0：00，endTime則被設為6/30 23：59：59。
由於有帶year與month，所以不會扣到6月的PAYG。

建議使用方式：
正常扣帳時，startTime與endTime可不填，直接填year與month即可。除非補單的特殊情況才要帶startTime與endTime。