页面历史

...

接口名称

编辑运单详情（运单编辑）编辑运单详情h2.

接口地址

...

...

/api/shipper/v1/parcel/order/edit

...

请求方式

...

...

POST

...

请求头

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

*语言取值：*||

...

...

...

...

...

...

...

...

...

请求参数

...

h3. 1. 订单基本信息 OrderInfo

|| 字段 || 类型 || 必填 || 说明 ||
| facility | String | 是 | 发件人网点 |
| addressCountry | String | 是 | 目的地国家/区域代码 |
| channel | Number | 是 | 服务ID渠道ID |
| serviceOption | String | 否 | 服务选项代码 |
| billingPartyName | String | 否 | 付款方 |
| platform | String | 否 | 电子商务平台 |
| lockerService | Boolean | 否 | 储物柜服务（当国家为RU时显示） |
| authorityToLeave | Boolean | 否 | 授权放置ATL（当服务为2、3、42、585、586、587时显示） |

h3. 2. 收件人地址信息 address

|| 字段 || 类型 || 必填 || 说明 ||
| addressId | String | 否 | 地址ID（编辑时传入） |
| country | String | 是 | 目的地国家代码 |
| addressLine1 | String | 是 | 地址行1 |
| addressLine2 | String | 否 | 地址行2 |
| addressLine3 | String | 否 | 地址行3 |
| city | String | 是 | 城市 |
| state | String | 是 | 省/州 |
| postcode | String | 是 | 邮编 |

h3. 3. 收件人联系信息

|| 字段 || 类型 || 必填 || 说明 ||
| recipientName | String | 是 | 收件人姓名 |
| recipientCompany | String | 否 | 接收方公司 |
| phone | String | 否 | 电话 |
| email | String | 否 | 邮箱 |

h3. 4. 包裹信息 ParcelInfo

|| 字段 || 类型 || 必填 || 说明 ||
| trackingNo | String | 否 | 跟踪号（编辑时显示，不可修改） |
| refNo | String | 是 | 参考号 |
| refNo1 | String | 否 | 参考号1 |
| dangerousGoods | Boolean | 否 | 包含其他危险品 |
| incoterm | String | 否 | 付税方式DDU/DDP |
| invoiceCurrency | String | 是 | 发票币种代码 |
| invoiceValue | String | 是 | 发票金额 |
| instruction | String | 否 | 装运提示 |
| weight | String | 是 | 重量 |
| weightUnit | String | 是 | 重量单位KG/G等 |
| volume | String | 否 | 体积 |
| description | String | 是 | 货物描述 |
| nativeDescription | String | 否 | 本地描述 |
| length | String | 否 | 长度 |
| width | String | 否 | 宽度 |
| height | String | 否 | 高度 |
| dimensionUnit | String | 否 | 体积单位cm/m/in |
| batteryPacking | Number | 否 | 电池包装intValue |
| batteryType | Number | 否 | 电池类型intValue |
| sku | String | 否 | 拣货清单 |
| recipientTaxId | String | 否 | 收件人税号 |
| vendorid | String | 否 | Vendor ID |
| agentID | String | 否 | 代理ID |
| sortCode | String | 否 | 分拣码 |
| purpose | String | 否 | 用途 |
| material | String | 否 | 材质 |
| codAmount | String | 否 | COD金额 |
| codCurrency | String | 否 | COD币种 |
| receiverKycType | String | 否 | 收件人KYC类型 |
| receiverKycNo | String | 否 | 收件人KYC号码 |
| injectPort | String | 否 | Inject Port |
| abnnumber | String | 否 | 澳洲生意注册号码（国家为AU时显示） |
| gstexemptioncode | String | 否 | 免税码（国家为AU时显示） |
| platformorderno | String | 否 | 平台订单号（特定服务显示） |
| coveramount | String | 否 | 投保金额（国家为AU时显示） |
| senderTaxId | String | 否 | 发货人税号 |
| postage | String | 否 | postage（特定服务显示） |
| icms | String | 否 | icms（特定服务显示） |
| vat | String | 否 | vat（特定服务显示） |
| originPort | String | 否 | 起运港（特定服务显示） |
| osnr | String | 否 | OSNR（特定服务显示，值为0或1） |
| specialHandlingType | String | 否 | 特殊交货类型（特定服务显示，SH05/SH06/SH07/SH09/SH10） |
| holdForPickup | String | 否 | Hold for Pickup（特定服务显示，值为N或Y） |
| residentialSignatureRequired | String | 否 | Residential Signature Required（特定服务显示，值为N或Y） |
| saturdayDelivery | String | 否 | Saturday Delivery（特定服务显示，值为N或Y） |
| exportInvoiceValue | String | 否 | 出口发票金额 |
| exportInvoiceCurrency | String | 否 | 出口发票币种 |
| imei1 | String | 否 | imei1（特定服务显示） |
| imei2 | String | 否 | imei2（特定服务显示） |
| warehouseID | String | 否 | 仓库ID |

h3. 5. 物品信息 parcelItems

数组类型，每个物品包含以下字段：

|| 字段 || 类型 || 必填 || 说明 ||
| uuid | String | 否 | 物品UUID（新增时为空，编辑时传入） |
| sku | String | 否 | SKU |
| description | String | 否 | 描述 |
| nativeDescription | String | 否 | 本地描述 |
| hsCode | String | 否 | HS编码 |
| originCountry | String | 否 | 原产国 |
| unitValue | Number | 否 | 单价 |
| itemCount | Number | 否 | 数量 |
| weight | Number | 否 | 重量 |
| productURL | String | 否 | 产品链接 |
| warehouseNo | String | 否 | 仓库号 |
| pictures | Array | 否 | 物品图片数组 |
| extendData | Object | 否 | 扩展数据（包含itemExportInvoiceValue、itemExportInvoiceCurrency） |

h3. 6. 发货人地址信息 shipperAddress

|| 字段 || 类型 || 必填 || 说明 ||
| addressId | String | 否 | 地址ID（编辑时传入） |
| country | String | 否 | 发货人国家代码 |
| addressLine1 | String | 是 | 地址行1 |
| addressLine2 | String | 否 | 地址行2 |
| addressLine3 | String | 否 | 地址行3 |
| city | String | 是 | 城市 |
| state | String | 否 | 省/州 |
| postcode | String | 否 | 邮编 |
| shipperName | String | 否 | 发货人姓名 |
| shipperPhone | String | 否 | 发货人电话 |
| shipperEmail | String | 否 | 发货人邮箱 |
| shipperOrganizationCode | String | 否 | 企业统一社会信用代码（扩展字段） |
| shipperCompanyName | String | 否 | 发货人公司名（扩展字段） |

h3. 7. 退货地址信息 returnAddress

|| 字段 || 类型 || 必填 || 说明 ||
| addressId | String | 否 | 地址ID（编辑时传入） |
| addressLine1 | String | 是 | 地址行1 |
| addressLine2 | String | 否 | 地址行2 |
| addressLine3 | String | 否 | 地址行3 |
| city | String | 是 | 城市 |
| state | String | 否 | 省/州 |
| postcode | String | 否 | 邮编 |
| country | String | 否 | 退货国家代码 |
| returnName | String | 否 | 退货人姓名 |
| returnPhone | String | 否 | 退件电话 |
| returnOption | String | 否 | 退货选项Destroy/Return/Forward/Change |

h3. 8. 在线投保信息 insur

|| 字段 || 类型 || 必填 || 说明 ||
| uuid | String | 否 | 投保UUID |
| cancel | Boolean | 否 | 是否取消投保（true表示不投保，提交时删除insur对象） |
| insureType | String | 否 | 被保险人类型（01=个人，02=公司） |
| insuredContackName | String | 否 | 被保人真实姓名 |
| insuredName | String | 否 | 被投保人联系人姓名 |
| insureAmount | String | 否 | 投保额 |
| insureCurrency | String | 否 | 投保额币种 |
| insureCardNo | String | 否 | 组织机构代码证或身份证号码 |
| projectNo | String | 否 | 保单号 |

h3. 9. 其他字段

|| 字段 || 类型 || 必填 || 说明 ||
| uuid | String | 是 | 运单UUID（编辑时必传） |
| actualWeight | String | 否 | 实际重量 |
| actualVolume | String | 否 | 实际体积 |
| actualLength | String | 否 | 实际长度 |
| actualWidth | String | 否 | 实际宽度 |
| actualHeight | String | 否 | 实际高度 |
| girth | String | 否 | 周长 |
| actualGirth | String | 否 | 实际周长 |

h2. 参数联动关系说明

h3. 1. 服务与付税方式联动

付税方式incoterm选项根据服务IDchannel动态变化：

|| 服务ID || 可用付税方式 ||
| 0 | DDU, DDP |
| 28 | DDU |
| 35 | DDU |
| 36 | DDU |
| 37 | DDU |
| 57 | DDP |
| 58 | DDU |
| 67 | DDU |
| 139 | DDP, DDU |
| 140 | DDP, DDU |
| 141 | DDP, DDU |
| 142 | DDP, DDU |
| 174 | DDP |
| 198 | DDP, DDU |
| 238 | DDP, DDU |
| 249 | DDP, DDU |
| 273 | DDP |
| 274 | DDU |
| 377 | DDP, DDU |
| 29（根据国家区分） | US=DDP, GB/其他=DDU或DDP |

h3. 2. 国家与服务联动

选择目的地国家后，服务选项会根据国家过滤。

h3. 3. 服务与服务选项联动

选择服务后，服务选项会根据服务ID查询对应的选项列表。

h3. 4. 字段显示/隐藏联动

|| 字段 || 显示条件 ||
| lockerService | 国家为RU时显示 |
| authorityToLeave | 服务为2、3、42、585、586、587时显示 |
| abnnumber, gstexemptioncode, coveramount | 国家为AU时显示 |
| platformorderno | 服务为139, 205, 237, 238, 249, 273, 275, 293, 345, 362, 364时显示 |
| originPort | 服务为698, 721, 724, 722, 725, 723, 726, 786时显示 |
| osnr, specialHandlingType, holdForPickup, residentialSignatureRequired, saturdayDelivery | 服务为1062, 1063时显示 |
| vat | 服务为698, 946, 1161时显示 |
| postage, icms | 服务为946, 1161时显示 |
| imei1, imei2 | 服务为1153时显示 |

h2. 写死在前端的下拉框数据

h3. 1. 扣留选项 heldsOptions

{code}
[
{ "label": "无扣留", "value": 0 },
{ "label": "客户扣留", "value": 1 },
{ "label": "承运商扣留", "value": 2 },
{ "label": "财务扣留", "value": 3 },
{ "label": "大货扣留", "value": 4 },
{ "label": "电池扣留", "value": 5 },
{ "label": "违禁品扣留", "value": 6 },
{ "label": "其他扣留", "value": 7 },
{ "label": "退货扣留", "value": 8 },
{ "label": "KYC扣留", "value": 9 },
{ "label": "超重扣留", "value": 10 },
{ "label": "超长扣留", "value": 11 },
{ "label": "包装问题扣留", "value": 12 },
{ "label": "重量差异", "value": 23 },
{ "label": "重复收件人", "value": 25 },
{ "label": "超重警告", "value": 26 },
{ "label": "超大", "value": 27 },
{ "label": "不符申报", "value": 29 },
{ "label": "HSCode扣留", "value": 30 },
{ "label": "无可用服务", "value": 31 },
{ "label": "超时", "value": 32 }
]
{code}

h3. 2. 默认付税方式选项 INCOTERM_OPTIONS_DEFAULT

{code}
[
{ "label": "DDU", "value": "DDU" },
{ "label": "DDP", "value": "DDP" }
]
{code}

h3. 3. 体积单位选项 DIMENSIONUNIT_OPTIONS

{code}
[
{ "label": "CM", "value": "cm" },
{ "label": "M", "value": "m" },
{ "label": "IN", "value": "in" }
]
{code}

h3. 4. 退货选项 RETURN_OPTIONS

{code}
[
{ "name": "Destroy", "cnName": "销毁", "value": "Destroy" },
{ "name": "Return", "cnName": "退回", "value": "Return" },
{ "name": "Forward", "cnName": "转寄", "value": "Forward" },
{ "name": "Change", "cnName": "地址更改", "value": "Change" }
]
{code}

h3. 5. 投保额币种选项 INSURANCE_CURRENCY_OPTIONS

{code}
[
{ "label": "RMB", "value": "RMB" },
{ "label": "HKD", "value": "HKD" },
{ "label": "USD", "value": "USD" },
{ "label": "GBP", "value": "GBP" },
{ "label": "JPY", "value": "JPY" },
{ "label": "SGD", "value": "SGD" },
{ "label": "CAD", "value": "CAD" },
{ "label": "EUR", "value": "EUR" },
{ "label": "AUD", "value": "AUD" }
]
{code}

h3. 6. 储物柜服务选项 lockerService

{code}
[
{ "label": "No", "value": false },
{ "label": "Yes", "value": true }
]
{code}

h3. 7. OSNR选项 osnr

{code}
[
{ "label": "No", "value": "0" },
{ "label": "Yes", "value": "1" }
]
{code}

h3. 8. 特殊交货类型选项 specialHandlingType

{code}
[
{ "label": "SH05", "value": "SH05" },
{ "label": "SH06", "value": "SH06" },
{ "label": "SH07", "value": "SH07" },
{ "label": "SH09", "value": "SH09" },
{ "label": "SH10", "value": "SH10" }
]
{code}

h3. 9. Yes/No类型选项

适用于：holdForPickup, residentialSignatureRequired, saturdayDelivery

{code}
[
{ "label": "No", "value": "N" },
{ "label": "Yes", "value": "Y" }
]
{code}

h2. 动态获取的下拉框数据

h3. 1. 发件人网点 facilityOptions

接口：GET /facility/getByPartyId

h3. 2. 国家列表 countryOptions

接口：全局方法 getCountryData() 获取

h3. 3. 服务列表 channelOptions

接口：根据国家获取可用服务 getServicesByShipperAndCountry({ country })

h3. 4. 服务选项 serviceOptions

接口：根据服务ID获取服务选项 getServiceOptionsByService(channel)

h3. 5. 币种列表 currencyOptions

接口：全局方法 getCurrencyData() 获取

h3. 6. 重量单位 weightUnitOptions

接口：系统代码表 getSysCode('WUT001')

h3. 7. 电池包装 batteryPackingOptions

接口：系统代码表 getSysCode('BOT001')

h3. 8. 电池类型 batteryTypeOptions

接口：系统代码表 getSysCode('BPT001')

h2. 请求示例

{code}
{
"uuid": "abc123-def456-ghi789",
"facility": "*",
"channel": 29,
"serviceOption": "STANDARD",
"billingPartyName": "Test Company",
"platform": "eBay",
"lockerService": false,
"authorityToLeave": false,
"recipientName": "John Doe",
"recipientCompany": "ABC Corp",
"phone": "+1234567890",
"email": "test@example.com",
"address": {
"addressId": "addr-123",
"country": "US",
"addressLine1": "123 Main St",
"addressLine2": "Apt 4B",
"addressLine3": "",
"city": "New York",
"state": "NY",
"postcode": "10001"
},
"trackingNo": "TRACK123456",
"refNo": "REF001",
"refNo1": "REF002",
"dangerousGoods": false,
"incoterm": "DDP",
"invoiceCurrency": "USD",
"invoiceValue": "100.00",
"instruction": "Fragile",
"weight": "1.5",
"weightUnit": "kg",
"volume": "0.1",
"description": "Electronics",
"nativeDescription": "电子产品",
"length": "20.0",
"width": "15.0",
"height": "10.0",
"dimensionUnit": "cm",
"batteryPacking": 0,
"batteryType": 0,
"sku": "SKU001",
"parcelItems": [
{
"uuid": "item-001",
"sku": "SKU001",
"description": "Phone Case",
"nativeDescription": "手机壳",
"hsCode": "8517",
"originCountry": "CN",
"unitValue": 10.00,
"itemCount": 2,
"weight": 0.3,
"extendData": {
"itemExportInvoiceValue": "20.00",
"itemExportInvoiceCurrency": "USD"
}
}
],
"shipperAddress": {
"addressId": "ship-addr-123",
"country": "CN",
"addressLine1": "456 Shipper St",
"addressLine2": "",
"addressLine3": "",
"city": "Shenzhen",
"state": "Guangdong",
"postcode": "518000",
"shipperName": "Sender Name",
"shipperPhone": "+861234567890",
"shipperEmail": "sender@example.com",
"shipperOrganizationCode": "ORG001",
"shipperCompanyName": "Sender Company"
},
"returnAddress": {
"addressId": "ret-addr-123",
"addressLine1": "789 Return St",
"addressLine2": "",
"addressLine3": "",
"city": "Shenzhen",
"state": "Guangdong",
"postcode": "518000",
"country": "CN",
"returnName": "Return Name",
"returnPhone": "+861234567890",
"returnOption": "Return"
},
"insur": {
"uuid": "ins-001",
"cancel": false,
"insureType": "02",
"insuredContackName": "Insured Name",
"insuredName": "Contact Name",
"insureAmount": "500.00",
"insureCurrency": "USD",
"insureCardNo": "ORG123456",
"projectNo": "POL123456"
},
"extendData": {
"vendorid": "VEN001",
"agentID": "AGENT001",
"sortCode": "SORT001",
"purpose": "Commercial",
"material": "Plastic",
"codAmount": "100.00",
"codCurrency": "USD",
"receiverKycType": "Individual",
"receiverKycNo": "KYC001",
"injectPort": "LAX",
"abnnumber": "ABN123456",
"gstexemptioncode": "GST001",
"platformorderno": "PLATFORM123",
"coveramount": "200.00",
"senderTaxId": "TAX001",
"postage": "10.00",
"icms": "5.00",
"vat": "20.00",
"originPort": "SZX",
"osnr": "0",
"specialHandlingType": "SH05",
"holdForPickup": "N",
"residentialSignatureRequired": "Y",
"saturdayDelivery": "N",
"exportInvoiceValue": "150.00",
"exportInvoiceCurrency": "USD",
"imei1": "IMEI001",
"imei2": "IMEI002",
"warehouseID": "WH001"
}
}
{code}

h2. 返回示例

{code}
{
"success": true,
"code": "0",
"data": {
"warnings": [],
"errors": [],
"errorMessage": null
}
}
{code}

h2. 返回字段说明

|| 字段 || 类型 || 说明 ||
| success | Boolean | 请求是否成功 |
| code | String | 响应状态码，0表示成功 |
| data | Object | 返回数据 |
| data.warnings | Array | 警告信息列表 |
| data.errors | Array | 错误信息列表 |
| data.errorMessage | String | 错误信息（当有错误时返回） |

h2. 错误处理说明

接口可能返回三种情况：

1. 成功：warnings和errors都为空
2. 有警告：warnings有内容，errors为空
3. 有错误：errors有内容，或errorMessage有值
4. 同时有警告和错误：warnings和errors都有内容

前端会根据返回结果展示不同的提示框：

有警告和错误：先展示警告，确认后再展示错误
只有警告：展示警告后关闭页面
只有错误：展示错误信息
成功：显示保存成功并关闭页面

h2. 前端文件位置

主文件：viewPages/shipper/views/orders/shippingOrders/OrdersDetail.vue

子组件目录：viewPages/shipper/views/orders/addOrder/ordersDetailComponents/

* OrderInfo.vue - 订单基本信息
* RecipientAddressInfo.vue - 收件人地址信息
* ParcelInfo.vue - 包裹信息
* ProductItemInfo.vue - 物品信息
* ShipperAddressInfo.vue - 发货人地址信息
* ReturnAddressInfo.vue - 退货地址信息
* OnlineInsuranceInfo.vue - 在线投保信息
* TrackingInfo.vue - 跟踪号信息（只读）

接口文件：viewPages/shipper/api/orders/shippingOrders.js

数据文件：viewPages/shipper/utils/data/orders/shippingOrdersDetail.js一、订单基础信息 (OrderInfo)

二、收件人地址信息 (RecipientAddressInfo)

注意：收件人地址信息会被组装成address对象提交，需包含addressId（编辑时必传）

三、包裹信息 (ParcelInfo)

四、扩展字段 extendData (共31个字段)

扩展字段包含以下内容：

注意：

• 以上31个字段会被收集到extendData对象中提交
• 如果接口未返回某字段，传空字符串""
• 最后2个字段（shipperOrganizationCode、shipperCompanyName）虽然展示在发货人地址模块，但提交时放入extendData对象中

注意：extendData字段如果接口未返回，传空字符串""

五、物品信息 parcelItems (数组)

六、收件人地址对象 address

七、发货人地址对象 shipperAddress

注意：shipperOrganizationCode和shipperCompanyName虽然展示在发货人地址模块，但提交时放入extendData对象中，不在shipperAddress对象内

八、退货地址对象 returnAddress

九、在线投保信息 insur

投保字段校验规则：

• cancel=true：不投保，提交时删除整个insur对象
• cancel=false：投保时必须填写insuredContackName、insuredName、insureCardNo
• insureType=02（公司）：insureCardNo为组织机构代码证
• insureType=01（个人）：insureCardNo为身份证号码

十、其他参数

下拉框选项数据

1. 体积单位选项 (DIMENSIONUNIT_OPTIONS)

2. 退货选项 (RETURN_OPTIONS)

3. 投保额币种 (INSURANCE_CURRENCY_OPTIONS)

4. 付税方式选项 (INCOTERM_OPTIONS_DEFAULT)

5. 扣留类型 (HELDS_OPTIONS，共32种)

参数联动关系

1. 国家 → 服务列表联动

2. 服务 → 服务选项联动

3. 服务ID → 付税方式可选值规则

// 服务ID与付税方式可选值对应关系：
服务ID=28,35,36,37,58,67,274：仅DDU
服务ID=29：美国(US)只能DDP，英国(GB)和其他可DDU/DDP
服务ID=57,174,273：仅DDP
服务ID=139：仅DDP（代码中配置为DDP、DDU，但实际仅DDP可用）
服务ID=140,141,142,198,238,249,377：DDP、DDU
服务ID=0：DDU、DDP（默认）
其他：DDU、DDP

4. 国家 → 储物柜服务显示

// 显示条件：addressCountry === 'RU'
// 字段：lockerService（Boolean）
// 仅俄罗斯显示储物柜选项

5. 服务 → ATL授权放置显示

// 显示条件：channel ∈ [2, 3, 42, 585, 586, 587]
// 字段：authorityToLeave（Boolean）
// 仅特定服务渠道显示ATL选项

6. 国家 → 澳洲特定字段显示

// 显示条件：addressCountry === 'AU'
// 显示字段：
//   - abnnumber（澳洲生意注册号码）
//   - gstexemptioncode（免税码）
//   - coveramount（投保金额）

7. 服务 → 巴西特定字段显示

// 显示条件：channel ∈ [946, 1161]
// 显示字段：
//   - postage（邮费）
//   - icms（ICMS税）
//   - vat（VAT税）

8. 服务 → 印度特定字段显示

// 显示条件：channel ∈ [698, 721, 724, 722, 725, 723, 726, 786]
// 显示字段：originPort（起运港）
// 显示条件：channel ∈ [1062, 1063]
// 显示字段：
//   - osnr
//   - specialHandlingType
//   - holdForPickup
//   - residentialSignatureRequired
//   - saturdayDelivery

9. 服务 → 平台订单号显示

// 显示条件：channel ∈ [139, 205, 237, 238, 249, 273, 275, 293, 345, 362, 364]
// 显示字段：platformorderno

10. 服务 → IMEI字段显示

// 显示条件：channel = 1153
// 显示字段：
//   - imei1
//   - imei2

请求示例

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "facility": "*",
  "channel": 29,
  "serviceOption": "STANDARD",
  "billingPartyName": "Test Company",
  "platform": "eBay",
  "lockerService": false,
  "authorityToLeave": true,
  "recipientName": "John Smith",
  "recipientCompany": "Smith Ltd",
  "phone": "+44 20 1234 5678",
  "email": "john.smith@example.com",
  "trackingNo": "TRACK123456",
  "refNo": "REF123456",
  "refNo1": "REF789012",
  "dangerousGoods": false,
  "incoterm": "DDP",
  "invoiceCurrency": "GBP",
  "invoiceValue": 25.99,
  "instruction": "Please call before delivery",
  "weight": 1.5,
  "weightUnit": "kg",
  "volume": 0.003,
  "description": "Cotton T-Shirt",
  "nativeDescription": "纯棉T恤",
  "length": 30,
  "width": 20,
  "height": 5,
  "dimensionUnit": "cm",
  "batteryPacking": "NOBATTERY",
  "batteryType": "NOBATTERY",
  "recipientTaxId": "GB123456789",
  "sku": "SKU001",
  "actualWeight": 1.6,
  "actualVolume": 0.0032,
  "actualLength": 30.5,
  "actualWidth": 20.5,
  "actualHeight": 5.5,
  "girth": 90,
  "actualGirth": 92,
  "address": {
    "addressId": "addr-123-456-789",
    "country": "GB",
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "addressLine3": "London",
    "city": "London",
    "state": "England",
    "postcode": "SW1A 1AA"
  },
  "parcelItems": [
    {
      "uuid": "item-uuid-001",
      "sku": "ITEM001",
      "description": "Cotton T-Shirt - Blue",
      "nativeDescription": "纯棉T恤-蓝色",
      "hsCode": "61091000",
      "originCountry": "CN",
      "unitValue": 12.99,
      "itemCount": 2,
      "weight": 0.3,
      "productURL": "https://example.com/product/123",
      "warehouseNo": "WH-SZ-001",
      "pictures": [
        "https://example.com/images/item1-front.jpg",
        "https://example.com/images/item1-back.jpg"
      ],
      "extendData": {
        "itemExportInvoiceValue": 15,
        "itemExportInvoiceCurrency": "GBP"
      }
    }
  ],
  "shipperAddress": {
    "addressId": "ship-addr-123-456",
    "country": "CN",
    "addressLine1": "456 Shipping Street, Suite 100",
    "addressLine2": "Futian District",
    "addressLine3": "Shenzhen",
    "city": "Shenzhen",
    "state": "Guangdong",
    "postcode": "518000"
  },
  "returnAddress": {
    "addressId": "ret-addr-123-456",
    "addressLine1": "789 Return Street",
    "addressLine2": "Warehouse B",
    "addressLine3": "Industrial Zone",
    "city": "Shenzhen",
    "state": "Guangdong",
    "postcode": "518001",
    "country": "CN",
    "returnName": "Return Department",
    "returnPhone": "+86 13900139000",
    "returnOption": "Return"
  },
  "insur": {
    "uuid": "ins-uuid-001",
    "cancel": false,
    "insureType": "01",
    "insuredContackName": "Zhang San",
    "insuredName": "Li Si",
    "insureAmount": 100,
    "insureCurrency": "GBP",
    "insureCardNo": "110101199001001234",
    "projectNo": "POL2023001"
  },
  "extendData": {
    "vendorid": "VENDOR001",
    "agentID": "AGENT001",
    "sortCode": "SORT001",
    "purpose": "GIFT",
    "material": "COTTON",
    "codAmount": 0,
    "codCurrency": "",
    "receiverKycType": "INDIVIDUAL",
    "receiverKycNo": "KYC123456",
    "injectPort": "LHR",
    "abnnumber": "",
    "gstexemptioncode": "",
    "platformorderno": "EBAY-ORDER-123",
    "coveramount": 100,
    "senderTaxId": "CN123456789",
    "postage": "",
    "icms": "",
    "vat": "GB20",
    "originPort": "CN",
    "osnr": "",
    "specialHandlingType": "",
    "holdForPickup": "",
    "residentialSignatureRequired": "",
    "saturdayDelivery": "",
    "exportInvoiceValue": 30,
    "exportInvoiceCurrency": "GBP",
    "imei1": "",
    "imei2": "",
    "warehouseID": "",
    "shipperOrganizationCode": "91310000MA1X4QC",
    "shipperCompanyName": "Shenzhen Tech Co., Ltd"
  }
}

返回示例

{
  "success": true,
  "code": "0",
  "data": {
    "warnings": [
      "包裹重量可能超过服务限制"
    ],
    "errors": [],
    "errorMessage": null
  }
}

返回字段说明

错误码说明

业务规则说明

1. 1. 编辑权限控制

• 订单状态判断：

• status >= 0 且 status < 2：可编辑
• 其他状态：不可编辑
• 虚拟服务判断：extendData.virtualId存在时为虚拟服务，不可编辑

• 可编辑字段（非虚拟服务且状态在可编辑范围内）：

• serviceOption
• platform
• lockerService
• authorityToLeave
• 收件人地址信息
• 包裹信息
• 物品信息
• 发货人地址信息
• 退货地址信息
• 投保信息

1. 2. 表单校验规则

• 订单信息模块（OrderInfo）：

• facility：必填
• channel：必填

• 收件人地址模块（RecipientAddressInfo）：

• recipientName：必填
• addressLine1：必填
• city：必填
• postcode：必填

• 包裹信息模块（ParcelInfo）：

• refNo：必填
• invoiceValue：必填，≥0
• description：必填
• weight：≥0
• volume：≥0
• length：≥0
• width：≥0
• height：≥0
• codAmount：≥0
• exportInvoiceValue：数字格式

• 发货人地址模块（ShipperAddressInfo）：

• addressLine1（shipperAddressLine1）：必填
• city（shipperAddressCity）：必填
• shipperEmail：邮箱格式校验

• 退货地址模块（ReturnAddressInfo）：

• city（returnAddressCity）：必填
• addressLine1（returnAddressLine1）：必填

1. 3. 数据组装规则

• 收件人地址字段会被组装成address对象：

• addressId：从服务端返回的orderDetial.addressId获取
• country：从addressCountry获取
• addressLine1-3：从对应字段获取
• city：从addressCity获取
• state：从addressState获取
• postcode：从addressPostcode获取

• 不直接提交addressCountry、addressLine1等原始字段
• 同理，shipperAddress和returnAddress也需要从对应字段组装

1. 4. 扩展字段处理规则

• 包含35个字段，详见上文"扩展字段 extendData"
• 如果接口未返回某字段，传空字符串""
• shipperOrganizationCode和shipperCompanyName：

• 展示在发货人地址模块
• 从服务端的extendData中提取到根级别
• 提交时收集回extendData对象中

1. 5. 物品信息处理规则

• 新增物品：uuid为空或以"add-"开头，提交时删除uuid字段
• 编辑物品：保留原uuid
• 删除物品：标记isDelete=true，只保留uuid字段
• 物品的extendData包含：

• itemExportInvoiceValue：出口申报金额
• itemExportInvoiceCurrency：出口申报币种

1. 6. 投保信息校验逻辑

• cancel=true：不投保

• 提交时删除整个insur对象

• cancel=false：投保

• 必须填写：insuredContackName、insuredName、insureCardNo
• insureType=02（公司）：insureCardNo为组织机构代码证
• insureType=01（个人）：insureCardNo为身份证号码

1. 7. 响应处理规则

• warnings有值，errors为空：

• 显示警告提示框
• 订单编辑成功，关闭页面

• warnings有值，errors有值：

• 先显示警告提示框（用户点继续）
• 再显示错误提示框
• 订单编辑失败

• errors有值，warnings为空：

• 显示错误提示框
• 订单编辑失败

• 两者都为空：

• 显示保存成功
• 关闭页面

1. 8. 实际测量字段处理

• actualWeight、actualVolume、actualLength、actualWidth、actualHeight：

• 从服务端返回
• 不可编辑
• 原样提交

• girth、actualGirth：

• 仅在值≠-1时从服务端返回
• 原样提交

注意事项

1. 编辑与创建的区别

• 编辑时必须提供uuid参数
• 编辑时需要提供addressId（收件人、发货人、退货地址）
• 编辑时需要提供actualWeight等实际测量字段并原样提交
• 编辑时某些字段可能被禁用，取决于订单状态
• 编辑时trackingNo不可修改

1. 重量和尺寸单位

• 重量单位：kg（千克）、lb（磅）
• 体积单位：cm（厘米）、in（英寸）、m（米）
• weightUnit和dimensionUnit必须与实际填写值保持一致

1. 物品信息

• 至少需要一个物品信息
• description（英文描述）和nativeDescription（中文描述）至少填写一个
• pictures数组最多5张图片URL

1. 发货人邮箱

• 必须符合邮箱格式校验

1. 退货选项

• 必须选择一项：Destroy、Return、Forward、Change
• returnPhone为必填字段（编辑时可能根据实际情况调整）

1. 虚拟服务

• 如果extendData.virtualId存在，表示是虚拟服务
• 虚拟服务时更多字段会被禁用