往来单位账号删除接口

说明

用户可以通过改接口删除维护在每刻系统中的往来单位账号。

接口限制

1. 同一往来单位下的银行账户信息存在重复的账号,支付宝账户信息存在重复的账号,现金账户存在重复的账户名,以靠后的数据为准。
2. 接口支持按照账户编码删除账号、以及账户编码参数之外的参数组合删除,如果一个请求参数两者都有,则优先按照账户编码删除。

接口地址

/api/openapi/tradingPartner/accounts

请求类型

DELETE

请求参数

参数说明

参数名称 类型 是否必填 参数说明
bizCode String(80) 是 往来单位编码
accounts List<Account> 是 往来单位账号

Account 往来单位账户

字段名称 字段类型 是否必填 字段说明
accountType String(20) 是 账户类型:
BANK 银行卡
ALIPAY 支付宝
CASH 现金
accountBizCode String(100) 条件必填 账户编码。传入后优先按该字段删除,accountName、accountNumber、bankName 均不再必填。
accountName String(100) 条件必填 未传 accountBizCode 时必填。BANK、ALIPAY 为账户名/户名;CASH 为现金账户名称。
accountNumber String(200) 条件必填 未传 accountBizCode 时,BANK 为银行卡号、ALIPAY 为支付宝账号,均必填;CASH 不需要传。
bankName String(200) 条件必填 未传 accountBizCode 且 accountType=BANK 时必填,填写银行名称。

删除账号可使用以下任一定位方式:

  1. 账户编码:传入 accountBizCode。
  2. 字段组合:不传 accountBizCode 时,BANK 必须传 accountName、accountNumber、bankName;ALIPAY 必须传 accountName、accountNumber;CASH 必须传 accountName。

参数样例

使用账户编码删除:

{
  "bizCode": "bizCode",
  "accounts": [
    {
      "accountType": "BANK",
      "accountBizCode": "BANKBIZCODE"
    }
  ]
}

使用字段组合删除:

{
  "bizCode": "bizCode",
  "accounts": [
    {
      "accountType": "CASH",
      "accountName": "1234"
    },
    {
      "accountType": "ALIPAY",
      "accountNumber": "1234",
      "accountName": "支付宝"
    },
    {
      "accountType": "BANK",
      "accountNumber": "123456789",
      "accountName": "bankAccountName",
      "bankName": "工商银行"
    }
  ]
}

响应参数

响应参数说明

参数名称 类型 是否必填 参数说明
businessCode String(80) 是 往来单位编码
status String(20) 是 删除结果,
SUCCESS 成功
PART_FAIL 部分失败
ALL_FAIL 全部失败
message String(100) 是 结果描述

参数样例

  1. 正常响应参数示例
    {
    "code": "ACK",
    "message": "操作成功",
    "data": {
     "hasErrorMsg":false,
     "errorMsgDetail":[]
    }
    }
    
    2.存在收款账户错误时的异常数据示例: 错误的数据会返回 NACK 及对应的可读错误信息。因为往来单位有多个账户,账户的错误信息会在信息前加 account[index],每个账户的错误信息使用英文逗号 , 隔开。 ```json { "code": "NACK", "message": "保存失败", "data": { "hasErrorMsg": true, "errorMsgDetail": [ {
     "bizCode": "bizCode",
     "errorMsg": [
       "account[0]账号不能为空,银行名称不能为空"
     ]
    
    } ] } }

## 修改记录
```text
2023-02-08  新增往来单位账户删除接口文档
2026-08-11  明确删除账号的条件必填字段及失败响应
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""