深圳捷旅(房掌柜)酒店接口(新)文档
接口实现功能
合作协议
房掌柜系统提供参数
房掌柜技术配置回调地址
运营商提供参数
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期：20170106
修改人：张语嫣
深圳捷旅(房掌柜)酒店接口(新)文档
接口实现功能
产品导入同步（支持）
订单同步（支持）
退款同步（支持）
核销同步（支持）
接口返码（不支持）
****温馨提示****
1.API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
2.系统中的酒店信息绑定数据库是所有自我游商户共享的，即是A运营商绑定了房掌柜的酒店，B运营商可以直接共享，无需绑定即可使用。在对接同步房型时，自我游商家们务必一定要检查核实酒店绑定信息后，再操作房型同步。
合作协议
（运营商与深圳捷旅（房掌柜）系统之间的合作协议）
房掌柜系统提供参数
房掌柜技术配置回调地址
房掌柜推送订单状态地址：http://运营商域名/hotel/jl/updateOrderState.jsp
房掌柜推送价格地址： http://运营商域名/hotel/jl/updateRoomPrice.jsp
对接房掌柜接口由运营商提供给房掌柜的IP：
14.17.112.56,112.90.153.59,183.232.79.196,14.17.112.58,112.90.153.58,183.232.79.198,14.17.112.57,112.90.153.61,183.232.79.195,14.17.112.52,14.17.112.59
运营商提供参数
cust_id供应商id：运营商在自我游新增加一个供应商帐号，用于与房掌柜酒店对接。将供应商账号编码提供给自我游运营部人员绑定。【供应商帐号开通，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1002143/】
自我游系统发布及设置
对接房掌柜接口实现了导入产品同步，运营商无需另外发布产品。操作流程：【产品管理】→【房掌柜酒店对接(新)】→【同步房型】。
【房掌柜酒店对接(新)】的页面，点击“同步房型”，这样操作后自我游系统就会自动生成这个酒店的新产品到【产品管理】，商户到【产品管理】，找到相应的产品，点击【上架】（产品的图片不能同步，需要运营商自己上传产品图片）。
对接房掌柜的产品，只同步房掌柜系统产品的采购价及库存。所以开通供应商帐号时，要给房掌柜这个供应商开通权限，设置一个加价规则。房掌柜的所有酒店就会统一按照这个价格规则设置了。
商户可以通过点击【价格规则设置】，针对某个酒店的产品设置一个新的价格。
已同步的产品，如需取消直连，可点击【取消同步】。
产品编码对应的数字代表的意思：房型ID + 价格类型id + 配额类型 + 早餐 + 供应商+酒店ID +酒店编码+酒店名称。
测试环节
使用分销商账号进行下单并支付。
订单退款
未支付的订单退款步骤：
只要在自我游系统给订单点击“取消”，系统会自动调用房掌柜的接口申请取消，无需人工再操作申请。已经支付成功的订单退款步骤：
退款的方式分为二种：
(1) 运营商对订单做异常处理。运营商在【订单管理】里找到该订单，对订单做异常订单处理，处理好后，点击“退款”，则退款完成。
(2) 分销商发起退款申请。运营商看到申请后处理订单后，方可退款。
注意，分销商预定产品时，需要认真查看产品的退改说明。以免不可以取消的产品会给您造成不必要的损失。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志
Q：对接房掌柜的接口，订单在自我游系统生成后，订单处于什么状态下才会同步到房掌柜的系统？
A:目前关于深圳捷旅-房掌柜的酒店接口，订单同步的情况分为2种：1.房掌柜系统规定的酒店是一经预订无法退单的情况下，订单支付成功后才会同步到房掌柜系统；2.房掌柜系统规定的酒店是一预订可允许退单的情况下，下单未支付状态就可以直接同步到房掌柜系统。
Q:关于房掌柜酒店编号的查询，如截图，自我游系统的‘房掌柜酒店信息’这个界面无法查询到需要对接的酒店编号，应如何获取？
A:直接登录房掌柜的系统查询即可，查询方法如下图：