Skip to content

工单状态回调通知

基本信息

Path:

Method: POST(平台主动推送)

使用说明

  • 分销商在旅仓后台配置回调地址后,工单状态变更时平台会主动推送通知;
  • 推送超时 30 秒,超时视为失败,不重试;
  • 通知通过 HTTP POST 发送 JSON,需返回旅仓标准响应格式。

请求参数

Headers

参数名称参数值是否必须示例备注
Content-Typeapplication/json
x-lvcang-api-account开放平台分配aaa.test用于识别分销商身份

Body

名称类型是否必须备注
timestring必须通知时间,格式 yyyy-MM-dd HH:mm:ss
workOrderNostring必须工单编号
lcOrderIdstring必须旅仓订单号
hotelOrderIdstring必须酒店供应商订单号
statusinteger必须工单当前状态:0 处理中 / 1 已完结
previousStatusinteger非必须变更前状态(首次创建时为空)
eventTypestring必须事件类型,见下方说明
messagestring非必须变更描述

事件类型(eventType)

说明触发场景
CREATED工单创建分销商提交工单成功
STATUS_CHANGED状态变更工单处理状态发生变化
REPLIED工单回复平台客服回复工单
URGED催单分销商发起催单

返回要求

接收方需返回旅仓标准响应格式:

json
{
    "code": "0",
    "message": "success",
    "success": true
}
  • code: "0" 表示接收成功,非 "0" 视为失败;
  • 平台收到失败响应仅记录日志,不重试。