文档中心 > 酒店通用分销

订单详情

更新时间:2023/08/11 访问次数:1304

方法名称

taobao.xhotel.order.distribution.detail

使用说明

概述

查询订单详情。获取订单的所有信息。

注意事项

  • 请求参数中飞猪订单号和外部订单号不能都为空,如果入参飞猪订单号及外部订单号皆存在,则取飞猪订单号为准
  • 【创建订单】、【确认支付】、【取消订单】或接收到【订单状态变更消息】后请轮询查询订单状态以保持同步,以避免两端不一致带来的资损问题
  • 请不要强依赖返回结果可为空的参数

API入参

字段

类型

可为空

示例值

描述

dis_order_id

String

N

4564658412

外部分销订单号,飞猪订单号与外部订单号不能都为空

distributor

String

N

hello

分销渠道

fliggy_order_id

Number

N

飞猪订单号,飞猪订单号与外部订单号不能都为空

API出参

字段

类型

可为空

示例值

描述

result

Object

Y

取消请求响应

is_success

Boolean

N

true

请求是否成功

error_msg

String

Y

该订单不属于此分销渠道,不可操作

错误信息

error_resp_code

Number

Y

111

错误码

msg_for_dev

String

Y

开发查看的错误信息

result节点

字段

类型

可为空

示例值

描述

order_base_info

Object

N

订单基础信息

order_fulfill_info

Object

N

订单履约信息

room_info

Object

N

房间信息

hotel_info

Object

N

酒店信息

order_base_info节点-订单基础信息

字段

类型

可为空

示例值

描述

fliggy_order_id

Number

N

3037649439744395500

飞猪订单号

dis_order_id

String

N

456123156

分销渠道的外部订单号

order_status

Number

N

1

订单状态

order_status_desc

String

N

未付款

订单状态描述

order_create_date

Date

N

2020-01-01 00:00:00

contact_name

String

N

言五

联系人姓名

contact_phone

String

N

18817366666

联系人联系方式

daily_info_list

List<Object>

Y


每日价格信息

discount_fee

Number

N

20000

卖家优惠的金额,单位:分

platform_promotion_amt

Number

N

3000

平台优惠的金额,单位:分

total_actual_price

Number

N

50000

买家实际支付金额,单位:分

total_room_price

Number

N

73000

总房费,单位:分

buyer_real_refund

Number

Y

30000

买家实退金额,当退款未成功时为空,单位:分

daily_info_list节点-每日价格信息

字段

类型

可为空

示例值

描述

date

Date

N

2020-01-01 00:00:00

日期

price

Number

N

100000

房费(包含税费),单位人民币的分

order_fulfill_info-订单履约信息

字段

类型

可为空

示例值

描述

late_arrive_time

Date

Y

2022-11-17 00:00:00

最晚到店时间,可能为空

check_in

Date

N

2022-11-17 00:00:00

入住日期

check_out

Date

N

2022-11-18 00:00:00

离店日期

order_guest_list

List<Object>

N


入住人信息

room_number

Number

N

1

房间数

nights

Number

N

1

入住晚数

invoice_status

Integer

N

1

发票状态

invoice_status_desc

String

N

待开票

发票状态描述

order_guest_list-入住人列表

数组,其中对象定义如下:

字段

类型

可为空

示例值

描述

name

String

N

言五


room_info-房间信息

字段

类型

可为空

示例值

描述

room_name

String

N

大床房

房型名称

room_facility

String[]

Y

["含双早","双床1.35米","有窗"]

酒店房间设施

hotel_info-酒店信息

字段

类型

可为空

示例值

备注

hotelName

String

N

测试酒店名称

酒店名称

shid

Number

N

12345

飞猪标准酒店ID

seller_id

Number

N

12345

酒店卖家ID

hotelAddress

String

N

测试酒店地址

酒店地址

hotelTel

String

N

+86-566-2083333

酒店电话。格式:国家代码(最长6位)#区号(最长4位)#电话(最长20位)。国家代码提示:中国大陆0086、香港00852、澳门00853、台湾00886

longitude

Double

Y

103.986369

经度

latitude

Double

Y

30.629186

纬度

FAQ

关于此文档暂时还没有FAQ
返回
顶部