订单同步
订单同步接口会有以下概念:
原订单: 机票与火车票的出票订单, 酒店的预订单(用户第一次到平台预订产生的订单) 订单状态: 出票(预订)/ 改签 / 退票(取消)单
在订单接口中会有以下三个字段:
字段名称 | 含义 |
---|---|
orderId | 原订单 唯一标识 |
operationId | 订单状态 改变的唯一标识 |
originalOperationId | 上一次的订单状态改变的唯一标识 |
机票的例子(酒店/火车票同理):
原订单:
orderId: 0001
operationId: 0001
originalOperationId: null // 原订单没有上一次
第一次改签:
orderId: 0001 // 订单号都是对应出票/预订单的唯一标识
operationId: 0002 // 标识一次订单状态改变
originalOperationId: 0001 // 对应原订单
第二次改签:
orderId: 0001
operationId: 0003
originalOperationId: 0002 // 对应第一次改签
最后退票:
orderId: 0001
operationId: 0004
originalOperationId: 0003 // 对应第二次改签
公共定义
City
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
code | String | [1] | 每刻城市编码 |
name | String | Y | 城市名称 |
adminDivCode | String | [1] | 行政区划编码(国内城市),如杭州 330100 |
[info] 说明:
[1] 行政区划编码与每刻城市 code 二选一必填,国内城市一般存在行政区划编码,可以只传行政区划编码,国际城市或者 TMC 做了国内城市映射,请使用每刻城市编码 code
OrderUseStatus
订单使用状态
code | 定义 | 简介 |
---|---|---|
ORDERED | 已预定 | 机票 & 火车:已出票(改签单为改签票出票),酒店:酒店已确认) |
USED | 已使用 | 机票:已使用,酒店:已离店,火车:已发车,用车:已完成 |
CHANGED | 已改签 | 机票 & 火车:已改签(改签单为改签票的改签) |
REFUND | 已退款 | 已退款(原单或者改签单上的标记,退单标记为“完成退款”) |
PARTIAL_REFUND | 部分退款 | 部分退款,酒店退部分间夜 |
REFUND_COMPLETE | 完成退票 | 只有退单有,表示在 orderId 订单维度整单已经退款 |