feat: update appraisal return address and test packaging assets

This commit is contained in:
wushumin
2026-06-15 20:08:36 +08:00
parent fa267c4413
commit 9be60fbe17
23 changed files with 1806 additions and 393 deletions

View File

@@ -200,6 +200,37 @@ POST /api/open/v1/orders
| `tracking_no` | string | 否 | 寄入运单号,可替代 `inbound_logistics.tracking_no` |
| `extra_info` | object | 否 | 购买、成色、附件、备注等扩展信息 |
### 5.3 单独设置寄回地址
```text
POST /api/open/v1/orders/return-address
```
第三方可以在建单后单独补录或更新寄回地址。订单已生成回寄运单后,不允许再修改。
### 5.4 请求参数
| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `external_order_no` | string | 是 | 第三方订单号 |
| `return_address` | object | 是 | 寄回地址,字段要求同创建订单接口 |
### 5.5 请求示例
```json
{
"external_order_no": "THIRD202605080001",
"return_address": {
"consignee": "张三",
"mobile": "13800138000",
"province": "浙江省",
"city": "杭州市",
"district": "西湖区",
"detail_address": "文三路 1 号"
}
}
```
### 5.2 可选对象字段
`product_info` 支持:
@@ -452,6 +483,15 @@ GET /api/open/v1/orders?order_no=AXY20260508120000123
"latest_desc": "客户已提交寄送运单:顺丰速运 SF1234567890等待鉴定中心签收。",
"latest_time": "2026-05-08 12:00:00"
},
"return_address": {
"consignee": "张三",
"mobile": "13800138000",
"province": "浙江省",
"city": "杭州市",
"district": "西湖区",
"detail_address": "文三路 1 号",
"full_address": "浙江省杭州市西湖区文三路 1 号"
},
"return_logistics": null,
"report_summary": {
"report_no": "R202605080001",
@@ -617,6 +657,7 @@ POST /api/open/v1/orders/shipping
2. 第三方完成签名调试。
3. 第三方调用套餐获取接口,确认可用套餐和 `price_package_code`
4. 第三方调用创建订单接口。最小只传 `external_order_no` 即可;如需要减少后续人工补录,建议同步传 `price_package_code``product_info``return_address``materials``inbound_logistics`
5. 商品实际寄出后,第三方调用发货通知接口提交 `express_company``tracking_no`
6. 第三方可通过查询接口主动查询订单状态
7. 如启用 webhook平台在订单状态变化时主动通知第三方。
5. 如建单时未提供寄回地址,或后续需要变更,可调用寄回地址接口补录或更新 `return_address`
6. 商品实际寄出后,第三方调用发货通知接口提交 `express_company``tracking_no`
7. 第三方可通过查询接口主动查询订单状态,并核对 `return_address`、物流和报告结果。
8. 如启用 webhook平台在订单状态变化时主动通知第三方。