编辑运单

请求地址

https://www.xxyb.cn/union/api/link/operateWaybillModify

Header

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

请求参数

ApiConsignorWaybillEditReq 修改运单请求

字段	类型	层级	描述	必填	备注
billCode	String	1	运单编号	是
waybillEditBasicDomain	ApiWaybillEditBasicDomain	1	运单编辑基础信息	否
waybillLineDomain	ApiWaybillLineDomain	1	运单线路信息	是
waybillGoodsDomains	List<ApiWaybillGoodsDomain>	1	运单货物信息	是
waybillReceiptDomains	List<ApiWaybillReceiptDomain>	1	运单回单信息	否
waybillSettlementDomain	ApiWaybillSettlementDomain	1	运单结算信息	是

ApiWaybillEditBasicDomain 运单编辑基础信息

字段	类型	层级	描述	必填	备注
driverPhone	String	2	司机手机号	是
licensePlateNumber	String	2	车牌号	是

ApiWaybillLineDomain 运单线路信息

字段	类型	层级	描述	必填	备注
sendProvince	String	2	发货省	是
sendCity	String	2	发货市	是
sendArea	String	2	发货区	是
sendAddress	String	2	发货详细地址	是
sendAddressRemark	String	2	发货详细地址备注	否
sendLon	BigDecimal	2	发货经度	是
sendLat	BigDecimal	2	发货纬度	是
sendPerson	String	2	发货联系人	否
sendPhone	String	2	发货联系手机号	否
sendPlanTime	Date	2	计划发货时间	否
deliveryProvince	String	2	收货省	是
deliveryCity	String	2	收货市	是
deliveryArea	String	2	收货区	是
deliveryAddress	String	2	收货详细地址	是
deliveryAddressRemark	String	2	收货详细地址备注	否
deliveryLon	BigDecimal	2	收货经度	是
deliveryLat	BigDecimal	2	收货纬度	是
deliveryPerson	String	2	收货联系人	否
deliveryPhone	String	2	收货联系手机号	否
deliveryPlanTime	Date	2	计划收货时间	否

ApiWaybillGoodsDomain 运单货物明细

字段	类型	层级	描述	必填	备注
goodsType	String	2	货物类型	是
goodsPrice	BigDecimal	2	货值	是
goodsName	String	2	货物名称	是
sendWeight	BigDecimal	2	发货重量	是
deliveryWeight	BigDecimal	2	收货重量	否
goodsNumber	BigDecimal	2	货物数量,按方必填	否

ApiWaybillReceiptDomain 运单回单信息

字段	类型	层级	描述	必填	备注
receiptUrl	String	2	回单地址	是
billImageType	BillImageTypeEnum	2	回单类型	是

ApiWaybillSettlementDomain 运单结算信息

字段	类型	层级	描述	必填	备注
settlementMethod	SettlementMethodEnum	2	结算吨位	是
feeUnit	BigDecimal	2	运输单价	是
deductQuantity	BigDecimal	2	扣杂	否
deductQuantityMethod	DeductQuantityMethodEnum	2	扣杂计算方式	否
reasonableLosses	BigDecimal	2	合理亏损	否	settlementMethod为AUTO时必填
reasonableMethod	DetailMethodEnum	2	合理亏损计算方式	否	settlementMethod为AUTO时必填
goodsUnitPrice	BigDecimal	2	货物单价	否	settlementMethod为AUTO时必填
detailMethod	String	2	计价单位	是	"吨"、"车"、"件", "支", "片", "套", "方"

请求参数示例

{
  "billCode": "WB202506260001",
  "waybillEditBasicDomain": {
    "driverPhone": "DRIVER001",
    "licensePlateNumber": "VEHICLE001",
    "licensePlateColor": "BLUE"
  },
  "waybillLineDomain": {
    "sendProvince": "上海市",
    "sendCity": "上海市",
    "sendArea": "浦东新区",
    "sendAddress": "上海市浦东新区世纪大道100号",
    "sendAddressRemark": "近地铁站",
    "sendLon": 121.4737,
    "sendLat": 31.2304,
    "sendPerson": "张三",
    "sendPhone": "13800138000",
    "sendPlanTime": "2025-06-27 10:00:00",
    "deliveryProvince": "北京市",
    "deliveryCity": "北京市",
    "deliveryArea": "朝阳区",
    "deliveryAddress": "北京市朝阳区建国路88号",
    "deliveryAddressRemark": "写字楼A座",
    "deliveryLon": 116.4074,
    "deliveryLat": 39.9042,
    "deliveryPerson": "李四",
    "deliveryPhone": "13900139000",
    "deliveryPlanTime": "2025-06-28 18:00:00"
  },
  "waybillGoodsDomains": [
    {
      "goodsType": "电子产品",
      "goodsPrice": 500000.00,
      "goodsName": "电脑配件",
      "sendWeight": 50.5,
      "deliveryWeight": 50.3,
      "goodsNumber": 100
    }
  ],
  "waybillReceiptDomains": [
    {
      "receiptUrl": "https://img.example.com/receipt/20250626001.jpg",
      "billImageType": "RECEIPT"
    }
  ],
  "waybillSettlementDomain": {
    "settlementMethod": "BY_WEIGHT",
    "feeUnit": 500.00,
    "deductQuantity": 0.2,
    "deductQuantityMethod": "BY_PERCENTAGE",
    "reasonableLosses": 0.5,
    "reasonableMethod": "BY_PERCENTAGE",
    "goodsUnitPrice": 10000.00,
    "detailMethod": "TON"
  }
}