运单提货

请求地址

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

Header

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

请求参数

ApiWaybillPickUpReq 运单提货请求

字段	类型	层级	描述	必填
bodyId	String	1	主体编号	是
waybillPickUpDomain	ApiWaybillPickUpDomain	1	运单信息	是
driverPickUpDomain	ApiDriverPickUpDomain	1	司机信息	是
vehiclePickUpDomain	ApiVehiclePickUpDomain	1	车辆信息	是
contractBasicDomain	List<ApiContractBasicDomain>	1	合同信息	是
goodsCreateDomains	List<ApiGoodsInfoDomain>	1	货物信息	是
trackDomain	List<ApiTrackDomain>	1	轨迹信息	否

ApiWaybillPickUpDomain 运单提货信息

字段	类型	层级	描述	必填
shippingNoteNumber	String	2	运单号	是
transportTypeCode	String	2	运输组织类型代码	是
businessTypeCode	String	2	业务类型代码	是
goodsArrangementTypeCode	String	2	运输组货方式代码	是
departureTime	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	收货地点的国家行政区划代码	是
imageUrl	List<ApiReceiptDomain>	2	回单	否
totalMonetaryAmount	BigDecimal	2	货主运费金额	是
waybillFreightAmount	BigDecimal	2	司机运单运费金额	是
totalDriverFreight	BigDecimal	2	司机收款金额	是

ApiReceiptDomain回单信息

字段	类型	层级	描述	必填
imageType	String	3	回单类型	是
imageUrl	String	3	回单地址	是
uploadTime	String	3	回单时间 格式yyyy-MM-dd HH:mm:ss	是

ApiDriverPickUpDomain 司机提货信息

字段	类型	层级	描述	必填
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	准驾车型	是

ApiVehiclePickUpDomain 车辆提货信息

字段	类型	层级	描述	必填
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	挂靠协议	否

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	合同文件	是

ApiGoodsInfoDomain 货物信息

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

ApiTrackDomain 轨迹信息

字段	类型	层级	描述	必填
locationMethod	String	2	定位方式	是
locationType	String	2	提货/运抵	是
locationAddress	String	2	定位地址	否
locationProvince	String	2	定位省份	否
locationCity	String	2	定位市	否
locationArea	String	2	定位区	否
lat	BigDecimal	2	纬度	是
lon	BigDecimal	2	经度	是
direction	String	2	方向	否
agl	String	2	方向 原始数据	否
speed	String	2	速度	否
high	String	2	高度	否
mileage	String	2	里程	否
locationTime	String	2	定位时间 格式yyyy-MM-dd HH:mm:ss	是
description	String	2	描述	否

请求参数示例

{
  "bodyId": "ed3b21396f1e4730a4da7d566c964c8f",
  "waybillPickUpDomain": {
    "shippingNoteNumber": "10250609552360667",
    "transportTypeCode": "ROAD_TRANSPORT",
    "businessTypeCode": "GANXIAN",
    "goodsArrangementTypeCode": "GOODS_TRANSPORT_TYPE_100",
    "departureTime": "2025-06-18 00:00:11",
    "goodsReceiptDateTime": "2025-06-18 00:00:00",
    "despatchActualDateTime": "2025-06-20 00:00:00",
    "consignor": "测试企业",
    "consignorId": "91151512021511202",
    "consignorImg": "www.baidu.com",
    "linkPerson": "张三",
    "linkPhone": "13312345666",
    "deliverLat": "32.123",
    "deliverLon": "12.123",
    "deliverProvince": "湖北省",
    "deliverCity": "武汉市",
    "deliverCounty": "洪山区",
    "placeOfLoading": "测试地址",
    "loadingCountrySubdivisionCode": "420100",
    "consignee": "李四",
    "consigneeId": "00000000000",
    "consigneeTel": "18813456888",
    "receivingLat": "22.566",
    "receivingLon": "12.555",
    "receivingCity": "武汉市",
    "receivingCounty": "江夏区",
    "receivingProvince": "湖北省",
    "goodsReceiptPlace": "测试地址2",
    "unLoadingCountrySubdivisionCode": "420122",
    "imageUrl": [
      {
        "imageType": "RECEIPT",
        "imageUrl": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
        "uploadTime": "2025-12-12 00:00:00"
      }
    ],
    "totalMonetaryAmount": 128,
    "waybillFreightAmount": 126,
    "totalDriverFreight": 126
  },
  "driverPickUpDomain": {
    "driverName": "王五",
    "driverIdCard": "420222199912121215",
    "driverPhone": "18271092923",
    "driverIdCardAddress": "湖北省武汉市洪山区1111",
    "idCardBackImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "idCardFrontImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "driverIdCardExpireTime": "2044-12-12",
    "driverIdCardIssuingTime": "2024-12-12",
    "driverLicense": "420222199912121212",
    "driverLicenseBackImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "driverLicenseFrontImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "driverLicenseIssuingAuthority": "内蒙古自治区巴彦淖尔市公安局交通警察支队",
    "driverLicenseExpireEndTime": "2044-12-12",
    "driverLicenseExpireStartTime": "2024-12-12",
    "professionalQualificationCertificate": "420222199912121212",
    "professionalQualificationCertificateImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "professionalQualificationCertificateExpireEndTime": "2044-12-12",
    "professionalQualificationCertificateExpireStartTime": "2024-12-12",
    "approvedDrivingType": "A2"
  },
  "vehiclePickUpDomain": {
    "vehicleNumber": "鄂A12349",
    "vehiclePlateColorCode": "YELLOW",
    "vehicleType": "HEAVY_BARN_TYPE_SEMI_TRAILER",
    "vehicleLength": 9,
    "vehicleEnergyType": "A",
    "vehicleIdentificationNumber": "LFWSRX9L0LAC44452",
    "vehicleLicense": "123123123213",
    "vehicleLicenseBackImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "vehicleLicenseClipImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "vehicleLicenseFrontImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "vehicleLicenseIssuingTime": "2024-12-12",
    "vehicleLicenseRegisterTime": "2024-12-12",
    "vehicleLicenseIssuingAuthority": "内蒙古自治区巴彦淖尔市公安局交通警察支队",
    "approvedLoad": 32,
    "creditCode": "61272419770715035X",
    "curbWeight": 8,
    "groupPhotoImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "overallDimensions": "9*12*3",
    "roadTransportBusinessLicense": "610823003694",
    "roadTransportLicense": "610823003694",
    "roadTransportLicenseExpireTime": "2044-12",
    "roadTransportLicenseImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "totalMass": 40,
    "trailerLicenseImg": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
    "trailerLicenseNumber": "陕K50D3挂",
    "useNature": "货运",
    "vehicleLicenseExpireTime": "2044-12-12",
    "vehicleOwner": "张海军",
    "vehicleOwnerExpireTime": "2025-10-11",
    "affiliationAgreement": [
      "dadsd"
    ]
  },
  "contractBasicDomain": [
    {
      "contractBusinessName": "运输合同",
      "contractType": "OWNER",
      "contractNumber": "1231321312",
      "partyBName": "测试平台",
      "partyBId": "91545548121245451",
      "partyBAccount": "62212345648951142121",
      "partyBBankName": "测试银行",
      "contractUrl": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
      "partyAAccount": "12345678241121",
      "partyABankName": "测试银行",
      "partyAId": "91151512021511202",
      "partyAName": "测试企业",
      "bankName": "招商银行",
      "partyBReceiptName": "测试平台",
      "agreedBusinessCompletionTime": "2025-06-20 00:00:00",
      "contractAmount": 128,
      "unit": "吨",
      "promisePayTime": "2025-02-10 00:00:00",
      "serviceCharge": "213123"
    },
    {
      "partyBName": "测试平台",
      "agreedBusinessCompletionTime": "2025-06-20 00:00:00",
      "contractAmount": 126,
      "contractBusinessName": "承运合同",
      "contractNumber": "12313213123123",
      "contractType": "OWNER",
      "contractUrl": "https://file.aaa.com/Rqmyu6j8sBUSDbckNF5Drh2IVxymXwox.jpg",
      "partyAAccount": "62212345648951142121",
      "partyABankName": "测试银行",
      "partyAId": "91545548121245451",
      "partyAName": "测试平台",
      "partyBAccount": "6248512315481212122",
      "partyBBankName": "测试银行",
      "partyBId": "420222199912121212",
      "partyBReceiptName": "张三"
    }
  ],
  "goodsCreateDomains": [
    {
      "cargoTypeClassificationCode": "OTHER",
      "descriptionOfGoods": "测试货物",
      "goodsItemGrossWeight": 11,
      "goodsUnit": "吨",
      "totalNumberOfPackages": "14",
      "cube": "40"
    }
  ],
  "trackDomain": [
    {
      "locationMethod": "BD",
      "locationType": "START",
      "locationAddress": "湖北武汉",
      "locationProvince": "湖北省",
      "locationCity": "武汉市",
      "locationArea": "洪山区",
      "lat": "123.21",
      "lon": "123.32",
      "direction": "向东",
      "speed": "100.00",
      "agl": "456",
      "high": "5",
      "mileage": "100",
      "locationTime": "2025-06-08 13:00:00",
      "description": "无"
    }
  ]
}

返回参数

字段名	类型	层级	描述
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	低风险