页面历史

/api/shipper/v1/parcel/order/edit
{code}

h2. 请求方式
{code}
POST
{code}

h2. 请求头

|| 参数 || 类型 || 必填 || 说明 ||
| sessionId | String | 是 | 登录会话ID |
| language | String | 是 | 语言 |
| Content-Type | String | 是 | application/json |

*语言取值：*

|| 值 || 说明 ||
| zh_CN | 中文 |
| en_US | 英文 |

h2. 请求参数
该接口参数较为复杂，由多个模块的数据组合而成。

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"

POST

// 服务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

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

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

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

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

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

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

// 显示条件：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": "SKU001ITEM001",
      "description": "Phone CaseCotton T-Shirt - Blue",
      "nativeDescription": "手机壳纯棉T恤-蓝色",
      "hsCode": "851761091000",
      "originCountry": "CN",
      "unitValue": 1012.0099,
      "itemCount": 2,
      "weight": 0.3.3,
      "productURL": "https://example.com/product/123",
      "warehouseNo": "WH-SZ-001",
      "extendDatapictures": {[
        "itemExportInvoiceValue": "20.00https://example.com/images/item1-front.jpg",
        "itemExportInvoiceCurrency": "USDhttps://example.com/images/item1-back.jpg"
      }],
    }   ],"extendData": {
  "shipperAddress": {     "addressIditemExportInvoiceValue": "ship-addr-123"15,
        "countryitemExportInvoiceCurrency": "CNGBP",
     "addressLine1": "456 Shipper St", }
    }
 "addressLine2": "",
  ],
  "addressLine3shipperAddress": "",{
    "cityaddressId": "Shenzhenship-addr-123-456",
    "statecountry": "GuangdongCN",
    "postcodeaddressLine1": "518000456 Shipping Street, Suite 100",
    "shipperNameaddressLine2": "SenderFutian NameDistrict",
    "shipperPhoneaddressLine3": "+861234567890Shenzhen",
    "shipperEmailcity": "sender@example.comShenzhen",
    "shipperOrganizationCodestate": "ORG001Guangdong",
    "shipperCompanyNamepostcode": "Sender Company518000"
  },
  "returnAddress": {
    "addressId": "ret-addr-123-456",
    "addressLine1": "789 Return StStreet",
    "addressLine2": "Warehouse B",
    "addressLine3": "Industrial Zone",
    "city": "Shenzhen",
    "state": "Guangdong",
    "postcode": "518000518001",
    "country": "CN",
    "returnName": "Return NameDepartment",
    "returnPhone": "+86123456789086 13900139000",
    "returnOption": "Return"
  },
  "insur": {
    "uuid": "ins-uuid-001",
    "cancel": false,
    "insureType": "0201",
    "insuredContackName": "InsuredZhang NameSan",
    "insuredName": "ContactLi NameSi",
    "insureAmount": "500.00"100,
    "insureCurrency": "USDGBP",
    "insureCardNo": "ORG123456110101199001001234",
    "projectNo": "POL123456POL2023001"
  },
  "extendData": {
    "vendorid": "VEN001VENDOR001",
    "agentID": "AGENT001",
    "sortCode": "SORT001",
    "purpose": "CommercialGIFT",
    "material": "PlasticCOTTON",
    "codAmount": "100.00"0,
    "codCurrency": "USD",
    "receiverKycType": "IndividualINDIVIDUAL",
    "receiverKycNo": "KYC001KYC123456",
    "injectPort": "LAXLHR",
    "abnnumber": "ABN123456",
    "gstexemptioncode": "GST001",
    "platformorderno": "PLATFORM123""EBAY-ORDER-123",
    "coveramount": "200.00"100,
    "senderTaxId": "TAX001CN123456789",
    "postage": "10.00",
    "icms": "5.00",
    "vat": "20.00GB20",
    "originPort": "SZXCN",
    "osnr": "0",
    "specialHandlingType": "SH05",
    "holdForPickup": "N",
    "residentialSignatureRequired": "Y",
    "saturdayDelivery": "N",
    "exportInvoiceValue": "150.00"30,
    "exportInvoiceCurrency": "USDGBP",
    "imei1": "IMEI001",
    "imei2": "IMEI002",
    "warehouseID": "WH001"": "",
    "shipperOrganizationCode": "91310000MA1X4QC",
    "shipperCompanyName": "Shenzhen Tech Co., Ltd"
  }
}
{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
包裹重量可能超过服务限制"
    ],
    "errors": [],
    "errorMessage": null
  }
}