sino-bc-cli 1.8.24 → 1.8.26

package/dist/api-doc/oapi/biz-line-strategy.md

@@ -141,23 +141,7 @@
 | `id` | integer | body | 是 |  |
 | `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
 
-## 6. 删除业务线
-
-`POST /sino-opti-hive/biz-line/del`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 |  |
-
-## 7. 查询投放策略分页列表
+## 6. 查询投放策略分页列表
 
 `POST /sino-opti-hive/biz-line/strategy/list`
 
@@ -177,7 +161,7 @@
 | `bizLineId` | integer | body | 否 | 可选，不传则按权限查全部可见业务线。 |
 | `trafficLight` | integer | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
-## 8. 查询投放策略消耗信息
+## 7. 查询投放策略消耗信息
 
 `POST /sino-opti-hive/biz-line/strategy/spend`
 
@@ -193,7 +177,7 @@
 | --- | --- | --- | --- | --- |
 | `strategyId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
-## 9. 新建投放策略
+## 8. 新建投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/save`
 
@@ -242,7 +226,7 @@
 | `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
 | `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
-## 10. 更新投放策略
+## 9. 更新投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/update`
 
@@ -294,23 +278,7 @@
 | `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
 | `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
-## 11. 删除投放策略
-
-`POST /sino-opti-hive/biz-line/strategy/del`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-删除投放策略
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
-
-## 12. 查询业务线关联项目和广告账号
+## 10. 查询业务线关联项目和广告账号
 
 `POST /sino-opti-hive/biz-line/project-list`
 
@@ -327,7 +295,7 @@
 | --- | --- | --- | --- | --- |
 | `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
 
-## 13. 查询项目分页列表
+## 11. 查询项目分页列表
 
 `POST /sino-opti-hive/optimize/project/queryByPage`
 
@@ -364,7 +332,7 @@
 | `serviceCodeList` | array | body | 否 | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
 | `bizLineIdList` | array | body | 否 | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 id |
 
-## 14. Facebook广告策略维度数据
+## 12. Facebook广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
@@ -427,7 +395,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 15. Google广告策略维度数据
+## 13. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
@@ -490,7 +458,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 16. TikTok广告策略维度数据
+## 14. TikTok广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
@@ -553,7 +521,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 17. Facebook广告策略成效数据
+## 15. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
@@ -624,7 +592,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 18. Google广告策略成效数据
+## 16. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
@@ -695,7 +663,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 19. TikTok广告策略成效数据
+## 17. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 

package/dist/api-doc/oapi/common-file.md

@@ -0,0 +1,44 @@
+# 通用文件管理
+
+对应命令：`common-file +<shortcut>` 与 `common-file api <name>`。
+
+## 1. 上传文件
+
+`POST /bc-business-pu/file/fileUpload`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+上传单个私有文件，使用multipart/form-data，file为必填文件part。serviceName可选，未传或为空字符串时默认bc-business-pu，支持的服务名见参数枚举。
+
+上传文件不能为空，默认最大50MB（52428800字节，含边界），由Apollo配置file.upload.max-size控制。存储目录为服务名/yyyy-MM，文件名使用UUID并保留扩展名。上传返回的私有链接有效期默认3600秒，由file.download.url-expire-seconds控制。
+
+成功返回UploadFileResult，请保存result.storageKey供后续获取下载链接或关联业务记录使用。重复上传会生成新的存储文件。服务名非法、文件为空、文件超限、文件名为空或配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。待上传文件，非空，默认最大50MB，以Apollo配置为准。 |
+| `serviceName` | string | form | 否 | 来源服务；未传或为空字符串时默认bc-business-pu，用于存储目录隔离。 |
+
+## 2. 获取文件下载链接
+
+`GET /bc-business-pu/file/getUrlByKey`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+使用文件上传成功后返回的storageKey获取私有文件下载链接。storageKey必填且不能是空白字符串，请原样传入，不要传已有下载URL。
+
+成功时result直接返回URL字符串，不执行302重定向。有效期默认3600秒，由Apollo配置file.download.url-expire-seconds控制，与上传返回链接使用同一配置。链接失效后可重新调用本接口生成。生成失败、返回空链接或有效期配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 | 上传接口result.storageKey返回的文件标识，非空白字符串。 |

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,117 @@
+# 发票结算单
+
+对应命令：`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. 下载发票
+
+`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 | 是 | 发票格式 |
+
+## 5. 结算单还款记录
+
+`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 | 是 | 目标币种 |