数据约定

本页说明各接口共用的数据格式、订单模型和典型对接流程。字段的取值和含义见各接口页的「请求参数」「返回响应」。

数据格式

金额单位为分，以字符串形式返回（如 "payAmount": "20000"）；数量为数字。

时间格式 yyyy-MM-dd HH:mm:ss，日期格式 yyyy-MM-dd。

没有值的字段返回 null。

一笔订单按 saleType 分为三类，退订方式不同：

`saleType`	是什么	怎么退订
`SINGLE` 销售订单	游客最初购买的订单：普通订单、预售券订单、组品主订单	「申请退单」，整单退
`PRESALE` 预约子订单	预售券预约后生成，`parentOrderNo` 为预售券订单号	「取消预约」，只取消预约，不退预售券
`COMBO` 组品子订单	组品订单拆出的各业态订单，`parentOrderNo` 为组品主订单号	随组品主订单「申请退单」，不能单独退

「查询订单列表」默认只返回销售订单；传 subOrderFlag=1 时，子订单紧跟所属销售订单返回。

预售券订单退单时，已预约成功的预约会被自动取消。

预约取消后重新预约会产生新的预约子订单，旧的仍会返回，用 orderStatus 判断是否有效。

游客来电要退单或取消预约：

「查询订单列表」：按来电号码（linkPhone）或游客报的订单号查询，传 subOrderFlag=1 带出子订单，与游客确认是哪一笔订单。

按 saleType 选择操作：

要退预售券的预约，不退券：「取消预约」，orderNo 传预售券订单号；只取消其中一笔预约时，把预约子订单号传在 reservationOrderNo。

要退整笔订单：「申请退单」，orderNo 传销售订单号。

看结果：

「申请退单」返回 refundStatus=PROCESSING 时，用「查询退单」按 refundNo 查询，直到 SUCCESS 或 FAILED。

「取消预约」返回 cancelStatus=PROCESSING 时，稍后用「查询订单列表」（subOrderFlag=1）确认预约子订单的 orderStatus。

超时、网络异常或返回 2312 时，按响应处理的「超时与重试」用相同参数重试。

游客问景区信息： 「查询景区列表」按名称取得景区编码，再用「查询景区详情」查地址、营业时间和开园状态。