accountingbank/add
目录 |
1.接口说明
1.1接口描述
新增一张本单位开户银行
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/accountingbank/add |
| 格式 | JSON |
| https请求方式 | POST |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| from_account | string | 是 | 调用方id |
| to_account | string | 是 | 提供方id |
| app_key | string | 是 | 应用编码 |
| token | string | 是 | api调用唯一识别码 |
| tradeid | string | 是 | 交易唯一识别码，tradeid与biz_id只能传入一个 |
| ds_sequence | number | 否 | 数据源序号（默认取应用的第一个数据源） |
| biz_id | string | 是 | 上游id，需要保证biz_id与ERP主键唯一对应关系，tradeid与biz_id只能传入一个 |
| sync | number | 否 | 0=异步新增（默认）;1=同步新增; |
3.3请求体参数说明
| 参数 | 类型 | 参数路径 | 是否必填 | 描述 |
|---|---|---|---|---|
| code | string | 否 | 银行编号 | |
| name | string | 否 | 开户银行名称 | |
| account | string | 否 | 银行帐号 | |
| flag | boolean | 否 | 暂封标志 | |
| cbankcode | string | 否 | 所属银行 | |
| caccname | string | 否 | 账户名称 | |
| copenaccaddr | string | 否 | 开户银行地址 | |
| cprovincename | string | 否 | 省/自治区 | |
| ccountyname | string | 否 | 市/县 | |
| ccurrencyname | string | 否 | 币种 | |
| dopenaccdate | date | 否 | 开户日期 | |
| ccustomerno | string | 否 | 客户编号 | |
| corgno | string | 否 | 机构号 | |
| cunionbankno | string | 否 | 联行号 | |
| isignflag | number | 否 | 签约标志 | |
| bpwdmng | boolean | 否 | 进行密码管理 | |
| iCcbAccountType | number | 否 | 建行账号属性 | |
| cTradeAddCode | string | 否 | 交易代码 | |
| iAccProperty | number | 否 | 账户属性 | |
| cCode | string | 否 | 对应科目 | |
| fCurBalance | number | 否 | 当前余额 | |
| cBankDefine1 | string | 否 | 自定义项1 | |
| cBankDefine2 | string | 否 | 自定义项2 | |
| cBankDefine3 | string | 否 | 自定义项3 | |
| cBankDefine4 | string | 否 | 自定义项4 | |
| cBankDefine5 | string | 否 | 自定义项5 | |
| cBankDefine6 | string | 否 | 自定义项6 | |
| cBankDefine7 | string | 否 | 自定义项7 | |
| cBankDefine8 | string | 否 | 自定义项8 | |
| cBankDefine9 | string | 否 | 自定义项9 | |
| cBankDefine10 | string | 否 | 自定义项10 | |
| cBankDefine11 | number | 否 | 自定义项11 | |
| cBankDefine12 | number | 否 | 自定义项12 | |
| cBankDefine13 | number | 否 | 自定义项13 | |
| cBankDefine14 | number | 否 | 自定义项14 | |
| cBankDefine15 | date | 否 | 自定义项15 | |
| cBankDefine16 | date | 否 | 自定义项16 |
3.4请求示例
POST https://api.yonyouup.com/api/accountingbank/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
POST 内容：
{
"accountingbank":{
"code":"03",
"name":"中国银行",
"account":"28909992338123",
"cbankcode":"00002",
"ccurrencyname":"人民币",
"corgno":"001",
"cunionbankno":"002"
}
}
3.5返回参数说明
| 参数说明 | 类型 | 描述 |
|---|---|---|
| errcode | string | 错误码，0 为正常。 |
| errmsg | string | 错误信息。 |
| id | string | 新增成功后返回新开户银行编号。 |
| tradeid | string | 新增成功后返回交易唯一识别码 |
3.6正确返回示例
JSON示例:
{
"tradeid": "158f3f05730711e591c702004c4f4f50",
"ping_after": "3",
"url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
}
上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果，结果格式如下：
{
"errcode" : "0",
"errmsg" : "",
"id" : "883",
"tradeid" : "158f3f05730711e591c702004c4f4f50"
}
3.7错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}