新增货主

请求地址

https://www.xxyb.cn/union/api/wlpt/consignor/createOwner

Header

参数名	必选	类型	说明
Token	是	string	应用令牌
cid	是	string	合作ID

请求参数

参数名	必选	类型	层级	说明	备注
ownerPhone	是	string	1	货主手机号
ownerAuthDomain	是	object	1	货主认证信息
businessLicense	是	string	2	营业执照URL
enterpriseName	是	string	2	企业名称
creditCode	是	string	2	统一社会信用代码
enterpriseType	否	string	2	企业类型
enterpriseAddr	否	string	2	注册地址
registeredCapital	否	decimal	2	注册资本（万元）
periodValidity	否	string	2	营业执照有效期至
businessScope	否	string	2	经营范围
corporateIdCardFront	否	string	2	法人身份证人像面URL
corporateIdCardBack	否	string	2	法人身份证国徽面URL
corporateName	否	string	2	法人姓名
corporateIdCardNumber	否	string	2	法人身份证号
corporateIdCardValidityBegin	否	string	2	法人身份证有效期起
corporateIdCardValidityEnd	否	string	2	法人身份证有效期至
contactName	是	string	2	联系人姓名
contactMobile	是	string	2	联系方式不能为空
contactEmail	否	string	2	联系人邮箱

入参示例

{
  "ownerPhone": "13800138000",
  "ownerAuthDomain": {
    "businessLicense": "https://example.com/business_license.pdf",
    "enterpriseName": "北京科技有限公司",
    "creditCode": "91110105MA00123456",
    "enterpriseType": "有限责任公司",
    "enterpriseAddr": "北京市海淀区中关村大街1号",
    "registeredCapital": 1000.00,
    "periodValidity": "长期",
    "businessScope": "技术开发、技术咨询、技术服务、技术转让；计算机系统服务；数据处理；基础软件服务；应用软件服务；软件开发；软件咨询；软件维护；软件测试；计算机维修；计算机系统集成；销售计算机、软件及辅助设备；货物进出口；技术进出口；代理进出口。",
    "corporateIdCardFront": "https://example.com/corporate_id_card_front.jpg",
    "corporateIdCardBack": "https://example.com/corporate_id_card_back.jpg",
    "corporateName": "张三",
    "corporateIdCardNumber": "410181198107110012",
    "corporateIdCardValidityBegin": "2001-07-11",
    "corporateIdCardValidityEnd": "长期",
    "contactName": "李四",
    "contactMobile": "13900139000",
    "contactEmail": "lisi@example.com"
  }
}

入参对象

@Setter
@Getter
@Schema(description = "新增货主")
public class ApiConsignorOwnerCreateReq {

    @Schema(description = "货主手机号", example = "13800000000")
    @NotBlank(message = "货主手机号不能为空")
    @Pattern(regexp = "(?:0|86|\\+86)?1[3-9]\\d{9}", message = "货主手机号格式错误")
    private String ownerPhone;

    @Schema(description = "货主认证信息")
    @Valid
    @NotNull(message = "货主认证信息不能为空")
    private ApiOwnerAuthDomain ownerAuthDomain;

}


@Setter
@Getter
@Accessors(chain = true)
@Schema(description = "货主认证信息")
public class ApiOwnerAuthDomain {

    //<editor-fold desc="企业信息">
    @Schema(description = "营业执照URL", example = "https://xx/yy.pdf")
    @NotBlank(message = "营业执照不能为空")
    private String businessLicense;

    @Schema(description = "企业名称")
    @NotBlank(message = "企业名称不能为空")
    private String enterpriseName;

    @Schema(description = "统一社会信用代码")
    @NotBlank(message = "统一社会信用代码不能为空")
    private String creditCode;

    @Schema(description = "企业类型")
    private String enterpriseType;

    @Schema(description = "注册地址")
    private String enterpriseAddr;

    @Schema(description = "注册资本（万元）", example = "999")
    private BigDecimal registeredCapital;

    @Schema(description = "营业执照有效期至", example = "yyyy-MM-dd | 长期")
    @Pattern(regexp = "^(\\d{4}-\\d{2}-\\d{2})|(长期)$", message = "营业执照有效期至格式不正确")
    private String periodValidity;

    @Schema(description = "经营范围")
    private String businessScope;
    //</editor-fold>

    //<editor-fold desc="法人信息">
    @Schema(description = "法人身份证人像面URL", example = "https://xx/yy.pdf")
    private String corporateIdCardFront;

    @Schema(description = "法人身份证国徽面URL", example = "https://xx/yy.pdf")
    private String corporateIdCardBack;

    @Schema(description = "法人姓名", example = "张三 | 尼古拉斯·赵四")
    @Pattern(regexp = "^[\u2E80-\u9FFF·]{2,60}$", message = "法人姓名格式错误")
    private String corporateName;

    @Schema(description = "法人身份证号", example = "410181198107110012")
    @Pattern(regexp = "^[1-9]\\d{5}[1-2]\\d{3}((0\\d)|(1[0-2]))(([012]\\d)|3[0-1])\\d{3}(\\d|X|x)$", message = "身份证格式错误")
    private String corporateIdCardNumber;

    @Schema(description = "法人身份证有效期起", example = "yyyy-MM-dd")
    @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "法人身份证有效期起格式不正确")
    private String corporateIdCardValidityBegin;

    @Schema(description = "法人身份证有效期至", example = "yyyy-MM-dd | 长期")
    @Pattern(regexp = "^(\\d{4}-\\d{2}-\\d{2})|(长期)$", message = "法人身份证有效期至格式不正确")
    private String corporateIdCardValidityEnd;
    //</editor-fold>

    //<editor-fold desc="联系人">
    @Schema(description = "联系人姓名")
    @NotBlank(message = "联系人姓名不能为空")
    private String contactName;

    @Schema(description = "联系方式")
    @NotBlank(message = "联系方式不能为空")
    private String contactMobile;

    @Schema(description = "联系人邮箱")
    private String contactEmail;
    //</editor-fold>

}

返回参数

参数名	类型	层级	说明	备注
code	int	1	状态码
msg	string	1	请求结果
total	int	1	返回总条数
requestId	string	1	请求编号
data	object	1	返回数据
id	string	2	业务数据ID
authStatus	enum	2	认证状态	见下方认证状态代码

反参示例

{
  "code": 200,
  "data": {
    "id": "131321321",
    "authStatus": "WAIT"
  },
  "msg": "业务处理成功",
  "total": null,
  "requestId": "1eb7cb0e"
}

反参对象

@Setter
@Getter
@Schema(description = "新增货主")
public class ApiConsignorOwnerCreateRes {

    @Schema(description = "业务数据ID")
    private String id;

    @Schema(description = "认证状态")
    private AuthStatusEnum authStatus;

}

认证状态代码（AuthStatusEnum）：

Name	Message
NONE	未认证
WAIT	认证中
PASS	认证通过
FAIL	认证失败