sino-bc-cli 1.8.24 → 1.8.26

package/dist/generated/api-catalog.json

@@ -1482,44 +1482,6 @@
       "sso"
     ]
   },
-  {
-    "name": "biz-line-del",
-    "displayName": "删除业务线",
-    "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。",
-    "group": "业务线策略",
-    "method": "POST",
-    "path": "/sino-opti-hive/biz-line/del",
-    "timeout": 180000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+delete",
-    "risk": "high-risk-write",
-    "summary": "删除业务线",
-    "docFile": "biz-line-strategy.md",
-    "requestSchema": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer",
-          "format": "int64",
-          "title": "业务线ID",
-          "example": 1251
-        }
-      },
-      "required": [
-        "id"
-      ]
-    },
-    "responseSchema": {
-      "type": "boolean",
-      "description": "是否成功",
-      "title": "是否成功"
-    },
-    "tenant": false,
-    "roleScope": [
-      "sso"
-    ]
-  },
   {
     "name": "biz-line-strategy-list",
     "displayName": "查询投放策略分页列表",
@@ -2435,49 +2397,10 @@
       "sso"
     ]
   },
-  {
-    "name": "biz-line-strategy-del",
-    "displayName": "删除投放策略",
-    "description": "删除投放策略",
-    "group": "业务线策略",
-    "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/del",
-    "timeout": 180000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+strategy-delete",
-    "risk": "high-risk-write",
-    "summary": "删除投放策略",
-    "docFile": "biz-line-strategy.md",
-    "requestSchema": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer",
-          "format": "int64",
-          "description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
-          "title": "投放策略ID",
-          "example": 1
-        }
-      },
-      "required": [
-        "id"
-      ]
-    },
-    "responseSchema": {
-      "type": "boolean",
-      "description": "是否成功",
-      "title": "是否成功"
-    },
-    "tenant": false,
-    "roleScope": [
-      "sso"
-    ]
-  },
   {
     "name": "biz-line-open-dict-items",
-    "displayName": "查询业务线和策略投放品类字典",
-    "description": "查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
+    "displayName": "查询业务线字典和策略标签",
+    "description": "按sceneCode查询业务字典，使用GET Query参数，不传JSON请求体。sceneCode必填，不存在的场景返回空数组。\n\nAI策略生成前分别调用三次：BUDGET_STRATEGY（预算）、MEDIA_STRATEGY（媒介产品）、AUDIENCE_STRATEGY（受众定位）。三次都需传非空filterCondition，使用当前业务实际字典配置值；缺少该参数不会报错，而是直接返回[]。匹配规则为filter_condition等于传入值或为NULL（通用项）。不要据空数组自动推断该场景没有标签。\n\n将返回id分别填入保存接口budgetStrategyTags、mediaStrategyTags、audienceStrategyTags；不要传name或itemCode。此接口也保留PLACEMENT_CATEGORY（投放品类）和CUSTOMER_TYPE（客户类型）用途，二者过滤“其他”项；策略场景不做该过滤。两级场景返回树，叶子children可为null。\n\n策略调用示例：/sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY&filterCondition={{strategyFilterCondition}}。变量必须替换为实际配置值；另外两类策略仅替换sceneCode。投放品类调用示例：/sino-opti-hive/dict/items?sceneCode=PLACEMENT_CATEGORY。",
     "group": "业务线查询",
     "method": "GET",
     "path": "/sino-opti-hive/dict/items",
@@ -2486,39 +2409,68 @@
     "domain": "biz-line",
     "shortcut": "+categories",
     "risk": "read",
-    "summary": "查询业务线和策略投放品类字典",
+    "summary": "查询业务线字典和策略标签",
     "docFile": "biz-line-query.md",
     "requestSchema": {
       "type": "object",
       "properties": {
         "sceneCode": {
           "type": "string",
-          "description": "查询投放品类时固定传 PLACEMENT_CATEGORY。不传则以后端默认为准。"
+          "enum": [
+            "BUDGET_STRATEGY",
+            "MEDIA_STRATEGY",
+            "AUDIENCE_STRATEGY",
+            "PLACEMENT_CATEGORY",
+            "CUSTOMER_TYPE"
+          ],
+          "description": "必填。BUDGET_STRATEGY预算策略、MEDIA_STRATEGY媒介产品策略、AUDIENCE_STRATEGY受众定位策略；同时支持PLACEMENT_CATEGORY投放品类、CUSTOMER_TYPE客户类型。"
+        },
+        "filterCondition": {
+          "type": "string",
+          "description": "三类策略场景必须传非空值，否则返回[]；按实际字典配置的filter_condition精确匹配，同时包含filter_condition为NULL的通用项。此值没有固定枚举，不要用场景名或业务线ID臆造；其他场景可不传。"
         }
       },
-      "required": []
+      "required": [
+        "sceneCode"
+      ]
     },
     "queryParameters": [
       {
         "name": "sceneCode",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "enum": [
+            "BUDGET_STRATEGY",
+            "MEDIA_STRATEGY",
+            "AUDIENCE_STRATEGY",
+            "PLACEMENT_CATEGORY",
+            "CUSTOMER_TYPE"
+          ],
+          "description": "必填。BUDGET_STRATEGY预算策略、MEDIA_STRATEGY媒介产品策略、AUDIENCE_STRATEGY受众定位策略；同时支持PLACEMENT_CATEGORY投放品类、CUSTOMER_TYPE客户类型。"
+        },
+        "explode": true
+      },
+      {
+        "name": "filterCondition",
         "required": false,
         "schema": {
           "type": "string",
-          "description": "查询投放品类时固定传 PLACEMENT_CATEGORY。不传则以后端默认为准。"
+          "description": "三类策略场景必须传非空值，否则返回[]；按实际字典配置的filter_condition精确匹配，同时包含filter_condition为NULL的通用项。此值没有固定枚举，不要用场景名或业务线ID臆造；其他场景可不传。"
         },
         "explode": true
       }
     ],
     "responseSchema": {
       "type": "array",
-      "description": "投放品类字典树。一级=投放行业，children=投放品类。已过滤 isOther=1。",
+      "description": "指定场景下未删除且启用的字典项，按sortOrder排序；两级场景返回children树，普通场景返回列表。场景不存在、无匹配数据或策略场景缺少filterCondition时返回[]。",
       "items": {
         "type": "object",
         "properties": {
           "id": {
             "type": "integer",
             "format": "int64",
-            "description": "字典项 ID。一级对应 adCategoryIndustryId，二级对应 adCategoryProjectId",
+            "description": "字典项ID；三类策略场景用于保存AI策略的相应标签ID列表。PLACEMENT_CATEGORY中一级为行业ID，二级为投放品类ID。",
             "title": "字典项ID"
           },
           "name": {
@@ -2545,7 +2497,7 @@
           "isOther": {
             "type": "integer",
             "format": "int32",
-            "description": "是否「其他」。本接口已过滤 isOther=1，返回值一般为 0",
+            "description": "是否其他：1是、0否。仅PLACEMENT_CATEGORY和CUSTOMER_TYPE场景过滤isOther=1，策略场景不做该过滤。",
             "title": "是否其他"
           },
           "sortOrder": {
@@ -2556,19 +2508,19 @@
           },
           "children": {
             "type": "array",
-            "description": "二级投放品类。叶子节点为 null 或不返回",
+            "description": "两级场景的子项；普通场景或叶子节点可能为null/不返回。投放品类场景下代表二级投放品类。",
             "items": {
               "type": "object",
               "properties": {
                 "id": {
                   "type": "integer",
                   "format": "int64",
-                  "description": "投放品类 ID，对应筛选参数 adCategoryProjectId",
+                  "description": "子字典项ID；具体含义由sceneCode决定，PLACEMENT_CATEGORY下为投放品类ID。",
                   "title": "投放品类ID"
                 },
                 "name": {
                   "type": "string",
-                  "description": "投放品类名称",
+                  "description": "子字典项名称。",
                   "title": "投放品类名称"
                 },
                 "description": {
@@ -2601,11 +2553,12 @@
                 }
               }
             },
-            "title": "二级投放品类"
+            "title": "子字典项",
+            "nullable": true
           }
         }
       },
-      "title": "投放品类字典树"
+      "title": "字典项列表或树"
     },
     "tenant": false,
     "roleScope": [
@@ -5607,6 +5560,221 @@
       "sso"
     ]
   },
+  {
+    "name": "biz-line-ai-strategy-save",
+    "displayName": "保存业务线AI策略",
+    "description": "保存一个业务线、一个完整自然周的AI策略生成结果，返回新AI策略ID。bizLineId取自业务线列表；周期为已结束的周一至周日，默认支持2026-09-07及之后的周期（以服务配置为准）。仅优化系统管理员可调用，以BizLinePermCacheManager返回结果的admin标记为准：admin=true放行，其他情况拒绝。\n\n生成成功：generateCode传READY，提交四大策略文本、效果（1有效/2无效/3待观察）、Learning、三类标签ID列表和Excel文件存储key。标签ID从GET /sino-opti-hive/dict/items的对应策略场景查询，列表允许[]，JSON序列化后每类最多500字符；文件先上传，fileStorageKey不是下载URL。\n未生成：generateCode传NO_PROJECT、UNSUPPORTED_CHANNEL、NO_AD_ACCOUNT、NO_DELIVERY_DATA或GENERATION_FAILED，并填写remark；三类展示状态PERIOD_NOT_FINISHED、BEFORE_SUPPORTED_PERIOD、GENERATING不可保存。\n\n副作用：同业务线同周期的有效旧AI策略逻辑删除后新增记录，并在同一注解事务内批量快照对应正式策略；没有正式策略时不造空快照。重复调用会产生新的AI策略ID，不是原记录更新。历史日志和快照保留，不改写正式策略内容。失败时整个事务回滚。本接口不加锁。\n返回遵循RestResponseVO，成功result为Long型AI策略ID。示例中的ID和文件key须替换为真实数据。",
+    "group": "业务线AI策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/ai-strategy/save",
+    "timeout": 180000,
+    "tag": "业务线AI策略",
+    "domain": "biz-line",
+    "shortcut": "+ai-strategy-save",
+    "risk": "write",
+    "summary": "保存业务线AI策略",
+    "docFile": "biz-line-ai-strategy.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "bizLineId": {
+          "type": "integer",
+          "title": "业务线ID",
+          "description": "必填，正整数；取自业务线列表的id。",
+          "format": "int64",
+          "minimum": 1,
+          "example": 1251
+        },
+        "periodStart": {
+          "type": "string",
+          "title": "周期开始",
+          "description": "必填，周一，yyyy-MM-dd。",
+          "format": "date",
+          "example": "2026-09-07"
+        },
+        "periodEnd": {
+          "type": "string",
+          "title": "周期结束",
+          "description": "必填，同一自然周的周日，必须早于当前日期。",
+          "format": "date",
+          "example": "2026-09-13"
+        },
+        "generateCode": {
+          "type": "string",
+          "title": "生成结果状态码",
+          "description": "必填，区分大小写：READY成功；NO_PROJECT无项目；UNSUPPORTED_CHANNEL渠道不支持；NO_AD_ACCOUNT无广告账号；NO_DELIVERY_DATA无投放数据；GENERATION_FAILED生成失败。",
+          "enum": [
+            "READY",
+            "NO_PROJECT",
+            "UNSUPPORTED_CHANNEL",
+            "NO_AD_ACCOUNT",
+            "NO_DELIVERY_DATA",
+            "GENERATION_FAILED"
+          ],
+          "example": "READY"
+        },
+        "budgetStrategyTags": {
+          "type": "array",
+          "title": "预算策略标签ID列表",
+          "description": "READY时必填，允许空数组；取/dict/items的BUDGET_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。",
+          "items": {
+            "type": "integer",
+            "format": "int64",
+            "minimum": 1
+          },
+          "example": []
+        },
+        "budgetStrategySupplement": {
+          "type": "string",
+          "title": "预算策略",
+          "description": "READY时必填，非空策略内容。",
+          "example": "预算策略建议"
+        },
+        "budgetStrategyEffect": {
+          "type": "integer",
+          "title": "预算策略效果",
+          "description": "READY时必填：1有效、2无效、3待观察。",
+          "format": "int32",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "example": 3
+        },
+        "budgetStrategyLearning": {
+          "type": "string",
+          "title": "预算策略Learning",
+          "description": "READY时必填，非空的策略效果总结及经验。",
+          "example": "预算策略仍需观察"
+        },
+        "mediaStrategyTags": {
+          "type": "array",
+          "title": "媒介产品策略标签ID列表",
+          "description": "READY时必填，允许空数组；取/dict/items的MEDIA_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。",
+          "items": {
+            "type": "integer",
+            "format": "int64",
+            "minimum": 1
+          },
+          "example": []
+        },
+        "mediaStrategySupplement": {
+          "type": "string",
+          "title": "媒介产品策略",
+          "description": "READY时必填，非空策略内容。",
+          "example": "媒介产品策略建议"
+        },
+        "mediaStrategyEffect": {
+          "type": "integer",
+          "title": "媒介产品策略效果",
+          "description": "READY时必填：1有效、2无效、3待观察。",
+          "format": "int32",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "example": 3
+        },
+        "mediaStrategyLearning": {
+          "type": "string",
+          "title": "媒介产品策略Learning",
+          "description": "READY时必填，非空的策略效果总结及经验。",
+          "example": "媒介产品策略仍需观察"
+        },
+        "audienceStrategyTags": {
+          "type": "array",
+          "title": "受众定位策略标签ID列表",
+          "description": "READY时必填，允许空数组；取/dict/items的AUDIENCE_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。",
+          "items": {
+            "type": "integer",
+            "format": "int64",
+            "minimum": 1
+          },
+          "example": []
+        },
+        "audienceStrategySupplement": {
+          "type": "string",
+          "title": "受众定位策略",
+          "description": "READY时必填，非空策略内容。",
+          "example": "受众定位策略建议"
+        },
+        "audienceStrategyEffect": {
+          "type": "integer",
+          "title": "受众定位策略效果",
+          "description": "READY时必填：1有效、2无效、3待观察。",
+          "format": "int32",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "example": 3
+        },
+        "audienceStrategyLearning": {
+          "type": "string",
+          "title": "受众定位策略Learning",
+          "description": "READY时必填，非空的策略效果总结及经验。",
+          "example": "受众定位策略仍需观察"
+        },
+        "creativeStrategy": {
+          "type": "string",
+          "title": "素材创意策略",
+          "description": "READY时必填，非空策略内容。",
+          "example": "素材创意策略建议"
+        },
+        "creativeStrategyEffect": {
+          "type": "integer",
+          "title": "素材创意策略效果",
+          "description": "READY时必填：1有效、2无效、3待观察。",
+          "format": "int32",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "example": 3
+        },
+        "creativeStrategyLearning": {
+          "type": "string",
+          "title": "素材创意策略Learning",
+          "description": "READY时必填，非空的策略效果总结及经验。",
+          "example": "素材创意策略仍需观察"
+        },
+        "fileStorageKey": {
+          "type": "string",
+          "title": "Excel文件key",
+          "description": "READY时必填；上传策略Excel后返回的存储key，不是下载URL。",
+          "maxLength": 512,
+          "example": "strategy/example.xlsx"
+        },
+        "remark": {
+          "type": "string",
+          "title": "备注/未生成原因",
+          "description": "非READY时必填，说明不能生成或生成失败的原因。"
+        }
+      },
+      "required": [
+        "bizLineId",
+        "periodStart",
+        "periodEnd",
+        "generateCode"
+      ]
+    },
+    "responseSchema": {
+      "type": "integer",
+      "title": "AI策略ID",
+      "description": "本次新增AI策略ID，采用/暂不采用反馈使用该ID；详情接口仍按业务线和周期查询。",
+      "format": "int64",
+      "example": 100
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
+  },
   {
     "name": "project-action-log-page-by-project",
     "displayName": "按项目查询最新操作日志（分页倒序）",
@@ -26949,5 +27117,3929 @@
       "system",
       "passport"
     ]
+  },
+  {
+    "name": "bill-list",
+    "displayName": "对账单列表",
+    "description": "按生成时间查当前主体的账单聚合列表（BillAggregation）。响应只保留列表，不含待还汇总。",
+    "group": "对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/bill/list",
+    "timeout": 180000,
+    "tag": "对账单",
+    "domain": "wallet",
+    "shortcut": "+bill-list",
+    "risk": "read",
+    "summary": "对账单列表",
+    "docFile": "wallet-bill.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "startTime": {
+          "type": "string",
+          "title": "账单生成开始日",
+          "description": "yyyy-MM-dd",
+          "example": "2026-01-01"
+        },
+        "endTime": {
+          "type": "string",
+          "title": "账单生成结束日",
+          "description": "yyyy-MM-dd",
+          "example": "2026-01-31"
+        },
+        "billName": {
+          "type": "string",
+          "title": "对账单名称",
+          "description": "支持模糊"
+        },
+        "channelIdList": {
+          "type": "array",
+          "title": "所属渠道",
+          "description": "0 代表服务费系统",
+          "items": {
+            "type": "integer",
+            "title": "渠道id",
+            "description": "媒资渠道id",
+            "format": "int32"
+          }
+        },
+        "minAmount": {
+          "type": "number",
+          "title": "账单金额最小值",
+          "description": "账单金额最小值"
+        },
+        "maxAmount": {
+          "type": "number",
+          "title": "账单金额最大值",
+          "description": "账单金额最大值"
+        },
+        "invoiceStatusList": {
+          "type": "array",
+          "title": "开票状态",
+          "description": "开票状态",
+          "items": {
+            "type": "string",
+            "title": "开票状态",
+            "description": "开票状态",
+            "enum": [
+              "INVOICE_NONE",
+              "INVOICE_PART",
+              "INVOICE_SUCCESS"
+            ]
+          }
+        },
+        "billTypeList": {
+          "type": "array",
+          "title": "账单类型",
+          "description": "账单类型",
+          "items": {
+            "type": "string",
+            "title": "账单类型",
+            "description": "账单类型",
+            "enum": [
+              "MEDIA_BILL",
+              "SERVICE_CHARGE_BILL",
+              "CREDIT_MEMO_BILL",
+              "RED_OFFSET_BILL"
+            ]
+          }
+        },
+        "startMonth": {
+          "type": "string",
+          "title": "所属月份起始",
+          "description": "yyyyMM，如 202309"
+        },
+        "endMonth": {
+          "type": "string",
+          "title": "所属月份结束",
+          "description": "yyyyMM，如 202310"
+        }
+      },
+      "required": [
+        "startTime",
+        "endTime"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "billListVoPage": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "billId": {
+                    "type": "string",
+                    "title": "对账单id",
+                    "description": "对账单id"
+                  },
+                  "billName": {
+                    "type": "string",
+                    "title": "对账单名称",
+                    "description": "对账单名称"
+                  },
+                  "channelId": {
+                    "type": "string",
+                    "title": "所属渠道code",
+                    "description": "媒资渠道 id；0 代表服务费系统"
+                  },
+                  "channelName": {
+                    "type": "string",
+                    "title": "所属渠道名称",
+                    "description": "所属渠道名称"
+                  },
+                  "billCurrency": {
+                    "type": "string",
+                    "title": "账单金额币种",
+                    "description": "账单金额币种"
+                  },
+                  "billAmount": {
+                    "type": "string",
+                    "title": "账单金额",
+                    "description": "账单金额"
+                  },
+                  "toBeInvoicedCurrency": {
+                    "type": "string",
+                    "title": "待开票币种",
+                    "description": "待开票币种"
+                  },
+                  "toBeInvoicedAmount": {
+                    "type": "string",
+                    "title": "待开票金额",
+                    "description": "待开票金额"
+                  },
+                  "month": {
+                    "type": "string",
+                    "title": "所属月份",
+                    "description": "所属月份"
+                  },
+                  "invoiceStatusCode": {
+                    "type": "string",
+                    "title": "开票状态code",
+                    "description": "INVOICE_NONE / INVOICE_PART / INVOICE_SUCCESS"
+                  },
+                  "invoiceStatusName": {
+                    "type": "string",
+                    "title": "开票状态名称",
+                    "description": "开票状态名称"
+                  },
+                  "billTypeCode": {
+                    "type": "string",
+                    "title": "账单类型code",
+                    "description": "MEDIA_BILL / SERVICE_CHARGE_BILL / CREDIT_MEMO_BILL / RED_OFFSET_BILL"
+                  },
+                  "billTypeName": {
+                    "type": "string",
+                    "title": "账单类型名称",
+                    "description": "账单类型名称"
+                  },
+                  "createTime": {
+                    "type": "string",
+                    "title": "生成时间",
+                    "description": "生成时间"
+                  },
+                  "frozenType": {
+                    "type": "integer",
+                    "title": "冻结状态",
+                    "description": "0 未冻结 / 1 已冻结",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          },
+          "title": "对账单分页"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-detail-basic",
+    "displayName": "对账单基本信息",
+    "description": "按 billId 查单条对账单金额、渠道、类型、开票状态。",
+    "group": "对账单",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/bill/detail/basic",
+    "timeout": 180000,
+    "tag": "对账单",
+    "domain": "wallet",
+    "shortcut": "+bill-detail",
+    "risk": "read",
+    "summary": "对账单基本信息",
+    "docFile": "wallet-bill.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "billId": {
+          "type": "string",
+          "description": "对账单id"
+        }
+      },
+      "required": [
+        "billId"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "billId",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "对账单id"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "billId": {
+          "type": "string",
+          "title": "账单id",
+          "description": "账单id"
+        },
+        "channelId": {
+          "type": "string",
+          "title": "所属渠道code",
+          "description": "所属渠道code"
+        },
+        "channelName": {
+          "type": "string",
+          "title": "所属渠道名称",
+          "description": "所属渠道名称"
+        },
+        "billTypeCode": {
+          "type": "string",
+          "title": "账单类型code",
+          "description": "账单类型code"
+        },
+        "billTypeName": {
+          "type": "string",
+          "title": "账单类型名称",
+          "description": "账单类型名称"
+        },
+        "billCurrency": {
+          "type": "string",
+          "title": "账单金额币种",
+          "description": "账单金额币种"
+        },
+        "billAmount": {
+          "type": "string",
+          "title": "账单金额",
+          "description": "账单金额"
+        },
+        "month": {
+          "type": "string",
+          "title": "所属月份",
+          "description": "所属月份"
+        },
+        "toBeInvoicedAmount": {
+          "type": "string",
+          "title": "待开票金额",
+          "description": "对账单金额-已开票金额"
+        },
+        "toBeInvoicedCurrency": {
+          "type": "string",
+          "title": "待开票币种",
+          "description": "待开票币种"
+        },
+        "invoiceStatusCode": {
+          "type": "string",
+          "title": "开票状态code",
+          "description": "开票状态code"
+        },
+        "invoiceStatusName": {
+          "type": "string",
+          "title": "开票状态名称",
+          "description": "开票状态名称"
+        },
+        "createTime": {
+          "type": "string",
+          "title": "对账单创建时间",
+          "description": "对账单创建时间"
+        },
+        "billName": {
+          "type": "string",
+          "title": "对账单名",
+          "description": "对账单名"
+        },
+        "frozenType": {
+          "type": "integer",
+          "title": "冻结状态",
+          "description": "0 未冻结 / 1 已冻结",
+          "format": "int32"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-original-list",
+    "displayName": "对账单明细",
+    "description": "按对账单类型返回媒体 / 服务费 / Credit Memo / 服务费红冲其中一类明细。",
+    "group": "对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/bill/detail/original/list",
+    "timeout": 180000,
+    "tag": "对账单",
+    "domain": "wallet",
+    "shortcut": "+bill-original",
+    "risk": "read",
+    "summary": "对账单明细",
+    "docFile": "wallet-bill.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "billId": {
+          "type": "string",
+          "title": "对账单id",
+          "description": "对账单id"
+        }
+      },
+      "required": [
+        "billId"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "mediaBill": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "adAccountName": {
+                    "type": "string",
+                    "title": "广告账号名称",
+                    "description": "广告账号名称"
+                  },
+                  "adAccountId": {
+                    "type": "string",
+                    "title": "广告账号id",
+                    "description": "广告账号id"
+                  },
+                  "billMonth": {
+                    "type": "string",
+                    "title": "账单月份",
+                    "description": "账单月份"
+                  },
+                  "consumeCurrency": {
+                    "type": "string",
+                    "title": "消耗金额币种",
+                    "description": "消耗金额币种"
+                  },
+                  "consumeAmount": {
+                    "type": "number",
+                    "title": "消耗金额",
+                    "description": "消耗金额"
+                  },
+                  "mediaTaxesAmount": {
+                    "type": "number",
+                    "title": "媒体税费金额",
+                    "description": "媒体税费金额"
+                  },
+                  "sumAmount": {
+                    "type": "number",
+                    "title": "合计费用",
+                    "description": "消耗+税费"
+                  },
+                  "advertiserName": {
+                    "type": "string",
+                    "title": "广告主名称",
+                    "description": "广告主名称"
+                  }
+                }
+              }
+            }
+          },
+          "title": "媒体类明细"
+        },
+        "serviceChargeBill": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "title": "服务费项目",
+                    "description": "服务费项目"
+                  },
+                  "amount": {
+                    "type": "string",
+                    "title": "服务费金额",
+                    "description": "服务费金额"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "服务费币种",
+                    "description": "服务费币种"
+                  }
+                }
+              }
+            }
+          },
+          "title": "服务费明细"
+        },
+        "creditMemoBill": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "adAccountName": {
+                    "type": "string",
+                    "title": "广告账号名称",
+                    "description": "广告账号名称"
+                  },
+                  "adAccountId": {
+                    "type": "string",
+                    "title": "广告账号id",
+                    "description": "广告账号id"
+                  },
+                  "billMonth": {
+                    "type": "string",
+                    "title": "账单月份",
+                    "description": "账单月份"
+                  },
+                  "amount": {
+                    "type": "string",
+                    "title": "金额",
+                    "description": "单位为正"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "金额币种",
+                    "description": "金额币种"
+                  }
+                }
+              }
+            }
+          },
+          "title": "Credit Memo明细"
+        },
+        "serviceChargeRedBill": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "serviceChargeBillid": {
+                    "type": "string",
+                    "title": "抵扣服务费对账单id",
+                    "description": "正数服务费对账单id"
+                  },
+                  "serviceChargeBillName": {
+                    "type": "string",
+                    "title": "抵扣服务费对账单名称",
+                    "description": "正数服务费对账单名称"
+                  },
+                  "redAmount": {
+                    "type": "string",
+                    "title": "红冲金额",
+                    "description": "单位为正"
+                  },
+                  "redAmountCurrency": {
+                    "type": "string",
+                    "title": "红冲币种",
+                    "description": "红冲币种"
+                  }
+                }
+              }
+            }
+          },
+          "title": "服务费红冲明细"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-operate-list",
+    "displayName": "对账单操作历史",
+    "description": "分页查对账单操作记录。",
+    "group": "对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/bill/detail/operate/list",
+    "timeout": 180000,
+    "tag": "对账单",
+    "domain": "wallet",
+    "shortcut": "+bill-operate",
+    "risk": "read",
+    "summary": "对账单操作历史",
+    "docFile": "wallet-bill.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "billId": {
+          "type": "string",
+          "title": "对账单id",
+          "description": "对账单id"
+        }
+      },
+      "required": [
+        "billId"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "title": "总数",
+          "description": "总数",
+          "format": "int64"
+        },
+        "result": {
+          "type": "array",
+          "title": "本页条目",
+          "description": "本页条目",
+          "items": {
+            "type": "object",
+            "properties": {
+              "operationTime": {
+                "type": "string",
+                "title": "操作时间",
+                "description": "操作时间"
+              },
+              "content": {
+                "type": "string",
+                "title": "更新事项",
+                "description": "更新事项"
+              },
+              "operationUserId": {
+                "type": "string",
+                "title": "操作人id",
+                "description": "操作人id"
+              },
+              "operationUserName": {
+                "type": "string",
+                "title": "操作人姓名",
+                "description": "操作人姓名"
+              },
+              "reason": {
+                "type": "string",
+                "title": "更新原因",
+                "description": "更新原因"
+              }
+            }
+          }
+        }
+      },
+      "title": "分页结果"
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-invoice-enum",
+    "displayName": "对账单与发票枚举",
+    "description": "按 types 批量取渠道、开票/还款状态、账单类型等枚举。type 必须用原文，含拼写。",
+    "group": "对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/enum/bill-invoice/by-type/list",
+    "timeout": 180000,
+    "tag": "对账单",
+    "domain": "wallet",
+    "shortcut": "+bill-enum",
+    "risk": "read",
+    "summary": "对账单与发票枚举",
+    "docFile": "wallet-bill.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "types": {
+          "type": "array",
+          "title": "枚举类型",
+          "description": "至少 1 个。INVOICE_E_FILE_TYPE 结果不可靠，下载格式请用 PDF/OFD。",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "enum": [
+              "BIll_CHANNEL",
+              "REPAYMENT_STAUTS",
+              "BILL_INVOICE_STATUS",
+              "BILL_TYPE",
+              "BILL_INVOICE_TYPE",
+              "INVOICE_DETAILS_STATUS",
+              "INVOICE_SECTION",
+              "ORIGINAL_BILL_TYPE",
+              "INVOICE_VAT_TYPE",
+              "INVOICE_E_FILE_TYPE"
+            ]
+          }
+        }
+      },
+      "required": [
+        "types"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "title": "按类型分组的枚举",
+      "description": "key 为请求的 type",
+      "additionalProperties": {
+        "type": "array",
+        "title": "枚举项",
+        "description": "枚举项",
+        "items": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string",
+              "title": "枚举值",
+              "description": "枚举值"
+            },
+            "desc": {
+              "type": "string",
+              "title": "枚举描述",
+              "description": "枚举描述"
+            }
+          }
+        }
+      },
+      "properties": {}
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-settlement-list",
+    "displayName": "对账单关联结算单",
+    "description": "查某张对账单下已开的发票结算单，不分页。",
+    "group": "发票结算单",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/bill/detail/settlement/list",
+    "timeout": 180000,
+    "tag": "发票结算单",
+    "domain": "wallet",
+    "shortcut": "+bill-settlements",
+    "risk": "read",
+    "summary": "对账单关联结算单",
+    "docFile": "wallet-invoice.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "billId": {
+          "type": "string",
+          "description": "账单id"
+        }
+      },
+      "required": [
+        "billId"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "billId",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "账单id"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "array",
+      "title": "结算单列表",
+      "description": "结算单列表",
+      "items": {
+        "type": "object",
+        "properties": {
+          "invoiceSettlementId": {
+            "type": "string",
+            "title": "结算单id",
+            "description": "结算单id"
+          },
+          "amount": {
+            "type": "string",
+            "title": "开票金额",
+            "description": "开票金额"
+          },
+          "name": {
+            "type": "string",
+            "title": "发票抬头",
+            "description": "发票抬头"
+          },
+          "invoiceType": {
+            "type": "integer",
+            "title": "发票形式code",
+            "description": "1 Invoice / 2 VAT",
+            "format": "int32"
+          },
+          "invoiceTypeName": {
+            "type": "string",
+            "title": "发票形式名称",
+            "description": "发票形式名称"
+          },
+          "issuanceStatus": {
+            "type": "string",
+            "title": "开票状态code",
+            "description": "开票状态code"
+          },
+          "issuanceStatusName": {
+            "type": "string",
+            "title": "开票状态名称",
+            "description": "开票状态名称"
+          },
+          "paymentStatus": {
+            "type": "string",
+            "title": "还款状态code",
+            "description": "还款状态code"
+          },
+          "paymentStatusName": {
+            "type": "string",
+            "title": "还款状态名称",
+            "description": "还款状态名称"
+          },
+          "currency": {
+            "type": "string",
+            "title": "币种",
+            "description": "币种"
+          },
+          "repaymentCurrency": {
+            "type": "string",
+            "title": "待还款币种",
+            "description": "待还款币种"
+          },
+          "repaymentAmount": {
+            "type": "string",
+            "title": "待还金额",
+            "description": "待还金额"
+          },
+          "time": {
+            "type": "string",
+            "title": "申请时间",
+            "description": "申请时间"
+          },
+          "billList": {
+            "type": "array",
+            "title": "关联对账单",
+            "description": "关联对账单",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "title": "对账单id/子账单id",
+                  "description": "对账单id/子账单id"
+                },
+                "name": {
+                  "type": "string",
+                  "title": "账单名称",
+                  "description": "账单名称"
+                }
+              }
+            }
+          },
+          "invoiceModeType": {
+            "type": "integer",
+            "title": "开票模式",
+            "description": "1 原始账单 / 2 对账单 / 3 子对账单 / 4 无账单",
+            "format": "int32"
+          },
+          "invoiceModeName": {
+            "type": "string",
+            "title": "开票模式描述",
+            "description": "开票模式描述"
+          },
+          "invoiceVatType": {
+            "type": "string",
+            "title": "VAT开票类型",
+            "description": "ORDINARY / SPECIAL / E_ORDINARY / E_SPECIAL"
+          },
+          "invoiceVatTypeName": {
+            "type": "string",
+            "title": "VAT开票类型名称",
+            "description": "VAT开票类型名称"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "invoice-settlement-list",
+    "displayName": "发票结算单列表",
+    "description": "按申请时间查当前主体的结算单列表。响应只保留列表，不含待还汇总。",
+    "group": "发票结算单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/invoice/settlement/list",
+    "timeout": 180000,
+    "tag": "发票结算单",
+    "domain": "wallet",
+    "shortcut": "+invoice-list",
+    "risk": "read",
+    "summary": "发票结算单列表",
+    "docFile": "wallet-invoice.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "startTime": {
+          "type": "string",
+          "title": "申请时间起始",
+          "description": "yyyy-MM-dd",
+          "example": "2026-01-01"
+        },
+        "endTime": {
+          "type": "string",
+          "title": "申请时间截止",
+          "description": "yyyy-MM-dd",
+          "example": "2026-01-31"
+        },
+        "invoiceSettlementId": {
+          "type": "string",
+          "title": "结算单id",
+          "description": "结算单id"
+        },
+        "billIdList": {
+          "type": "array",
+          "title": "账单id列表",
+          "description": "账单id列表",
+          "items": {
+            "type": "string",
+            "title": "账单id",
+            "description": "账单id"
+          }
+        },
+        "name": {
+          "type": "string",
+          "title": "发票抬头",
+          "description": "模糊"
+        },
+        "paymentStatusList": {
+          "type": "array",
+          "title": "还款状态",
+          "description": "还款状态",
+          "items": {
+            "type": "string",
+            "title": "还款状态",
+            "description": "还款状态",
+            "enum": [
+              "REPAYMENT_NONE",
+              "REPAYMENT_PART",
+              "REPAYMENT_SUCCESS"
+            ]
+          }
+        },
+        "issuanceStatusList": {
+          "type": "array",
+          "title": "开票状态",
+          "description": "开票状态",
+          "items": {
+            "type": "string",
+            "title": "开票状态",
+            "description": "开票状态",
+            "enum": [
+              "INVOICE_APPROVING",
+              "INVOICE_REJECTED",
+              "INVOICE_SUCCESS",
+              "ABOLISH_APPROVING",
+              "ABOLISH_REJECTED",
+              "ABOLISH_SUCCESS"
+            ]
+          }
+        },
+        "invoiceTypeList": {
+          "type": "array",
+          "title": "发票形式",
+          "description": "发票形式",
+          "items": {
+            "type": "integer",
+            "title": "发票形式",
+            "description": "1 Invoice / 2 VAT",
+            "format": "int32"
+          }
+        },
+        "invoiceVatTypeList": {
+          "type": "array",
+          "title": "VAT发票类型",
+          "description": "VAT发票类型",
+          "items": {
+            "type": "string",
+            "title": "VAT发票类型",
+            "description": "VAT发票类型",
+            "enum": [
+              "ORDINARY",
+              "SPECIAL",
+              "E_ORDINARY",
+              "E_SPECIAL"
+            ]
+          }
+        },
+        "minAmount": {
+          "type": "number",
+          "title": "金额起始",
+          "description": "金额起始"
+        },
+        "maxAmount": {
+          "type": "number",
+          "title": "金额截止",
+          "description": "金额截止"
+        },
+        "collectFlag": {
+          "type": "boolean",
+          "title": "是否获取汇总信息",
+          "description": "本契约丢弃汇总，可不传",
+          "example": false
+        }
+      },
+      "required": [
+        "startTime",
+        "endTime"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "invoiceSettlementVoPageResult": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "invoiceSettlementId": {
+                    "type": "string",
+                    "title": "结算单id",
+                    "description": "结算单id"
+                  },
+                  "amount": {
+                    "type": "string",
+                    "title": "开票金额",
+                    "description": "开票金额"
+                  },
+                  "name": {
+                    "type": "string",
+                    "title": "发票抬头",
+                    "description": "发票抬头"
+                  },
+                  "invoiceType": {
+                    "type": "integer",
+                    "title": "发票形式code",
+                    "description": "1 Invoice / 2 VAT",
+                    "format": "int32"
+                  },
+                  "invoiceTypeName": {
+                    "type": "string",
+                    "title": "发票形式名称",
+                    "description": "发票形式名称"
+                  },
+                  "issuanceStatus": {
+                    "type": "string",
+                    "title": "开票状态code",
+                    "description": "开票状态code"
+                  },
+                  "issuanceStatusName": {
+                    "type": "string",
+                    "title": "开票状态名称",
+                    "description": "开票状态名称"
+                  },
+                  "paymentStatus": {
+                    "type": "string",
+                    "title": "还款状态code",
+                    "description": "还款状态code"
+                  },
+                  "paymentStatusName": {
+                    "type": "string",
+                    "title": "还款状态名称",
+                    "description": "还款状态名称"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "币种",
+                    "description": "币种"
+                  },
+                  "repaymentCurrency": {
+                    "type": "string",
+                    "title": "待还款币种",
+                    "description": "待还款币种"
+                  },
+                  "repaymentAmount": {
+                    "type": "string",
+                    "title": "待还金额",
+                    "description": "待还金额"
+                  },
+                  "time": {
+                    "type": "string",
+                    "title": "申请时间",
+                    "description": "申请时间"
+                  },
+                  "billList": {
+                    "type": "array",
+                    "title": "关联对账单",
+                    "description": "关联对账单",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "title": "对账单id/子账单id",
+                          "description": "对账单id/子账单id"
+                        },
+                        "name": {
+                          "type": "string",
+                          "title": "账单名称",
+                          "description": "账单名称"
+                        }
+                      }
+                    }
+                  },
+                  "invoiceModeType": {
+                    "type": "integer",
+                    "title": "开票模式",
+                    "description": "1 原始账单 / 2 对账单 / 3 子对账单 / 4 无账单",
+                    "format": "int32"
+                  },
+                  "invoiceModeName": {
+                    "type": "string",
+                    "title": "开票模式描述",
+                    "description": "开票模式描述"
+                  },
+                  "invoiceVatType": {
+                    "type": "string",
+                    "title": "VAT开票类型",
+                    "description": "ORDINARY / SPECIAL / E_ORDINARY / E_SPECIAL"
+                  },
+                  "invoiceVatTypeName": {
+                    "type": "string",
+                    "title": "VAT开票类型名称",
+                    "description": "VAT开票类型名称"
+                  }
+                }
+              }
+            }
+          },
+          "title": "结算单分页"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "invoice-settlement-detail",
+    "displayName": "发票结算单详情",
+    "description": "按结算单号查开票金额、税费、发票/VAT 明细与预览地址。",
+    "group": "发票结算单",
+    "method": "GET",
+    "path": "/sino-wallet-pu/invoice/settlement/detail",
+    "timeout": 180000,
+    "tag": "发票结算单",
+    "domain": "wallet",
+    "shortcut": "+invoice-detail",
+    "risk": "read",
+    "summary": "发票结算单详情",
+    "docFile": "wallet-invoice.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "invoiceSettlementId": {
+          "type": "string",
+          "description": "发票编号/结算单id"
+        }
+      },
+      "required": [
+        "invoiceSettlementId"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "invoiceSettlementId",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "发票编号/结算单id"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "invoiceSettlementNo": {
+          "type": "string",
+          "title": "结算单id",
+          "description": "结算单id"
+        },
+        "currency": {
+          "type": "string",
+          "title": "开票总金额币种",
+          "description": "开票总金额币种"
+        },
+        "amount": {
+          "type": "number",
+          "title": "开票总金额",
+          "description": "开票总金额"
+        },
+        "taxRate": {
+          "type": "number",
+          "title": "税点",
+          "description": "税点"
+        },
+        "taxAmount": {
+          "type": "number",
+          "title": "税费",
+          "description": "税费"
+        },
+        "repaymentCurrency": {
+          "type": "string",
+          "title": "还款金额币种",
+          "description": "还款金额币种"
+        },
+        "settledAmount": {
+          "type": "number",
+          "title": "还款金额",
+          "description": "还款金额"
+        },
+        "repaymentAmount": {
+          "type": "number",
+          "title": "待还款金额",
+          "description": "待还款金额"
+        },
+        "invoiceType": {
+          "type": "integer",
+          "title": "发票形式code",
+          "description": "1 Invoice / 2 VAT",
+          "format": "int32"
+        },
+        "invoiceTypeName": {
+          "type": "string",
+          "title": "发票形式名称",
+          "description": "发票形式名称"
+        },
+        "issuanceStatus": {
+          "type": "string",
+          "title": "开票状态code",
+          "description": "开票状态code"
+        },
+        "issuanceStatusName": {
+          "type": "string",
+          "title": "开票状态名称",
+          "description": "开票状态名称"
+        },
+        "paymentStatus": {
+          "type": "string",
+          "title": "还款状态code",
+          "description": "还款状态code"
+        },
+        "paymentStatusName": {
+          "type": "string",
+          "title": "还款状态名称",
+          "description": "还款状态名称"
+        },
+        "applyUserId": {
+          "type": "string",
+          "title": "申请人id",
+          "description": "申请人id"
+        },
+        "applyUserName": {
+          "type": "string",
+          "title": "申请人姓名",
+          "description": "申请人姓名"
+        },
+        "billList": {
+          "type": "array",
+          "title": "关联对账单",
+          "description": "关联对账单",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "title": "对账单id/子账单id",
+                "description": "对账单id/子账单id"
+              },
+              "name": {
+                "type": "string",
+                "title": "账单名称",
+                "description": "账单名称"
+              }
+            }
+          }
+        },
+        "invoiceModeType": {
+          "type": "integer",
+          "title": "开票模式",
+          "description": "1 原始账单 / 2 对账单 / 3 子对账单 / 4 无账单",
+          "format": "int32"
+        },
+        "invoiceSubjectsCode": {
+          "type": "string",
+          "title": "发票科目code",
+          "description": "发票科目code"
+        },
+        "invoiceSubjectsName": {
+          "type": "string",
+          "title": "发票科目名称",
+          "description": "发票科目名称"
+        },
+        "isPostal": {
+          "type": "boolean",
+          "title": "是否邮寄",
+          "description": "VAT"
+        },
+        "recipientInfo": {
+          "type": "object",
+          "properties": {
+            "recipientName": {
+              "type": "string",
+              "title": "邮寄联系人",
+              "description": "邮寄联系人"
+            },
+            "recipientPhone": {
+              "type": "string",
+              "title": "邮寄电话",
+              "description": "邮寄电话"
+            },
+            "recipientAddress": {
+              "type": "string",
+              "title": "邮寄地址",
+              "description": "邮寄地址"
+            }
+          }
+        },
+        "invoiceInfo": {
+          "type": "object",
+          "properties": {
+            "pdfUrl": {
+              "type": "string",
+              "title": "发票pdf预览url",
+              "description": "Invoice 预览"
+            }
+          }
+        },
+        "vatInfo": {
+          "type": "object",
+          "properties": {
+            "vatInvoiceItemInfoList": {
+              "type": "array",
+              "title": "发票明细",
+              "description": "发票明细",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "title": "发票流水号",
+                    "description": "发票流水号"
+                  },
+                  "issuanceStatus": {
+                    "type": "integer",
+                    "title": "发票状态code",
+                    "description": "发票状态code",
+                    "format": "int32"
+                  },
+                  "issuanceStatusName": {
+                    "type": "string",
+                    "title": "发票状态名称",
+                    "description": "发票状态名称"
+                  },
+                  "invoiceType": {
+                    "type": "string",
+                    "title": "发票类型code",
+                    "description": "发票类型code"
+                  },
+                  "invoiceTypeName": {
+                    "type": "string",
+                    "title": "发票类型名称",
+                    "description": "专用、普通"
+                  },
+                  "colourCode": {
+                    "type": "integer",
+                    "title": "红蓝字code",
+                    "description": "红蓝字code",
+                    "format": "int32"
+                  },
+                  "colourName": {
+                    "type": "string",
+                    "title": "红蓝字名称",
+                    "description": "红蓝字名称"
+                  },
+                  "code": {
+                    "type": "string",
+                    "title": "发票代码",
+                    "description": "发票代码"
+                  },
+                  "number": {
+                    "type": "string",
+                    "title": "发票号码",
+                    "description": "发票号码"
+                  },
+                  "amount": {
+                    "type": "number",
+                    "title": "开票金额",
+                    "description": "开票金额"
+                  },
+                  "taxAmount": {
+                    "type": "number",
+                    "title": "开票税额",
+                    "description": "开票税额"
+                  },
+                  "nonTaxAmount": {
+                    "type": "number",
+                    "title": "不含税金额",
+                    "description": "不含税金额"
+                  },
+                  "time": {
+                    "type": "string",
+                    "title": "开票时间",
+                    "description": "开票时间"
+                  },
+                  "pdfUrl": {
+                    "type": "string",
+                    "title": "pdf预览url",
+                    "description": "ofd 无预览url"
+                  }
+                }
+              }
+            },
+            "totalAmount": {
+              "type": "number",
+              "title": "合计开票金额",
+              "description": "合计开票金额"
+            },
+            "totalTaxAmount": {
+              "type": "number",
+              "title": "合计开票税额",
+              "description": "合计开票税额"
+            },
+            "totalNonTaxAmount": {
+              "type": "number",
+              "title": "合计不含税金额",
+              "description": "合计不含税金额"
+            }
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "invoice-download",
+    "displayName": "下载发票",
+    "description": "按结算单号和 PDF/OFD 返回发票下载 URL 列表。",
+    "group": "发票结算单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/invoice/settlement/invoice/download",
+    "timeout": 180000,
+    "tag": "发票结算单",
+    "domain": "wallet",
+    "shortcut": "+invoice-download",
+    "risk": "read",
+    "summary": "下载发票",
+    "docFile": "wallet-invoice.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "invoiceSettlementId": {
+          "type": "string",
+          "title": "发票编号",
+          "description": "结算单id"
+        },
+        "fileType": {
+          "type": "string",
+          "title": "文件类型",
+          "description": "发票格式",
+          "enum": [
+            "PDF",
+            "OFD"
+          ]
+        }
+      },
+      "required": [
+        "invoiceSettlementId",
+        "fileType"
+      ]
+    },
+    "responseSchema": {
+      "type": "array",
+      "title": "下载URL列表",
+      "description": "下载URL列表",
+      "items": {
+        "type": "string",
+        "title": "下载url",
+        "description": "下载url"
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "invoice-settlement-payment-list",
+    "displayName": "结算单还款记录",
+    "description": "查结算单还款历史。",
+    "group": "发票结算单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/invoice/settlement/payment/list",
+    "timeout": 180000,
+    "tag": "发票结算单",
+    "domain": "wallet",
+    "shortcut": "+invoice-payments",
+    "risk": "read",
+    "summary": "结算单还款记录",
+    "docFile": "wallet-invoice.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "invoiceSettlementId": {
+          "type": "string",
+          "title": "结算单id",
+          "description": "结算单id"
+        }
+      },
+      "required": [
+        "invoiceSettlementId"
+      ]
+    },
+    "responseSchema": {
+      "type": "array",
+      "title": "还款记录",
+      "description": "还款记录",
+      "items": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "title": "还款日期",
+            "description": "还款日期"
+          },
+          "currency": {
+            "type": "string",
+            "title": "还款币种",
+            "description": "还款币种"
+          },
+          "amount": {
+            "type": "number",
+            "title": "还款金额",
+            "description": "还款金额"
+          },
+          "operatorUserId": {
+            "type": "string",
+            "title": "操作人id",
+            "description": "操作人id"
+          },
+          "operatorUserName": {
+            "type": "string",
+            "title": "操作人",
+            "description": "操作人"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-reconciliation-page",
+    "displayName": "月度对账单列表",
+    "description": "按月份区间分页查标准化对账文件（主体+月份，通常每月一条）。",
+    "group": "月度对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/bill-reconciliation/page",
+    "timeout": 180000,
+    "tag": "月度对账单",
+    "domain": "wallet",
+    "shortcut": "+reconciliation",
+    "risk": "read",
+    "summary": "月度对账单列表",
+    "docFile": "wallet-reconciliation.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "billMonthStart": {
+          "type": "string",
+          "title": "账单起始月份",
+          "description": "yyyy-MM",
+          "example": "2026-06"
+        },
+        "billMonthEnd": {
+          "type": "string",
+          "title": "账单结束月份",
+          "description": "yyyy-MM",
+          "example": "2026-06"
+        }
+      },
+      "required": [
+        "billMonthStart",
+        "billMonthEnd"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "title": "总数",
+          "description": "总数",
+          "format": "int64"
+        },
+        "result": {
+          "type": "array",
+          "title": "本页条目",
+          "description": "本页条目",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "title": "业财对账文件记录ID",
+                "description": "业财对账文件记录ID",
+                "format": "int32"
+              },
+              "billMonth": {
+                "type": "string",
+                "title": "账单月份",
+                "description": "yyyy-MM"
+              },
+              "fileAndReceivableBalanceList": {
+                "type": "array",
+                "title": "对账文件及应收余额",
+                "description": "与业财文件一一对应",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "currencyId": {
+                      "type": "integer",
+                      "title": "币种ID",
+                      "description": "币种ID",
+                      "format": "int32"
+                    },
+                    "currencyCode": {
+                      "type": "string",
+                      "title": "币种编码",
+                      "description": "币种编码"
+                    },
+                    "amount": {
+                      "type": "number",
+                      "title": "金额",
+                      "description": "金额"
+                    },
+                    "fileName": {
+                      "type": "string",
+                      "title": "文件名",
+                      "description": "文件名"
+                    },
+                    "fileId": {
+                      "type": "string",
+                      "title": "文件ID",
+                      "description": "换下载链接时作为 storageKey"
+                    },
+                    "fileType": {
+                      "type": "integer",
+                      "title": "对账文件类型",
+                      "description": "0 对账单 / 1 发票",
+                      "format": "int32"
+                    }
+                  }
+                }
+              },
+              "receivableBalanceList": {
+                "type": "array",
+                "title": "应收余额",
+                "description": "按币种聚合后的应收",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "currencyId": {
+                      "type": "integer",
+                      "title": "币种ID",
+                      "description": "币种ID",
+                      "format": "int32"
+                    },
+                    "currencyCode": {
+                      "type": "string",
+                      "title": "币种编码",
+                      "description": "币种编码"
+                    },
+                    "amount": {
+                      "type": "number",
+                      "title": "金额",
+                      "description": "按币种聚合"
+                    }
+                  }
+                }
+              },
+              "generateTime": {
+                "type": "string",
+                "title": "生成时间",
+                "description": "取文件最新时间"
+              },
+              "sendStatus": {
+                "type": "string",
+                "title": "发送状态",
+                "description": "PENDING / SUCCESS / FAILED"
+              },
+              "sendStatusName": {
+                "type": "string",
+                "title": "发送状态中文",
+                "description": "发送状态中文"
+              },
+              "emailSendRecordId": {
+                "type": "string",
+                "title": "本地邮件发送记录id",
+                "description": "本地主键，不能用于预览"
+              },
+              "corporationId": {
+                "type": "integer",
+                "title": "签约主体id",
+                "description": "响应字段，请求不要传",
+                "format": "int32"
+              },
+              "corporationName": {
+                "type": "string",
+                "title": "签约主体名称",
+                "description": "签约主体名称"
+              }
+            }
+          }
+        }
+      },
+      "title": "分页结果"
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-reconciliation-send-log",
+    "displayName": "月度对账单发送记录",
+    "description": "按账单月份分页查邮件发送记录。",
+    "group": "月度对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/bill-reconciliation/send-log/page",
+    "timeout": 180000,
+    "tag": "月度对账单",
+    "domain": "wallet",
+    "shortcut": "+reconciliation-log",
+    "risk": "read",
+    "summary": "月度对账单发送记录",
+    "docFile": "wallet-reconciliation.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "billMonth": {
+          "type": "string",
+          "title": "账单月份",
+          "description": "yyyy-MM",
+          "example": "2026-06"
+        }
+      },
+      "required": [
+        "billMonth"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "title": "总数",
+          "description": "总数",
+          "format": "int64"
+        },
+        "result": {
+          "type": "array",
+          "title": "本页条目",
+          "description": "本页条目",
+          "items": {
+            "type": "object",
+            "properties": {
+              "sendRecordId": {
+                "type": "integer",
+                "title": "业财邮件发送记录id",
+                "description": "预览邮件时使用",
+                "format": "int64"
+              },
+              "sendTime": {
+                "type": "string",
+                "title": "发送时间",
+                "description": "yyyy-MM-dd HH:mm"
+              },
+              "sendStatus": {
+                "type": "integer",
+                "title": "发送状态值",
+                "description": "发送状态值",
+                "format": "int32"
+              },
+              "sendStatusName": {
+                "type": "string",
+                "title": "发送状态中文",
+                "description": "发送状态中文"
+              },
+              "recipientEmailList": {
+                "type": "array",
+                "title": "收件人邮箱",
+                "description": "收件人邮箱",
+                "items": {
+                  "type": "string",
+                  "title": "收件人",
+                  "description": "收件人"
+                }
+              },
+              "ccEmailList": {
+                "type": "array",
+                "title": "抄送人邮箱",
+                "description": "抄送人邮箱",
+                "items": {
+                  "type": "string",
+                  "title": "抄送人",
+                  "description": "抄送人"
+                }
+              },
+              "senderEmailList": {
+                "type": "array",
+                "title": "发件人邮箱",
+                "description": "发件人邮箱",
+                "items": {
+                  "type": "string",
+                  "title": "发件人",
+                  "description": "发件人"
+                }
+              },
+              "operatorName": {
+                "type": "string",
+                "title": "触发人名称",
+                "description": "触发人名称"
+              },
+              "triggerType": {
+                "type": "string",
+                "title": "触发类型",
+                "description": "AUTO / MANUAL"
+              },
+              "fileList": {
+                "type": "array",
+                "title": "附件列表",
+                "description": "附件列表",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "fileName": {
+                      "type": "string",
+                      "title": "文件名",
+                      "description": "文件名"
+                    },
+                    "fileId": {
+                      "type": "string",
+                      "title": "文件ID",
+                      "description": "换下载链接时作为 storageKey"
+                    }
+                  }
+                }
+              },
+              "emailContent": {
+                "type": "string",
+                "title": "邮件正文",
+                "description": "邮件正文"
+              }
+            }
+          }
+        }
+      },
+      "title": "分页结果"
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-reconciliation-email-preview",
+    "displayName": "对账邮件预览",
+    "description": "按业财发送记录 id 返回邮件 HTML。不要用列表里的本地 emailSendRecordId。",
+    "group": "月度对账单",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/bill-reconciliation/send-log/preview",
+    "timeout": 180000,
+    "tag": "月度对账单",
+    "domain": "wallet",
+    "shortcut": "+reconciliation-preview",
+    "risk": "read",
+    "summary": "对账邮件预览",
+    "docFile": "wallet-reconciliation.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "sendRecordId": {
+          "type": "integer",
+          "title": "业财发送记录id",
+          "description": "发送记录页的 sendRecordId",
+          "format": "int64"
+        }
+      },
+      "required": [
+        "sendRecordId"
+      ]
+    },
+    "responseSchema": {
+      "type": "string",
+      "title": "邮件HTML",
+      "description": "邮件HTML"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "bill-reconciliation-download-url",
+    "displayName": "月度对账单下载链接",
+    "description": "用文件 storageKey（即列表 fileId）换 3 小时有效下载/预览 URL。不要传 corporationId。",
+    "group": "月度对账单",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/bill-reconciliation/generate/download-url",
+    "timeout": 180000,
+    "tag": "月度对账单",
+    "domain": "wallet",
+    "shortcut": "+reconciliation-url",
+    "risk": "read",
+    "summary": "月度对账单下载链接",
+    "docFile": "wallet-reconciliation.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "storageKey": {
+          "type": "string",
+          "description": "文件存储 key，即列表 fileId"
+        }
+      },
+      "required": [
+        "storageKey"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "storageKey",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "文件存储 key，即列表 fileId"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "storageKey": {
+          "type": "string",
+          "title": "存储key",
+          "description": "存储key"
+        },
+        "url": {
+          "type": "string",
+          "title": "下载url",
+          "description": "下载url"
+        },
+        "documentPreviewUrl": {
+          "type": "string",
+          "title": "预览url",
+          "description": "预览url"
+        },
+        "fileName": {
+          "type": "string",
+          "title": "文件名",
+          "description": "文件名"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "quota-credit-info",
+    "displayName": "后付信用额度",
+    "description": "查当前主体后付授信与使用率；非后付不展示。",
+    "group": "后付额度",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/quota/credit/info",
+    "timeout": 180000,
+    "tag": "后付额度",
+    "domain": "wallet",
+    "shortcut": "+credit",
+    "risk": "read",
+    "summary": "后付信用额度",
+    "docFile": "wallet-quota.md",
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "showInfo": {
+          "type": "boolean",
+          "title": "是否展示信用额度信息",
+          "description": "非后付或风控黑名单为 false"
+        },
+        "isMonitorAmount": {
+          "type": "integer",
+          "title": "控额类型",
+          "description": "0 不控额 / 1 主体控额 / 2 合并控额",
+          "format": "int32"
+        },
+        "isMonitorAmountName": {
+          "type": "string",
+          "title": "控额类型名称",
+          "description": "控额类型名称"
+        },
+        "groupCreditCorporationCount": {
+          "type": "integer",
+          "title": "合并控额主体数量",
+          "description": "合并控额主体数量",
+          "format": "int32"
+        },
+        "quotaUsageRate": {
+          "type": "number",
+          "title": "额度使用率",
+          "description": "已乘以 100"
+        },
+        "lineOfCredit": {
+          "type": "number",
+          "title": "授信额度",
+          "description": "授信额度"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-own",
+    "displayName": "钱包首页",
+    "description": "查当前主体钱包：预付给现金/待还，后付给现金+信用金。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/own",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+own",
+    "risk": "read",
+    "summary": "钱包首页",
+    "docFile": "wallet-prepaid.md",
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "walletPayType": {
+          "type": "string",
+          "title": "支付类型",
+          "description": "PRE 预付 / POST 后付",
+          "enum": [
+            "PRE",
+            "POST"
+          ]
+        },
+        "prepareDetailVo": {
+          "type": "object",
+          "properties": {
+            "cashItemVos": {
+              "type": "array",
+              "title": "现金明细",
+              "description": "现金明细",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "accountNo": {
+                    "type": "string",
+                    "title": "账户编号",
+                    "description": "账户编号"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "币种",
+                    "description": "USD / CNY / HKD / EUR / GBP / JPY"
+                  },
+                  "currencyName": {
+                    "type": "string",
+                    "title": "币种描述",
+                    "description": "币种描述"
+                  },
+                  "amount": {
+                    "type": "number",
+                    "title": "金额",
+                    "description": "金额"
+                  },
+                  "accountType": {
+                    "type": "string",
+                    "title": "账户分类",
+                    "description": "CASH / REBATE / CREDIT"
+                  },
+                  "usdExchangeRate": {
+                    "type": "number",
+                    "title": "对美金汇率",
+                    "description": "对美金汇率"
+                  },
+                  "usdAmount": {
+                    "type": "number",
+                    "title": "兑换美金金额",
+                    "description": "兑换美金金额"
+                  },
+                  "currencySortWeight": {
+                    "type": "number",
+                    "title": "币种排序",
+                    "description": "币种排序"
+                  },
+                  "accountTypeSortWeight": {
+                    "type": "number",
+                    "title": "币种户排序",
+                    "description": "币种户排序"
+                  }
+                }
+              }
+            },
+            "debtItemVos": {
+              "type": "array",
+              "title": "待还明细",
+              "description": "待还明细",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "accountNo": {
+                    "type": "string",
+                    "title": "账户编号",
+                    "description": "账户编号"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "币种",
+                    "description": "USD / CNY / HKD / EUR / GBP / JPY"
+                  },
+                  "currencyName": {
+                    "type": "string",
+                    "title": "币种描述",
+                    "description": "币种描述"
+                  },
+                  "amount": {
+                    "type": "number",
+                    "title": "金额",
+                    "description": "金额"
+                  },
+                  "accountType": {
+                    "type": "string",
+                    "title": "账户分类",
+                    "description": "CASH / REBATE / CREDIT"
+                  },
+                  "usdExchangeRate": {
+                    "type": "number",
+                    "title": "对美金汇率",
+                    "description": "对美金汇率"
+                  },
+                  "usdAmount": {
+                    "type": "number",
+                    "title": "兑换美金金额",
+                    "description": "兑换美金金额"
+                  },
+                  "currencySortWeight": {
+                    "type": "number",
+                    "title": "币种排序",
+                    "description": "币种排序"
+                  },
+                  "accountTypeSortWeight": {
+                    "type": "number",
+                    "title": "币种户排序",
+                    "description": "币种户排序"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "afterDetailVo": {
+          "type": "object",
+          "properties": {
+            "amountVo": {
+              "type": "object",
+              "properties": {
+                "cash": {
+                  "type": "number",
+                  "title": "现金总可用",
+                  "description": "美元口径"
+                },
+                "credit": {
+                  "type": "number",
+                  "title": "信用风控额度",
+                  "description": "美元口径"
+                },
+                "used": {
+                  "type": "number",
+                  "title": "已使用额度",
+                  "description": "已用+冻结，美元口径"
+                },
+                "total": {
+                  "type": "number",
+                  "title": "钱包总额",
+                  "description": "现金+信用金-已使用，美元口径"
+                }
+              }
+            },
+            "cashVo": {
+              "type": "object",
+              "properties": {
+                "total": {
+                  "type": "number",
+                  "title": "现金总可用",
+                  "description": "现金户+返点户"
+                },
+                "currencyItemVos": {
+                  "type": "array",
+                  "title": "现金明细",
+                  "description": "现金+返点币种户",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "accountNo": {
+                        "type": "string",
+                        "title": "账户编号",
+                        "description": "账户编号"
+                      },
+                      "currency": {
+                        "type": "string",
+                        "title": "币种",
+                        "description": "USD / CNY / HKD / EUR / GBP / JPY"
+                      },
+                      "currencyName": {
+                        "type": "string",
+                        "title": "币种描述",
+                        "description": "币种描述"
+                      },
+                      "amount": {
+                        "type": "number",
+                        "title": "金额",
+                        "description": "金额"
+                      },
+                      "accountType": {
+                        "type": "string",
+                        "title": "账户分类",
+                        "description": "CASH / REBATE / CREDIT"
+                      },
+                      "usdExchangeRate": {
+                        "type": "number",
+                        "title": "对美金汇率",
+                        "description": "对美金汇率"
+                      },
+                      "usdAmount": {
+                        "type": "number",
+                        "title": "兑换美金金额",
+                        "description": "兑换美金金额"
+                      },
+                      "currencySortWeight": {
+                        "type": "number",
+                        "title": "币种排序",
+                        "description": "币种排序"
+                      },
+                      "accountTypeSortWeight": {
+                        "type": "number",
+                        "title": "币种户排序",
+                        "description": "币种户排序"
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "creditVo": {
+              "type": "object",
+              "properties": {
+                "total": {
+                  "type": "number",
+                  "title": "信用风控额度",
+                  "description": "信用风控额度"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-change-recent",
+    "displayName": "最近钱包流水",
+    "description": "钱包首页最近消费/返额，默认 7 条。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/recent/walletchangeitem",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+change-recent",
+    "risk": "read",
+    "summary": "最近钱包流水",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageSize": {
+          "type": "integer",
+          "description": "条数，默认 7"
+        }
+      },
+      "required": []
+    },
+    "queryParameters": [
+      {
+        "name": "pageSize",
+        "required": false,
+        "schema": {
+          "type": "integer",
+          "description": "条数，默认 7"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "array",
+      "title": "最近钱包流水",
+      "description": "最近钱包流水",
+      "items": {
+        "type": "object",
+        "properties": {
+          "changeTime": {
+            "type": "string",
+            "title": "变动时间",
+            "description": "变动时间"
+          },
+          "flowNo": {
+            "type": "string",
+            "title": "平台流水单号",
+            "description": "平台流水单号"
+          },
+          "source": {
+            "type": "string",
+            "title": "交易来源",
+            "description": "交易来源"
+          },
+          "accountsType": {
+            "type": "string",
+            "title": "账务类型",
+            "description": "账务类型"
+          },
+          "currency": {
+            "type": "string",
+            "title": "币种",
+            "description": "币种"
+          },
+          "currencyName": {
+            "type": "string",
+            "title": "币种描述",
+            "description": "币种描述"
+          },
+          "accountType": {
+            "type": "string",
+            "title": "账户分类",
+            "description": "CASH / REBATE / CREDIT"
+          },
+          "amount": {
+            "type": "number",
+            "title": "本次消费额度",
+            "description": "本次消费额度"
+          },
+          "usedAmount": {
+            "type": "number",
+            "title": "已消费额度",
+            "description": "已冻+已用"
+          },
+          "plusOrMinus": {
+            "type": "string",
+            "title": "金额正负",
+            "description": "+ 或 -"
+          },
+          "departmentCode": {
+            "type": "string",
+            "title": "团队编码",
+            "description": "团队编码"
+          },
+          "departmentName": {
+            "type": "string",
+            "title": "使用团队",
+            "description": "使用团队"
+          },
+          "operatorId": {
+            "type": "integer",
+            "title": "操作人id",
+            "description": "操作人id",
+            "format": "int32"
+          },
+          "operator": {
+            "type": "string",
+            "title": "操作人",
+            "description": "操作人"
+          },
+          "changeAccount": {
+            "type": "string",
+            "title": "影响账户",
+            "description": "影响账户"
+          },
+          "overageAmount": {
+            "type": "number",
+            "title": "可用余额",
+            "description": "可用余额"
+          },
+          "remark": {
+            "type": "string",
+            "title": "单据备注",
+            "description": "单据备注"
+          },
+          "externalBizType": {
+            "type": "string",
+            "title": "账务类型",
+            "description": "ExternalBizTypeEnum"
+          },
+          "externalBizTypeDesc": {
+            "type": "string",
+            "title": "账务类型描述",
+            "description": "中台描述"
+          },
+          "flowDirection": {
+            "type": "integer",
+            "title": "流水收支方向",
+            "description": "FlowDirectionEnum",
+            "format": "int32"
+          },
+          "flowDirectionDesc": {
+            "type": "string",
+            "title": "流水收支方向描述",
+            "description": "中台描述"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-recharge-recent",
+    "displayName": "最近充值记录",
+    "description": "钱包首页最近充值，默认 7 条。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/recent/recharge",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+recharge-recent",
+    "risk": "read",
+    "summary": "最近充值记录",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageSize": {
+          "type": "integer",
+          "description": "条数，默认 7"
+        }
+      },
+      "required": []
+    },
+    "queryParameters": [
+      {
+        "name": "pageSize",
+        "required": false,
+        "schema": {
+          "type": "integer",
+          "description": "条数，默认 7"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "array",
+      "title": "最近充值",
+      "description": "最近充值",
+      "items": {
+        "type": "object",
+        "properties": {
+          "incomeTime": {
+            "type": "string",
+            "title": "入账时间",
+            "description": "入账时间"
+          },
+          "paymentBankStatementId": {
+            "type": "string",
+            "title": "银行流水单号",
+            "description": "银行流水单号"
+          },
+          "paymentTime": {
+            "type": "string",
+            "title": "打款时间",
+            "description": "打款时间"
+          },
+          "paymentBankAccount": {
+            "type": "string",
+            "title": "打款银行账户",
+            "description": "打款银行账户"
+          },
+          "incomeName": {
+            "type": "string",
+            "title": "收款方名称",
+            "description": "收款方名称"
+          },
+          "incomeBankName": {
+            "type": "string",
+            "title": "收款方银行名称",
+            "description": "收款方银行名称"
+          },
+          "paymentName": {
+            "type": "string",
+            "title": "打款方名称",
+            "description": "打款方名称"
+          },
+          "incomeBankAccount": {
+            "type": "string",
+            "title": "平台收款方银行账户",
+            "description": "平台收款方银行账户"
+          },
+          "paymentType": {
+            "type": "string",
+            "title": "充值方式",
+            "description": "默认返回银行转账"
+          },
+          "paymentAmount": {
+            "type": "string",
+            "title": "充值金额",
+            "description": "充值金额"
+          },
+          "currency": {
+            "type": "string",
+            "title": "充值币种",
+            "description": "充值币种"
+          },
+          "currencyName": {
+            "type": "string",
+            "title": "充值币种描述",
+            "description": "充值币种描述"
+          },
+          "paymentRemark": {
+            "type": "string",
+            "title": "转账附言",
+            "description": "操作附言|转账附言"
+          },
+          "rechargeStatementId": {
+            "type": "string",
+            "title": "平台充值入账单号",
+            "description": "平台充值入账单号"
+          },
+          "feeAmount": {
+            "type": "number",
+            "title": "支付商手续费金额",
+            "description": "支付商手续费金额"
+          },
+          "feeCurrency": {
+            "type": "string",
+            "title": "支付商手续费币种",
+            "description": "支付商手续费币种"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-currency-list",
+    "displayName": "钱包币种列表",
+    "description": "当前主体可用币种。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/currency/list",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+currency",
+    "risk": "read",
+    "summary": "钱包币种列表",
+    "docFile": "wallet-prepaid.md",
+    "responseSchema": {
+      "type": "array",
+      "title": "币种列表",
+      "description": "币种列表",
+      "items": {
+        "type": "object",
+        "properties": {
+          "currency": {
+            "type": "string",
+            "title": "币种",
+            "description": "USD / CNY / HKD / EUR / GBP / JPY"
+          },
+          "currencyName": {
+            "type": "string",
+            "title": "币种描述",
+            "description": "币种描述"
+          },
+          "currencySortWeight": {
+            "type": "number",
+            "title": "币种排序",
+            "description": "币种排序"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-cash-change-accounts-type",
+    "displayName": "现金账务类型",
+    "description": "现金收支筛选项：账务类型与流水方向。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/cashchange/list/accountstype",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+cash-accounts",
+    "risk": "read",
+    "summary": "现金账务类型",
+    "docFile": "wallet-prepaid.md",
+    "responseSchema": {
+      "type": "array",
+      "title": "账务类型",
+      "description": "账务类型",
+      "items": {
+        "type": "object",
+        "properties": {
+          "accountsType": {
+            "type": "string",
+            "title": "类型",
+            "description": "类型"
+          },
+          "desc": {
+            "type": "string",
+            "title": "描述",
+            "description": "描述"
+          },
+          "itemVoList": {
+            "type": "array",
+            "title": "子节点",
+            "description": "账务类型子项",
+            "items": {
+              "type": "object",
+              "properties": {
+                "externalBizType": {
+                  "type": "string",
+                  "title": "账务类型",
+                  "description": "ExternalBizTypeEnum"
+                },
+                "externalBizTypeDesc": {
+                  "type": "string",
+                  "title": "账务类型描述",
+                  "description": "账务类型描述"
+                },
+                "flowDirectionList": {
+                  "type": "array",
+                  "title": "流水方向列表",
+                  "description": "给流水查询用",
+                  "items": {
+                    "type": "string",
+                    "title": "流水方向",
+                    "description": "流水方向 name"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-cash-change-list",
+    "displayName": "现金收支明细",
+    "description": "分页查现金/返点账户流水。响应不含收支汇总。",
+    "group": "预付钱包",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/cashchange/list",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+cash-change",
+    "risk": "read",
+    "summary": "现金收支明细",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "changeTimeOrderBy": {
+          "type": "string",
+          "title": "变动时间排序",
+          "description": "desc 倒序 / asc 正序",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "startTime": {
+          "type": "string",
+          "title": "开始日期",
+          "description": "开始日期"
+        },
+        "endTime": {
+          "type": "string",
+          "title": "结束日期",
+          "description": "结束日期"
+        },
+        "externalBizType": {
+          "type": "string",
+          "title": "账务类型",
+          "description": "来自现金账务类型接口"
+        },
+        "flowDirectionList": {
+          "type": "array",
+          "title": "流水收支方向",
+          "description": "来自账务类型接口",
+          "items": {
+            "type": "string",
+            "title": "流水方向",
+            "description": "流水方向 name"
+          }
+        },
+        "incomeAndExpensesType": {
+          "type": "string",
+          "title": "收支类型",
+          "description": "income 收入 / expenses 支出",
+          "enum": [
+            "income",
+            "expenses"
+          ]
+        },
+        "currencyList": {
+          "type": "array",
+          "title": "币种类型",
+          "description": "币种类型",
+          "items": {
+            "type": "string",
+            "title": "币种",
+            "description": "币种"
+          }
+        },
+        "flowNo": {
+          "type": "string",
+          "title": "流水单号",
+          "description": "流水单号"
+        },
+        "min": {
+          "type": "number",
+          "title": "收支金额最小值",
+          "description": "收支金额最小值"
+        },
+        "max": {
+          "type": "number",
+          "title": "收支金额最大值",
+          "description": "收支金额最大值"
+        },
+        "operatorIds": {
+          "type": "array",
+          "title": "操作人",
+          "description": "操作人",
+          "items": {
+            "type": "integer",
+            "title": "操作人id",
+            "description": "操作人id",
+            "format": "int32"
+          }
+        },
+        "departmentCodeList": {
+          "type": "array",
+          "title": "团队编码",
+          "description": "含顶级团队时服务端会再加管理员团队 0",
+          "items": {
+            "type": "string",
+            "title": "团队编码",
+            "description": "团队编码"
+          }
+        },
+        "collectFlag": {
+          "type": "boolean",
+          "title": "是否获取汇总信息",
+          "description": "本契约丢弃汇总，可不传"
+        }
+      },
+      "required": [
+        "changeTimeOrderBy"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "title": "总数",
+          "description": "总数",
+          "format": "int64"
+        },
+        "result": {
+          "type": "array",
+          "title": "本页条目",
+          "description": "本页条目",
+          "items": {
+            "type": "object",
+            "properties": {
+              "changeTime": {
+                "type": "string",
+                "title": "变动时间",
+                "description": "变动时间"
+              },
+              "flowNo": {
+                "type": "string",
+                "title": "平台流水单号",
+                "description": "平台流水单号"
+              },
+              "source": {
+                "type": "string",
+                "title": "交易来源",
+                "description": "交易来源"
+              },
+              "accountsType": {
+                "type": "string",
+                "title": "账务类型",
+                "description": "账务类型"
+              },
+              "currency": {
+                "type": "string",
+                "title": "币种",
+                "description": "币种"
+              },
+              "currencyName": {
+                "type": "string",
+                "title": "币种描述",
+                "description": "币种描述"
+              },
+              "accountType": {
+                "type": "string",
+                "title": "账户分类",
+                "description": "CASH / REBATE / CREDIT"
+              },
+              "amount": {
+                "type": "number",
+                "title": "收支金额",
+                "description": "收支金额"
+              },
+              "availableAmount": {
+                "type": "number",
+                "title": "现金账户可用金额",
+                "description": "现金账户可用金额"
+              },
+              "plusOrMinus": {
+                "type": "string",
+                "title": "金额正负",
+                "description": "+ 或 -"
+              },
+              "departmentCode": {
+                "type": "string",
+                "title": "团队编码",
+                "description": "团队编码"
+              },
+              "departmentName": {
+                "type": "string",
+                "title": "使用团队",
+                "description": "使用团队"
+              },
+              "operatorId": {
+                "type": "integer",
+                "title": "操作人id",
+                "description": "操作人id",
+                "format": "int32"
+              },
+              "operator": {
+                "type": "string",
+                "title": "操作人",
+                "description": "操作人"
+              },
+              "changeAccount": {
+                "type": "string",
+                "title": "影响账户",
+                "description": "影响账户"
+              },
+              "overageAmount": {
+                "type": "number",
+                "title": "账户余额",
+                "description": "账户余额"
+              },
+              "remark": {
+                "type": "string",
+                "title": "单据备注",
+                "description": "单据备注"
+              },
+              "externalBizType": {
+                "type": "string",
+                "title": "账务类型",
+                "description": "ExternalBizTypeEnum"
+              },
+              "externalBizTypeDesc": {
+                "type": "string",
+                "title": "账务类型描述",
+                "description": "中台描述"
+              },
+              "flowDirection": {
+                "type": "integer",
+                "title": "流水收支方向",
+                "description": "FlowDirectionEnum",
+                "format": "int32"
+              },
+              "flowDirectionDesc": {
+                "type": "string",
+                "title": "流水收支方向描述",
+                "description": "中台描述"
+              }
+            }
+          }
+        }
+      },
+      "title": "分页结果"
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-change-accounts-type",
+    "displayName": "钱包账务类型",
+    "description": "钱包消费明细的账务类型筛选项。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/walletchange/list/accountstype",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+change-accounts",
+    "risk": "read",
+    "summary": "钱包账务类型",
+    "docFile": "wallet-prepaid.md",
+    "responseSchema": {
+      "type": "array",
+      "title": "账务类型",
+      "description": "账务类型",
+      "items": {
+        "type": "object",
+        "properties": {
+          "accountsType": {
+            "type": "string",
+            "title": "类型",
+            "description": "类型"
+          },
+          "desc": {
+            "type": "string",
+            "title": "描述",
+            "description": "描述"
+          },
+          "itemVoList": {
+            "type": "array",
+            "title": "子节点",
+            "description": "账务类型子项",
+            "items": {
+              "type": "object",
+              "properties": {
+                "externalBizType": {
+                  "type": "string",
+                  "title": "账务类型",
+                  "description": "ExternalBizTypeEnum"
+                },
+                "externalBizTypeDesc": {
+                  "type": "string",
+                  "title": "账务类型描述",
+                  "description": "账务类型描述"
+                },
+                "flowDirectionList": {
+                  "type": "array",
+                  "title": "流水方向列表",
+                  "description": "给流水查询用",
+                  "items": {
+                    "type": "string",
+                    "title": "流水方向",
+                    "description": "流水方向 name"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-change-quota-type",
+    "displayName": "钱包额度类型",
+    "description": "额度类型：consume 消费 / return_quota 返额。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/walletchange/list/quotatype",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+quota-type",
+    "risk": "read",
+    "summary": "钱包额度类型",
+    "docFile": "wallet-prepaid.md",
+    "responseSchema": {
+      "type": "array",
+      "title": "额度类型",
+      "description": "额度类型",
+      "items": {
+        "type": "object",
+        "properties": {
+          "quotaType": {
+            "type": "string",
+            "title": "额度类型",
+            "description": "额度类型",
+            "enum": [
+              "consume",
+              "return_quota"
+            ]
+          },
+          "desc": {
+            "type": "string",
+            "title": "描述",
+            "description": "描述"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-change-list",
+    "displayName": "钱包消费明细",
+    "description": "分页查钱包额度流水。响应不含消费/返额汇总。",
+    "group": "预付钱包",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/walletchange/list",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+change",
+    "risk": "read",
+    "summary": "钱包消费明细",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "changeTimeOrderBy": {
+          "type": "string",
+          "title": "变动时间排序",
+          "description": "desc 倒序 / asc 正序",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "startTime": {
+          "type": "string",
+          "title": "开始日期",
+          "description": "开始日期"
+        },
+        "endTime": {
+          "type": "string",
+          "title": "结束日期",
+          "description": "结束日期"
+        },
+        "quotaType": {
+          "type": "string",
+          "title": "额度类型",
+          "description": "额度类型",
+          "enum": [
+            "consume",
+            "return_quota"
+          ]
+        },
+        "externalBizType": {
+          "type": "string",
+          "title": "账务类型",
+          "description": "来自钱包账务类型接口"
+        },
+        "flowDirectionList": {
+          "type": "array",
+          "title": "流水收支方向",
+          "description": "来自账务类型接口",
+          "items": {
+            "type": "string",
+            "title": "流水方向",
+            "description": "流水方向 name"
+          }
+        },
+        "currencyList": {
+          "type": "array",
+          "title": "币种类型",
+          "description": "币种类型",
+          "items": {
+            "type": "string",
+            "title": "币种",
+            "description": "币种"
+          }
+        },
+        "flowNo": {
+          "type": "string",
+          "title": "流水单号",
+          "description": "流水单号"
+        },
+        "min": {
+          "type": "number",
+          "title": "额度最小值",
+          "description": "额度最小值"
+        },
+        "max": {
+          "type": "number",
+          "title": "额度最大值",
+          "description": "额度最大值"
+        },
+        "operatorIds": {
+          "type": "array",
+          "title": "操作人",
+          "description": "操作人",
+          "items": {
+            "type": "integer",
+            "title": "操作人id",
+            "description": "操作人id",
+            "format": "int32"
+          }
+        },
+        "departmentCodeList": {
+          "type": "array",
+          "title": "团队编码",
+          "description": "含顶级团队时服务端会再加管理员团队 0",
+          "items": {
+            "type": "string",
+            "title": "团队编码",
+            "description": "团队编码"
+          }
+        },
+        "collectFlag": {
+          "type": "boolean",
+          "title": "是否获取汇总信息",
+          "description": "服务端默认 true；本契约丢弃汇总",
+          "example": true
+        }
+      },
+      "required": [
+        "changeTimeOrderBy"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "title": "总数",
+          "description": "总数",
+          "format": "int64"
+        },
+        "result": {
+          "type": "array",
+          "title": "本页条目",
+          "description": "本页条目",
+          "items": {
+            "type": "object",
+            "properties": {
+              "changeTime": {
+                "type": "string",
+                "title": "变动时间",
+                "description": "变动时间"
+              },
+              "flowNo": {
+                "type": "string",
+                "title": "平台流水单号",
+                "description": "平台流水单号"
+              },
+              "source": {
+                "type": "string",
+                "title": "交易来源",
+                "description": "交易来源"
+              },
+              "accountsType": {
+                "type": "string",
+                "title": "账务类型",
+                "description": "账务类型"
+              },
+              "currency": {
+                "type": "string",
+                "title": "币种",
+                "description": "币种"
+              },
+              "currencyName": {
+                "type": "string",
+                "title": "币种描述",
+                "description": "币种描述"
+              },
+              "accountType": {
+                "type": "string",
+                "title": "账户分类",
+                "description": "CASH / REBATE / CREDIT"
+              },
+              "amount": {
+                "type": "number",
+                "title": "本次消费额度",
+                "description": "本次消费额度"
+              },
+              "usedAmount": {
+                "type": "number",
+                "title": "已消费额度",
+                "description": "已冻+已用"
+              },
+              "plusOrMinus": {
+                "type": "string",
+                "title": "金额正负",
+                "description": "+ 或 -"
+              },
+              "departmentCode": {
+                "type": "string",
+                "title": "团队编码",
+                "description": "团队编码"
+              },
+              "departmentName": {
+                "type": "string",
+                "title": "使用团队",
+                "description": "使用团队"
+              },
+              "operatorId": {
+                "type": "integer",
+                "title": "操作人id",
+                "description": "操作人id",
+                "format": "int32"
+              },
+              "operator": {
+                "type": "string",
+                "title": "操作人",
+                "description": "操作人"
+              },
+              "changeAccount": {
+                "type": "string",
+                "title": "影响账户",
+                "description": "影响账户"
+              },
+              "overageAmount": {
+                "type": "number",
+                "title": "可用余额",
+                "description": "可用余额"
+              },
+              "remark": {
+                "type": "string",
+                "title": "单据备注",
+                "description": "单据备注"
+              },
+              "externalBizType": {
+                "type": "string",
+                "title": "账务类型",
+                "description": "ExternalBizTypeEnum"
+              },
+              "externalBizTypeDesc": {
+                "type": "string",
+                "title": "账务类型描述",
+                "description": "中台描述"
+              },
+              "flowDirection": {
+                "type": "integer",
+                "title": "流水收支方向",
+                "description": "FlowDirectionEnum",
+                "format": "int32"
+              },
+              "flowDirectionDesc": {
+                "type": "string",
+                "title": "流水收支方向描述",
+                "description": "中台描述"
+              }
+            }
+          }
+        }
+      },
+      "title": "分页结果"
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-recharge-list",
+    "displayName": "充值明细",
+    "description": "按入账时间查充值记录。响应只保留列表，不含充值汇总。",
+    "group": "预付钱包",
+    "method": "POST",
+    "path": "/sino-wallet-pu/platform/wallet/recharge/list",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+recharge",
+    "risk": "read",
+    "summary": "充值明细",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数",
+          "example": 10
+        },
+        "incomeTimeOrderBy": {
+          "type": "string",
+          "title": "入账时间排序",
+          "description": "desc 倒序 / asc 正序",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "startIncomeTime": {
+          "type": "string",
+          "title": "入账开始日",
+          "description": "yyyy-MM-dd"
+        },
+        "endIncomeTime": {
+          "type": "string",
+          "title": "入账结束日",
+          "description": "yyyy-MM-dd"
+        },
+        "currency": {
+          "type": "string",
+          "title": "币种",
+          "description": "单币种"
+        },
+        "min": {
+          "type": "number",
+          "title": "充值金额最小值",
+          "description": "充值金额最小值"
+        },
+        "max": {
+          "type": "number",
+          "title": "充值金额最大值",
+          "description": "充值金额最大值"
+        }
+      },
+      "required": [
+        "incomeTimeOrderBy"
+      ]
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "rechargeItemVoPage": {
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "integer",
+              "title": "总数",
+              "description": "总数",
+              "format": "int64"
+            },
+            "result": {
+              "type": "array",
+              "title": "本页条目",
+              "description": "本页条目",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "incomeTime": {
+                    "type": "string",
+                    "title": "入账时间",
+                    "description": "入账时间"
+                  },
+                  "paymentBankStatementId": {
+                    "type": "string",
+                    "title": "银行流水单号",
+                    "description": "银行流水单号"
+                  },
+                  "paymentTime": {
+                    "type": "string",
+                    "title": "打款时间",
+                    "description": "打款时间"
+                  },
+                  "paymentBankAccount": {
+                    "type": "string",
+                    "title": "打款银行账户",
+                    "description": "打款银行账户"
+                  },
+                  "incomeName": {
+                    "type": "string",
+                    "title": "收款方名称",
+                    "description": "收款方名称"
+                  },
+                  "incomeBankName": {
+                    "type": "string",
+                    "title": "收款方银行名称",
+                    "description": "收款方银行名称"
+                  },
+                  "paymentName": {
+                    "type": "string",
+                    "title": "打款方名称",
+                    "description": "打款方名称"
+                  },
+                  "incomeBankAccount": {
+                    "type": "string",
+                    "title": "平台收款方银行账户",
+                    "description": "平台收款方银行账户"
+                  },
+                  "paymentType": {
+                    "type": "string",
+                    "title": "充值方式",
+                    "description": "默认返回银行转账"
+                  },
+                  "paymentAmount": {
+                    "type": "string",
+                    "title": "充值金额",
+                    "description": "充值金额"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "title": "充值币种",
+                    "description": "充值币种"
+                  },
+                  "currencyName": {
+                    "type": "string",
+                    "title": "充值币种描述",
+                    "description": "充值币种描述"
+                  },
+                  "paymentRemark": {
+                    "type": "string",
+                    "title": "转账附言",
+                    "description": "操作附言|转账附言"
+                  },
+                  "rechargeStatementId": {
+                    "type": "string",
+                    "title": "平台充值入账单号",
+                    "description": "平台充值入账单号"
+                  },
+                  "feeAmount": {
+                    "type": "number",
+                    "title": "支付商手续费金额",
+                    "description": "支付商手续费金额"
+                  },
+                  "feeCurrency": {
+                    "type": "string",
+                    "title": "支付商手续费币种",
+                    "description": "支付商手续费币种"
+                  }
+                }
+              }
+            }
+          },
+          "title": "充值分页"
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-currency-amount",
+    "displayName": "币种可用额度",
+    "description": "按币种查各账户可用额度。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/currency/list/amount",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+currency-amount",
+    "risk": "read",
+    "summary": "币种可用额度",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "currency": {
+          "type": "string",
+          "description": "币种，如 USD"
+        }
+      },
+      "required": [
+        "currency"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "currency",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "币种，如 USD"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "array",
+      "title": "币种可用额度",
+      "description": "该币种下各账户可用额度",
+      "items": {
+        "type": "object",
+        "properties": {
+          "accountNo": {
+            "type": "string",
+            "title": "账户编号",
+            "description": "账户编号"
+          },
+          "currency": {
+            "type": "string",
+            "title": "币种",
+            "description": "USD / CNY / HKD / EUR / GBP / JPY"
+          },
+          "currencyName": {
+            "type": "string",
+            "title": "币种描述",
+            "description": "币种描述"
+          },
+          "amount": {
+            "type": "number",
+            "title": "金额",
+            "description": "金额"
+          },
+          "accountType": {
+            "type": "string",
+            "title": "账户分类",
+            "description": "CASH / REBATE / CREDIT"
+          },
+          "usdExchangeRate": {
+            "type": "number",
+            "title": "对美金汇率",
+            "description": "对美金汇率"
+          },
+          "usdAmount": {
+            "type": "number",
+            "title": "兑换美金金额",
+            "description": "兑换美金金额"
+          },
+          "currencySortWeight": {
+            "type": "number",
+            "title": "币种排序",
+            "description": "币种排序"
+          },
+          "accountTypeSortWeight": {
+            "type": "number",
+            "title": "币种户排序",
+            "description": "币种户排序"
+          }
+        }
+      }
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "wallet-exchange-rate",
+    "displayName": "币种汇率",
+    "description": "查 sourceCurrency 到 targetCurrency 的汇率。",
+    "group": "预付钱包",
+    "method": "GET",
+    "path": "/sino-wallet-pu/platform/wallet/currency/exchange/rate",
+    "timeout": 180000,
+    "tag": "预付钱包",
+    "domain": "wallet",
+    "shortcut": "+exchange-rate",
+    "risk": "read",
+    "summary": "币种汇率",
+    "docFile": "wallet-prepaid.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "sourceCurrency": {
+          "type": "string",
+          "description": "原始币种"
+        },
+        "targetCurrency": {
+          "type": "string",
+          "description": "目标币种"
+        }
+      },
+      "required": [
+        "sourceCurrency",
+        "targetCurrency"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "sourceCurrency",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "原始币种"
+        },
+        "explode": true
+      },
+      {
+        "name": "targetCurrency",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "目标币种"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "number",
+      "title": "汇率",
+      "description": "汇率"
+    },
+    "tenant": true,
+    "roleScope": [
+      "passport"
+    ]
+  },
+  {
+    "name": "common-file-upload",
+    "displayName": "上传文件",
+    "description": "上传单个私有文件，使用multipart/form-data，file为必填文件part。serviceName可选，未传或为空字符串时默认bc-business-pu，支持的服务名见参数枚举。\n\n上传文件不能为空，默认最大50MB（52428800字节，含边界），由Apollo配置file.upload.max-size控制。存储目录为服务名/yyyy-MM，文件名使用UUID并保留扩展名。上传返回的私有链接有效期默认3600秒，由file.download.url-expire-seconds控制。\n\n成功返回UploadFileResult，请保存result.storageKey供后续获取下载链接或关联业务记录使用。重复上传会生成新的存储文件。服务名非法、文件为空、文件超限、文件名为空或配置非正数时返回业务错误。本接口不要求业务签约主体参数。",
+    "group": "通用文件管理",
+    "method": "POST",
+    "path": "/bc-business-pu/file/fileUpload",
+    "timeout": 180000,
+    "tag": "通用文件管理",
+    "domain": "common-file",
+    "shortcut": "+upload",
+    "risk": "write",
+    "summary": "上传文件",
+    "docFile": "common-file.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "file": {
+          "description": "待上传文件，非空，默认最大50MB，以Apollo配置为准。",
+          "type": "string",
+          "format": "binary"
+        },
+        "serviceName": {
+          "type": "string",
+          "enum": [
+            "sino-icenter",
+            "sino-bc-nexus",
+            "sino-opti-hive",
+            "bc-business-pu",
+            "sino-data-analysis",
+            "sino-msg-notice-center",
+            "sino-wallet-pu-service",
+            "sino-ka"
+          ],
+          "default": "bc-business-pu",
+          "description": "来源服务；未传或为空字符串时默认bc-business-pu，用于存储目录隔离。",
+          "example": "bc-business-pu"
+        }
+      },
+      "required": [
+        "file"
+      ]
+    },
+    "requestContentType": "multipart/form-data",
+    "responseSchema": {
+      "type": "object",
+      "title": "文件上传结果",
+      "description": "UploadFileResult，额外链接字段由存储客户端配置决定。",
+      "properties": {
+        "storageKey": {
+          "type": "string",
+          "title": "文件存储Key",
+          "description": "云存储返回的文件标识，请原样保存；获取下载链接时传此值，不要传下载URL。"
+        },
+        "url": {
+          "type": "string",
+          "title": "文件访问链接",
+          "description": "临时私有访问链接，默认有效期3600秒，以Apollo配置为准。"
+        },
+        "cdnUrl": {
+          "type": "string",
+          "title": "CDN链接",
+          "description": "由云存储客户端返回，是否有值取决于存储配置。"
+        },
+        "internalUrl": {
+          "type": "string",
+          "title": "内网链接",
+          "description": "由云存储客户端返回，是否有值取决于存储配置。"
+        },
+        "accelerateUrl": {
+          "type": "string",
+          "title": "加速链接",
+          "description": "由云存储客户端返回，是否有值取决于存储配置。"
+        },
+        "documentPreviewUrl": {
+          "type": "string",
+          "title": "文档预览链接",
+          "description": "由云存储客户端返回，是否有值取决于存储配置及文件类型。"
+        },
+        "fileName": {
+          "type": "string",
+          "title": "存储文件名",
+          "description": "使用UUID生成的文件名，保留原文件最后一个扩展名；无扩展名文件也支持上传。"
+        }
+      }
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
+  },
+  {
+    "name": "common-file-download-url",
+    "displayName": "获取文件下载链接",
+    "description": "使用文件上传成功后返回的storageKey获取私有文件下载链接。storageKey必填且不能是空白字符串，请原样传入，不要传已有下载URL。\n\n成功时result直接返回URL字符串，不执行302重定向。有效期默认3600秒，由Apollo配置file.download.url-expire-seconds控制，与上传返回链接使用同一配置。链接失效后可重新调用本接口生成。生成失败、返回空链接或有效期配置非正数时返回业务错误。本接口不要求业务签约主体参数。",
+    "group": "通用文件管理",
+    "method": "GET",
+    "path": "/bc-business-pu/file/getUrlByKey",
+    "timeout": 180000,
+    "tag": "通用文件管理",
+    "domain": "common-file",
+    "shortcut": "+url",
+    "risk": "read",
+    "summary": "获取文件下载链接",
+    "docFile": "common-file.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "storageKey": {
+          "type": "string",
+          "description": "上传接口result.storageKey返回的文件标识，非空白字符串。"
+        }
+      },
+      "required": [
+        "storageKey"
+      ]
+    },
+    "queryParameters": [
+      {
+        "name": "storageKey",
+        "required": true,
+        "schema": {
+          "type": "string",
+          "description": "上传接口result.storageKey返回的文件标识，非空白字符串。"
+        },
+        "explode": true
+      }
+    ],
+    "responseSchema": {
+      "type": "string",
+      "title": "下载链接",
+      "description": "临时私有下载URL，默认有效期3600秒，以Apollo配置为准。",
+      "example": "https://example.com/private-file?signature=example"
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "system"
+    ]
   }
 ]