批量修改采购商

接口说明

批量修改企业(采购商)信息并加入指定项目

接口地址

POST /api/member/modify/batch

请求参数 (data 解密后)

{
  "transactionId": "TXN20250111002",
  "batchRequests": [
    {
      "memberId": 1000001,
      "certificateName": "某某科技有限公司",
      "certificateFront": 123456789,
      "bankCode": "102100099996",
      "bankName": "中国工商银行北京分行",
      "bankCardName": "某某科技有限公司",
      "bankCardNo": "6222021234567890123",
      "contactName": "张三",
      "contactPhone": "13812345678",
      "contactAddress": "北京市朝阳区某某街道某某大厦",
      "contactPostCode": "100000",
      "contactEmail": "contact@example.com",
      "authorizerName": "张三",
      "authorizerPhone": "13912345678",
      "authorizerIdStartDate": "2020-01-01",
      "authorizerIdEndDate": "2030-12-31",
      "authorizerIdFront": 123456790,
      "authorizerIdBack": 123456791,
      "operators": [
        {
          "operatorType": 1,
          "operatorName": "张三",
          "operatorPhone": "13912345678",
          "operatorIdCard": "110101199001011234"
        }
      ],
      "projectId": 1,
      "risExtend": "{}",
      "outerBusinessId": "BIZ20250111002"
    }
  ]
}

字段说明

字段名	类型	必填	说明
transactionId	String	是	幂等ID，用于防止重复提交
batchRequests	Array	是	采购商信息列表
batchRequests[].memberId	Long	是	成员ID（必传，用于识别要修改的成员）
batchRequests[].certificateName	String(100)	否	企业名称
batchRequests[].certificateFront	Long	否	证件附件资源ID（通过文件上传接口获取）
batchRequests[].bankCode	String(50)	否	开户行联行号
batchRequests[].bankName	String(100)	否	开户银行名称
batchRequests[].bankCardName	String(150)	否	银行开户名
batchRequests[].bankCardNo	String(32)	否	银行卡号
batchRequests[].contactName	String(32)	否	收件人
batchRequests[].contactPhone	String(20)	否	收件人联系电话（11位数字）
batchRequests[].contactAddress	String(200)	否	地址（长度应在5-200之间）
batchRequests[].contactPostCode	String(10)	否	邮编
batchRequests[].contactEmail	String(32)	否	邮箱
batchRequests[].authorizerName	String(50)	否	法人姓名
batchRequests[].authorizerPhone	String(20)	否	法定代表人手机号（11位数字）
batchRequests[].authorizerIdStartDate	String	否	法人证件开始日期（格式：yyyy-MM-dd）
batchRequests[].authorizerIdEndDate	String	否	法人证件结束日期（格式：yyyy-MM-dd）
batchRequests[].authorizerIdFront	Long	否	法人身份证正面资源ID（通过文件上传接口获取）
batchRequests[].authorizerIdBack	Long	否	法人身份证反面资源ID（通过文件上传接口获取）
batchRequests[].operators	Array	是	操作员列表（注册时固定传法定代表人信息）
batchRequests[].operators[].operatorType	Integer	是	操作员类型：1-法人，2-经办员，3-复核员，4-授权员
batchRequests[].operators[].operatorName	String(50)	是	操作员姓名
batchRequests[].operators[].operatorPhone	String(20)	是	操作员手机号（11位数字）
batchRequests[].operators[].operatorIdCard	String(20)	否	操作员身份证号
batchRequests[].projectId	Long	否	项目ID（壹药网项目必传）
batchRequests[].risExtend	String	否	风控扩展信息（JSON字符串，可以参考授信项的KEY，以及其他约定信息）
batchRequests[].outerBusinessId	String(64)	是	业务流水ID（用于幂等控制，每笔业务唯一）

枚举值说明

成员类型 (memberType)

代码	说明
1	企业
2	个体工商户

企业证件类型 (certificateType)

代码	说明
1	营业执照

说明：企业/个体工商户的证件类型，目前只支持营业执照

法人证件类型 (authorizerIdType)

代码	说明
2	身份证
3	护照（预留）
4	军官证（预留）

说明：法定代表人的证件类型，目前只支持身份证

操作员类型 (operatorType)

代码	说明
1	法人
2	经办员
3	复核员
4	授权员

注意：操作员列表会先删除后新增（全量替换）

响应参数 (data 解密后)

{
  "batchResponses": [
    {
      "code": 0,
      "message": "修改成功",
      "memberId": 1000001,
      "outerBusinessId": "BIZ20250111002"
    }
  ]
}

响应字段说明

字段名	类型	说明
batchResponses	Array	批量修改响应列表
batchResponses[].code	Integer	响应码：0-成功，非0-失败
batchResponses[].message	String	结果信息
batchResponses[].memberId	Long	采购商成员ID
batchResponses[].outerBusinessId	String	业务流水ID

业务规则

1. 必传字段：memberId（用于识别要修改的成员）、outerBusinessId（用于幂等控制）
2. 不可修改字段：memberType（成员类型）、certificateType（证件类型）、certificateNo（证件号码）、authorizerIdType（法人证件类型）、authorizerIdNo（法人证件号码）等创建时的关键字段不可修改
3. 可选修改字段：除 memberId 和 outerBusinessId 外的所有字段都是可选的，只传需要修改的字段即可
4. 操作员列表：如果传入 operators，会先删除后新增（全量替换）
5. 幂等控制：transactionId 用于防止重复提交，outerBusinessId 用于业务唯一标识