订单查询与金额
POST /v2/order/search 的每条订单在顶层返回 priceDetail,由订单保存的价格明细投影而来。查询单个订单可使用订单号:
{
"filter": { "search": "O-DEMO-001" },
"paging": { "skip": 0, "limit": 1 },
"preferred": { "version": "v2", "currency": "CNY" }
}
金额口径
| 字段 | 含义 |
|---|---|
orders[].priceDetail.aggregated.sum |
扣减后订单总价,使用 priceDetail.currency |
orders[].priceDetail.aggregated.approximate.sum |
扣减后订单总价,使用 priceDetail.approximate.currency |
orders[].priceDetail.aggregated.sumReservation |
扣减前总价,使用 priceDetail.currency |
orders[].priceDetail.aggregated.approximate.sumReservation |
扣减前总价,使用 priceDetail.approximate.currency |
orders[].priceDetail.breakdown |
房费、税费及整单优惠明细;优惠通常为负数 |
顶层 priceDetail 与 details[].booking.rate.priceDetail 使用相同的币种、汇总和明细字段口径,但值不一定相同:后者是房价报价,可能隐藏整单优惠;顶层保留订单优惠及扣减后的总价。breakdown[].item 是按请求语言投影的展示文案。details[].payment.status 表示支付状态;订单总价不代表已经实收。
以下是仅展示相关字段的合成示例。房价与税费合计 CNY 1,000,预付立减 CNY 20、立返佣金 CNY 80,扣减后订单总价为 CNY 900;订单仍待支付:
{
"orders": [{
"no": "O-DEMO-001",
"priceDetail": {
"currency": "CNY",
"approximate": { "currency": "CNY", "exchangeRate": 1 },
"aggregated": {
"currency": "CNY",
"sumReservation": 1000,
"sum": 900,
"approximate": {
"currency": "CNY",
"sumReservation": 1000,
"sum": 900
}
},
"breakdown": [
{ "item": "房费", "type": "base", "amount": 900, "currency": "CNY" },
{ "item": "税费", "type": "tax", "amount": 100, "currency": "CNY" },
{ "item": "预付立减", "type": "discount", "amount": -20, "currency": "CNY" },
{ "item": "立返佣金", "type": "discount", "amount": -80, "currency": "CNY" }
]
},
"details": [{
"booking": { "rate": { "priceDetail": { "aggregated": { "sumReservation": 1000 } } } },
"payment": { "type": "prepay", "status": "toBePaid" }
}]
}],
"paging": { "skip": 0, "limit": 1, "count": 1 }
}
可在酒店 API 演示完成 mock 预订后查看 /v2/order/search 的响应和订单总价展示。完整字段定义见 Open API v2 Order 模型。