工单状态回调通知
基本信息
Path:
Method: POST(平台主动推送)
使用说明
- 分销商在旅仓后台配置回调地址后,工单状态变更时平台会主动推送通知;
- 推送超时 30 秒,超时视为失败,不重试;
- 通知通过 HTTP POST 发送 JSON,需返回旅仓标准响应格式。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | 开放平台分配 | 是 | aaa.test | 用于识别分销商身份 |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| time | string | 必须 | 通知时间,格式 yyyy-MM-dd HH:mm:ss |
| workOrderNo | string | 必须 | 工单编号 |
| lcOrderId | string | 必须 | 旅仓订单号 |
| hotelOrderId | string | 必须 | 酒店供应商订单号 |
| status | integer | 必须 | 工单当前状态:0 处理中 / 1 已完结 |
| previousStatus | integer | 非必须 | 变更前状态(首次创建时为空) |
| eventType | string | 必须 | 事件类型,见下方说明 |
| message | string | 非必须 | 变更描述 |
事件类型(eventType)
| 值 | 说明 | 触发场景 |
|---|---|---|
| CREATED | 工单创建 | 分销商提交工单成功 |
| STATUS_CHANGED | 状态变更 | 工单处理状态发生变化 |
| REPLIED | 工单回复 | 平台客服回复工单 |
| URGED | 催单 | 分销商发起催单 |
返回要求
接收方需返回旅仓标准响应格式:
json
{
"code": "0",
"message": "success",
"success": true
}code: "0"表示接收成功,非"0"视为失败;- 平台收到失败响应仅记录日志,不重试。
