综合交通-商家对接
商家入驻问题
入驻奇门认证未通过不是企业资质认证
入驻要用企业账号在支付宝完成实名认证，商家检查企业支付宝账号关联认证是否通过
用淘宝账号登录开放平台控制台，然后点这个链接授权开放平台获取支付宝信息，试一下https://openauth.alipay.com/oauth2/publicAppAuthorize.htm?app_id=2021002164609043&scope=auth_user&redirect_uri=https://i.fuwu.taobao.com%2Fisv%2Falipay_callback.htm?type=top&execute=update
商家接入问题
奇门中心官方集成没有业务显示
1.没有授权实现方，提交appkey给技术支持授权
2.已经授权appkey仍没有业务场景，查看登录账号是否有误，必须是入驻的商家账号
飞猪侧出票成功的标志
1：回调出票成功 2：查询订单，订单状态返回3
价格单位是元还是分
价格单位统一是分
调商家创建订单接口时是否已经支付成功
是
出票逻辑：用户先点击去支付，会有10分钟的支付时间（十分钟未付款后自动关闭订单），支付成功后，调用创单接口锁单，锁单成功后调出票接口，等待商家出票，商家出票接口出票返回票信息，我们会调查单接口查询订单状态，最终飞猪出票状态以查单信息为准
拉取班次信息scheduleId保持全局唯一性
这个唯一标识一旦生成，以后每次同步都不能变，一旦变了就会认为是新车次。
查询余座、创建订单都传这个字段
scheduleId要全局唯一，返回的scheduleId不能和历史的scheduleId重复，否则我们拿到这个scheduleId会一直同步历史的班次
出发日期格式
yyyy-MM-dd
查询停运班次接口，这个接口可以不支持吗，还是必须要对接？
必接，因为之后如果班次停运我们拿不到状态，我们会定期拉取商家班次来获取状态的
不同时间段手续费收取如何配置
例：24小时不可退，24-48小时扣20%，48小时前不收手续费
begin end percent
0 1440 100
1440 2880 20
2880 0
不可退如何配置
percent=100
我们会解析percent=100的begin，begin时间内不可申请退票
停运班次的场景
1.在售的因不可抗力不能发车的
2.用户购了票还未发车的
退票接口乘客列表是否只会传退票的乘客
是的，但是需要标识是按单退还是按票退
飞猪出票回调和退票回调接口是哪个
出票回调接口：https://open.taobao.com/api.htm?docId=25473&docType=2
taobao.bus.agent.bookticket.confirm
退票回调接口：https://open.taobao.com/api.htm?docId=42022&docType=2
taobao.bus.agent.refund.confirm
退票接口
场景1：只退款，（不管票状态，不管下线退/线上退）
taobao.bus.agent.multiple.refund.confirm(?综合交通多次退款接口?)
https://open.taobao.com/api.htm?docId=49134&docType=2
场景2：异步退票，线上提交退票，商家退票成功之后调用该接口通知我们进行退款
taobao.bus.agent.refund.confirm(?汽车票退票和退款二合一接口?)
https://open.taobao.com/api.htm?docId=42022&docType=2
是否支持部分退
支持的，分按订单退和按票退
标志站点顺序怎么传
站点里的这个字段一定要传，比如路线从a->b 那a站点就是0，b站点就是1。
路线a->b->c a站点就是0，b:1, c: 2,依次类推。前边的站点一定要比后边的站点的值要小
第一个站点非必要是0
需要幂等的接口
创单，出票，退票
line Id是什么
line Id是查询班次时返回的这个路线id
fromtime格式是00:00
流水班次怎么传
fromtimetype=4 固定时间段发车
以下必填
流水班次的fromtime也要传
流水班次的fromTime传fromDurationBegin一样的值
创单接口lineid不传
lineid咱们不传，scheduleId是班次的唯一标识，以scheduleId为准
所属标准城市可以是地级市也支持县、区、镇
注意字段的大小写，不然解析错误
比如toCity 写成tocity会解析失败
字段类是boalean型的不能加双引号
比如true 传“true”会报错
字段类型是number数字类型不能加双引号
创单接口示例规范传值
出票接口必须返回票价和票状态
虽然是非必填的但还是要传
示例:
{"retCode":"0","retDesc":"success","success":true,"alitripOrderId":"5755116820","agentOrderId":"2309211112731666","agentIssueTime":"2023-09-21 13:48:03","status":"3","statusDesc":"出票成功","fetchTicketSpot":"","ticketWicket":"","smsContent":"","passengerList":[{"passengerCertificateNo":"44050811117271031","passengerCertificateType":"1","passengerId":"21111762203820","passengerName":"王","passengerType":"0","ticketList":[{"eTicketNo":"/2309112731666","ticketDesc":"","ticketExpireTime":"2023-09-21 13:48:03.0","ticketId":"230914111740549","ticketNo":"/23092111731666","ticketPrice":"18000","ticketPwd":"","ticketSeatNo":"*","ticketStatus":"2","ticketSubType":"11","ticketTitle":"","ticketType":"1"}]}]}
新增关闭订单接口
qimen.alitrip.custombus.order.close
（手动出票时间内未出票会调用此接口关闭订单，停止出票）
调整变价或者调价
在用户预定获取票价的时候，贵方如果调整价格辛苦贵方在创建订单接口能做一个拦截，把调整的价格和发车时间也返回给飞猪
定制巴士创建订单接口
https://open.taobao.com/api.htm?docId=63228&docType=2
行政编码
fromcity ，tocity可以传到区县镇或者其他名称，我们没做限制，比如（天府机场），但是code必须传地级市的行政编码
传了电子围栏，但看不到围栏范围
区域站点传的初始经纬度不在电子围栏里
如果商家自测提示缺少经纬度，
让商家检查一下有没有任意点，任意点的经纬度也要传，作为初始经纬度
如果要安排区域点的话只能选择一个区域点作为出发点，不能存在其他的站点。如果出发点都是固定点的话才能配多个途径站点
└ ticketId └ ticketNo要保持一致
经纬度值不能超过范围
站点经度取值范围：72 - 136
站点维度取值范围：3-54
乘客类型都传1
"passengerCertificateType":"1",
班次同步 注意事项
班次数据 如果 返回值有6个站点 A b c d e f
价格返回的只给了c f 这种的我们解析不了 ，，必须全部返回
比如：A-B-C-D-E-F ABC上车点、DEF下车点
segmentPrice正常的组合方式是：AD,AE,AF,BD,BE,BF,CD,CE,CF （这是理论上的，业务上看你们的实际情况哈）
同步班次时间
同步班次的record 是每天的早上5点生成一次。新增的线路得到第二天早上5点后才能同步排班。也就是今天新增的线路明天才能看到
需要用申请appkey的账户登录open.taobao.com，在对应应用左侧菜单--应用设置-授权管理（或者叫授权报备）进行申请，审批通过后才可进行授权
