粒粒通金融服务平台 API 文档

Appearance

批量创建采购商 ​

接口说明 ​

批量注册企业(采购商)并加入指定项目

接口地址 ​

POST /api/member/create/batch

请求参数 (data 解密后) ​

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

字段说明 ​

字段名类型必填说明
transactionIdString是幂等ID，用于防止重复提交
batchRequestsArray是采购商信息列表
batchRequests[].memberTypeInteger是成员类型：1-企业，2-个体工商户
batchRequests[].certificateTypeInteger是证件类型：1-营业执照
batchRequests[].certificateNoString(32)是证件号码（社会信用代码/营业执照号）
batchRequests[].certificateNameString(100)否企业名称
batchRequests[].certificateFrontLong是证件附件资源ID（通过文件上传接口获取）
batchRequests[].bankCodeString(50)否开户行联行号（企业必填，个体工商户可选）
batchRequests[].bankNameString(100)否开户银行名称（企业必填，个体工商户可选）
batchRequests[].bankCardNameString(150)否银行开户名（企业必填，个体工商户可选）
batchRequests[].bankCardNoString(32)否银行卡号（企业必填，个体工商户可选）
batchRequests[].contactNameString(32)是收件人
batchRequests[].contactPhoneString(20)是收件人联系电话（11位数字）
batchRequests[].contactAddressString(200)是地址（长度应在5-200之间）
batchRequests[].contactPostCodeString(10)否邮编
batchRequests[].contactEmailString(32)否邮箱
batchRequests[].authorizerNameString(50)否法人姓名
batchRequests[].authorizerPhoneString(20)是法定代表人手机号（11位数字）
batchRequests[].authorizerIdTypeInteger是法人证件类型：2-身份证
batchRequests[].authorizerIdNoString(20)是法定代表人证件号码
batchRequests[].authorizerIdStartDateString是法人证件开始日期（格式：yyyy-MM-dd）
batchRequests[].authorizerIdEndDateString是法人证件结束日期（格式：yyyy-MM-dd）
batchRequests[].authorizerIdFrontLong是法人身份证正面资源ID（通过文件上传接口获取）
batchRequests[].authorizerIdBackLong是法人身份证反面资源ID（通过文件上传接口获取）
batchRequests[].operatorsArray是操作员列表（注册时固定传法定代表人信息）
batchRequests[].operators[].operatorTypeInteger是操作员类型：1-法人，2-经办员，3-复核员，4-授权员
batchRequests[].operators[].operatorNameString(50)是操作员姓名
batchRequests[].operators[].operatorPhoneString(20)是操作员手机号（11位数字）
batchRequests[].operators[].operatorIdCardString(20)否操作员身份证号
batchRequests[].projectIdLong否项目ID（壹药网项目必传）
batchRequests[].risExtendString否风控扩展信息（JSON字符串，可以参考授信项的KEY，以及其他约定信息）
batchRequests[].outerBusinessIdString(64)是业务流水ID（用于幂等控制，每笔业务唯一）

枚举值说明 ​

成员类型 (memberType) ​

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

企业证件类型 (certificateType) ​

代码说明
1营业执照

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

法人证件类型 (authorizerIdType) ​

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

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

操作员类型 (operatorType) ​

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

注意：注册时操作员列表固定传法定代表人信息，即 operatorType = 1

响应参数 (data 解密后) ​

json
{
  "batchResponses": [
    {
      "code": 0,
      "message": "创建成功",
      "memberId": 1000001,
      "certificateNo": "91110000XXXXXXXXXX",
      "outerBusinessId": "BIZ20250111001"
    }
  ]
}

响应字段说明 ​

字段名类型说明
batchResponsesArray批量创建响应列表
batchResponses[].codeInteger响应码：0-成功，非0-失败
batchResponses[].messageString结果信息
batchResponses[].memberIdLong采购商成员ID
batchResponses[].certificateNoString证件号码
batchResponses[].outerBusinessIdString业务流水ID

业务规则 ​

  1. certificateNo 和 outerBusinessId 不能重复
  2. 同一批次内不能有重复的 certificateNo 或 outerBusinessId
  3. 个体工商户(memberType=2)的银行账户信息可选
  4. transactionId 用于防止重复提交，outerBusinessId 用于业务唯一标识
  5. 操作员身份证号(operatorIdCard)为可选字段

测试数据 ​

注意：以下数据仅可用于测试环境测试企业实名认证流程，实名过程中的法定代表人信息填写测试人员本人的信息即可。

可用测试企业列表 ​

企业名称统一社会信用代码
aqtest南京一粒沙科技有限公司FOTC532419MABMXDE1X3
aqtest南京一粒沙科技有限公司GFTC203472MABMXDE1XN
aqtest南京一粒沙科技有限公司SCTC644422MABMXDE1X1
aqtest南京一粒沙科技有限公司HHTC162037MABMXDE1X2
aqtest南京一粒沙科技有限公司RHTC619553MABMXDE1XL
aqtest南京一粒沙科技有限公司TYTC484800MABMXDE1XW
aqtest南京一粒沙科技有限公司VHTC860982MABMXDE1XU
aqtest南京一粒沙科技有限公司RJTC192070MABMXDE1X7

使用方式 ​

  1. 选择测试企业：从上表中选择任意一家测试企业
  2. 填写企业信息：
    • certificateName: 使用表中的企业名称（如：aqtest南京一粒沙科技有限公司FO）
    • certificateNo: 使用对应的统一社会信用代码（如：TC532419MABMXDE1X3）
  3. 填写法人信息：
    • authorizerName: 填写测试人员本人的真实姓名
    • authorizerPhone: 填写测试人员本人的手机号
    • authorizerIdNo: 填写测试人员本人的身份证号
  4. 其他信息：其他字段可按实际情况填写或使用模拟数据

测试示例 ​

json
{
  "transactionId": "TEST20250111001",
  "batchRequests": [
    {
      "memberType": 1,
      "certificateType": 1,
      "certificateNo": "TC532419MABMXDE1X3",
      "certificateName": "aqtest南京一粒沙科技有限公司FO",
      "certificateFront": 123456789,
      "bankCode": "102100099996",
      "bankName": "中国工商银行北京分行",
      "bankCardName": "aqtest南京一粒沙科技有限公司FO",
      "bankCardNo": "6222021234567890123",
      "contactName": "张三",
      "contactPhone": "13812345678",
      "contactAddress": "北京市朝阳区某某街道某某大厦",
      "contactPostCode": "100000",
      "contactEmail": "test@example.com",
      "authorizerName": "张三",
      "authorizerPhone": "13812345678",
      "authorizerIdType": 2,
      "authorizerIdNo": "110101199001011234",
      "authorizerIdStartDate": "2020-01-01",
      "authorizerIdEndDate": "2030-12-31",
      "authorizerIdFront": 123456790,
      "authorizerIdBack": 123456791,
      "operators": [
        {
          "operatorType": 1,
          "operatorName": "张三",
          "operatorPhone": "13812345678",
          "operatorIdCard": "110101199001011234"
        }
      ],
      "projectId": 1,
      "risExtend": "{}",
      "outerBusinessId": "TEST_BIZ20250111001"
    }
  ]
}

重要提示：

  • ⚠️ 测试数据仅限测试环境使用，请勿在生产环境使用
  • ⚠️ 每个测试企业的统一社会信用代码是唯一的，创建成功后不可重复创建
  • ⚠️ 法人信息（姓名、身份证、手机号）必须使用测试人员本人的真实信息

粒粒通金融服务平台 API 文档

Copyright © 2025 - 2055