feat: update appraisal return address and test packaging assets
This commit is contained in:
@@ -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,平台在订单状态变化时主动通知第三方。
|
||||
|
||||
Reference in New Issue
Block a user