优化发货接口对接流程

docs/开放接口-皮肤源头对接.md

@@ -215,6 +215,8 @@ GET /api/open/v1/orders/{order_no}
 
 ## 4. 接口二：发货结果推送
 
+> 当前接口只接受 `success` / `failed` 两种最终结果。`processing` 是旧口径里曾出现过的中间状态，当前 `ship_notify` 不再接受；当 `ship_status=failed` 时，`fail_reason` 必须填写详细失败原因。
+
 ### 4.1 请求
 
 ```http
@@ -235,16 +237,15 @@ Content-Type: application/json
 | 字段 | 必填 | 说明 |
 |------|------|------|
 | `order_no` | 是 | 店铺订单号 |
-| `ship_status` | 是 | `success` / `failed` / `processing` |
+| `ship_status` | 是 | 仅 `success` / `failed` |
 | `provider_order_no` | 否 | 你们系统的发货单号 |
 | `shipped_at` | 否 | RFC3339；success 未传则用服务端时间 |
-| `fail_reason` | 否 | 失败原因（failed 时建议填） |
+| `fail_reason` | 失败时是 | `failed` 时必填，填写详细失败原因 |
 
 ### 4.2 ship_status → 我们订单状态
 
 | ship_status | 订单变为 | 说明 |
 |-------------|---------|------|
-| `processing` | `delivering` | 已接单 / 发货中 |
 | `success` | `delivered` | 发货成功 |
 | `failed` | `ship_failed` | 失败，允许之后再次查询并重试 |
 
@@ -279,8 +280,6 @@ GET 订单查询
     ↓
 can_ship == false ？ → 停止，展示 cannot_ship_reason
     ↓ true
-（可选）POST ship_status=processing
-    ↓
 按 product.sku 发货
     ↓
 POST ship_status=success 或 failed