sino-bc-cli 1.8.24 → 1.8.26

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 |