修改日期：2023-08-24
修改人：符娇珠
对接前提
有美团海外店铺
一、接口实现功能
①自我游系统支持发布类目：门票、套餐、打包（套餐或联票）、线路
②产品价格和库存同步
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心
二、美团系统提供参数
登录沙箱后台记得选择线上环境，然后去生成otaId、secretCode参数
url：http://www.dianping.com 统一配置此固定地址
三、运营商提供参数
分销商id【分销商需要设置授信额度，接口支付方式：授信扣除】
四、自我游发布产品流程
4.1支持产品类目
门票、抢购、套餐，打包产品(A+B=C)、线路
4.2发布产品注意事项
①预定成功短信，如果是自营产品，根据产品实际情况来是否设置
②生成通知单及出票设置
生成通知单选择第三项以及出票设置选择为“不需要”
③对接供应商接口/绑定码库出票
门票类目：通知单选择在预订（支付）成功后自动锁定订单，无需生成通知单
出票：需要
出票短信：按实际需求设置
对应接口：选择对应接口
供应商产品编码：绑定供应商系统产品编码（按实际情况设置）/码库编码
④应到未到
门票类目应到未到处理：人工做退改处理（如果支持多次验证必选这项）
⑤销售对象：同行和直客
⑥销售范围：PC版本(b2b版本) ，H5手机版本(包含b2b和b2c两个版本)
五、产品推送步骤
点击【新美大海外门票】进行产品授权
若修改产品的价格库存后需点击【更新价格库存】， 已经授权的产品，如需下架，点击【（下线）取消授权】。
六、美团后台操作
6.1回调地址配置
先登录登录美团后台 https://e.dianping.com/overseas/poseidon/mt/index# 成功后再在打开美团海外的浏览器开新的窗口输入链接址https://www.dianping.com/overseas/openplatform/mt/register 登录开放平台进行沙箱测试，先在注册中心把下面的回调地址配置好，记得不要有空格，有空格会导致测试失败
正式环境以及测试环境的接口配置都需要填写好地址，测试环境和正式环境的接口地址一样。
占位接口URL：http://14.17.112.52:8080/channel/meituanseas/occupyMtSeasOrder.jsp
清位接口URL：http://14.17.112.52:8080/channel/meituanseas/releaseMtSeasOrder.jsp
确认并发货接口URL：http://14.17.112.52:8080/channel/meituanseas/confrimMtSeasOrder.jsp
取消接口URL：http://14.17.112.52:8080/channel/meituanseas/cancelMtSeasOrder.jsp
确认并发货查询接口URL：http://14.17.112.52:8080/channel/meituanseas/queryMtSeasOrder.jsp
核销查询接口URL：http://14.17.112.52:8080/channel/meituanseas/queryMtSeasVerifyOrder.jsp
取消查询接口URL：http://14.17.112.52:8080/channel/meituanseas/queryMtSeasCancelOrder.jsp
重发凭证URL：http://14.17.112.52:8080/channel/meituanseas/resendMtSeasOrder.jsp
心跳接口URL：http://14.17.112.52:8080/channel/meituanseas/checkSeasAlive.jsp
6.2沙箱测试
登录美团开放平台--API测试--订单沙箱测试
6.21验收标准（有2条验收数据，都需测试成功）
至少有一个订单完成了占位－确认并发货－确认并发货查询－取消－取消查询.推送这个周期，并且全部成功
①占位：直接在美团后台绑定自我游系统产品编码、输入联系方式 、姓名、价格和邮箱
点击【Goooo】按钮，返回【请求成功】即可
②确认并发货：输入美团订单号以及自我游产品id
点击【Goooo】按钮，返回【请求成功】即可
③确认并发货查询：：输入美团订单号
点击【Goooo】按钮，返回【请求成功】即可
④取消：输入美团订单号
点击【Goooo】按钮，返回【请求成功】即可
至少有一个订单完成了占位－清位周期，并且全部成功
①占位：直接在美团后台绑定自我游系统产品编码、输入联系方式 、姓名、价格和邮箱
点击【Goooo】按钮，返回【请求成功】即可
②清位，直接用刚刚占位成功的订单在美团后台输入，点击【Goooo】按钮，返回【请求成功】即可
（2）6.22测试订单推送流程
①占位：直接在美团后台绑定自我游系统产品编码、输入联系方式 、姓名、价格和邮箱
点击【Goooo】按钮，返回【请求成功】即可，
②确认并发货：直接用刚刚占位成功的订单在美团后台输入，点击【Goooo】按钮，返回【请求成功】
③推送：将第②步骤完成确认并发货成功的订单号给自我游我游对接人员再次推送出票状态，推送界面显示成功即可完成全部验收
沙箱环境测试成功之后到API开关模块数值修改为1。（1代表开放美团海外接口，0代表关闭美团海外接口）
七、美团后台正式环境发布产品流程
新增产品，产品供应商套餐id绑定自我游产品编码
休闲娱乐和演出的产品，需要在产品价格库存那边还有要填写分别的场次的对接编码，供应商套餐id对应的是自我游的产品编号。
测试环节
在美团官网上找到自己的产品，并下一个测试单。
订单退款
订单退款规则需要在美团后台进行设置，按照设置的规则执行。关于退改时限要求，请以平台官方通告为准。如逾期未处理造成损失，自行承担。
自营订单退款处理
①如接口要求自营产品需要人工审核，客人在美团发起退款申请，自我游商户必须在自我游系统【退改申请处理】，点击【处理】。自我游商户请勿对订单做异常处理，此操作退款状态是无法同步到美团。
7.2、对接第三方供应商系统的订单退款处理
①客人在美团发起退款申请，该订单对接的供应商接口还没升级自动推送退款请求，自我游商户需在自我游系统针对订单操作“异常处理”，选择“允许取消”保存后，再点击“退款”。接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，供应商同意退款，运营商再回到自我游【退改申请处理】，点击【处理】“同意取消”。若供应商拒绝退款，点击“拒绝取消”。状态会直接同步到美团。
②该订单对接的供应商接口还没升级自动推送退款请求，商户想实现自动推送退款请求给到供应商接口，自我游系统产品可设置退款规则，客人发起退款申请时，自我游系统会自动将退款请求推送给供应商接口，等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给美团。PS：该设置以实际下单退款后结果为准，因不是所有供应商接口都支持，在设置之后下单测试后产品再上线
③客人在美团发起退款申请，该订单对接的供应商接口可实现自动推送退款请求，接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，等供应商返回“同意退款”或“拒绝退款”状态给自我游，自我游再推送给美团。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志 ，查看错误并处理