宋城旅游接口（千古情）(10014146).md
宋城旅游门票供应接口
接口实现功能
合作协议
宋城旅游接口技术配置
宋城旅游接口系统提供参数
自我游系统发布及设置
测试环节
处理订单
订单退款
常见问题
编辑日期：20190404
编辑人：卢晓晴
宋城旅游接口（千古情）门票供应接口
接口实现功能
取消订单(支持)
获取对方订单详情(支持)
查询对方接口日志(支持)
生成通知单对接（支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与宋城旅游接口（千古情）之间的合作协议）
运营商与宋城旅游接口系统提供参数
宋城旅游接口（千古情）技术配置
退款审核，核销回调地址：
http://运营商域名/api/songchenglvyou/orderNotice.jsp
ip地址列表：
14.17.112.50, 14.17.112.51, 14.17.112.52
14.17.112.53, 14.17.112.54, 14.17.112.55
14.17.112.56, 14.17.112.57, 14.17.112.58
14.17.112.59, 14.17.112.60, 14.17.112.62
14.17.96.76, 122.13.172.21, 58.248.137.132
自我游系统发布及设置
方法一：
运营商到【供应商接口管理】---【已开通接口】，找到对应的宋城旅游接口，操作同步供应商产品进入产品列表，搜索宋城旅游接口后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可）。同步到自我游系统的产品在【产品管理】中也可以看到。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到票付通。
产品短信：若是使用宋城旅游接口的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$
对应接口：产品导入时自动对应接口。
产品编码：导入时自动对应宋城旅游接口系统查询产品编号。
方法二：
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到宋城旅游接口。
产品短信：若是使用宋城旅游接口的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$
对应接口：由自我游配置好接口后才会显示，选择自我游配置的宋城旅游接口接口。
产品编码：点击产品编码参考进入产品列表查询对应的宋城旅游接口产品，将对应的绑定编码填写上。
测试环节
产品发布完毕，用分销商账号下单测试。
处理订单
查看订单状态，若订单状态显示【已成功，已支付。待出票】且那边宋城旅游接没有订单同步，检查一下订单是否已经生成了通知单，需要生成了通知单才会下单到宋城旅游接系统。
出票无误之后，测试验证，系统是会自动抓取核销信息的，观察一下宋城旅游接核销之后自我游系统的订单状态是否变成【已完成】。
一旦出现错误：让运营商截图，点击重新执行，查看失败原因；查看接口详细日志，是出现什么异常；查看产品编号是否已经填写正确。
订单退款
订单状态“已出票”：分销商登录系统，【订单管理】点击【退改申请】，运营商在退改申请功能里允许取消并点击退款后，取消的申请才会下发到宋城旅游接系统。然后宋城旅游接系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。宋城旅游接系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到宋城旅游接系统。然后宋城旅游接系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。宋城旅游接系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志