创建运单

请求地址

https://www.xxyb.cn/union/api/connection/createWaybill

Header

参数名	必选	类型	说明
token	是	string	应用令牌
cid	是	string	合作ID
corpId	是	string	企业ID

请求参数

ApiWaybillCreateReq 运单创建请求

字段	类型	层级	描述	必填
bodyId	String	1	主体编号	是
driverCreateDomain	ApiDriverCreateDomain	1	司机信息	是
vehicleCreateDomain	ApiVehicleCreateDomain	1	车辆信息	是
waybillBasicDomain	ApiWaybillBasicDomain	1	运单信息	是
goodsCreateDomains	List<ApiGoodsInfoDomain>	1	货物信息	是
contractBasicDomains	List<ApiContractBasicDomain>	1	合同信息	否

ApiDriverCreateDomain 司机信息

字段	类型	层级	描述	必填
driverName	String	2	司机姓名	是
driverIdCard	String	2	身份证	是
driverPhone	String	2	司机手机号	是
driverIdCardAddress	String	2	身份证地址	否
idCardFrontImg	String	2	身份证人像面图片	否
idCardBackImg	String	2	身份证国徽面图片	否
driverIdCardIssuingTime	String	2	身份证签发时间 格式yyyy-MM-dd	否
driverIdCardExpireTime	String	2	身份证过期时间 格式yyyy-MM-dd	否
driverLicense	String	2	驾驶证号码	否
driverLicenseFrontImg	String	2	驾驶证正面图片	否
driverLicenseBackImg	String	2	驾驶证背面图片	否
driverLicenseIssuingAuthority	String	2	驾驶证发证机关	否
driverLicenseExpireStartTime	String	2	驾驶证有效期-起 格式yyyy-MM-dd	否
driverLicenseExpireEndTime	String	2	驾驶证有效期-止 格式yyyy-MM-dd	否
professionalQualificationCertificate	String	2	从业资格证	除C1/C2外的准驾车型，其他都必填
professionalQualificationCertificateImg	String	2	从业资格证图片	除C1/C2外的准驾车型，其他都必填
professionalQualificationCertificateExpireStartTime	String	2	从业资格证有效期-起 格式yyyy-MM-dd	选填
professionalQualificationCertificateExpireEndTime	String	2	从业资格证有效期-止 格式yyyy-MM-dd	除C1/C2外的准驾车型，其他都必填
approvedDrivingType	String	2	准驾车型	除C1/C2外的准驾车型，其他都必填

ApiVehicleCreateDomain 车辆信息

字段	类型	层级	描述	必填
vehicleNumber	String	2	车辆牌号	是
vehiclePlateColorCode	String	2	车牌颜色	是
vehicleType	String	2	车型	否
vehicleLength	BigDecimal	2	车长	否
vehicleEnergyType	String	2	车辆能源类型	否
vehicleIdentificationNumber	String	2	车辆识别代码	否
vehicleLicense	String	2	行驶证号码	否
vehicleLicenseFrontImg	String	2	行驶证正面图片	否
vehicleLicenseBackImg	String	2	行驶证反面图片	否
vehicleLicenseClipImg	String	2	行驶证最新年检页	否
vehicleLicenseRegisterTime	String	2	行驶证注册日期 格式yyyy-MM-dd	否
vehicleLicenseExpireTime	String	2	行驶证证有效期 格式yyyy-MM	否
vehicleLicenseIssuingAuthority	String	2	行驶证发证机关	否
vehicleLicenseIssuingTime	String	2	行驶证发证日期 格式yyyy-MM-dd	否
roadTransportLicense	String	2	道路运输证号	车牌颜色非蓝色/车长大于4.2米必填
roadTransportLicenseImg	String	2	道路运输证照片	车牌颜色非蓝色/车长大于4.2米必填
roadTransportLicenseExpireTime	String	2	道路运输证有效期至 格式yyyy-MM-dd	车牌颜色非蓝色/车长大于4.2米必填
roadTransportBusinessLicense	String	2	道路运输经营许可证	选填
trailerLicenseNumber	String	2	挂车牌照号	否
trailerLicenseImg	String	2	挂车正本照片	否
trailerLicenseBackImg	String	2	挂车副本照片	否
groupPhotoImg	String	2	人车合照	否
totalMass	BigDecimal	2	总质量	否
approvedLoad	BigDecimal	2	核定载质量	否
curbWeight	BigDecimal	2	整备质量	否
overallDimensions	String	2	外廓尺寸	否
useNature	String	2	使用性质	否
creditCode	String	2	统一社会信用代码/身份证号	否
vehicleOwner	String	2	车辆所有人	否
vehicleOwnerExpireTime	String	2	车辆所有人有效期 格式yyyy-MM-dd	否
affiliationAgreement	List<String>	2	挂靠协议	否

ApiWaybillBasicDomain 运单基本信息

字段	类型	层级	描述	必填
shippingNoteNumber	String	2	运单号	是
transportTypeCode	String	2	运输组织类型代码	是
businessTypeCode	String	2	业务类型代码	是
goodsArrangementTypeCode	String	2	运输组货方式代码	是
consignmentDateTime	String	2	运单生成时间 格式yyyy-MM-dd HH:mm:ss	是
orderTime	String	2	接单时间 格式yyyy-MM-dd HH:mm:ss	是
goodsReceiptDateTime	String	2	计划收货时间 格式yyyy-MM-dd HH:mm:ss	否
despatchActualDateTime	String	2	计划发货时间 格式yyyy-MM-dd HH:mm:ss	否
consignor	String	2	发货人方名称	是
consignorId	String	2	发货方统一社会信用代码或个人证件号	是
consignorImg	String	2	发货方统一社会信用代码或个人证件号照片	否
linkPerson	String	2	发货联系人	是
linkPhone	String	2	发货联系人电话	是
deliverLon	String	2	发货经度	是
deliverLat	String	2	发货纬度	是
deliverProvince	String	2	发货省	是
deliverCity	String	2	发货市	是
deliverCounty	String	2	发货区县	是
placeOfLoading	String	2	发货地点	是
loadingCountrySubdivisionCode	String	2	发货地点的国家行政区划代码	是
consignee	String	2	收货方名称	是
consigneeId	String	2	收货方统一社会信用代码或个人证件号码	选填
consigneeTel	String	2	收货方电话	是
receivingLon	String	2	收货经度	是
receivingLat	String	2	收货纬度	是
receivingProvince	String	2	收货方省	是
receivingCity	String	2	收货方市	是
receivingCounty	String	2	收货方区县	是
goodsReceiptPlace	String	2	收货地址	是
unLoadingCountrySubdivisionCode	String	2	收货地点的国家行政区划代码	是
totalMonetaryAmount	BigDecimal	2	货主运费金额	是
waybillFreightAmount	BigDecimal	2	司机运单运费金额	是
totalDriverFreight	BigDecimal	2	司机收款金额	是

ApiGoodsInfoDomain 货物信息

字段	类型	层级	描述	必填
descriptionOfGoods	String	2	货物名称	是
cargoTypeClassificationCode	String	2	货物类型分类代码	是
goodsItemGrossWeight	BigDecimal	2	货物项毛重	是
cube	BigDecimal	2	体积	否
totalNumberOfPackages	BigDecimal	2	总件数	否
goodsUnit	String	2	货物单位	否

ApiContractBasicDomain 合同信息

字段	类型	层级	描述	必填
contractBusinessName	String	2	合同业务名称	是
contractType	String	2	合同类型	是
contractNumber	String	2	合同编号	是
partyAName	String	2	甲方名称	是
partyAId	String	2	甲方统一社会信用代码或个人证件号	是
partyAAccount	String	2	甲方收款账号	否
partyABankName	String	2	甲方收款银行	否
partyBName	String	2	乙方名称	是
partyBId	String	2	乙方统一社会信用代码	是
partyBReceiptName	String	2	乙方收款名称	否
partyBAccount	String	2	乙方收款账号	否
partyBBankName	String	2	乙方银行	否
contractAmount	BigDecimal	2	合同金额	是
agreedBusinessCompletionTime	String	2	约定业务完成时间 格式yyyy-MM-dd HH:mm:ss	是
bankName	String	2	银行名称	否
businessActualCompletionTime	String	2	业务实际完成时间 格式yyyy-MM-dd HH:mm:ss	否
paymentAmount	BigDecimal	2	付款金额	否
contractSigningTime	String	2	合同签订时间	否
contractedCarryingCapacity	BigDecimal	2	合同签订承运量	否
unit	String	2	合同签订承运量单位：吨/立方米/件/车	否
promisePayTime	String	2	约定甲方付款时间 格式yyyy-MM-dd HH:mm:ss	否
serviceCharge	String	2	收取服务费标准	否
contractUrl	String	2	合同文件	是

请求参数示例

{
  "bodyId": "ed3b21396f1e4730a4da7d566c964c8f",
  "driverCreateDomain": {
    "driverName": "李四",
    "driverIdCard": "420281200208086688",
    "driverPhone": "18271092921",
    "driverIdCardAddress": "湖北省黄石市下陆区",
    "idCardFrontImg": "www.baidu.com",
    "idCardBackImg": "www.baidu.com",
    "driverIdCardIssuingTime": "2020-02-13",
    "driverIdCardExpireTime": "2030-02-13",
    "driverLicense": "685268523423",
    "driverLicenseFrontImg": "www.baidu.com",
    "driverLicenseBackImg": "www.baidu.com",
    "driverLicenseIssuingAuthority": "武汉江夏车管所",
    "driverLicenseExpireStartTime": "2021-06-06",
    "driverLicenseExpireEndTime": "2026-06-06",
    "professionalQualificationCertificate": "www.baidu.com",
    "professionalQualificationCertificateImg": "www.baidu.com",
    "professionalQualificationCertificateExpireStartTime": "2025-01-11",
    "professionalQualificationCertificateExpireEndTime": "2027-11-11",
    "approvedDrivingType": "A1"
  },
  "vehicleCreateDomain": {
    "vehicleNumber": "鄂BCN346",
    "vehiclePlateColorCode": "BLUE",
    "vehicleType": "HEAVY_DUMP_TRUCK",
    "vehicleLength": "5.20",
    "vehicleEnergyType": "C",
    "vehicleIdentificationNumber": "123456",
    "vehicleLicense": "178931456",
    "vehicleLicenseFrontImg": "www.baidu.com",
    "vehicleLicenseBackImg": "www.baidu.com",
    "vehicleLicenseClipImg": "www.baidu.com",
    "vehicleLicenseRegisterTime": "2025-02-15",
    "vehicleLicenseExpireTime": "2030-02-15",
    "vehicleLicenseIssuingAuthority": "武汉江夏车管所",
    "vehicleLicenseIssuingTime": "2025-02-20",
    "roadTransportLicense": "123456789",
    "roadTransportLicenseImg": "www.baidu.com",
    "roadTransportLicenseExpireTime": "2027-10-01",
    "roadTransportBusinessLicense": "www.baidu.com",
    "trailerLicenseNumber": "123456789",
    "trailerLicenseImg": "www.baidu.com",
    "groupPhotoImg": "www.baidu.com",
    "totalMass": "100.00",
    "approvedLoad": "101.00",
    "curbWeight": "1.00",
    "overallDimensions": "4.23",
    "creditCode": "421012200208082255",
    "vehicleOwner": "12345685233",
    "vehicleOwnerExpireTime": "2025-06-10",
    "affiliationAgreement": ""
  },
  "waybillBasicDomain": {
    "shippingNoteNumber": "10250609552360667",
    "transportTypeCode": "ROAD_TRANSPORT",
    "businessTypeCode": "CHENGSHI",
    "goodsArrangementTypeCode": "GOODS_TRANSPORT_TYPE_100",
    "consignmentDateTime": "2025-06-28 00:00:00",
    "orderTime": "2025-06-19 00:00:01",
    "goodsReceiptDateTime": "2025-06-18 00:00:00",
    "despatchActualDateTime": "2025-06-20 00:00:00",
    "consignor": "测试企业",
    "consignorId": "91151512021511202",
    "consignorImg": "www.baidu.com",
    "linkPerson": "张三",
    "linkPhone": "13312345666",
    "deliverLon": "12.123",
    "deliverLat": "32.123",
    "deliverProvince": "湖北省",
    "deliverCity": "武汉市",
    "deliverCounty": "洪山区",
    "placeOfLoading": "测试地址",
    "loadingCountrySubdivisionCode": "420",
    "consignee": "李四",
    "consigneeId": "420281200208087414",
    "consigneeTel": "18813456888",
    "receivingLat": "22.566",
    "receivingLon": "12.555",
    "receivingProvince": "湖北省",
    "receivingCity": "武汉市",
    "receivingCounty": "江夏区",
    "goodsReceiptPlace": "测试地址2",
    "unLoadingCountrySubdivisionCode": "420122",
    "totalMonetaryAmount": 128,
    "waybillFreightAmount": 126,
    "totalDriverFreight": 126
  },
  "goodsCreateDomains": [
    {
      "descriptionOfGoods": "测试货物",
      "cargoTypeClassificationCode": "OTHER",
      "goodsItemGrossWeight": "11.00",
      "cube": "10.00",
      "totalNumberOfPackages": "5.32",
      "goodsUnit": "吨"
    }
  ],
  "contractBasicDomains": [
    {
      "contractBusinessName": "测试合同",
      "contractType": "CARRIER",
      "contractNumber": "123468",
      "partyAName": "马哥",
      "partyAId": "420258200808084456",
      "partyAAccount": "123",
      "partyABankName": "招商银行",
      "partyBName": "小名",
      "partyBId": "123456789",
      "partyBReceiptName": "测试收款",
      "partyBAccount": "1459753",
      "partyBBankName": "建设银行",
      "contractAmount": "100.23",
      "agreedBusinessCompletionTime": "2025-10-14 12:10:00",
      "bankName": "招商银行",
      "businessActualCompletionTime": "2025-10-14 12:13:00",
      "paymentAmount": "10000.55",
      "contractSigningTime": "2025-08-09 12:10:00",
      "contractedCarryingCapacity": "2",
      "unit": "吨",
      "promisePayTime": "2025-10-14",
      "serviceCharge": "2025-10-14",
      "contractUrl": "https://aaaaa.com/prod/bb.jpg"
    }
  ]
}

返回参数

字段名	类型	层级	描述
id	String	1	运单id
riskCheckStatus	RiskCheckStatusEnum	1	核验/申诉状态
riskDetails	List<Object>	1	风控详情
riskType	String	2	风控类型
riskCount	int	2	风控数量
abnormalCount	int	2	异常数量
riskItemDetails	List<Object>	2	风控项详情
rikeItem	String	3	风控项
isAbnormal	Boolean	3	是否异常
riskResults	List<String>	3	风控结果
riskWeightType	RiskWeightTypeEnum	3	风险等级

返回参数示例

{
  "code": 200,
  "msg": "业务处理成功",
  "data": {
    "riskCheckStatus": "FAILED",
    "riskCheckStatusText": "核验不通过",
    "riskDetails": [
      {
        "riskType": "运力异常",
        "riskCount": 7,
        "abnormalCount": 1,
        "riskItemDetails": [
          {
            "rikeItem": "行驶证有效期",
            "isAbnormal": true,
            "riskResults": [
              "车辆行驶证已过期"
            ],
            "riskWeightType": "MEDIUM",
            "riskWeightTypeText": "中风险"
          }
        ]
      },
      {
        "riskType": "运单异常",
        "riskCount": 17,
        "abnormalCount": 1,
        "riskItemDetails": [
          {
            "rikeItem": "超载",
            "isAbnormal": true,
            "riskResults": [
              "车辆超载，车辆核定载质量：10.00，运单吨重：200.00"
            ],
            "riskWeightType": "MEDIUM",
            "riskWeightTypeText": "中风险"
          }
        ]
      }
    ]
  },
  "total": null,
  "requestId": "95be5737-428020"
}

枚举

核验/申诉状态（RiskCheckStatusEnum）：

Name	Message
WAIT	核验中
PASS	核验通过
FAILED	核验不通过
APPROVED	申诉通过
REJECTED	申诉驳回
PROGRESS	申诉中
NONE	无需申诉

风险等级 （RiskWeightTypeEnum）：

Name	Message
HIGH	高风险
MEDIUM	中风险
LOW	低风险