sino-bc-cli 1.8.23 → 1.8.25

package/dist/api-doc/oapi/wallet-bill.md

@@ -0,0 +1,118 @@
+# 对账单
+
+对应命令：`wallet +<shortcut>` 与 `wallet api <name>`。
+
+## 1. 对账单列表
+
+`POST /sino-wallet-pu/platform/wallet/bill/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按生成时间查当前主体的账单聚合列表（BillAggregation）。响应只保留列表，不含待还汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `startTime` | string | body | 是 | yyyy-MM-dd |
+| `endTime` | string | body | 是 | yyyy-MM-dd |
+| `billName` | string | body | 否 | 支持模糊 |
+| `channelIdList` | array | body | 否 | 0 代表服务费系统 |
+| `minAmount` | number | body | 否 | 账单金额最小值 |
+| `maxAmount` | number | body | 否 | 账单金额最大值 |
+| `invoiceStatusList` | array | body | 否 | 开票状态 |
+| `billTypeList` | array | body | 否 | 账单类型 |
+| `startMonth` | string | body | 否 | yyyyMM，如 202309 |
+| `endMonth` | string | body | 否 | yyyyMM，如 202310 |
+
+## 2. 对账单基本信息
+
+`GET /sino-wallet-pu/platform/wallet/bill/detail/basic`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-detail-basic --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 billId 查单条对账单金额、渠道、类型、开票状态。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `billId` | string | query | 是 | 对账单id |
+
+## 3. 对账单明细
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/original/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-original-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按对账单类型返回媒体 / 服务费 / Credit Memo / 服务费红冲其中一类明细。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 4. 对账单操作历史
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/operate/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-operate-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查对账单操作记录。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 5. 对账单与发票枚举
+
+`POST /sino-wallet-pu/platform/wallet/enum/bill-invoice/by-type/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-invoice-enum --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 types 批量取渠道、开票/还款状态、账单类型等枚举。type 必须用原文，含拼写。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `types` | array | body | 是 | 至少 1 个。INVOICE_E_FILE_TYPE 结果不可靠，下载格式请用 PDF/OFD。 |

package/dist/api-doc/oapi/wallet-invoice.md

@@ -0,0 +1,137 @@
+# 发票结算单
+
+对应命令：`wallet +<shortcut>` 与 `wallet api <name>`。
+
+## 1. 对账单关联结算单
+
+`GET /sino-wallet-pu/platform/wallet/bill/detail/settlement/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-settlement-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查某张对账单下已开的发票结算单，不分页。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `billId` | string | query | 是 | 账单id |
+
+## 2. 发票结算单列表
+
+`POST /sino-wallet-pu/invoice/settlement/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api invoice-settlement-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按申请时间查当前主体的结算单列表。响应只保留列表，不含待还汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `startTime` | string | body | 是 | yyyy-MM-dd |
+| `endTime` | string | body | 是 | yyyy-MM-dd |
+| `invoiceSettlementId` | string | body | 否 | 结算单id |
+| `billIdList` | array | body | 否 | 账单id列表 |
+| `name` | string | body | 否 | 模糊 |
+| `paymentStatusList` | array | body | 否 | 还款状态 |
+| `issuanceStatusList` | array | body | 否 | 开票状态 |
+| `invoiceTypeList` | array | body | 否 | 发票形式 |
+| `invoiceVatTypeList` | array | body | 否 | VAT发票类型 |
+| `minAmount` | number | body | 否 | 金额起始 |
+| `maxAmount` | number | body | 否 | 金额截止 |
+| `collectFlag` | boolean | body | 否 | 本契约丢弃汇总，可不传 |
+
+## 3. 发票结算单详情
+
+`GET /sino-wallet-pu/invoice/settlement/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api invoice-settlement-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按结算单号查开票金额、税费、发票/VAT 明细与预览地址。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | query | 是 | 发票编号/结算单id |
+
+## 4. 结算单详情 PDF
+
+`GET /sino-wallet-pu/invoice/settlement/detail/pdf`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api invoice-settlement-detail-pdf --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+已废弃。返回单条 PDF URL；多文件请用发票下载。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | query | 是 | 发票编号/结算单id |
+
+## 5. 下载发票
+
+`POST /sino-wallet-pu/invoice/settlement/invoice/download`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api invoice-download --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按结算单号和 PDF/OFD 返回发票下载 URL 列表。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | body | 是 | 结算单id |
+| `fileType` | string | body | 是 | 发票格式 |
+
+## 6. 结算单还款记录
+
+`POST /sino-wallet-pu/invoice/settlement/payment/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api invoice-settlement-payment-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查结算单还款历史。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | body | 是 | 结算单id |

package/dist/api-doc/oapi/wallet-prepaid.md

@@ -0,0 +1,249 @@
+# 预付钱包
+
+对应命令：`wallet +<shortcut>` 与 `wallet api <name>`。
+
+## 1. 钱包首页
+
+`GET /sino-wallet-pu/platform/wallet/own`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-own --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查当前主体钱包：预付给现金/待还，后付给现金+信用金。
+
+## 2. 最近钱包流水
+
+`GET /sino-wallet-pu/platform/wallet/recent/walletchangeitem`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-change-recent --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+钱包首页最近消费/返额，默认 7 条。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageSize` | integer | query | 否 | 条数，默认 7 |
+
+## 3. 最近充值记录
+
+`GET /sino-wallet-pu/platform/wallet/recent/recharge`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-recharge-recent --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+钱包首页最近充值，默认 7 条。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageSize` | integer | query | 否 | 条数，默认 7 |
+
+## 4. 钱包币种列表
+
+`GET /sino-wallet-pu/platform/wallet/currency/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-currency-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+当前主体可用币种。
+
+## 5. 现金账务类型
+
+`GET /sino-wallet-pu/platform/wallet/cashchange/list/accountstype`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-cash-change-accounts-type --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+现金收支筛选项：账务类型与流水方向。
+
+## 6. 现金收支明细
+
+`POST /sino-wallet-pu/platform/wallet/cashchange/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-cash-change-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查现金/返点账户流水。响应不含收支汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `changeTimeOrderBy` | string | body | 是 | desc 倒序 / asc 正序 |
+| `startTime` | string | body | 否 | 开始日期 |
+| `endTime` | string | body | 否 | 结束日期 |
+| `externalBizType` | string | body | 否 | 来自现金账务类型接口 |
+| `flowDirectionList` | array | body | 否 | 来自账务类型接口 |
+| `incomeAndExpensesType` | string | body | 否 | income 收入 / expenses 支出 |
+| `currencyList` | array | body | 否 | 币种类型 |
+| `flowNo` | string | body | 否 | 流水单号 |
+| `min` | number | body | 否 | 收支金额最小值 |
+| `max` | number | body | 否 | 收支金额最大值 |
+| `operatorIds` | array | body | 否 | 操作人 |
+| `departmentCodeList` | array | body | 否 | 含顶级团队时服务端会再加管理员团队 0 |
+| `collectFlag` | boolean | body | 否 | 本契约丢弃汇总，可不传 |
+
+## 7. 钱包账务类型
+
+`GET /sino-wallet-pu/platform/wallet/walletchange/list/accountstype`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-change-accounts-type --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+钱包消费明细的账务类型筛选项。
+
+## 8. 钱包额度类型
+
+`GET /sino-wallet-pu/platform/wallet/walletchange/list/quotatype`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-change-quota-type --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+额度类型：consume 消费 / return_quota 返额。
+
+## 9. 钱包消费明细
+
+`POST /sino-wallet-pu/platform/wallet/walletchange/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-change-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查钱包额度流水。响应不含消费/返额汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `changeTimeOrderBy` | string | body | 是 | desc 倒序 / asc 正序 |
+| `startTime` | string | body | 否 | 开始日期 |
+| `endTime` | string | body | 否 | 结束日期 |
+| `quotaType` | string | body | 否 | 额度类型 |
+| `externalBizType` | string | body | 否 | 来自钱包账务类型接口 |
+| `flowDirectionList` | array | body | 否 | 来自账务类型接口 |
+| `currencyList` | array | body | 否 | 币种类型 |
+| `flowNo` | string | body | 否 | 流水单号 |
+| `min` | number | body | 否 | 额度最小值 |
+| `max` | number | body | 否 | 额度最大值 |
+| `operatorIds` | array | body | 否 | 操作人 |
+| `departmentCodeList` | array | body | 否 | 含顶级团队时服务端会再加管理员团队 0 |
+| `collectFlag` | boolean | body | 否 | 服务端默认 true；本契约丢弃汇总 |
+
+## 10. 充值明细
+
+`POST /sino-wallet-pu/platform/wallet/recharge/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-recharge-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按入账时间查充值记录。响应只保留列表，不含充值汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `incomeTimeOrderBy` | string | body | 是 | desc 倒序 / asc 正序 |
+| `startIncomeTime` | string | body | 否 | yyyy-MM-dd |
+| `endIncomeTime` | string | body | 否 | yyyy-MM-dd |
+| `currency` | string | body | 否 | 单币种 |
+| `min` | number | body | 否 | 充值金额最小值 |
+| `max` | number | body | 否 | 充值金额最大值 |
+
+## 11. 币种可用额度
+
+`GET /sino-wallet-pu/platform/wallet/currency/list/amount`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-currency-amount --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按币种查各账户可用额度。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `currency` | string | query | 是 | 币种，如 USD |
+
+## 12. 币种汇率
+
+`GET /sino-wallet-pu/platform/wallet/currency/exchange/rate`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api wallet-exchange-rate --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查 sourceCurrency 到 targetCurrency 的汇率。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sourceCurrency` | string | query | 是 | 原始币种 |
+| `targetCurrency` | string | query | 是 | 目标币种 |

package/dist/api-doc/oapi/wallet-quota.md

@@ -0,0 +1,17 @@
+# 后付额度
+
+对应命令：`wallet +<shortcut>` 与 `wallet api <name>`。
+
+## 1. 后付信用额度
+
+`GET /sino-wallet-pu/platform/quota/credit/info`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api quota-credit-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查当前主体后付授信与使用率；非后付不展示。

package/dist/api-doc/oapi/wallet-reconciliation.md

@@ -0,0 +1,88 @@
+# 月度对账单
+
+对应命令：`wallet +<shortcut>` 与 `wallet api <name>`。
+
+## 1. 月度对账单列表
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-reconciliation-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按月份区间分页查标准化对账文件（主体+月份，通常每月一条）。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billMonthStart` | string | body | 是 | yyyy-MM |
+| `billMonthEnd` | string | body | 是 | yyyy-MM |
+
+## 2. 月度对账单发送记录
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/send-log/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-reconciliation-send-log --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按账单月份分页查邮件发送记录。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billMonth` | string | body | 是 | yyyy-MM |
+
+## 3. 对账邮件预览
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/send-log/preview`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-reconciliation-email-preview --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按业财发送记录 id 返回邮件 HTML。不要用列表里的本地 emailSendRecordId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sendRecordId` | integer | body | 是 | 发送记录页的 sendRecordId |
+
+## 4. 月度对账单下载链接
+
+`GET /sino-wallet-pu/platform/bill-reconciliation/generate/download-url`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport`。
+
+该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+调用示例：`sino-bc-cli wallet api bill-reconciliation-download-url --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+用文件 storageKey（即列表 fileId）换 3 小时有效下载/预览 URL。不要传 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 | 文件存储 key，即列表 fileId |