注册类接口

企业注册

场景：服务商调用当前接口实现企业注册数字农人平台。

调用方法B2CCustomer.apply

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CCustomer;
import com.gc365.sznr.sdk.model.b2c.CustomerApplyParam;

CustomerApplyParam param = CustomerApplyParam.builder()
    // 设置企业信息
    .build();

CustomerApply result = B2CCustomer.apply(param);

POST/open-api/customer/apply

请求参数 Body

namestring必需

企业名称

最大长度 100

creditCodestring必需

社会信用代码

长度 18

registerProvinceIdstring必需

企业注册省份 code，与城市和地区配合使用，参考全国地区编码

registerCityIdstring必需

企业注册城市 code，与省份和地区配合使用，参考全国地区编码

registerDistrictIdstring必需

企业注册地区 code，与省份和城市配合使用，参考全国地区编码

registerAddressstring可选

企业注册详细地址

最大长度 100

taxOrgansstring必需

省市级税务机关编码，传代号如 BEIJING，参考税务机关编码

最大长度 10

businessLicensestring必需

营业执照，上传文件 URL 地址

sceneRemarkstring必需

业务场景说明，自定义说明当前的情况，可为「无」

最大长度 100

contactTypeenum<string>必需

企业联系人类型

最大长度 10

枚举值:

LEGAL企业法人

FINANCE财务负责人

contactNamestring必需

企业联系人姓名

最大长度 60

contactPhonestring必需

企业联系人手机号

最大长度 20

applyNamestring必需

申请人姓名

最大长度 60

applyCardNostring必需

申请人身份证号

最大长度 60

applyPhonestring必需

申请人手机号

最大长度 20

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataobject可选

数据接口，有就返回结果，没有就为空

查询企业注册结果

场景：按照纳税人识别号查询企业注册数字农人平台的状态。

调用方法B2CCustomer.result

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CCustomer;
import com.gc365.sznr.sdk.model.b2c.CustomerResultParam;

CustomerResultParam param = CustomerResultParam.builder()
    // 设置查询参数
    .build();

CustomerResult result = B2CCustomer.result(param);

POST/open-api/customer/result

请求参数 Body

creditCodestring必需

纳税人识别号

长度 18

响应参数

msgstring可选

返回成功或者失败结果提示语

codeinteger必需

响应码，200 表示调用接口正常

dataobject必需

数据体

namestring必需

企业名称

creditCodestring必需

企业税号

taxOrgansstring必需

省市级税务机关编码，参考税务机关编码

businessLicensestring必需

营业执照下载地址

sceneRemarkstring可选

业务场景说明

contactTypeenum<string>必需

企业联系人类型

枚举值:

LEGAL企业法人

FINANCE财务负责人

contactNamestring必需

企业联系人姓名

contactPhonestring必需

企业联系人手机号

applyNamestring必需

申请人姓名

applyCardNostring必需

申请人身份证号

applyPhonestring必需

申请人手机号

registerProvinceIdstring必需

企业注册省份 code，参考全国地区编码

registerCityIdstring必需

企业注册城市 code，参考全国地区编码

registerDistrictIdstring必需

企业注册地区 code，参考全国地区编码

registerAddressstring可选

企业详细地址

statusenum<string>必需

入驻状态

枚举值:

NOT_AUDIT待审核

SUCCESS成功

FAIL失败

failReasonstring可选

入驻失败驳回理由

最大长度 200

accessStatueenum<string>可选

乐企入驻状态，申请乐企后才返回

枚举值:

01已接入

02待审批

03待商户接入确认

04待商户能力授权确认

05待商户开票员登记

06待商户开票员确认

07待商户开票安全设置

08未接入

09不可开票

10接入失败

bankStatusenum<string>可选

开户行状态

枚举值:

OPENING开通中

TOBE_AUTH待授权

OPEN_FAIL开通失败

NORMAL正常

ABNORMAL异常

bankAccountstring可选

企业的开户银行账号

accessFailMessagestring可选

乐企接入失败原因

最大长度 200

industryEndTimedate可选

行业性质有效期

格式 yyyy-MM-dd

applyStatusenum<string>可选

申请状态

枚举值:

APPLYMENT_STATE_EDITTING编辑中

APPLYMENT_STATE_SUBMITTING提交中

APPLYMENT_STATE_SUBMIT_FAILED提交失败

APPLYMENT_STATE_AUDITING审核中

APPLYMENT_STATE_REJECTED已驳回

APPLYMENT_STATE_TO_BE_CONFIRMED待账户验证

APPLYMENT_STATE_TO_BE_SIGNED待签约

APPLYMENT_STATE_SIGNING开通权限中

APPLYMENT_STATE_FINISHED已完成

APPLYMENT_STATE_CANCELED已作废

payStateenum<string>可选

微信支付授权状态

枚举值:

AUTHORIZED已授权

UNAUTHORIZED未授权

EXPIRED授权已过期

CANCELED授权已解除

merchantNostring可选

微信支付商户号（待签约、未授权、已完成的状态下是有值的）

authDatestring可选

乐企安全时间有效期

邀请企业绑定应用

场景：服务商邀请采购商绑定应用，绑定关系初始状态为「待确认」，需采购商确认后生效。

调用方法B2CCustomer.inviteBind

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CCustomer;
import com.gc365.sznr.sdk.model.b2c.CustomerInviteBindParam;

CustomerInviteBindParam param = CustomerInviteBindParam.builder()
    // 设置绑定参数
    .build();

B2CCustomer.inviteBind(param);

POST/open-api/customer/invite-bind

请求参数 Body

customerNamestring必需

采购商名称

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataobject可选

数据体，无返回数据

注册农户

场景：服务商业务系统跳转打通数字农人的农户数据，支持第三方小程序通过 wx.navigateToMiniProgram 接口跳转到数字农人小程序进行农户身份认证与绑定。

流程

[第三方小程序]
    ↓ 调用 wx.navigateToMiniProgram
[数字农人小程序]
    ↓ 用户填写身份信息
[身份验证]
    ↓ 验证成功
[实名注册]
    ↓ 注册完成
[用户完成操作]

配置

在微信公众平台后台配置相关业务域名，确保可以正常跳转到数字农人小程序（AppId：wx3ea1cec562e22285）。

请求参数

参数	类型	必填	说明
appId	String	是	数字农人小程序 AppId：wx3ea1cec562e22285
envVersion	String	否	版本类型：develop（开发版）、trial（体验版）、release（正式版）
path	String	是	跳转路径：/pages/authentication/personAuth
extraData	Object	-	传递给目标小程序的数据
extraData.idcardName	String	否	预填姓名
extraData.idcardNo	String	否	预填身份证号
extraData.phone	String	否	预填手机号
extraData.externalIdentityId	String	否	服务商系统的农户 ID
extraData.serviceId	String	是	服务商 ID
extraData.appId	String	是	服务商应用 ID
extraData.sign	String	是	服务商签名
extraData.timeStamp	String	是	时间戳

请求示例

wx.navigateToMiniProgram({
  appId: "wx3ea1cec562e22285",
  envVersion: "trial",
  path: "/pages/authentication/personAuth",
  extraData: {
    idcardName: "张三",
    idcardNo: "5002***********",
    phone: "15***********",
    externalIdentityId: "123",
    serviceId: "10002",
    appId: "snanu9xbkkaukqbdtj",
    sign: "3046022100e32324df...7ee7b8abef",
    timeStamp: "222323245"
  },
  success: function(res) {
    console.log('跳转成功', res);
  },
  fail: function(err) {
    console.error('跳转失败', err);
  }
});

查询农户数农码

场景：查询获取农户的数农码以及农户实名、是否授权自动收款、收款方式等，可通过本接口获取。

调用方法B2CSupplier.querySupplierInfo

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CSupplier;
import com.gc365.sznr.sdk.model.b2c.SupplierQueryParam;

SupplierQueryParam param = SupplierQueryParam.builder()
    // 设置查询条件
    .build();

SupplierInfo supplier = B2CSupplier.querySupplierInfo(param);

POST/open-api/supplier/querySupplierInfo

请求参数 Body

snCodestring可选

数农码编号，与身份证、外部 ID、手机号四选一

cardNostring可选

身份证号，与数农码编号、外部 ID、手机号四选一

externalIdentityIdstring可选

外部 ID，业务系统传给数字农人的用户 ID，与数农码编号、身份证号、手机号四选一

phonestring可选

手机号，农户注册数字农人的手机号，与数农码编号、身份证号、外部 ID 四选一

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataobject必需

农户数据

snCodestring必需

数农码编号

qrCodeUrlstring必需

数农码二维码链接地址（二维码规则：https://shunong.gc365.com/sn/{snCode}）

receivePayTypesenum<array[string]>必需

农户收款支持方式

枚举值:

WX_PAY微信支付

BANK_CARD银行卡

autoReceiveenum<string>必需

是否授权自动收款

枚举值:

01已授权

02未授权

isUserInfoPassedenum<string>必需

微信是否实名

枚举值:

01是

02否

externalIdentityIdstring可选

外部 ID，业务系统传给数字农人的用户 ID；若供应商未通过小程序跳转绑定，此字段为空

phonestring可选

手机号，查询参数为手机号时返回

cardNostring可选

身份证号码，查询参数为身份证号码时返回

批量查询农户数农码

场景：批量查询获取农户的数农码以及农户实名、是否授权自动收款、收款方式等信息，支持按数农码、身份证号、外部 ID、手机号多种条件组合批量查询。

调用方法B2CSupplier.batchQuerySupplierInfo

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CSupplier;
import com.gc365.sznr.sdk.model.b2c.SupplierBatchQueryParam;
import java.util.List;

SupplierBatchQueryParam param = SupplierBatchQueryParam.builder()
    // 设置批量查询条件
    .build();

List<SupplierInfo> suppliers = B2CSupplier.batchQuerySupplierInfo(param);

POST/open-api/supplier/batchQuerySupplierInfo

请求参数 Body

snCodesarray[string]可选

数农码列表，与身份证列表、外部 ID 列表、手机号列表至少传一项

cardNosarray[string]可选

身份证号列表，与数农码列表、外部 ID 列表、手机号列表至少传一项

externalIdentityIdsarray[string]可选

外部 ID 列表，业务系统传给数字农人的用户 ID，与数农码列表、身份证号列表、手机号列表至少传一项

phonesarray[string]可选

手机号列表，农户注册数字农人的手机号，与数农码列表、身份证号列表、外部 ID 列表至少传一项

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataarray[object]必需

农户数据列表

snCodestring必需

数农码编号

qrCodeUrlstring必需

数农码二维码链接地址（二维码规则：https://shunong.gc365.com/sn/{snCode}）

receivePayTypesenum<array[string]>必需

农户收款支持方式

枚举值:

WX_PAY微信支付

BANK_CARD银行卡

autoReceiveenum<string>必需

是否授权自动收款

枚举值:

01已授权

02未授权

isUserInfoPassedenum<string>必需

微信是否实名

枚举值:

01是

02否

externalIdentityIdstring可选

外部 ID，业务系统传给数字农人的用户 ID；若供应商未通过小程序跳转绑定，此字段为空

phonestring可选

手机号，查询参数为手机号时返回

cardNostring可选

身份证号码，查询参数为身份证号码时返回

使用说明

• 四个查询参数列表中至少传一项，支持多条件组合查询
• 所有查询参数的总条数不能超过 500 条
• 多条件查询时，结果会自动去重，同一农户只返回一条记录

注册经纪人

场景：经纪人通过服务商系统跳转数字农人注册经纪人用户，支持第三方小程序通过 wx.navigateToMiniProgram 接口跳转到数字农人小程序进行身份认证与绑定。

流程

[第三方小程序]
    ↓ 调用 wx.navigateToMiniProgram
[数字农人小程序]
    ↓ 用户填写身份信息
[身份验证]
    ↓ 验证成功
[实名注册]
    ↓ 注册完成
[用户完成操作]

配置

在微信公众平台后台配置相关业务域名，确保可以正常跳转到数字农人小程序（AppId：wxe72008b1103bf2c7）。

请求参数

参数	类型	必填	说明
appId	String	是	数字农人经纪端小程序 AppId：wxe72008b1103bf2c7
envVersion	String	否	版本类型：develop（开发版）、trial（体验版）、release（正式版）
path	String	是	跳转路径：/pages/authentication/personAuth
extraData	Object	-	传递给目标小程序的数据
extraData.idcardName	String	否	预填姓名
extraData.idcardNo	String	否	预填身份证号
extraData.phone	String	否	预填手机号
extraData.externalIdentityId	String	否	服务商系统的经纪人 ID
extraData.serviceId	String	是	服务商 ID
extraData.appId	String	是	服务商应用 ID
extraData.sign	String	是	服务商签名
extraData.timeStamp	String	是	时间戳

请求示例

wx.navigateToMiniProgram({
  appId: "wxe72008b1103bf2c7",
  envVersion: "trial",
  path: "/pages/authentication/personAuth",
  extraData: {
    idcardName: "张三",
    idcardNo: "5002***********",
    externalIdentityId: "123",
    serviceId: "10002",
    appId: "snanu9xbkkaukqbdtj",
    sign: "3046022100e32324df...7ee7b8abef",
    timeStamp: "222323245"
  },
  success: function(res) {
    console.log('跳转成功', res);
  },
  fail: function(err) {
    console.error('跳转失败', err);
  }
});

查询企业采购经纪人

场景：查询企业下所有的采购经纪人，包含内部采购和外协采购，一个企业下存在多个采购经纪人，通过此接口可获取到经纪人的基本信息。

调用方法B2CCustomerAgent.getCustomerAgentList

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CCustomerAgent;
import com.gc365.sznr.sdk.model.b2c.CustomerAgentQueryParam;
import java.util.List;

CustomerAgentQueryParam param = CustomerAgentQueryParam.builder()
    // 设置查询条件
    .build();

List<CustomerAgent> agents = B2CCustomerAgent.getCustomerAgentList(param);

POST/open-api/customer/agent/getCustomerAgentList

请求参数 Body

companyNamestring必需

企业名称

taxNostring必需

企业税号

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataarray[object]必需

经纪人列表

namestring必需

经纪人姓名

phonestring必需

经纪人手机号

cardNostring必需

经纪人身份证号

okboolean必需

是否成功

查询经纪人关联企业

场景：查询经纪人跟企业绑定情况，一个经纪人可能会绑定多个企业。支持批量查询。

调用方法B2CCustomerAgent.getCustomerAgentCompanyList

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CCustomerAgent;
import com.gc365.sznr.sdk.model.b2c.CustomerAgentCompanyQueryParam;
import java.util.List;

CustomerAgentCompanyQueryParam param = CustomerAgentCompanyQueryParam.builder()
    // 设置查询条件
    .build();

List<CustomerAgentCompany> companies = B2CCustomerAgent.getCustomerAgentCompanyList(param);

POST/open-api/customer/agent/getCustomerAgentCompanyList

请求参数 Body

externalAgentIdstring可选

业务方经纪人 ID，经纪人在外部服务商的业务系统用户 ID，跟手机号二选一

externalAgentPhonestring可选

经纪人手机号，经纪人在外部业务系统的手机号，跟经纪人 ID 二选一

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

dataarray[object]必需

企业列表

companyNamestring必需

企业名称

taxNostring必需

企业税号

okboolean必需

是否成功

requestIdstring必需

请求流水号

邀请经纪人

场景：服务商调用当前接口实现邀请经纪人。

调用方法B2CAgent.inviteAgent

SDK 示例（Java）

import com.gc365.sznr.sdk.api.b2c.B2CAgent;
import com.gc365.sznr.sdk.model.b2c.AgentInviteParam;

AgentInviteParam param = AgentInviteParam.builder()
        // 设置请求条件
        .build();

Boolean whetherInvite = B2CAgent.inviteAgent(param);

POST/open-api/agent/invite

请求参数 Body

taxNostring必需

税号

namestring必需

被邀请经纪人姓名

phonestring必需

被邀请经纪人手机号

cardNostring必需

被邀请经纪人身份证号码

accountTypestring必需

账户类型 INTERNAL为内部账户 MARGIN为保证金账户

ruleTypestring必需

交易佣金规则类型 ORDER_AMOUNT为按订单金额 TRADE_UNIT为按交易单位 ORDER_COUNT为按订单笔数

commissionRatiobigDecimal必需

佣金比例

commissionRulesarray[object]必需

佣金规则配置列表

ruleTypestring必需

交易佣金规则类型 ORDER_AMOUNT为按订单金额 TRADE_UNIT为按交易单位 ORDER_COUNT为按订单笔数

ruleUnitstring必需

单位

ruleValuebigDecimal必需

规则值

goodTypeIdlong必需

商品类目ID

响应参数

msgstring可选

错误消息

codeinteger必需

响应码，200 表示正常

databoolean可选

true 表示邀请成功，false 表示邀请失败