psbc-treasury-api（psbc treasury API 文档）

version: 1.0.0

author: tanghaowen

（司库系统）API 全生命周期管理智能 Skill

概述

本技能提供中国邮政储蓄银行财资管理系统统一前置平台的完整接口能力，包括：

• 📋 接口清单查询 - 列出所有可用 API
• 📖 接口规范详情 - HTTP 方法、请求路径、报文格式、响应结构
• 🔢 响应码查询 - 标准码与业务码的中英文说明
• 🧪 报文验证 - JSON Schema 校验、字段合法性检查
• 🔧 示例生成 - curl/Postman/Python 可运行示例
• 🎭 Mock 模拟 - 预设成功/失败响应、延迟、异常场景

使用场景

当用户询问以下内容时使用本技能：

1. "财资系统有哪些接口？"
2. "601113 接口怎么调用？"
3. "帮我生成一个支付接口的 curl 示例"
4. "验证这个请求报文是否正确"
5. "模拟一个余额查询的响应"
6. "ERR_INSUFFICIENT_BALANCE 是什么意思？"

核心能力

1. 接口清单

2. 接口规范

基础信息：

• 通讯方式：HTTPS + POST
• Content-Type：application/json;charset=UTF-8
• 字符编码：UTF-8

3. 报文结构

公共请求参数 (txComm)：

{
  "txComm": {
    "sysTrackNo": "32 位系统跟踪号",
    "reqSysCode": "12 位接入系统代码",
    "txCode": "6 位交易码",
    "txTime": "yyyyMMddHHmmssSSS",
    "securityLevel": "10 或 15",
    "sign": "签名值",
    "bankCertSN": "银行证书序列号 (安全级别 10 必输)",
    "userCertSN": "接入系统证书序列号",
    "encData": "报文密文 (安全级别 10 必输)",
    "encKey": "加密秘钥密文 (安全级别 10 必输)"
  }
}

4. 响应码

标准响应码：

业务响应码：

使用方法

查询接口列表

列出所有财资系统 API 接口

获取接口详情

601113 接口的详细规范
查询租户下直连账户列表的报文格式

生成示例代码

生成 601118 接口的 curl 示例
帮我写一个 Python 调用 601116 的代码

报文验证

验证这个请求报文是否正确：{...}
检查 601114 接口的 fileContent 字段格式

Mock 模拟

模拟一个 601118 余额查询的成功响应
模拟 601116 支付接口余额不足的错误响应

安全级别说明

安全级别 10：

• 使用国密证书对报文进行加密/解密、签名/验签
• SM4 随机秘钥对称加密业务报文
• 银行证书加密 SM4 秘钥

安全级别 15：

• 仅对报文进行签名/验签
• 不涉及报文加密/解密
• 业务报文平铺传输

注意事项

1. 系统跟踪号规则： 时间戳 (14 位) + 接入系统代码 (12 位) + 6 位唯一序列号
2. 签名顺序： sysTrackNo → reqSysCode → txCode → txTime → (encData) → (encKey)
3. 日期格式： 请求时间使用 yyyyMMddHHmmssSSS，业务日期使用 yyyyMMdd 或 yyyy-MM-dd
4. 金额精度： 保留 2 位小数，使用 D(20,2) 格式
5. 分页参数： pageSize 支持 1-100

相关文件

• apis.json - 完整接口定义与 JSON Schema
• response-codes.json - 响应码字典
• examples/ - 各接口示例报文
• validator.py - 报文验证工具
• mock.py - Mock 响应生成器

版本信息

• 文档版本：v1.2.5
• 更新日期：2026-03-04
• 技能版本：1.0.0