8. 公共参数（地址 / 包裹）与错误信息速查
rate 与 print 共用以下地址与包裹参数。
发货地址参数（shipper_*，选填，可传 vendor_address_id / vendor_address_label 替代）
| 参数 | 说明 |
|---|---|
shipper_name |
发件人姓名 |
shipper_company |
发件公司 |
shipper_telphone |
联系电话 |
shipper_email |
邮箱 |
shipper_country |
国家（如 US） |
shipper_state |
州/省 |
shipper_city |
城市 |
shipper_street1 / shipper_street2 |
街道地址1 / 2 |
shipper_zipcode |
邮编 |
收货地址参数（recipient_*）
| 参数 | 必填 | 说明 |
|---|---|---|
recipient_name |
是 | 收件人姓名 |
recipient_street1 |
是 | 街道地址1 |
recipient_city |
是 | 城市 |
recipient_country |
是 | 国家（如 US） |
recipient_company |
选填 | 收件公司 |
recipient_street2 |
选填 | 街道地址2 |
recipient_zipcode |
选填 | 邮编 |
recipient_state |
选填 | 州/省 |
recipient_email |
选填 | 邮箱 |
recipient_telphone |
选填 | 联系电话 |
包裹参数（packages 数组，rate/print 通用）
| 参数 | 必填 | 说明 |
|---|---|---|
packages[i].name |
选填 | 包裹名称/品名 |
packages[i].length |
是 | 长 |
packages[i].width |
是 | 宽 |
packages[i].height |
是 | 高 |
packages[i].weight |
是 | 重量 |
packages[i].weight_unit |
是 | 重量单位：lb/g/kg/oz |
packages[i].length_unit |
是 | 长度单位：in/cm/m |
packages[i].unit |
选填 | 单位制，默认 1（公制） |
错误信息速查（code=400，message/msg 返回）
| 接口 | 错误信息 | 说明 |
|---|---|---|
| 通用 | Please provide the vendor ID! |
缺少客户 ID |
| 通用 | Please provide the package info! |
未传递包裹信息 |
| 通用 | Package N: dimensions and weight are incomplete! |
第 N 个包裹尺寸/重量不全 |
| 通用 | Package N: invalid weight unit, only lb/g/kg/oz are supported! |
第 N 个包裹重量单位非法 |
| 通用 | Package N: invalid length unit, only in/cm/m are supported! |
第 N 个包裹长度单位非法 |
| 通用 | Invalid weight unit / Invalid length unit, ... |
旧版单包裹格式单位非法 |
| 通用 | Please provide the complete recipient address! |
收货地址不完整（name/street1/city/country） |
Please provide the shipping code! |
打单缺少渠道编码 | |
Please provide the shipping service code! |
打单缺少渠道服务编码 | |
Insufficient vendor balance, please top up first! |
余额+信用额度 ≤ 0，请先充值 | |
Carrier not found |
承运商不存在 | |
Label fetch timeout: waiting 1200s, ... |
面单获取超时 | |
| cancel | Please provide the order ID! |
缺少订单 ID |
| cancel | Order not found! |
订单不存在或非本人订单（归属校验失败同样返回该提示） |
| cancel | Order already completed, cannot be canceled! |
订单已完成，不可取消 |
| cancel | Order already canceled, do not repeat! |
订单已取消，请勿重复操作 |
| cancel | Service not found for this order! |
订单对应服务不存在 |
| label | Shipping not found for this order! |
订单对应渠道不存在 |
| label | Label data is empty / Response missing base64code |
渠道未返回面单数据 |
| 通用 | 渠道透传错误（msgEn/Msg） |
渠道接口返回的错误信息原样返回 |