京东团购接口
接口实现功能
合作协议
京东系统提供参数
运营商提供参数
自我游提供参数
自我游产品发布及设置
京东系统设置及操作
产品推送步骤
测试环节
订单验证
订单退款
常见问题
修改日期:20161230
修改人:语嫣
京东团购接口
接口实现功能
订单同步
产品属性同步
门票产品只支持期票产品
产品必须是可以由京东无条件退款
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与京东团购之间的合作协议)
京东系统提供参数
运营商提供参数
提供分销商编号。【该分销商编号获取方法,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/1009468/】
自我游提供参数
订单同步通知接口地址:http://运营商域名/channel/jdtuangou/callback/sendOrder.jsp
退款通知接口地址:http://运营商域名/channel/jdtuangou/callback/orderRefund.jsp
发短信通知接口地址:http://运营商域名/channel/jdtuangou/callback/sendSms.jsp
产品销量同步接口地址:http://运营商域名/channel/jdtuangou/callback/queryTeamSellCount.jsp
自我游产品发布及设置
【合作伙伴→分销商管理】点击管理,设置接口支付方式为“授信扣除”;点击“信用授权”设置信用额度。(建议额度大一点,便于接口下单,授信不足会下单失败)。
更新京东团购标题名称对应的是自我游系统的产品简称(不是产品名称)。
有效期设置:京东团购所有产品的优惠券都是一段时间内有效,对应自我游产品设置应设置为期票,期票设置如图以下5个选项,任意一种。(京东要求订单有效期不可小于产品有效期,即产品有效期设置的时间段不能下于产品价格有效日期)。
更新优惠券消费截止日期京东接口不支持产品预约,不支持快递类产品。
预定说明与产品详细描述,必须填写,此项内容会同步到京东团购平台。
京东系统设置及操作
更新团购主图(不支持)
由于京东主图要求图片尺寸为440*280且图片大小在100kb以内 ,而与我方景点图片不相符,所以不支持更新主图,建议在产品上报后在京东团购平台人工上传景点主图。
产品推送步骤
【渠道(串货)管理】-【京东团购】-【产品授权】,操作顺序为:产品授权-京东产品设置-上报产品到京东。
京东产品设置:“所属城市”“优惠券绑定模式”选项,在产品上报到京东团购平台成功后,将不可再作修改(京东接口限制)。
优惠券绑定模式分为二种:
一个验证码只验证多张票:此模式,当京东订单同步到自我游系统时,在自我游系统将会对应一张订单。
一个验证码只验证一张票:此模式,当京东订单同步到自我游系统时,自我游系统将会根据购买数拆分成相应多张订单(如京东一有3张票订单,同步到自我游系统时会将这京东订单拆分成三个订单,且这三个订单里的票数为1)。更新京东产品一二级分类
查询团购信息:产品上报到京东后,可以通过此功能查看审核状态。如下图;
产品变更通知:京东团购平台对更新产品信息分成多个接口,所以此“产品变更通知”将会执行时间比其它时间长。若修改自我游产品信息,系统不会自动同步到京东团购,运营商必须手动在此点击更新。如下图:
目前京东只支持下架产品,产品下架后将不能再进行上架。
测试环节
在京东官网上找到自己的产品,并下一个测试单。
订单验证
若优惠券绑定模式为“一个验证码只验证多张票”的订单,在自我游系统只支持一次验证。
若优惠券绑定模式为“一个验证码只验证一张票”,由于订单已被拆分,也就订单里只有一张票,也就只有验证一次的可能。
订单退款
客人必须先在京东团购申请退款,但是退款审核权限是京东团购平台决定的,然后京东团购通过退款通知接口通知自我游系统(请运营商知晓此点)。自我游系统收到京东团购的退款通知后将会做退款处理。若优惠券绑定模式为“一个验证码只验证多张票”,则根据京东退款数量与退款金额来退款。若优惠券绑定模式为“一个验证码只验证一张票”,则全退。
常见问题
A:产品推送出现这个提示是什么原因?如图:
B:原因:产品的简称字符超过12个字了,修改在进行推送就可以了 。