美团商品美团属性值填什么怎么填
点击联系发帖人
时间：2016-01-08 06:57
大家都在搜：
扫描二维码安装房天下APP
手机浏览器访问房天下
> > 问题详情
美团的成长值怎么算,和花的钱有关系吗
浏览次数：0
小伙伴们还在答题的路上，先看看下面这些内容吧~
怎样花更少的钱买更好的房子呢?以下这十招快来学学吧。 []
浏览量：5035
手机动态登录
请输入用户名/邮箱/手机号码！
请输入密码！
没有房天下通行证，
ask:2,asku:0,askr:44,askz:15,askzx0:659,ask0:0,RedisW:1askR:1,askD：724 mz:nohit,askU:0,askT:0askA:727
Copyright &
北京拓世宏业科技发展有限公司
Beijing Tuo Shi Hong Ye Science&Technology Development Co.,Ltd 版权所有
违法信息举报邮箱：【图文】美团网分析_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
美团网分析
大小：342.50KB
登录百度文库，专享文档复制特权，财富值每天免费拿！
你可能喜欢在 SegmentFault，解决技术问题
每个月，我们帮助 1000 万的开发者解决各种各样的技术问题。并助力他们在技术能力、职业生涯、影响力上获得提升。
一线的工程师、著名开源项目的作者们，都在这里：
获取验证码
已有账号？
问题对人有帮助，内容完整，我也想知道答案
问题没有实际价值，缺少关键内容，没有改进余地
类似美团的团购类网站设计mysql数据表时有必要加类似B2C网站的商品类型和属性吗
答案对人有帮助，有参考价值
答案没帮助，是错误的答案，答非所问
有必要，团购一量车和园内一顿早饭还是有很大区别的……
分享到微博？
关闭理由：
删除理由：
忽略理由：
推广（招聘、广告、SEO 等）方面的内容
与已有问题重复（请编辑该提问指向已有相同问题）
答非所问，不符合答题要求
宜作评论而非答案
带有人身攻击、辱骂、仇恨等违反条款的内容
无法获得确切结果的问题
非开发直接相关的问题
非技术提问的讨论型问题
其他原因（请补充说明）
我要该，理由是：& 美团网账号批发，美团团购帐号，小号出售
商品货号：ECS000192
商品库存：
商品点击数：8876
本店售价：￥0.18
用户评价：
商品总价：
购买数量：
此商品为免运费商品，计算配送金额时将不计入配送费用
商品描述：
本店美团账号已开通支付密码，全网独有技术，给您支付更方便！
如果你是那种觉得有个新账号。就可以买新用户减价物品的买家，那就不用买本店账号。同一手机，同一设备，同一IP同时间段，同一支付方式，同一银行卡支付，只能买一次新用户的物品。就算你换再多新号也提示不符合或者购买后封号等等，反正是成功不了。别说我的账号是旧号什么的。账号里面有购买记录才是旧号，没有就是新号。出售的账号不接收2次验证码，购买后一概不退不换。
温馨提示:不限制地区美团号
本店出售的是手机注册的新号!一个账号一个IP，一手账号,绝对可以登录的.卖出一概不退不换。拍前请看清使用限制，请勿因没看而申请退款或给出中差评。账号就像卫生纸一样，你使用过了再退给卖家，那已经没用了，请买家自重！
24小时自动发货
购买流程和收货流程：
发货格式:----abc123654----147258
账号格式:手机号码----随机密码----支付密码
本店只负责可以正常登陆，最好先买一个测试，OK，再多买
如果需要定制指定密码的请联系在线客服
账号属性：全新注册，已开通支付密码，没认证过邮箱
1. 1个IP下使用软件批量登陆N个帐号造成的 封号 帐号被注销 不在补号范围内!
2. 发过贴,回过贴，买过物品被封号（或注销）的帐号 不在补号范围内
3. 卖出帐号 不保存档案 买家帐号遗失自负
4.账号一经售出，概不退货！不得以任何理由申请退款！
5.所有帐号请在2小时内测试或是抽查，过后将不负责！
6.购买后不立即使用到账回收冻结不负责！
本店免费提供绿色数据整理工具，有需要的亲们请在百度网盘下载：
购买记录(近期成交数量4)
用户名购买数量购买时间订单状态
s***45 11:46:59成交
水***草1 11:36:54成交
q***810 14:50:56成交
2***8100 12:01:46成交
总计 4 个记录，共 1 页。美团开放平台开发文档
美团外卖开放平台是基于美团外卖平台的业务流程，为第三方平台及众多的餐饮公司，提供更加便捷的信息传递方式，以及信息管理方式，致力于提升消费者的服务体验，并增加消费者用餐选择。
美团外卖是美团网旗下的网上订餐平台，于2013年11月正式上线，目前覆盖两百余城市。美团外卖为消费者精心挑选众多优质外卖商家，提供快速、便捷的线上订外卖服务。
商家在开发过程中若有疑问请发送邮件至waimai.，正常情况下一个工作日内回复。
商家可以借助美团外卖开发者后台进行订单、门店等的查询，开通开发者后台权限请提供开通者的姓名、手机号码、公司和职务，发邮件至waimai.。 线下开发者后台地址：http://st.developer./
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
medicineCat/save
创建药品分类
新增创建药品分类接口
medicineCat/update
更新药品分类
新增更新药品分类接口
medicineCat/delete
删除药品分类
新增删除药品分类接口
medicineCat/list
查询门店药品分类列表
新增查询门店药品分类列表接口
medicine/save
新增创建药品接口
medicine/update
新增更新药品接口
medicine/batchsave
批量创建药品
新增批量创建药品接口
medicine/batchupdate
批量更新药品
新增批量更新药品接口
medicine/delete
新增删除药品接口
medicine/list
查询门店药品列表
新增查询门店药品列表接口
美团药品分类
美团药品分类code列表
新增美团药品分类code
美团药品属性
美团药品属性code列表
新增美团药品属性code
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
三方常见问题
补充三方常见问题
门店上线流程
描述门店上线流程
新增门店上线流程图
订单流转状态图
描述订单正常下单流程
新增订单状态流转图
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
三方常见问题
补充三方常见问题（什么情况下订单会美团系统自动取消、什么情况下美团外卖门店会被美团系统置休）
订单退款流程图
描述订单退款一般流程
新增订单退款流程图
API参数共由两部分组成, 系统级参数指所有由美团提供的API所必须的参数, 应用级参数是指对应API所需的参数。一般情况下, 系统级参数是调用API时所必须传递的参数
进行接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（日)
以秒计算的时间，即unix-timestamp
美团分配给APP方的id
输入参数计算后的签名结果
将所有参数（sig除外）按照参数名的字母顺序排序，并用&连接：app_id=&app_poi_code=31×tamp=
按照请求url + ? + 排序后的参数 + consumer_secret的顺序进行连接，得到加密前的字符串: /api/v1/poi/mget?app_id=&app_poi_code=31×tamp=d31ba58fd73c71db697ab5e4946d52d
注：参数中包含中文时，处理方法：中文保持原文即可，无需对其单独转码，示例(参数未列全部)如下
/api/v1/poi/save?app_id=&app_poi_codes=31&name=丽华快餐&address=北苑路北站K酷时代广场4层×tamp=d31ba58fd73c71db697ab5e4946d52d
对加密前的字符串进行MD5加密，得到签名 aea6f12161edfb6456143d
将得到的签名赋给sig作为get请求的参数 /api/v1/poi/mget?app_poi_codes=31&app_id=& timestamp=&sig=5cfbbaaf2c18
APP方需判断http的响应码：
200表调用成功
500，502表系统内部错误，可稍后再试
401表未授权
403表禁止访问
通常以Json格式返回，返回格式如下：
POST请求或GET请求
200情况下，返回{"data":"ok"} 或者{"data":"ng"}
error情况下，返回{"code":错误码, "msg":"错误详情"}，如:{"code":600, "msg":"内部错误"} 后增加文字。
注:更多错误码请参考。
门店相关问题
如何知道上传的门店已经上线?
可以通过外卖开发者后台，查询门店的审核状态，来判断门店是否已经上线。也可以通过调用批量获取门店接口时，返回的open_level字段，若值为0，则代表门店还没有上线；若值为1或者3，则代表门店已经上线，其中1表示门店正常营业，3表示门店处于休息状态。(新增加-1状态，若open_level值为-1，则代表门店扔处于Task状态)
什么情况下美团外卖门店会被美团系统置休?
通过主动拉取订单方式获取订单的商家，若5分钟之内没有拉单操作， 置休门店。
订单一小时内连续2单超时未接，置休门店。
通过推单方式获取订单的商家， 5分钟之内推送超过10单时计算推单失败率，若失败率高于80% 置休门店。
如何管理同步到美团的数据?
目前门店，订单，退款申请等信息都是可以在外卖开发者后台来进行查询的。开发者后台需要美团团购的账号，请申请账号后联系美团人员进行添加和权限的绑定。
美团外卖开发者后台线下环境：
美团外卖开发者后台线上环境：
线上门店审核不通过可能原因？
线上环境中不允许出现“测试”，为敏感词； 门店名称不能出现数字，否则会被理解为优惠活动，属于恶意竞争，例如“ 全时便利店-十里河店” 的门店是不允许的。
订餐必读&商家公告能否通过商家端修改？
不能，必须通过api接口修改。通过open api文档里“+创建或更新门店信息” 进行更新商家公告。
线上调用poi/save报700错误？
先检查营业时间的设置需在配送营业时间之内，否则需要再看日志追查。
门店是在美团外卖后台创建，可以通过人工方式关联到开放平台吗？
可以的，提供美团门店ID或名称，和对应的app_poi_code给运营同学即可。
使用接口创建门店时默认是“自配送”吗？
是的，商家自配送。
通过美团外卖后台创建的门店，可以通过人工方式关联到开放平台吗？
可以的，提供美团门店ID或名称，和对应的app_poi_code即可。
不开发门店类API，可以通过其他方式同步门店到开放平台吗？
可以，联系美团业务创建门店，通过商家后台管理门店。
门店上线要做的事情？
两方测试成功后，美团给商家正式的appid和secret。给商家开正式开发者后台的权限。
商家根据正式的appid和secret调整你们的设置。在开发者后台设置你们接好的回调的各类url。
没有对接的那些接口的功能，需要使用商家客户端来实现。例如退款等。
门店怎么设置一级品类和二级品类？
开放平台已经预设了一级品类，商家只用传二级品类，系统会自动将商家的品类进行归类。
页面显示菜品已售罄问题怎么办？
暂停售卖字段（is_sold_out）设置为0 通过sku/stock , initdata, batchinitdata 这几个接口设置库存。 检查菜品售卖时间。
当门店设置为休息状态，暂停接单。 第二天营业时间到了，门店是否会自动恢复营业状态呢？还是一直都维持休息状态？
商家人工设为休息状态第二天不会自动恢复营业。如果是因为营业时间到了休息了，第二天会恢复的。
有些门店在开放平台展示为营业上线状态，但是用户端的门店首页展示门店下线？
可能因为门店的一些资质（合同、证照）没有上传，门店可能会被置为休息中，请按照开发文档的要求（poi/save）建店。
保存门店时，返回结果：{"error":{"code":1019,"msg":"门店品类设置失败，无效的品类名称"},"data":"ng"}
品类输入不合法，开发文档中有品类的标准。
测试门店注册的问题？
，左上角登录一下，商家用测试用的账号，先在正式里面登录一下，然后在刷新测试环境的就可以了，商家配置好了商家本地的接口地址，打开商家界面，就可以下单了。
外卖商家版PC端中的“回收站”？
商品列表的商品删除后会进入回收站，放到回收站的商品不在C端展现。当商家用户将回收站的商品恢复到商品列表，消费者用户就能在C端看到。大连锁部门用回收站比较多，主要是因为大连锁的商品较多，当某个商品暂停售卖时仍在C端展现，他们认为这相当于浪费了C端首页展现商品的机会，因此将暂时不卖的商品删除到回收站，排序靠后的商品会位置前移，优先让用户看到，提高了C端可销售商品的曝光率。
如何知道上传的门店已经上线
可以通过外卖开发者后台，查询门店的审核状态，来判断门店是否已经上线。也可以通过调用批量获取门店接口时，返回的open_level字段，若值为0，则代表门店还没有上线；若值为1或者3，则代表门店已经上线，其中1表示门店正常营业，3表示门店处于休息状态。(新增加-1状态，若open_level值为-1，则代表门店扔处于Task状态)
订单相关问题
如何测试下单?
测试环境门店上线后，可以在美团外卖的主站上面通过地图或者地标找到门店，或者可以通过开发者后台，获取到门店在美团的ID。在http://test./restaurant/门店ID 上面下测试单
拉单出现漏单是什么情况？
检查是否已经通过PC端或其他接单方式接单。
如何得知美团取消了订单？
为了得到订单取消的通知，请参阅文档第7部分。接口开发好后，需要通知到美团的技术（线上线下接口URL需不同）。需要注意的是，美团调用APP方取消订单的URL后，APP方避免再回调美团取消接口，以免发生循环调用。
什么情况下订单会美团系统自动取消？
1.推送订单后，5分钟之内商家未确认，系统推送取消订单。
2.订单推送失败，连续推送5次之后，推送取消订单
已经设置好回调接口，美团为什么始终不推送订单？
目前美团外卖开放平台仅仅支持端口号为80或8080的回调地址。
当商家确认订单但还没发送到openapi，openapi此时发送取消订单时会怎么样？
这个问题目前是小概率事件，如果发生暂时按照事故处理，逻辑上商家平台应该有足够的时间通知商家取消订单。
推送的订单内容是否已经按首字母排序？
内容没有排序，需要三方自己排序。
推送订单的内容不是json？
订单里的参数是post参数，里面的detail字段是json格式。
推送订单缺少经纬度导致三方取消订单，如何解决？
针对用户低版本的美团外卖APP，C端不推送经纬度。需要三方兼容。
调用取消订单接口失败，提示订单不存在？
检查三方传的订单号是order_id还是order_view_id， 应该上传order_id.
用户在申请退款过程中可以主动取消退款申请，取消退款申请后是否会推送消息？
对接了美团用户退款接口，如取消退款申请也会推送信息。
美团的订单推送接口在每分钟轮询商家的服务器一次，给商家系统产生了一堆无用的访问日志？
针对商家配置的推单，取消订单，退款，同步配送状态四个回调url（在开发者中心配置)，美团会每隔1分钟检测一次是否存活，忽略即可，商家系统也可调整不记录此日志即可。
订单详情中，订单总额-优惠金额=商户实收金额？
不是，商家实收＝在线支付＋活动款－［在线支付-退款］－［活动款-退款］－菜品分成（收商家）－配送费（收商家）＋［菜品分成（收商家）-退款］＋［配送费（收商家）-退款］
已确认订单，商户能否取消？
可以取消。
取消原因除了原因代码以外，是否还要传入我方的取消原因文字描述？
需要，reason和reasoncode都需要。
推送订单接口和商家确认订单接口有什么区别?
推送订单接口，是三方提供一个url，我们往这个url上面推送订单信息；商家确认订单是指三方接单后告知美团
不使用美团配送，订单状态更新是否有下发通知？
如果接了推送接口，就会推送，如对接了订单取消，订单退款等接口就会推送信息。
退款接口是否必须接入？前期能否先通过平台客服进行自动退款？
可以根据情况接入，如果用客服来处理退款，使用商家后台也可以，但是需注意，30分钟（大连锁商家3小时）不处理的退款，会被默认同意退款。
实收金额，接口没有对应字段，实际情况是需要商家计算吗？开放平台有没有订单状态更新的接口？
财务相关的接口，开放平台目前不涉及，不过我们的商家客户端有财务模块，订单和账单表都有，如果有需要，去那里面下载更方便。 订单相相关的接口对接了的话，订单状态更新会推送的。
商家通过接口接到的订单，需不需要商家通过接口回传完成的状态？
订单完成的这个状态，商家是没法实现的，不用传。开放平台的订单状态和跟商家客户端一样的，没什么差别。
如何获取订单状态?
可以通过+ viewstatus接口查询。
回调端口改为8080后是否会立即生效？
推单会立即生效。但是url监控第二天才会开始。
开发平台向商家连续推单的时间间隔是多少？
美团每分钟调用商家的接口给商家传空过去的时候，商家应该怎么给美团返回？
这是美团对对商家url存活的检测，http的code 能返回200 就ok。
order/getOrderDetail接口中，"delivery_time": 用户预计送达时间，“立即送达”时为0 这个字段是以什么为单位？
秒。order/getOrderDetail 这个接口只推送status字段，没有order_status字段。status字段参考13.1；logistics_status参考12.+。
什么版本以下的app下单时不会上报经纬度？
因为客户的手机上装的美团外卖的app的版本太低；老版本是不会上传经纬度的 ；美团外卖APP（+）和美团APP（+）以下不会上传经纬度。
订单推送过来计算sig的时候detail和extras两个参数值是json数组， json数组里的key也是按字母顺序排列之后再计算sig么？
detail 和 extras 里面的json 数据不需要排序。
在线支付退款流程？
在线支付的单，用户在线申请退款，然后商家可以同意或者拒绝退款，需在30分钟内（大连锁3小时）处理，否则会被系统默认同意退款。若是驳回顾客的退款请求后，顾客不能直接进行退款申诉，需联系美团客服后由客服裁决。
商家设置满减活动时，设置多个梯度：比如58-13，100-30，在美团这边设置生成的是只有一个活动code？
商家直接解析remark字段获取满减活动，例如"remark": "满10元减+元",（优惠说明）。
美团为何取消订单？
美团取消订单分为系统取消和用户取消两种。用户取消会调用第APP方的订单取消通知接口。若用户下单后5分钟，第APP方都没有确认订单，订单就会被系统自动取消。
签名计算和编码问题
先对参数进行编码后计算签名，还是先计算签名后编码？
先计算签名再进行编码。
为什么调用接口总是验证失败？
请首先检查是否参数都已经传递，包括系统级参数和应用级参数；再检查参数名称是否正确；确保参数加密前已经按照要求进行排序；最后查看MD5算法是否为通用的算法而没有经过额外修改。
调用API接口时，请求参数都是传Json格式的吗？ 系统级参数和应用级参数 传递时有什么格式要求吗？
有json，也有字符串, 具体参数请参考开放文档。
计算签名有什么注意事项？
门店签名问题美团现在给商家一个新的 sdk，商家当做一个 jar 包引用一下就行了，附帮助文档，打开其中的index.html文件，辅助sdk编程，有问题的话可能就是签名问题。商家的技术小伙伴通过反编译就能看到源码，就是最普通的 post 签名验证。商家用Java开发的话，用新包不用计算sign了，直接新包的方法：就行，计算签名的时候，中文不需要编码。签名区分大小写。
接收到推送订单后的签名计算？
接收到推送订单后需要解码两次：第一次utf8解码之后，参数里的中文还是编码的，需再解码一次，然后计算签名。没有值测参数也需要拼接。没有值的如：avg_send_time这个参数是平均送达时长。
开放平台测试环境和生产环境的请求地址是什么？
如果使用了美团外卖开放平台SDK的话，是不需要我们自己去设置请求的URL地址的，SDK会读取environment.properties 里面的值，根据env的值去做好URL映射关系。
美团外卖OpenApi线下环境
美团外卖OpenAPI线上环境
菜品相关问题
三方更新菜品图片, url没变，为什么图片没有更新成功？
菜品图片更新后，不能使用与原先菜品图片相同的url。（原因：美团l更新菜品图片接口先根据url去缓存找图片，如果找到，就不会去抓取对方的图片）
调用batchsave接口批量保存菜品，返回“{"data":"ng","error":{"code":808,"msg":"操作失败"}}”？
检查是否上传菜品数量过多导致超时，建议单次上传菜品个数100个以内。
线下环境商家调用foodcat/update接口报参数错误?
门店审核通过之前不能调用该接口上传菜品分类。
是否有菜品回收站相关接口？
回收站的菜品不会被删除，只是用户不会看到回收站里的菜品，恢复回收站里的菜品只能通过pc端页面，开放平台暂时没有这个接口。
上传菜品资料时，是不是用同一个美团appid的连锁分店每个店都要单独上传自己的菜品分类和菜品资料？
是的，同一个appid下可以有多个apppoicode，每个apppoicode都要传菜品资料。
food/batchsave、batchinitdata接口批量上传菜品有数量限制么？
跟商家上传的数据有关，是字节限制（一个菜的所有字段加起来）的 ，菜的数量在100个左右是合理的。
unit字段长度限制多少？
20个字节。
配送相关问题
是否可以增加“配送费”字段？
开放平台的shipping/save 和 shipping/batchsave 接口都已新增“配送费”shipping_fee字段。保存结果用shipping/list 查看。
商户如果使用美团配送，配置的流程是怎么样的？起送价/配送费/配送范围/配送时间这些配置能否通过接口修改？
使用美团配送，先通过接口上传门店，联系美团对应的品牌运营修改设置，改为美团配送。起送价/配送费/配送范围/配送时间，如果使用美团配送的话，这些都无法通过接口修改。
如果使用美团配送，配送状态是“配送单已确认”的时候，订单状态会不会自动变为“商家已确认”？
商家确认订单后，订单被美团骑手抢单后，配送单才会确认。
优惠金额是直接包含商家部分优惠以及美团官方优惠？使用美团配送时，商户如何收取骑手金额,是接口中的哪个值？
优惠金额=商家优惠 +美团优惠。开放平台的接口中，没有骑手应收款。
如果是美团配送订单取消订单是否直接调用订单取消接口就可以，还是要调用取消美团配送的接口?
直接用订单取消接口即可，美团内部会告知配送。
取餐时，骑手付款给商家时，只有骑手单方知道实收金额吗？
如果是骑手到店付款的形式的话，骑手客户端会展示应付金额。商家客户端也有展示应付金额，你们可以参考。
美团外卖平台的“取餐号”接口资料和权限能给到我们做对接吗？这样对接完以后美团取餐员的取餐号和我们公司系统出单号一致，方便骑士取餐，分餐。
B端商家版可以提供上述功能，每个门店，每天从一号开始。
配送烽火台相关设置？
先申请添加至一个组织下；然后新建“配送区域”；在“组织人员”下的“配送区域审核”中自己审核通过；然后“解绑”原有组织下配送区域，重新绑定已新建的配送区域，如有必要（更改配送时间已匹配门店营业时间）。
门店上线流程
美团的外卖门店上线有较为严格的要求，须要保证门店包含配送范围信息和菜品信息，缺少这两类信息的会被驳回。同时美团的外卖门店上线需要走匹配审核的流程，新建的门店会以一个门店上线任务的概念存在，如果各项数据都正常，且不与其他门店重复（美团这边判重不仅仅是依据APP方门店的ID来进行，会根据门店地址，坐标，电话等因素来判断是否为相同门店），5分钟之内就会上线，流程图如下：
创建或更新门店信息，包括基本信息，营业状态，上下线状态等
http://test./api/v1/poi/save
/api/v1/poi/save
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店ID
北苑路北站K酷时代广场4层
门店纬度 （美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换）(门店坐标不需要乘以一百万)
115.281708
门店经度 （美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换）(门店坐标不需要乘以一百万)
http://p1.meituan.net/crm/__82979.jpg
门店图片地址（默认图片为：http://p1.meituan.net/crm/__82979.jpg）图片比例1:1，需要为Jpg/JPEG格式，大于256x256
pic_url_large
http://p1.meituan.net/crm/__82979.jpg
门店图片地址（默认图片为：http://p1.meituan.net/crm/__82979.jpg ）图片比例4:3，需要为Jpg/JPEG格式，大于400x300
客服电话号码 （注意：此号码留客服号码）
standby_tel
门店电话号码 （注意：此号码留商家电话）(已废弃)
shipping_fee
每个订单的配送费
shipping_time
7:00-9:00,11:30-19:00
门店营业时间 （注意格式，且保证不同时间段之间不存在交集）
promotion_info
推广信息范例
门店推广信息
open_level
门店的营业状态 ： 1可配送 3休息中
门店上下线状态 ：1表上线,0表下线，必须菜品、配送范围和门店信息都齐全后才能提交上线 （注意：此字段不为1时门店不会提交审核）
invoice_support
门店是否支持发票
invoice_min_price
门店支持开发票的最小订单价（invoice_suport为1时可用）
invoice_description
发票特殊说明，如只有定额发票，不支持开抬头等
发票相关说明（invoice_suport为1时可用）
third_tag_name
APP方品类名称需要根据接口获取门店品类列表接口获得，如果一个门店包含多个品类须以英文逗号隔开，如中餐,西餐
目前最多支持上传两个门店品类：一个主营品类（上传的第一个品类为主营品类），一个辅营品类；部分门店品类只支持上传一个品类（例如：火锅，特色菜，地方菜，东南亚菜，日韩料理，生活超市）
是否支持营业时间范围外预下单，1表支持，0表不支持
time_select
是否支持营业时间范围内预下单，1表支持，0表不支持 此字段开启后不可关闭，新建门店自动开启
app_brand_code
第三方品牌code值（对接的三方需要提前将该值告诉美团开发人员）
mt_type_id
美团品类id，输入该字段可以加快门店审核速度（美团合法品类表请联系美团运营获取）
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店id
http://test./api/v1/poi/getids
/api/v1/poi/getids
调用成功返回值：{"data":[123，456]}。
批量获取门店详细信息
http://test./api/v1/poi/mget
/api/v1/poi/mget
如下表（key = value 形式）
应用级参数
app_poi_codes
APP方门店id(半角逗号分隔)
{ "data":[
"app_poi_code":"122323",
"name":"咿呀米美食工作餐快送(原包天下)",
"address":"北苑路北站 K 酷时代广场 4 层",
"latitude":"38.693203",
"longitude":"115.281708",
"pic_url":"http://p1.meituan.net/crm1582979.jpg",
"phone":"010-",
"standby_tel":"",
"shipping_fee":1.00,
"shipping_time":"7:00-9:00,11:30-19:00",
"promotion_info":"商家公告栏",
"invoice_support" : 1, "0.9.4 新增 门店是否支持发票,1 表示支持",
"invoice_min_price": 2, "1.0.2 新增 门店支持开发票的最小订单价",
"invoice_description": "mmmm", "1.0.2 新增 发票相关说明",
"open_level":1,
"is_online":1,
"tag_name":"中式炒菜","1.0.5 新增 美团品类名称",
“pre_book”:1,”1.0.15 新增 是否支持营业时间范围外预下单,1 表示支持”,
“time_select”:1,”1.0.15 新增 是否支持营业时间范围内预下单,1 表示支持”
门店设置为营业状态（开发者可以不使用这个API，因为也可以通过接口更新open_level字段值来实现）
http://test./api/v1/poi/open
/api/v1/poi/open
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为休息状态（开发者可以不使用这个API，因为也可以通过接口更新open_level字段值来实现）
http://test./api/v1/poi/close
/api/v1/poi/close
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为下线状态（开发者可以不使用这个API，因为也可以通过接口更新is_online字段值来实现）
http://test./api/v1/poi/offline
/api/v1/poi/offline
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
门店倒闭了
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为上线状态（开发者可以不使用这个API，因为也可以通过接口更新is_online字段值来实现）（目前重新上线的策略是：调用上线API，不会马上上线，美团先通知美团编审人员，然后手工擦操作上线）
http://test./api/v1/poi/online
/api/v1/poi/online
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
更改门店附加信息
http://test./api/v1/poi/additional/save
/api/v1/poi/additional/save
如下表（key = value 形式）
注：更改门店附加信息，该接口为非必接接口。
更改门店邮箱信息，系统会定时将门店维度的结算等信息发送至该邮箱。如需开通此功能，需要联系美团对接商务。
更改门店的结算企业信息，系统会根据门店对应的结算企业结算信息进行相关结算。
应用级参数
app_poi_code
APP方门店id
app_poi_email
app_brand_code
第三方品牌code值（对接的三方需要提前将该值告诉美团开发人员）
app_org_id
门店的法人企业（门店的财务结算等均由与之关联的结算企业信息决定，对接的三方需要提前将该值告诉美团对接商务）
调用成功返回值：{"data" : "ok"}，其余情况请参考
更改门店公告信息
http://test./api/v1/poi/updatepromoteinfo
/api/v1/poi/updatepromoteinfo
如下表（key = value 形式）
注：更改门店公告信息，该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
promotion_info
门店公告栏
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店品类详细信息列表
http://test./api/v1/poiTag/list
/api/v1/poiTag/list
如下表（key = value 形式）
调用成功返回值：
{"data" : [
"id":1, // 品类id
"name":"中餐" // 品类名称
更改门店营业时间
http://test./api/v1/poi/shippingtime/update
/api/v1/poi/shippingtime/update
如下表（key = value 形式）
注：更改门店营业时间，该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
shipping_time
7:00-9:00,11:30-19:00
门店营业时间
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店是否在延迟发配送名单内，延迟发配送只针对美团配送的 自建、代理两种配送方式
http://test./api/v1/poi/logistics/isDelayPush
/api/v1/poi/logistics/isDelayPush
如下表（key = value 形式）
应级级参数
app_poi_code
APP方门店id
调用成功返回值：
{"code" : 0,"msg" : "success", "data" : {"support_delay_push" : 1 (1表示该门店在延迟发配送名单中，0表示不在名单内),
"delay_push_second" : 600 } }
如果门店在延迟发配送（仅限自建，代理）名单内，商家可通过该接口设置具体的延迟时间
http://test./api/v1/poi/logistics/setDelayPush
/api/v1/poi/logistics/setDelayPush
如下表（key = value 形式）
应级级参数
app_poi_code
APP方门店id
delay_seconds
延迟发配送时间／秒，该参数需在300-600秒之间
调用成功返回值：
{"data" : "ok"}
根据门店id和起止时间批量查询评价信息
http://test./api/v1/poi/comment/app_poi_code
/api/v1/poi/comment/app_poi_code
如下表（key = value 形式）
注：该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
start_time
查询开始时间，单位秒，最多查询30天前的评价信息
查询结束时间，单位秒
pageoffset
分页查询的偏移量
每页评价信息条数，需小于等于20
调用成功返回值：{"data":"[{\"add_comment\":\"\",\"add_comment_time\":0,\"comment_content\":\"送餐快 味道棒 服务好 餐量足 干净卫生\",\"comment_id\":1136559,\"delivery_comment_score\":0,\"food_comment_score\":0,\"order_comment_score\":5,\"result\":\"ok\"},
"code":0,"msg":"success" }
，其余情况请参考
根据评价id(comment_id,评价信息查询接口返回值)添加商家回复
http://test./api/v1/poi/comment/add_reply
/api/v1/poi/comment/add_reply
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
comment_id
"感谢您的支持"
商家回复内容
调用成功返回值：{"data":"ok",
"code":0,"msg":"success" }，其余情况请参考
创建／更新门店配送范围
http://test./api/v1/shipping/save
/api/v1/shipping/save
如下表（key = value 形式）
注：如果一个门店含有一个以上的配送范围，建议使用，批量更新配送范围
应用级参数
app_poi_code
APP方门店id
app_shipping_code
APP方提供的配送范围id，如一个门店没有配送范围ID，且每个门店只有一个配送范围，可以填1
配置范围类型，（1表示多个配送范围由多个多边形组成）只支持多边形
[{"x":,"y":},{"x":,"y":},{"x":,"y":}]
配送范围type 为 1 时: [{"x":,"y":},{ "x":,"y":},{"x ":,"y":}] type 为 2 时: {"r":1000,"x":,"y":}，需要对其urlEncode，x代表纬度，y代表经度（美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换，配送范围坐标需要乘以一百万)
该配送区域的起送价
shipping_fee
该配送区域的配送费(建议填写这个字段设定配送费,如果此字段为空,则以门店保存的配送费为准)
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店配送范围
http://test./api/v1/shipping/list
/api/v1/shipping/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
{"data":[{"min_price":1.0,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"125","shipping_fee":144.0,"type":1},{"min_price":25775.0,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"123","shipping_fee":0.0,"type":1}]}
批量创建/更新配送范围
http://test./api/v1/shipping/batchsave
/api/v1/shipping/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
shipping_data
[{"min_price":10,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":124,"type":1,"shipping_fee":33},{"min_price":1,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":125,"type":1,"shipping_fee":44},{"min_price":25775,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"123","type":1,"shipping_fee":55},{...}]
配送范围集合的json数据，处理逻辑：1）如果配送范围原来不存在就新增；2）如app_shipping_code存在就更新；3）如原来存在的app_shipping_code，而这次没提交，就删除范围都为多边形，不支持圆形
调用成功返回值：{"data" : "ok"}，其余情况请参考
更新菜品分类
http://test./api/v1/foodCat/update
/api/v1/foodCat/update
如下表（key = value 形式）
注意：更改菜品分类，会同时将其他菜品所属的该分类一并改掉。
例如，拉面的分类应该是面食，而拌土豆丝应该是凉菜。如果把拌土豆丝的分类错写成面食，并且调用此api更新菜品分类：面食＝>凉菜，就会把拉面的分类改称凉菜。请慎重使用。如果想改变单个食物的食品分类，请调用创建/更新菜品的api。
应用级参数
app_poi_code
APP方门店id
category_name_origin
更新时必须，新建时无须填写
美团定制饭1
原始的菜品分类名称
category_name
美团定制饭2
新建的菜品分类名称
添加时必须
菜品排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除菜品分类
http://test./api/v1/foodCat/delete
/api/v1/foodCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_name
APP方分类名
调用成功返回值：{"data" : "ok"}，其余情况请参考
推荐使用，批量更新门店菜品
注：现对菜品上传接口进行升级，分为两步，第一步为上传图片，第二步为创建/更新菜品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新菜品）
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用
2.上传其他菜品信息
创建／更新菜品（推荐使用4.7的API，批量更新门店菜品）
http://test./api/v1/food/save
/api/v1/food/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id，最大长度128，不同门店可以重复，同一门店内不能重复
添加时必须
美团定制版
description
这是一个菜品
添加时必须
菜品价格 不能为负数
min_order_count
添加时必须
最小购买量，最小为1
添加时必须
添加时必须
打包盒数量
添加时必须
餐盒价格 不能为负数
category_name
添加时必须
菜品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
菜品图片ID（注意：①此处的图片ID由步骤1上传图片获得 ②更新菜品图片时必须更新图片URL），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
新增菜品数据接口，支持菜品多规格，支持库存、商品物料码、可售时间
注：菜品上传接口，分为两步，第一步为上传图片，第二步为创建/更新菜品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新菜品）
a.目前我们的商品结构支持spu和sku
b.如果三方的商品没有sku信息的话，不用传sku相关信息
c.填写sku信息时，sku_id, price, spec, upc, stock, available_times, location_code必须一一对应，即参数个数一致
d.如果不传sku信息，必须上传name
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用</p
2.上传其他菜品信息
创建／更新菜品（推荐使用4.7的API，批量更新门店菜品）
http://test./api/v1/food/initdata
/api/v1/food/initdata
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id(三方商品spu_code值, 不同门店可以重复，同一门店内不能重复)最大长度128
添加时必须
美团定制版
description
这是一个菜品
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&},{...}&&&]
App方菜品的skus，代表菜品下的多个sku信息，使用json格式传递参数，分别包括sku_id(必须),spec(必须),upc(非必须),price(必须),stock(必须),available_times(非必须，默认与门店营业时间一致),location_code(非必须)；sku_id是sku唯一标识，spec表示sku的规格，upc表示sku的upc码，price表示sku的价格，price不能为负数，不能超过10个字，stock表示sku的库存数量，stock不能为负数，也不能为小数，传"*"表示表示库存无限 ，available_times表示sku起售时间，要保证不同时间段之间不存在交集，location_code表示sku的料位码 如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
菜品价格 不能为负数，如果传递了skus价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
如果sku内传递了box_num，本参数不生效
添加时必须
餐盒价格 不能为负数
如果sku内传递了box_price，本参数不生效
category_name
菜品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
菜品图片ID（注意：此处的图片ID由步骤1上传图片获得），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
http://test./api/v1/food/delete
/api/v1/food/delete
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品ID, 最大长度128 不同门店可以重复，同一门店内不能重复
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店菜品列表
http://test./api/v1/food/list
/api/v1/food/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
分页查询偏移量
分页查询每页查询的数量,须小于200
{ "data": [
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5"
菜品信息以json格式请求，详细参数请参见参数定义
说明：1）批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品；如果原来有的菜品不在此次更新的数据中，就会删除原来的菜品。
2）若菜品的数量超出200，该接口可能会出错，建议使用零售类接口:
批量创建／更新菜品
http://test./api/v1/food/batchsave
/api/v1/food/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品3","description": "菜品描述","price": 13.5,"unit": "份","picture":"","sequence":1},{"app_food_code": "food_0002","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是另一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品2","price": 18.5,"unit": "份","picture":"","sequence":1},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）如原来存在的app_food_code，而这次没提交，就删除；4）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
调用成功返回值：{"data" : "ok"}，其余情况请参考
菜品信息以json格式请求，详细参数请参见接口中的参数定义
说明：1）批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品。 2）批量更新的菜品数量不能超过200。
批量创建／更新菜品
http://test./api/v1/food/batchinitdata
/api/v1/food/batchinitdata
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品3","description": "菜品描述","skus":[{"sku_id":"5","upc":"13","spec":"小","price": "13","stock":"10","available_times":{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"},"location_code":"34"}"box_num":"1""box_price":"0.5",{...}],"unit": "份","picture":"","sequence":1},{....},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店菜品分类列表
http://test./api/v1/foodCat/list
/api/v1/foodCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
"app_poi_code": 123,
"name": "面条类",
"sequence": "1",
说明：创建/更新的菜品sku会和原有菜品sku进行比对,sku_id作为唯一界定标准，如果某个菜品sku原来没有，就会新增此菜品sku；如果原来有，就会更新此菜品sku。
添加菜品SKU规格信息
http://test./api/v1/food/sku/save
/api/v1/food/sku/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id(相当于spu, 不同门店可以重复，同一门店内不能重复)，一个菜品可以有多个规格，如大份、小份，即为sku，最大长度128
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-2Am1:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&},{...}&&&]
sku相关参数要求同4.3 创建/更新菜品接口
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除门店菜品SKU信息
http://test./api/v1/food/sku/delete
/api/v1/food/sku/delete
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id，不同门店可以重复，同一门店内不能重复最大长度128
App方菜品的sku_id
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：更新的菜品sku的价格
更新菜品SKU价格信息
http://test./api/v1/food/sku/price
/api/v1/food/sku/price
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","skus":{"sku_id":"5"，"price":"10"},{...}]},{...}[]]
菜品sku价格集合的json数据，菜品sku的价格。 菜品价格不能为负数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：更新的菜品sku的库存
更新菜品SKU库存信息
http://test./api/v1/food/sku/stock
/api/v1/food/sku/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，菜品sku的库存。菜品stock不能为负数,也不能为小数,传"*"表示库存无限
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：增加菜品sku的库存
增加菜品SKU库存
http://test./api/v1/food/sku/inc_stock
/api/v1/food/sku/inc_stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，此处stock为菜品sku库存增加值。不能为负数,也不能为小数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：减少菜品sku的库存
减少菜品SKU库存
http://test./api/v1/food/sku/desc_stock
/api/v1/food/sku/desc_stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，此处stock为菜品sku库存减少值。不能为负数,也不能为小数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：绑定菜品属性，例如菜品是否需要加热、酸辣程度等；如果菜品已有菜品属性调用此接口后会全量覆盖旧的菜品属性；
properties字段传空则会清空该菜品的所有属性。
绑定菜品属性
http://test./api/v1/food/bind/property
/api/v1/food/bind/property
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
food_property
[{&&&&"app_food_code": "food_0001",&&&&"properties":
[&&&&&&&&{"property_name":"冷热",
&&&&&&&&"values":"["冷", "热"]"},
&&&&&&&&{"property_name":"辣度",
&&&&&&&&"values":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}&&&]},{...}]
菜品属性的json数据
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：获取菜品属性
获取菜品属性
http://test./api/v1/food/property/list
/api/v1/food/property/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品id
{ "data":[&&&&&&&&{"property_name":"冷热",
&&&&&&&&"values":"["冷", "热"]"},
&&&&&&&&{"property_name":"辣度",
&&&&&&&&"values":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}
查询菜品详情
http://test./api/v1/food/get
/api/v1/food/get
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品id
{ "data": {
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5"
说明：获取菜品属性
批量更新售卖状态
http://test./api/v1/food/sku/sellStatus
/api/v1/food/sku/sellStatus
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
&&&&"app_food_code": "abcd135",
&&&&"skus":[{"sku_id":"abcd135"}]
菜品sku集合的json数据
sell_status
0.上架 1.下架
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：美团有标准的药品分类库（美团标准药品分类参考13.6），三方可以按照标准分类上传药品，如果不能满足三方需求，可自行创建和修改药品分类；在上传药品时，如果使用到了美团标准药品库中的分类，系统会自动将该分类复制到您的门店（未曾使用的不会复制），暂只支持一级类目。
创建药品分类
http://test./api/v1/medicineCat/save
/api/v1/medicineCat/save
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code，门店内不允许重复（包括与美团标准药品分类code都不能重复），最大长度6位字符
category_name
药品分类名称，最大长度128个汉字
药品分类排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：如果想修改在您门店下美团标准的分类信息，必须按照美团标准药品分类库的code进行修改；更新时非必须的参数如果不传，接口会保持原有值不变，如果想改变单个药品的药品分类，请调用5.6更新药品的api。
更新药品分类
http://test./api/v1/medicineCat/update
/api/v1/medicineCat/update
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code，最大长度6位字符
category_name
药品分类名称，最大长度128个汉字
药品分类排序
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：如果该药品分类下有药品，则不能删除。
删除药品分类
http://test./api/v1/medicineCat/delete
/api/v1/medicineCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code
调用成功返回值：{"data" : "ok"}，其余情况请参考
默认按照sequence升序排序返回结果
查询门店药品分类列表
http://test./api/v1/medicineCat/list
/api/v1/medicineCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
"app_poi_code": 123,
"code":"901600",
"name": "肠胃不适",
"sequence": "5",
美团有标准的药品库，三方商家上传药品时，系统会根据“UPC+国药准字号”锁定唯一药品，锁定成功后，系统会直接使用药品库中的标准信息（比如药品名称、生产厂商名称、批准文号、电子监管码、用法用量、适应症、适应人群、成分、不良反应、禁忌、注意事项、药物相互作用、儿童用药、妊娠与哺乳用药、老年人用药、性状、包装、剂型、贮藏、药理作用、有效期）
三方在上传药品时，扩展属性比如注意事项、外表特征等等会从标准库中取值，不需要单独上传
创建药品（推荐使用5.7的API，批量创建药品）
http://test./api/v1/medicine/save
/api/v1/medicine/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_medicine_code
APP方药品id，最大长度128位字符
medicine_no
国药准字号
药品价格 不能为负数
药品库存 stock不能为负数，也不能为小数
category_code
药品分类code
category_name
药品分类名称
is_sold_out
1：卖光，0：未卖光
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
相关注意事项同5.5API，创建药品；另外，如果相关非必须参数不传，系统API会保持原有值不变，只更新传入有值属性
更新药品（推荐使用5.8的API，批量更新药品）
http://test./api/v1/medicine/update
/api/v1/medicine/update
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_medicine_code
APP方药品id，最大长度128位字符
medicine_no
国药准字号
药品价格 不能为负数
药品库存 stock不能为负数，也不能为小数
category_code
药品分类code
category_name
药品分类名称
is_sold_out
1：卖光，0：未卖光
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
多个药品信息以json格式传递，详细参数请参见接口5.7中的参数定义
批量创建药品
http://test./api/v1/medicine/batchsave
/api/v1/medicine/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
[{&&&&&&"app_medicine_code":"medicine_0001",&&&&&&"app_poi_code": "990001",&&&&&&"upc": "02",&&&&&&"medicine_no": "B",&&&&&&"spec": "0.5g*10粒",&&&&&&"price": 10.5,&&&&&&"stock": 0,&&&&&&"category_code": "901600",&&&&&&"category_name": "退烧止痛",&&&&&&"is_sold_out": 1,&&&&&&"sequence": 1},{…}]
同单个药品上传接口描述
调用成功返回值：{"data" : "ok"}，其余情况请参考
药品信息以json格式请求，详细参数请参见接口5.8中的参数定义
说明：批量更新药品接口只存在更新操作：如果上传的某个药品原来没有，API不做任何处理；如果原来有，就会更新此药品，未上传的非必须参数，API会保持原有值，API只更新传入参数值的属性。
批量更新药品
http://test./api/v1/medicine/batchupdate
/api/v1/medicine/batchupdate
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
<pre class="prettyprint prettyprinted active"[{&&&&&&"app_medicine_code":"medicine_0001",&&&&&&"app_poi_code": "990001",&&&&&&"upc": "02",&&&&&&"medicine_no": "B",&&&&&&"spec": "0.5g*10粒",&&&&&&"price": 10.5,&&&&&&"stock": 0,&&&&&&"category_code": "901600",&&&&&&"category_name": "退烧止痛",&&&&&&"is_sold_out": 1,&&&&&&"sequence": 1},{…}]
同更新单个药品接口的描述
调用成功返回值：{"data" : "ok"}，其余情况请参考
http://test./api/v1/medicine/delete
/api/v1/medicine/delete
应用级参数
app_poi_code
APP方门店id
app_medicine_code
APP方药品ID, 最大长度128位字符
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询时，药品的扩展属性会全部展示出来，属性值是美团标准属性库中的code
查询门店药品列表
http://test./api/v1/medicine/list
/api/v1/medicine/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
{ "data": [
"medicine_id": 123,
"name": "布洛芬缓释片",
"app_medicine_code": "buluofen",
"upc":"02",
"medicine_no":"B",
"spec":"0.5g*10粒",
"price": 13.5,
"stock":10,
"category_code": "901600",
"category_name": "退烧止痛",
"is_sold_out": 1,
"sequence":10,
"090015":"孕妇食用，谨遵医生叮嘱",
"090025":"3个月",
更新药品的库存(支持批量更新)
更新药品库存
http://test./api/v1/medicine/stock
/api/v1/medicine/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
[&&{&&&&"app_medicine_code":"medicine_0001",
&&&&"app_poi_code":"990001",&&&&"stock": "0"
&&},&&{…}]
medicine_data中,app_poi_code、app_medicine_code、stock为必传字段。
药品stock不能为负数,也不能为小数,传"*"表示库存无限
调用成功返回值：{"data" : "ok"}，其余情况请参考
更新商品分类
http://test./api/v1/retailCat/update
/api/v1/retailCat/update
如下表（key = value 形式）
category_name_origin字段不为空时，即将category_name_origin对应的商品分类的名称更改为category_name
只允许门店类型为生活超市下的便利店、超市的门店创建二级商品分类，即可以传secondary_category_name字段。
最多只支持两级分类，即不能在一个二级分类下创建子分类。
门店下不论一级或二级分类，都不允许重名。
应用级参数
app_poi_code
APP方门店id
category_name_origin
原始的商品分类名称
category_name
商品分类名称
secondary_category_name
子级商品分类名称
添加时必须
商品分类排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除商品分类
http://test./api/v1/retailCat/delete
/api/v1/retailCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_name
APP方分类名
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店商品分类列表
http://test./api/v1/retailCat/list
/api/v1/retailCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
"name":"主食",
"sequence":1,
"children":null
"name":"各种炒饭",
"sequence":3,
"children":null
"name":"面类",
"sequence":4,
"children":[
"name":"炒面",
"sequence":4,
"children":null
"name":"凉面",
"sequence":5,
"children":null
"name":"酒水饮料",
"sequence":6,
"children":null
其余情况请参考
新增商品数据接口，支持商品多规格，支持库存、商品物料码、可售时间
注：商品上传接口，分为两步，第一步为上传图片，第二步为创建/更新商品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新商品）
a.目前我们的商品结构支持spu和sku
b.如果三方的商品没有sku信息的话，不用传sku相关信息
c.填写sku信息时，sku_id, price, spec, upc, stock, available_times, location_code必须一一对应，即参数个数一致
d.如果不传sku信息，必须上传name
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用</p
2.上传其他商品信息
创建／更新商品（推荐使用4.7的API，批量更新门店商品）
http://test./api/v1/retail/initdata
/api/v1/retail/initdata
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方商品id(三方商品spu_code值, 不同门店可以重复，同一门店内不能重复)最大长度128
添加时必须
美团定制版
description
这是一个商品
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&"weight":430&&&},{...}&&&]
App方商品的skus，代表商品下的多个sku信息，使用json格式传递参数，分别包括sku_id(必须),spec(必须),upc(非必须),price(必须),stock(必须),available_times(非必须，默认与门店营业时间一致),location_code(非必须)；sku_id是sku唯一标识，spec表示sku的规格，upc表示sku的upc码，price表示sku的价格，price不能为负数，不能超过10个字，stock表示sku的库存数量，stock不能为负数，也不能为小数，传"*"表示表示库存无限 ，available_times表示sku起售时间，要保证不同时间段之间不存在交集，location_code表示sku的料位码
skus中，只限门店类型为生活超市下的便利店、超市时，可以传weight(重量)字段,单位克/g
如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
商品价格 不能为负数，如果传递了skus价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
如果sku内传递了box_num，本参数不生效
添加时必须
餐盒价格 不能为负数
如果sku内传递了box_price，本参数不生效
category_name
商品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
商品图片ID（注意：此处的图片ID由步骤1上传图片获得），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
1）如果商品是在二级分类下面，则category_name为其一级分类，secondary_category_name为其所属分类（二级分类）
2）如果商品是在一级分类下面，则category_name为其所属分类，secondary_category_name字段为空
查询门店商品列表
http://test./api/v1/retail/list
/api/v1/retail/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
分页查询偏移量
分页查询每页查询的数量,须小于200
{ "data": [
"name": "立白洗洁精500g",
"app_food_code": "23413",
"price": 3.1
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "瓶",
"category_name": "清洁用品",
"secondary_category_name":"厨卫清洁",
"is_sold_out": 1,
"picture": "",
"sequence": 1,
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139",
"box_num":"1",
"box_price":"0.5",
"weight":500
商品信息以json格式请求，详细参数请参见接口中的参数定义
说明：1）批量更新的商品会和原有商品进行比对：如果某个商品原来没有，就会新增此商品；如果原来有，就会更新此商品。 2）批量更新的商品数量不能超过200。
批量创建／更新商品
http://test./api/v1/retail/batchinitdata
/api/v1/retail/batchinitdata
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "商品所属分类","is_sold_out": 0,"min_order_count": 1,"name": "商品3","description": "商品描述","unit": "份","picture":"","sequence":1,
"skus":[{"sku_id":"5","upc":"13","spec":"小","price": "13","stock":"10","available_times":{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"},"location_code":"34","box_num":"1","box_price":"0.5","weight":500},{...}]
商品集合的json数据，处理逻辑：1）如果商品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
4）skus中，只限门店类型为生活超市下的便利店、超市时，可以传weight(重量)字段,单位克/g
如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001","sku_id":"3452", "error_msg":"存在敏感词"},{{"app_food_code":"food_0002", "error_msg":"参数中包含敏感词, 操作失败, 请检查商品分类名称"}}]}，其余情况请参考
说明：更新的商品sku的价格
更新商品SKU价格信息
http://test./api/v1/retail/sku/price
/api/v1/retail/sku/price
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","skus":{"sku_id":"5","price":"8.5"},{...}]},{...}[]]
商品sku价格集合的json数据。 商品价格不能为负数
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001", "error_msg":"不存在此商品"},{{"app_food_code":"food_0002","sku_id":"2134","error_msg":"不存在此商品sku"}}]}，其余情况请参考
说明：更新的商品sku的库存
更新商品SKU库存信息
http://test./api/v1/retail/sku/stock
/api/v1/retail/sku/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5","stock":"10"},{...}]},{...}]
商品sku库存集合的json数据。商品库存stock字段为非负整数,传"*"表示库存无限
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001", "error_msg":"不存在此商品"},{{"app_food_code":"food_0002","sku_id":"2134","error_msg":"不存在此商品sku"}}]}，其余情况请参考
查询商品详情
http://test./api/v1/retail/get
/api/v1/retail/get
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方商品id
{ "data": {
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"secondary_category_name": null,
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5",
"weight":500
注:美团目前采用主动推送订单到APP方的形式，需APP方参考第6节提供回调地址
将订单设为商家已收到
http://test./api/v1/order/poi_received
/api/v1/order/poi_received
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家确认订单（商家收到订单并回执，如商家已接入美团配送服务，则调用该接口会自动下发配送单给美团配送，无需再调用下发配送单接口5.12）
http://test./api/v1/order/confirm
/api/v1/order/confirm
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家取消订单（如商家已接入美团配送服务，则调用该接口会自动取消美团配送单，无需再调用取消配送单接口）
http://test./api/v1/order/cancel
/api/v1/order/cancel
如下表（key = value 形式）
应用级参数
reason_code
规范化取消原因code，详情请参考
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单配送中(必接,如接入美团配送则无需接)
http://test./api/v1/order/delivering
/api/v1/order/delivering
如下表（key = value 形式）
应用级参数
courier_name
配送员姓名
courier_phone
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单已送达(如接入美团配送则无需接)
http://test./api/v1/order/arrived
/api/v1/order/arrived
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单确认退款请求
http://test./api/v1/order/refund/agree
/api/v1/order/refund/agree
如下表（key = value 形式）
应用级参数
因***原因确认退款
确认退款详情
调用成功返回值：{"data" : "ok"}，其余情况请参考
驳回订单退款申请
http://test./api/v1/order/refund/reject
/api/v1/order/refund/reject
如下表（key = value 形式）
应用级参数
因***原因驳回退款
驳回退款详情
调用成功返回值：{"data" : "ok"}，其余情况请参考
只适用于美团商家APP方配送的情况
获取订单商家补贴款
http://test./api/v1/order/subsidy
/api/v1/order/subsidy
如下表（key = value 形式）
应用级参数
调用成功返回值：
"order_id": 111, 订单ID
"order_total": "527.5", 订单总价
"subsidy": 100, 补偿款
"extras": [{
"reduce_fee": 2.5,
"remark": "满10元减2.5元"
活动说明},
reduce_fee": 2.5,
"remark": "满10元减2.5元"
查询订单状态
http://test./api/v1/order/viewstatus
/api/v1/order/viewstatus
如下表（key = value 形式）
应用级参数
返回值: { "data":
"status": 1 // 订单状态 }
查询活动信息
http://test./api/v1/order/getActDetailByAcId
/api/v1/order/getActDetailByAcId
如下表（key = value 形式）
应用级参数
act_detail_id
调用正确返回值:
"id":71,(活动id)
"poi_policy":"{\"full_price\":15,\"gift_name\":\"么么\",\"gift_price\":1,\"mt_charge\":0.00,\"poi_charge\":1}",(活动内容json)
"remark":"满赠",(活动备注)
"start_time":,(活动开始时间)
"end_time":, (活动结束时间)
"type":5 (活动类型)
更多订单详细信息可以在开发者后台的"基础设置->订单可选字段订阅设置"中设置，设置后推送订单和获取订单详细信息时都会获得订阅信息。
商家主动查询订单状态详细信息
http://test./api/v1/order/getOrderDetail
/api/v1/order/getOrderDetail
如下表（key = value 形式）
应用级参数
is_mt_logistics
是否为美团配送
（当需要查询美团配送的详细信息时此字段需要为1）
调用正确返回值：
"result":"ok"
"order_id": 25217, 订单ID
"wm_order_id_view": 订单展示ID
"app_poi_code": APP方商家ID
"wm_poi_name": 美团商家名称
"wm_poi_address": 美团商家地址
"wm_poi_phone": 美团商家电话
"recipient_address": 收件人地址
"recipient_phone": 收件人电话
"recipient_name": 收件人姓名
"shipping_fee": 门店配送费
"total": 总价
"original_price": 原价
"caution": 忌口或备注
"shipper_phone": 送餐员电话
"status": 订单状态 订单当前状态code，详情请参考13.1节
"city_id": 城市ID(目前暂时用不到此信息)
"has_invoiced": 是否开发票
"invoice_title": 发票抬头
"ctime": 创建时间
"utime": 更新时间
"delivery_time": 用户预计送达时间，“立即送达”时为0
"is_third_shipping": 是否是第三方配送平台配送（0：否；1：是）
"pay_type": 支付类型（1：货到付款；2：在线支付）
"latitude": 实际送餐地址纬度
"longitude": 实际送餐地址经度
"detail": 此字段为Json串，具体格式如下："detail": [{"app_food_code": 1,"food_name": "狗不理","quantity": 6,"price": 100,"box_num":2,"box_price":
1,"unit": "份","food_discount": 0.8 (菜品折扣，只是美团商家、APP方配送的门店才会设置，默认为1。折扣值不参与总价计算。开放平台1.0.3 新增)},{"..."}]
"extras": 此字段为Json串，具体格式如下："extras": [{"act_detail_id":10,(活动id) "reduce_fee": 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "满10元减2.5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟)},{"reduce_fee": 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "新用户立减5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟)},{…}]
"order_send_time": , 用户下单时间
"order_receive_time":
, 商户收到时间
"order_confirm_time":
, 商户确认时间
"order_cancel_time": , 订单取消时间
"order_completed_time": , 订单完成时间
"logistics_status": 20, 配送订单状态code，若is_mt_logistics不为1则此字段为空，详情请参考13.5.1节
"logistics_id": 7, 配送方ID，若is_mt_logistics不为1则此字段为空
"logistics_name": "斑马快送", 配送方名称，若is_mt_logistics不为1则此字段为空
"logistics_send_time": , 配送单下单时间，若is_mt_logistics不为1则此字段为空
"logistics_confirm_time":
, 配送单确认时间，若is_mt_logistics不为1则此字段为空
"logistics_cancel_time": , 配送单取消时间，若is_mt_logistics不为1则此字段为空
"logistics_fetch_time": , 骑手取单时间，若is_mt_logistics不为1则此字段为空
"logistics_completed_time": , 配送单完成时间，若is_mt_logistics不为1则此字段为空
"logistics_dispatcher_name": , 骑手姓名，若is_mt_logistics不为1则此字段为空
"logistics_dispatcher_mobile": , 骑手电话，若is_mt_logistics不为1则此字段为空
商家下发美团配送订单(接入美团配送选接)
http://test./api/v1/order/logistics/push
/api/v1/order/logistics/push
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家取消美团配送订单(接入美团配送选接)
http://test./api/v1/order/logistics/cancel
/api/v1/order/logistics/cancel
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
配送状态变更回调
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照
需要验证签名才可以访问APP方门店的api。
应用级参数
注意：post的Content-Type字段为text，所有参数均为普通post参数，不是json
logistics_status
配送单状态，详情请参考13.5.1节
该状态对应的时间
dispatcher_name
dispatcher_mobile
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家主动查询配送订单状态
http://test./api/v1/order/logistics/status
/api/v1/order/logistics/status
如下表（key = value 形式）
应用级参数
"result":"ok"
"order_id": 25217, 订单ID
"logistics_status": 20, 配送订单状态code，详情请参考13.5.1节
"logistics_name": "自建", 配送方名称
"send_time": , 配送单下单时间
"confirm_time":
, 配送单确认时间
"cancel_time": , 配送单取消时间
"fetch_time": , 骑手取单时间
"completed_time": , 订单完成时间
"dispatcher_name": , 骑手姓名
"dispatcher_mobile": , 骑手电话
"poi_shipping_fee": 2, 商家承担运费
"shipping_tips": "运费波动为xx元", 商家承担运费的具体说明
"tip_amount": 3.0, 商家给定的小费金额
调用成功返回值：{"data" : "ok"}，其余情况请参考
根据三方门店ID获取当日最新订单流水号
http://test./api/v1/order/getOrderDaySeq
/api/v1/order/getOrderDaySeq
如下表（key = value 形式）
应用级参数
app_poi_code
三方门店ID
调用成功返回值：{
"result":"ok",
"day_seq" : "17"
}，其余情况请参考
根据三方门店ID,日期,流水号获取订单ID（该接口只支持30天内查询）
http://test./api/v1/order/getOrderIdByDaySeq
/api/v1/order/getOrderIdByDaySeq
如下表（key = value 形式）
应用级参数
app_poi_code
三方门店ID
日期,整形数据
订单流水号
调用成功返回值：{
"result":"ok",
"order_id" : ""
}，其余情况请参考
众包配送下单前，先调用该接口查看当前配送费
http://test./api/v1/order/zhongbao/shippingFee
/api/v1/order/zhongbao/shippingFee
如下表（key = value 形式）
应用级参数
订单ID，用英文逗号隔开
调用成功返回值：{
"wm_order_id":"",
"shipping_fee" : "3.0",
"wm_order_view_id" : "",
"shipping_tips" : "浮动价格XX元"
"wm_order_id":"",
"shipping_fee" : "4.0",
"wm_order_view_id" : "",
"shipping_tips" : "浮动价格XX元"
}，其余情况请参考
众包发配送，如配送费较接口查询到的值不同（即配送费变更），则发配送失败
http://test./api/v1/order/zhongbao/dispatch
/api/v1/order/zhongbao/dispatch
如下表（key = value 形式）
应用级参数
shipping_fee
7.18接口查询到的配送费
tip_amount
调用成功返回值：{"data":"ok"}，其余情况请参考
众包配送单追加小费，用于已下发配送但没有配送员接单时，更新小费
http://test./api/v1/order/zhongbao/update/tip
/api/v1/order/zhongbao/update/tip
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
在商家发起部分退款前，查询可被部分退款的商品详情
http://test./api/v1/order/getPartRefundFoods
/api/v1/order/getPartRefundFoods
如下表（key = value 形式）
应用级参数
调用正确返回值：
"app_food_code":"food_0001",
"food_name":"退款商品05",
"sku_id":"sku_0001",
"spec":"份",
"food_price":16, 菜品价格,单位元
"count":2, 菜品数量
"box_num":2, 餐盒数量
"box_price":1, 餐盒价格
"origin_food_price":16, 菜品原价,单位元
"refund_price":16}, 退款价格,单位元
部分退款申请
http://test./api/v1/order/applyPartRefund
/api/v1/order/applyPartRefund
如下表（key = value 形式）
应用级参数
因***原因部分退款
申请部分退原因
&&&&"app_food_code": "abcd135",
&&&&"sku_id": "abcd135",
&&&&"count":2]
没有sku，sku_id为"" ,count不能为0
部分退款菜品详情
调用成功返回值：{
"data":"ok"
}，其余情况请参考
用户在美团外卖下单后，会回调APP方提供的callback_url，请按照以下请求和响应格式实现相应的api
推送已支付状态的订单给APP方
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
注意：①千万不要将判断签名信息是否正确的参数列表写死，以后接口还会升级，如果写死的话后期接口升级那么我们推送的签名信息就会较之前的发生改变，建议这里获取请求的所有参数来作为判断签名信息是否正确的准则 ②正式环境和测试环境接口端口请使用80或8080
应用级参数
注意：①post的Content-Type字段为text，所有参数均为普通post参数，不是json ②美团推送的参数未排序，请将参数排序后再计算sig
订单ID(数据库中请用bigint(20)存储此字段)
wm_order_id_view
订单展示ID
app_poi_code
APP方商家ID
wm_poi_name
美团商家名称
wm_poi_address
美团商家地址
wm_poi_phone
美团商家电话
recipient_address
收件人地址(此字段为用户填写的收货地址，可在开发者中心订阅是否根据经纬度反查地址，若订阅则会在此字段后追加反查结果，并用“@#”符号分割，如：用户填写地址@#反查结果)
recipient_phone
收件人电话
recipient_name
收件人姓名（若用户没有填写姓名，此字段默认为空。可在开发者中心订阅是否用“美团客人”填充此字段）
shipping_fee
门店配送费
original_price
忌口或备注
shipper_phone
送餐员电话
城市ID（目前暂时用不到此信息）
has_invoiced
是否开发票
invoice_title
taxpayer_id
纳税人识别号，该信息默认不推送，如有需求可在开发者中心订阅
delivery_time
用户预计送达时间，“立即送达”时为0
is_third_shipping
是否是第三方配送平台配送（0：否；1：是）
支付类型（1：货到付款；2：在线支付）
取餐类型（0：普通取餐；1：到店取餐）该信息默认不推送，如有需求可在开发者中心订阅
实际送餐地址纬度
实际送餐地址经度
门店当天的推单流水号，该信息默认不推送，如有需求请联系美团
is_favorites
用户是否收藏此门店（true, false），该信息默认不推送，如有需求可在开发者中心订阅
is_poi_first_order
用户是否第一次在此门店点餐（true, false），该信息默认不推送，如有需求可在开发者中心订阅
dinners_number
用餐人数，（0：用户没有选择用餐人数；1-10：用户选择的用餐人数；-10：10人以上用餐；99：用户不需要餐具）该信息默认不推送，如有需求可在开发者中心订阅
logistics_code
订单配送方式，该信息默认不推送，如有需求可在开发者中心订阅
poi_receive_detail
商家对账信息，该信息默认不推送，如有需求可在开发者中心订阅，此字段为Json串，具体格式如下：
{"actOrderChargeByMt" (美团承担明细) :[{
"comment":"美团配送减3.0元" (备注),
"feeTypeDesc":"活动款" (明细费用类型描述),
"feeTypeId":10019 (明细费用类型Id),
"moneyCent":300 (明细金额（分）)}],
"actOrderChargeByPoi" (商家承担明细):[{
"comment":"美团配送减3.0元",
"feeTypeDesc":"活动款",
"feeTypeId":10019,
"moneyCent":0}],
"foodShareFeeChargeByPoi":390 (菜品分成 (分)),
"logisticsFee":300 (配送费 (分)),
"onlinePayment":2000 (在线支付款 (分)),
"wmPoiReceiveCent":1610 (商家应收款（分）)}
此字段为Json串，具体格式如下："detail": [{"app_food_code": 1,"food_name": "狗不理","sku_id": "1","quantity": 6,"price": 100 （此字段默认为活动折扣后价格，可在开发者中心订阅是否替换为原价）,"box_num":2,"box_price":1,"unit": "份","food_discount": 0.8 (菜品折扣，只是美团商家、APP方配送的门店才会设置，默认为1。折扣值不参与总价计算。开放平台1.0.3 新增),"food_property":"中辣,微甜" (菜品属性，多个属性用英文逗号隔开，该信息默认不推送，如有需求可在开发者中心订阅)},"cart_id":0 （商品所在的口袋,0为1号口袋，1为2号口袋，以此类推，如有需求请在开发者中心订阅）, {"..."}]
此字段为Json串，具体格式如下："extras": [{"act_detail_i}
扫描二维码安装房天下APP
手机浏览器访问房天下
> > 问题详情
美团的成长值怎么算,和花的钱有关系吗
浏览次数：0
小伙伴们还在答题的路上，先看看下面这些内容吧~
怎样花更少的钱买更好的房子呢?以下这十招快来学学吧。 []
浏览量：5035
手机动态登录
请输入用户名/邮箱/手机号码！
请输入密码！
没有房天下通行证，
ask:2,asku:0,askr:44,askz:15,askzx0:659,ask0:0,RedisW:1askR:1,askD：724 mz:nohit,askU:0,askT:0askA:727
Copyright &
北京拓世宏业科技发展有限公司
Beijing Tuo Shi Hong Ye Science&Technology Development Co.,Ltd 版权所有
违法信息举报邮箱：【图文】美团网分析_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
美团网分析
大小：342.50KB
登录百度文库，专享文档复制特权，财富值每天免费拿！
你可能喜欢在 SegmentFault，解决技术问题
每个月，我们帮助 1000 万的开发者解决各种各样的技术问题。并助力他们在技术能力、职业生涯、影响力上获得提升。
一线的工程师、著名开源项目的作者们，都在这里：
获取验证码
已有账号？
问题对人有帮助，内容完整，我也想知道答案
问题没有实际价值，缺少关键内容，没有改进余地
类似美团的团购类网站设计mysql数据表时有必要加类似B2C网站的商品类型和属性吗
答案对人有帮助，有参考价值
答案没帮助，是错误的答案，答非所问
有必要，团购一量车和园内一顿早饭还是有很大区别的……
分享到微博？
关闭理由：
删除理由：
忽略理由：
推广（招聘、广告、SEO 等）方面的内容
与已有问题重复（请编辑该提问指向已有相同问题）
答非所问，不符合答题要求
宜作评论而非答案
带有人身攻击、辱骂、仇恨等违反条款的内容
无法获得确切结果的问题
非开发直接相关的问题
非技术提问的讨论型问题
其他原因（请补充说明）
我要该，理由是：& 美团网账号批发，美团团购帐号，小号出售
商品货号：ECS000192
商品库存：
商品点击数：8876
本店售价：￥0.18
用户评价：
商品总价：
购买数量：
此商品为免运费商品，计算配送金额时将不计入配送费用
商品描述：
本店美团账号已开通支付密码，全网独有技术，给您支付更方便！
如果你是那种觉得有个新账号。就可以买新用户减价物品的买家，那就不用买本店账号。同一手机，同一设备，同一IP同时间段，同一支付方式，同一银行卡支付，只能买一次新用户的物品。就算你换再多新号也提示不符合或者购买后封号等等，反正是成功不了。别说我的账号是旧号什么的。账号里面有购买记录才是旧号，没有就是新号。出售的账号不接收2次验证码，购买后一概不退不换。
温馨提示:不限制地区美团号
本店出售的是手机注册的新号!一个账号一个IP，一手账号,绝对可以登录的.卖出一概不退不换。拍前请看清使用限制，请勿因没看而申请退款或给出中差评。账号就像卫生纸一样，你使用过了再退给卖家，那已经没用了，请买家自重！
24小时自动发货
购买流程和收货流程：
发货格式:----abc123654----147258
账号格式:手机号码----随机密码----支付密码
本店只负责可以正常登陆，最好先买一个测试，OK，再多买
如果需要定制指定密码的请联系在线客服
账号属性：全新注册，已开通支付密码，没认证过邮箱
1. 1个IP下使用软件批量登陆N个帐号造成的 封号 帐号被注销 不在补号范围内!
2. 发过贴,回过贴，买过物品被封号（或注销）的帐号 不在补号范围内
3. 卖出帐号 不保存档案 买家帐号遗失自负
4.账号一经售出，概不退货！不得以任何理由申请退款！
5.所有帐号请在2小时内测试或是抽查，过后将不负责！
6.购买后不立即使用到账回收冻结不负责！
本店免费提供绿色数据整理工具，有需要的亲们请在百度网盘下载：
购买记录(近期成交数量4)
用户名购买数量购买时间订单状态
s***45 11:46:59成交
水***草1 11:36:54成交
q***810 14:50:56成交
2***8100 12:01:46成交
总计 4 个记录，共 1 页。美团开放平台开发文档
美团外卖开放平台是基于美团外卖平台的业务流程，为第三方平台及众多的餐饮公司，提供更加便捷的信息传递方式，以及信息管理方式，致力于提升消费者的服务体验，并增加消费者用餐选择。
美团外卖是美团网旗下的网上订餐平台，于2013年11月正式上线，目前覆盖两百余城市。美团外卖为消费者精心挑选众多优质外卖商家，提供快速、便捷的线上订外卖服务。
商家在开发过程中若有疑问请发送邮件至waimai.，正常情况下一个工作日内回复。
商家可以借助美团外卖开发者后台进行订单、门店等的查询，开通开发者后台权限请提供开通者的姓名、手机号码、公司和职务，发邮件至waimai.。 线下开发者后台地址：http://st.developer./
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
medicineCat/save
创建药品分类
新增创建药品分类接口
medicineCat/update
更新药品分类
新增更新药品分类接口
medicineCat/delete
删除药品分类
新增删除药品分类接口
medicineCat/list
查询门店药品分类列表
新增查询门店药品分类列表接口
medicine/save
新增创建药品接口
medicine/update
新增更新药品接口
medicine/batchsave
批量创建药品
新增批量创建药品接口
medicine/batchupdate
批量更新药品
新增批量更新药品接口
medicine/delete
新增删除药品接口
medicine/list
查询门店药品列表
新增查询门店药品列表接口
美团药品分类
美团药品分类code列表
新增美团药品分类code
美团药品属性
美团药品属性code列表
新增美团药品属性code
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
三方常见问题
补充三方常见问题
门店上线流程
描述门店上线流程
新增门店上线流程图
订单流转状态图
描述订单正常下单流程
新增订单状态流转图
升级接口索引
升级接口/标准
接口/标准说明
调用方式变化
三方常见问题
补充三方常见问题（什么情况下订单会美团系统自动取消、什么情况下美团外卖门店会被美团系统置休）
订单退款流程图
描述订单退款一般流程
新增订单退款流程图
API参数共由两部分组成, 系统级参数指所有由美团提供的API所必须的参数, 应用级参数是指对应API所需的参数。一般情况下, 系统级参数是调用API时所必须传递的参数
进行接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（日)
以秒计算的时间，即unix-timestamp
美团分配给APP方的id
输入参数计算后的签名结果
将所有参数（sig除外）按照参数名的字母顺序排序，并用&连接：app_id=&app_poi_code=31×tamp=
按照请求url + ? + 排序后的参数 + consumer_secret的顺序进行连接，得到加密前的字符串: /api/v1/poi/mget?app_id=&app_poi_code=31×tamp=d31ba58fd73c71db697ab5e4946d52d
注：参数中包含中文时，处理方法：中文保持原文即可，无需对其单独转码，示例(参数未列全部)如下
/api/v1/poi/save?app_id=&app_poi_codes=31&name=丽华快餐&address=北苑路北站K酷时代广场4层×tamp=d31ba58fd73c71db697ab5e4946d52d
对加密前的字符串进行MD5加密，得到签名 aea6f12161edfb6456143d
将得到的签名赋给sig作为get请求的参数 /api/v1/poi/mget?app_poi_codes=31&app_id=& timestamp=&sig=5cfbbaaf2c18
APP方需判断http的响应码：
200表调用成功
500，502表系统内部错误，可稍后再试
401表未授权
403表禁止访问
通常以Json格式返回，返回格式如下：
POST请求或GET请求
200情况下，返回{"data":"ok"} 或者{"data":"ng"}
error情况下，返回{"code":错误码, "msg":"错误详情"}，如:{"code":600, "msg":"内部错误"} 后增加文字。
注:更多错误码请参考。
门店相关问题
如何知道上传的门店已经上线?
可以通过外卖开发者后台，查询门店的审核状态，来判断门店是否已经上线。也可以通过调用批量获取门店接口时，返回的open_level字段，若值为0，则代表门店还没有上线；若值为1或者3，则代表门店已经上线，其中1表示门店正常营业，3表示门店处于休息状态。(新增加-1状态，若open_level值为-1，则代表门店扔处于Task状态)
什么情况下美团外卖门店会被美团系统置休?
通过主动拉取订单方式获取订单的商家，若5分钟之内没有拉单操作， 置休门店。
订单一小时内连续2单超时未接，置休门店。
通过推单方式获取订单的商家， 5分钟之内推送超过10单时计算推单失败率，若失败率高于80% 置休门店。
如何管理同步到美团的数据?
目前门店，订单，退款申请等信息都是可以在外卖开发者后台来进行查询的。开发者后台需要美团团购的账号，请申请账号后联系美团人员进行添加和权限的绑定。
美团外卖开发者后台线下环境：
美团外卖开发者后台线上环境：
线上门店审核不通过可能原因？
线上环境中不允许出现“测试”，为敏感词； 门店名称不能出现数字，否则会被理解为优惠活动，属于恶意竞争，例如“ 全时便利店-十里河店” 的门店是不允许的。
订餐必读&商家公告能否通过商家端修改？
不能，必须通过api接口修改。通过open api文档里“+创建或更新门店信息” 进行更新商家公告。
线上调用poi/save报700错误？
先检查营业时间的设置需在配送营业时间之内，否则需要再看日志追查。
门店是在美团外卖后台创建，可以通过人工方式关联到开放平台吗？
可以的，提供美团门店ID或名称，和对应的app_poi_code给运营同学即可。
使用接口创建门店时默认是“自配送”吗？
是的，商家自配送。
通过美团外卖后台创建的门店，可以通过人工方式关联到开放平台吗？
可以的，提供美团门店ID或名称，和对应的app_poi_code即可。
不开发门店类API，可以通过其他方式同步门店到开放平台吗？
可以，联系美团业务创建门店，通过商家后台管理门店。
门店上线要做的事情？
两方测试成功后，美团给商家正式的appid和secret。给商家开正式开发者后台的权限。
商家根据正式的appid和secret调整你们的设置。在开发者后台设置你们接好的回调的各类url。
没有对接的那些接口的功能，需要使用商家客户端来实现。例如退款等。
门店怎么设置一级品类和二级品类？
开放平台已经预设了一级品类，商家只用传二级品类，系统会自动将商家的品类进行归类。
页面显示菜品已售罄问题怎么办？
暂停售卖字段（is_sold_out）设置为0 通过sku/stock , initdata, batchinitdata 这几个接口设置库存。 检查菜品售卖时间。
当门店设置为休息状态，暂停接单。 第二天营业时间到了，门店是否会自动恢复营业状态呢？还是一直都维持休息状态？
商家人工设为休息状态第二天不会自动恢复营业。如果是因为营业时间到了休息了，第二天会恢复的。
有些门店在开放平台展示为营业上线状态，但是用户端的门店首页展示门店下线？
可能因为门店的一些资质（合同、证照）没有上传，门店可能会被置为休息中，请按照开发文档的要求（poi/save）建店。
保存门店时，返回结果：{"error":{"code":1019,"msg":"门店品类设置失败，无效的品类名称"},"data":"ng"}
品类输入不合法，开发文档中有品类的标准。
测试门店注册的问题？
，左上角登录一下，商家用测试用的账号，先在正式里面登录一下，然后在刷新测试环境的就可以了，商家配置好了商家本地的接口地址，打开商家界面，就可以下单了。
外卖商家版PC端中的“回收站”？
商品列表的商品删除后会进入回收站，放到回收站的商品不在C端展现。当商家用户将回收站的商品恢复到商品列表，消费者用户就能在C端看到。大连锁部门用回收站比较多，主要是因为大连锁的商品较多，当某个商品暂停售卖时仍在C端展现，他们认为这相当于浪费了C端首页展现商品的机会，因此将暂时不卖的商品删除到回收站，排序靠后的商品会位置前移，优先让用户看到，提高了C端可销售商品的曝光率。
如何知道上传的门店已经上线
可以通过外卖开发者后台，查询门店的审核状态，来判断门店是否已经上线。也可以通过调用批量获取门店接口时，返回的open_level字段，若值为0，则代表门店还没有上线；若值为1或者3，则代表门店已经上线，其中1表示门店正常营业，3表示门店处于休息状态。(新增加-1状态，若open_level值为-1，则代表门店扔处于Task状态)
订单相关问题
如何测试下单?
测试环境门店上线后，可以在美团外卖的主站上面通过地图或者地标找到门店，或者可以通过开发者后台，获取到门店在美团的ID。在http://test./restaurant/门店ID 上面下测试单
拉单出现漏单是什么情况？
检查是否已经通过PC端或其他接单方式接单。
如何得知美团取消了订单？
为了得到订单取消的通知，请参阅文档第7部分。接口开发好后，需要通知到美团的技术（线上线下接口URL需不同）。需要注意的是，美团调用APP方取消订单的URL后，APP方避免再回调美团取消接口，以免发生循环调用。
什么情况下订单会美团系统自动取消？
1.推送订单后，5分钟之内商家未确认，系统推送取消订单。
2.订单推送失败，连续推送5次之后，推送取消订单
已经设置好回调接口，美团为什么始终不推送订单？
目前美团外卖开放平台仅仅支持端口号为80或8080的回调地址。
当商家确认订单但还没发送到openapi，openapi此时发送取消订单时会怎么样？
这个问题目前是小概率事件，如果发生暂时按照事故处理，逻辑上商家平台应该有足够的时间通知商家取消订单。
推送的订单内容是否已经按首字母排序？
内容没有排序，需要三方自己排序。
推送订单的内容不是json？
订单里的参数是post参数，里面的detail字段是json格式。
推送订单缺少经纬度导致三方取消订单，如何解决？
针对用户低版本的美团外卖APP，C端不推送经纬度。需要三方兼容。
调用取消订单接口失败，提示订单不存在？
检查三方传的订单号是order_id还是order_view_id， 应该上传order_id.
用户在申请退款过程中可以主动取消退款申请，取消退款申请后是否会推送消息？
对接了美团用户退款接口，如取消退款申请也会推送信息。
美团的订单推送接口在每分钟轮询商家的服务器一次，给商家系统产生了一堆无用的访问日志？
针对商家配置的推单，取消订单，退款，同步配送状态四个回调url（在开发者中心配置)，美团会每隔1分钟检测一次是否存活，忽略即可，商家系统也可调整不记录此日志即可。
订单详情中，订单总额-优惠金额=商户实收金额？
不是，商家实收＝在线支付＋活动款－［在线支付-退款］－［活动款-退款］－菜品分成（收商家）－配送费（收商家）＋［菜品分成（收商家）-退款］＋［配送费（收商家）-退款］
已确认订单，商户能否取消？
可以取消。
取消原因除了原因代码以外，是否还要传入我方的取消原因文字描述？
需要，reason和reasoncode都需要。
推送订单接口和商家确认订单接口有什么区别?
推送订单接口，是三方提供一个url，我们往这个url上面推送订单信息；商家确认订单是指三方接单后告知美团
不使用美团配送，订单状态更新是否有下发通知？
如果接了推送接口，就会推送，如对接了订单取消，订单退款等接口就会推送信息。
退款接口是否必须接入？前期能否先通过平台客服进行自动退款？
可以根据情况接入，如果用客服来处理退款，使用商家后台也可以，但是需注意，30分钟（大连锁商家3小时）不处理的退款，会被默认同意退款。
实收金额，接口没有对应字段，实际情况是需要商家计算吗？开放平台有没有订单状态更新的接口？
财务相关的接口，开放平台目前不涉及，不过我们的商家客户端有财务模块，订单和账单表都有，如果有需要，去那里面下载更方便。 订单相相关的接口对接了的话，订单状态更新会推送的。
商家通过接口接到的订单，需不需要商家通过接口回传完成的状态？
订单完成的这个状态，商家是没法实现的，不用传。开放平台的订单状态和跟商家客户端一样的，没什么差别。
如何获取订单状态?
可以通过+ viewstatus接口查询。
回调端口改为8080后是否会立即生效？
推单会立即生效。但是url监控第二天才会开始。
开发平台向商家连续推单的时间间隔是多少？
美团每分钟调用商家的接口给商家传空过去的时候，商家应该怎么给美团返回？
这是美团对对商家url存活的检测，http的code 能返回200 就ok。
order/getOrderDetail接口中，"delivery_time": 用户预计送达时间，“立即送达”时为0 这个字段是以什么为单位？
秒。order/getOrderDetail 这个接口只推送status字段，没有order_status字段。status字段参考13.1；logistics_status参考12.+。
什么版本以下的app下单时不会上报经纬度？
因为客户的手机上装的美团外卖的app的版本太低；老版本是不会上传经纬度的 ；美团外卖APP（+）和美团APP（+）以下不会上传经纬度。
订单推送过来计算sig的时候detail和extras两个参数值是json数组， json数组里的key也是按字母顺序排列之后再计算sig么？
detail 和 extras 里面的json 数据不需要排序。
在线支付退款流程？
在线支付的单，用户在线申请退款，然后商家可以同意或者拒绝退款，需在30分钟内（大连锁3小时）处理，否则会被系统默认同意退款。若是驳回顾客的退款请求后，顾客不能直接进行退款申诉，需联系美团客服后由客服裁决。
商家设置满减活动时，设置多个梯度：比如58-13，100-30，在美团这边设置生成的是只有一个活动code？
商家直接解析remark字段获取满减活动，例如"remark": "满10元减+元",（优惠说明）。
美团为何取消订单？
美团取消订单分为系统取消和用户取消两种。用户取消会调用第APP方的订单取消通知接口。若用户下单后5分钟，第APP方都没有确认订单，订单就会被系统自动取消。
签名计算和编码问题
先对参数进行编码后计算签名，还是先计算签名后编码？
先计算签名再进行编码。
为什么调用接口总是验证失败？
请首先检查是否参数都已经传递，包括系统级参数和应用级参数；再检查参数名称是否正确；确保参数加密前已经按照要求进行排序；最后查看MD5算法是否为通用的算法而没有经过额外修改。
调用API接口时，请求参数都是传Json格式的吗？ 系统级参数和应用级参数 传递时有什么格式要求吗？
有json，也有字符串, 具体参数请参考开放文档。
计算签名有什么注意事项？
门店签名问题美团现在给商家一个新的 sdk，商家当做一个 jar 包引用一下就行了，附帮助文档，打开其中的index.html文件，辅助sdk编程，有问题的话可能就是签名问题。商家的技术小伙伴通过反编译就能看到源码，就是最普通的 post 签名验证。商家用Java开发的话，用新包不用计算sign了，直接新包的方法：就行，计算签名的时候，中文不需要编码。签名区分大小写。
接收到推送订单后的签名计算？
接收到推送订单后需要解码两次：第一次utf8解码之后，参数里的中文还是编码的，需再解码一次，然后计算签名。没有值测参数也需要拼接。没有值的如：avg_send_time这个参数是平均送达时长。
开放平台测试环境和生产环境的请求地址是什么？
如果使用了美团外卖开放平台SDK的话，是不需要我们自己去设置请求的URL地址的，SDK会读取environment.properties 里面的值，根据env的值去做好URL映射关系。
美团外卖OpenApi线下环境
美团外卖OpenAPI线上环境
菜品相关问题
三方更新菜品图片, url没变，为什么图片没有更新成功？
菜品图片更新后，不能使用与原先菜品图片相同的url。（原因：美团l更新菜品图片接口先根据url去缓存找图片，如果找到，就不会去抓取对方的图片）
调用batchsave接口批量保存菜品，返回“{"data":"ng","error":{"code":808,"msg":"操作失败"}}”？
检查是否上传菜品数量过多导致超时，建议单次上传菜品个数100个以内。
线下环境商家调用foodcat/update接口报参数错误?
门店审核通过之前不能调用该接口上传菜品分类。
是否有菜品回收站相关接口？
回收站的菜品不会被删除，只是用户不会看到回收站里的菜品，恢复回收站里的菜品只能通过pc端页面，开放平台暂时没有这个接口。
上传菜品资料时，是不是用同一个美团appid的连锁分店每个店都要单独上传自己的菜品分类和菜品资料？
是的，同一个appid下可以有多个apppoicode，每个apppoicode都要传菜品资料。
food/batchsave、batchinitdata接口批量上传菜品有数量限制么？
跟商家上传的数据有关，是字节限制（一个菜的所有字段加起来）的 ，菜的数量在100个左右是合理的。
unit字段长度限制多少？
20个字节。
配送相关问题
是否可以增加“配送费”字段？
开放平台的shipping/save 和 shipping/batchsave 接口都已新增“配送费”shipping_fee字段。保存结果用shipping/list 查看。
商户如果使用美团配送，配置的流程是怎么样的？起送价/配送费/配送范围/配送时间这些配置能否通过接口修改？
使用美团配送，先通过接口上传门店，联系美团对应的品牌运营修改设置，改为美团配送。起送价/配送费/配送范围/配送时间，如果使用美团配送的话，这些都无法通过接口修改。
如果使用美团配送，配送状态是“配送单已确认”的时候，订单状态会不会自动变为“商家已确认”？
商家确认订单后，订单被美团骑手抢单后，配送单才会确认。
优惠金额是直接包含商家部分优惠以及美团官方优惠？使用美团配送时，商户如何收取骑手金额,是接口中的哪个值？
优惠金额=商家优惠 +美团优惠。开放平台的接口中，没有骑手应收款。
如果是美团配送订单取消订单是否直接调用订单取消接口就可以，还是要调用取消美团配送的接口?
直接用订单取消接口即可，美团内部会告知配送。
取餐时，骑手付款给商家时，只有骑手单方知道实收金额吗？
如果是骑手到店付款的形式的话，骑手客户端会展示应付金额。商家客户端也有展示应付金额，你们可以参考。
美团外卖平台的“取餐号”接口资料和权限能给到我们做对接吗？这样对接完以后美团取餐员的取餐号和我们公司系统出单号一致，方便骑士取餐，分餐。
B端商家版可以提供上述功能，每个门店，每天从一号开始。
配送烽火台相关设置？
先申请添加至一个组织下；然后新建“配送区域”；在“组织人员”下的“配送区域审核”中自己审核通过；然后“解绑”原有组织下配送区域，重新绑定已新建的配送区域，如有必要（更改配送时间已匹配门店营业时间）。
门店上线流程
美团的外卖门店上线有较为严格的要求，须要保证门店包含配送范围信息和菜品信息，缺少这两类信息的会被驳回。同时美团的外卖门店上线需要走匹配审核的流程，新建的门店会以一个门店上线任务的概念存在，如果各项数据都正常，且不与其他门店重复（美团这边判重不仅仅是依据APP方门店的ID来进行，会根据门店地址，坐标，电话等因素来判断是否为相同门店），5分钟之内就会上线，流程图如下：
创建或更新门店信息，包括基本信息，营业状态，上下线状态等
http://test./api/v1/poi/save
/api/v1/poi/save
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店ID
北苑路北站K酷时代广场4层
门店纬度 （美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换）(门店坐标不需要乘以一百万)
115.281708
门店经度 （美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换）(门店坐标不需要乘以一百万)
http://p1.meituan.net/crm/__82979.jpg
门店图片地址（默认图片为：http://p1.meituan.net/crm/__82979.jpg）图片比例1:1，需要为Jpg/JPEG格式，大于256x256
pic_url_large
http://p1.meituan.net/crm/__82979.jpg
门店图片地址（默认图片为：http://p1.meituan.net/crm/__82979.jpg ）图片比例4:3，需要为Jpg/JPEG格式，大于400x300
客服电话号码 （注意：此号码留客服号码）
standby_tel
门店电话号码 （注意：此号码留商家电话）(已废弃)
shipping_fee
每个订单的配送费
shipping_time
7:00-9:00,11:30-19:00
门店营业时间 （注意格式，且保证不同时间段之间不存在交集）
promotion_info
推广信息范例
门店推广信息
open_level
门店的营业状态 ： 1可配送 3休息中
门店上下线状态 ：1表上线,0表下线，必须菜品、配送范围和门店信息都齐全后才能提交上线 （注意：此字段不为1时门店不会提交审核）
invoice_support
门店是否支持发票
invoice_min_price
门店支持开发票的最小订单价（invoice_suport为1时可用）
invoice_description
发票特殊说明，如只有定额发票，不支持开抬头等
发票相关说明（invoice_suport为1时可用）
third_tag_name
APP方品类名称需要根据接口获取门店品类列表接口获得，如果一个门店包含多个品类须以英文逗号隔开，如中餐,西餐
目前最多支持上传两个门店品类：一个主营品类（上传的第一个品类为主营品类），一个辅营品类；部分门店品类只支持上传一个品类（例如：火锅，特色菜，地方菜，东南亚菜，日韩料理，生活超市）
是否支持营业时间范围外预下单，1表支持，0表不支持
time_select
是否支持营业时间范围内预下单，1表支持，0表不支持 此字段开启后不可关闭，新建门店自动开启
app_brand_code
第三方品牌code值（对接的三方需要提前将该值告诉美团开发人员）
mt_type_id
美团品类id，输入该字段可以加快门店审核速度（美团合法品类表请联系美团运营获取）
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店id
http://test./api/v1/poi/getids
/api/v1/poi/getids
调用成功返回值：{"data":[123，456]}。
批量获取门店详细信息
http://test./api/v1/poi/mget
/api/v1/poi/mget
如下表（key = value 形式）
应用级参数
app_poi_codes
APP方门店id(半角逗号分隔)
{ "data":[
"app_poi_code":"122323",
"name":"咿呀米美食工作餐快送(原包天下)",
"address":"北苑路北站 K 酷时代广场 4 层",
"latitude":"38.693203",
"longitude":"115.281708",
"pic_url":"http://p1.meituan.net/crm1582979.jpg",
"phone":"010-",
"standby_tel":"",
"shipping_fee":1.00,
"shipping_time":"7:00-9:00,11:30-19:00",
"promotion_info":"商家公告栏",
"invoice_support" : 1, "0.9.4 新增 门店是否支持发票,1 表示支持",
"invoice_min_price": 2, "1.0.2 新增 门店支持开发票的最小订单价",
"invoice_description": "mmmm", "1.0.2 新增 发票相关说明",
"open_level":1,
"is_online":1,
"tag_name":"中式炒菜","1.0.5 新增 美团品类名称",
“pre_book”:1,”1.0.15 新增 是否支持营业时间范围外预下单,1 表示支持”,
“time_select”:1,”1.0.15 新增 是否支持营业时间范围内预下单,1 表示支持”
门店设置为营业状态（开发者可以不使用这个API，因为也可以通过接口更新open_level字段值来实现）
http://test./api/v1/poi/open
/api/v1/poi/open
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为休息状态（开发者可以不使用这个API，因为也可以通过接口更新open_level字段值来实现）
http://test./api/v1/poi/close
/api/v1/poi/close
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为下线状态（开发者可以不使用这个API，因为也可以通过接口更新is_online字段值来实现）
http://test./api/v1/poi/offline
/api/v1/poi/offline
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
门店倒闭了
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店设置为上线状态（开发者可以不使用这个API，因为也可以通过接口更新is_online字段值来实现）（目前重新上线的策略是：调用上线API，不会马上上线，美团先通知美团编审人员，然后手工擦操作上线）
http://test./api/v1/poi/online
/api/v1/poi/online
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：{"data" : "ok"}，其余情况请参考
更改门店附加信息
http://test./api/v1/poi/additional/save
/api/v1/poi/additional/save
如下表（key = value 形式）
注：更改门店附加信息，该接口为非必接接口。
更改门店邮箱信息，系统会定时将门店维度的结算等信息发送至该邮箱。如需开通此功能，需要联系美团对接商务。
更改门店的结算企业信息，系统会根据门店对应的结算企业结算信息进行相关结算。
应用级参数
app_poi_code
APP方门店id
app_poi_email
app_brand_code
第三方品牌code值（对接的三方需要提前将该值告诉美团开发人员）
app_org_id
门店的法人企业（门店的财务结算等均由与之关联的结算企业信息决定，对接的三方需要提前将该值告诉美团对接商务）
调用成功返回值：{"data" : "ok"}，其余情况请参考
更改门店公告信息
http://test./api/v1/poi/updatepromoteinfo
/api/v1/poi/updatepromoteinfo
如下表（key = value 形式）
注：更改门店公告信息，该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
promotion_info
门店公告栏
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店品类详细信息列表
http://test./api/v1/poiTag/list
/api/v1/poiTag/list
如下表（key = value 形式）
调用成功返回值：
{"data" : [
"id":1, // 品类id
"name":"中餐" // 品类名称
更改门店营业时间
http://test./api/v1/poi/shippingtime/update
/api/v1/poi/shippingtime/update
如下表（key = value 形式）
注：更改门店营业时间，该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
shipping_time
7:00-9:00,11:30-19:00
门店营业时间
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店是否在延迟发配送名单内，延迟发配送只针对美团配送的 自建、代理两种配送方式
http://test./api/v1/poi/logistics/isDelayPush
/api/v1/poi/logistics/isDelayPush
如下表（key = value 形式）
应级级参数
app_poi_code
APP方门店id
调用成功返回值：
{"code" : 0,"msg" : "success", "data" : {"support_delay_push" : 1 (1表示该门店在延迟发配送名单中，0表示不在名单内),
"delay_push_second" : 600 } }
如果门店在延迟发配送（仅限自建，代理）名单内，商家可通过该接口设置具体的延迟时间
http://test./api/v1/poi/logistics/setDelayPush
/api/v1/poi/logistics/setDelayPush
如下表（key = value 形式）
应级级参数
app_poi_code
APP方门店id
delay_seconds
延迟发配送时间／秒，该参数需在300-600秒之间
调用成功返回值：
{"data" : "ok"}
根据门店id和起止时间批量查询评价信息
http://test./api/v1/poi/comment/app_poi_code
/api/v1/poi/comment/app_poi_code
如下表（key = value 形式）
注：该接口为非必接接口。
应级级参数
app_poi_code
APP方门店id
start_time
查询开始时间，单位秒，最多查询30天前的评价信息
查询结束时间，单位秒
pageoffset
分页查询的偏移量
每页评价信息条数，需小于等于20
调用成功返回值：{"data":"[{\"add_comment\":\"\",\"add_comment_time\":0,\"comment_content\":\"送餐快 味道棒 服务好 餐量足 干净卫生\",\"comment_id\":1136559,\"delivery_comment_score\":0,\"food_comment_score\":0,\"order_comment_score\":5,\"result\":\"ok\"},
"code":0,"msg":"success" }
，其余情况请参考
根据评价id(comment_id,评价信息查询接口返回值)添加商家回复
http://test./api/v1/poi/comment/add_reply
/api/v1/poi/comment/add_reply
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
comment_id
"感谢您的支持"
商家回复内容
调用成功返回值：{"data":"ok",
"code":0,"msg":"success" }，其余情况请参考
创建／更新门店配送范围
http://test./api/v1/shipping/save
/api/v1/shipping/save
如下表（key = value 形式）
注：如果一个门店含有一个以上的配送范围，建议使用，批量更新配送范围
应用级参数
app_poi_code
APP方门店id
app_shipping_code
APP方提供的配送范围id，如一个门店没有配送范围ID，且每个门店只有一个配送范围，可以填1
配置范围类型，（1表示多个配送范围由多个多边形组成）只支持多边形
[{"x":,"y":},{"x":,"y":},{"x":,"y":}]
配送范围type 为 1 时: [{"x":,"y":},{ "x":,"y":},{"x ":,"y":}] type 为 2 时: {"r":1000,"x":,"y":}，需要对其urlEncode，x代表纬度，y代表经度（美团使用的是高德坐标系，也就是火星坐标系，如果是百度坐标系需要转换，配送范围坐标需要乘以一百万)
该配送区域的起送价
shipping_fee
该配送区域的配送费(建议填写这个字段设定配送费,如果此字段为空,则以门店保存的配送费为准)
调用成功返回值：{"data" : "ok"}，其余情况请参考
获取门店配送范围
http://test./api/v1/shipping/list
/api/v1/shipping/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
{"data":[{"min_price":1.0,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"125","shipping_fee":144.0,"type":1},{"min_price":25775.0,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"123","shipping_fee":0.0,"type":1}]}
批量创建/更新配送范围
http://test./api/v1/shipping/batchsave
/api/v1/shipping/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
shipping_data
[{"min_price":10,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":124,"type":1,"shipping_fee":33},{"min_price":1,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":125,"type":1,"shipping_fee":44},{"min_price":25775,"area":"[{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":},{\"x\":,\"y\":}]","app_shipping_code":"123","type":1,"shipping_fee":55},{...}]
配送范围集合的json数据，处理逻辑：1）如果配送范围原来不存在就新增；2）如app_shipping_code存在就更新；3）如原来存在的app_shipping_code，而这次没提交，就删除范围都为多边形，不支持圆形
调用成功返回值：{"data" : "ok"}，其余情况请参考
更新菜品分类
http://test./api/v1/foodCat/update
/api/v1/foodCat/update
如下表（key = value 形式）
注意：更改菜品分类，会同时将其他菜品所属的该分类一并改掉。
例如，拉面的分类应该是面食，而拌土豆丝应该是凉菜。如果把拌土豆丝的分类错写成面食，并且调用此api更新菜品分类：面食＝>凉菜，就会把拉面的分类改称凉菜。请慎重使用。如果想改变单个食物的食品分类，请调用创建/更新菜品的api。
应用级参数
app_poi_code
APP方门店id
category_name_origin
更新时必须，新建时无须填写
美团定制饭1
原始的菜品分类名称
category_name
美团定制饭2
新建的菜品分类名称
添加时必须
菜品排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除菜品分类
http://test./api/v1/foodCat/delete
/api/v1/foodCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_name
APP方分类名
调用成功返回值：{"data" : "ok"}，其余情况请参考
推荐使用，批量更新门店菜品
注：现对菜品上传接口进行升级，分为两步，第一步为上传图片，第二步为创建/更新菜品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新菜品）
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用
2.上传其他菜品信息
创建／更新菜品（推荐使用4.7的API，批量更新门店菜品）
http://test./api/v1/food/save
/api/v1/food/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id，最大长度128，不同门店可以重复，同一门店内不能重复
添加时必须
美团定制版
description
这是一个菜品
添加时必须
菜品价格 不能为负数
min_order_count
添加时必须
最小购买量，最小为1
添加时必须
添加时必须
打包盒数量
添加时必须
餐盒价格 不能为负数
category_name
添加时必须
菜品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
菜品图片ID（注意：①此处的图片ID由步骤1上传图片获得 ②更新菜品图片时必须更新图片URL），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
新增菜品数据接口，支持菜品多规格，支持库存、商品物料码、可售时间
注：菜品上传接口，分为两步，第一步为上传图片，第二步为创建/更新菜品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新菜品）
a.目前我们的商品结构支持spu和sku
b.如果三方的商品没有sku信息的话，不用传sku相关信息
c.填写sku信息时，sku_id, price, spec, upc, stock, available_times, location_code必须一一对应，即参数个数一致
d.如果不传sku信息，必须上传name
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用</p
2.上传其他菜品信息
创建／更新菜品（推荐使用4.7的API，批量更新门店菜品）
http://test./api/v1/food/initdata
/api/v1/food/initdata
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id(三方商品spu_code值, 不同门店可以重复，同一门店内不能重复)最大长度128
添加时必须
美团定制版
description
这是一个菜品
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&},{...}&&&]
App方菜品的skus，代表菜品下的多个sku信息，使用json格式传递参数，分别包括sku_id(必须),spec(必须),upc(非必须),price(必须),stock(必须),available_times(非必须，默认与门店营业时间一致),location_code(非必须)；sku_id是sku唯一标识，spec表示sku的规格，upc表示sku的upc码，price表示sku的价格，price不能为负数，不能超过10个字，stock表示sku的库存数量，stock不能为负数，也不能为小数，传"*"表示表示库存无限 ，available_times表示sku起售时间，要保证不同时间段之间不存在交集，location_code表示sku的料位码 如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
菜品价格 不能为负数，如果传递了skus价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
如果sku内传递了box_num，本参数不生效
添加时必须
餐盒价格 不能为负数
如果sku内传递了box_price，本参数不生效
category_name
菜品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
菜品图片ID（注意：此处的图片ID由步骤1上传图片获得），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
http://test./api/v1/food/delete
/api/v1/food/delete
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品ID, 最大长度128 不同门店可以重复，同一门店内不能重复
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店菜品列表
http://test./api/v1/food/list
/api/v1/food/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
分页查询偏移量
分页查询每页查询的数量,须小于200
{ "data": [
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5"
菜品信息以json格式请求，详细参数请参见参数定义
说明：1）批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品；如果原来有的菜品不在此次更新的数据中，就会删除原来的菜品。
2）若菜品的数量超出200，该接口可能会出错，建议使用零售类接口:
批量创建／更新菜品
http://test./api/v1/food/batchsave
/api/v1/food/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品3","description": "菜品描述","price": 13.5,"unit": "份","picture":"","sequence":1},{"app_food_code": "food_0002","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是另一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品2","price": 18.5,"unit": "份","picture":"","sequence":1},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）如原来存在的app_food_code，而这次没提交，就删除；4）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
调用成功返回值：{"data" : "ok"}，其余情况请参考
菜品信息以json格式请求，详细参数请参见接口中的参数定义
说明：1）批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品。 2）批量更新的菜品数量不能超过200。
批量创建／更新菜品
http://test./api/v1/food/batchinitdata
/api/v1/food/batchinitdata
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "这是一个分类","is_sold_out": 0,"min_order_count": 1,"name": "菜品3","description": "菜品描述","skus":[{"sku_id":"5","upc":"13","spec":"小","price": "13","stock":"10","available_times":{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"},"location_code":"34"}"box_num":"1""box_price":"0.5",{...}],"unit": "份","picture":"","sequence":1},{....},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店菜品分类列表
http://test./api/v1/foodCat/list
/api/v1/foodCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
"app_poi_code": 123,
"name": "面条类",
"sequence": "1",
说明：创建/更新的菜品sku会和原有菜品sku进行比对,sku_id作为唯一界定标准，如果某个菜品sku原来没有，就会新增此菜品sku；如果原来有，就会更新此菜品sku。
添加菜品SKU规格信息
http://test./api/v1/food/sku/save
/api/v1/food/sku/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id(相当于spu, 不同门店可以重复，同一门店内不能重复)，一个菜品可以有多个规格，如大份、小份，即为sku，最大长度128
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-2Am1:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&},{...}&&&]
sku相关参数要求同4.3 创建/更新菜品接口
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除门店菜品SKU信息
http://test./api/v1/food/sku/delete
/api/v1/food/sku/delete
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方菜品id，不同门店可以重复，同一门店内不能重复最大长度128
App方菜品的sku_id
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：更新的菜品sku的价格
更新菜品SKU价格信息
http://test./api/v1/food/sku/price
/api/v1/food/sku/price
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","skus":{"sku_id":"5"，"price":"10"},{...}]},{...}[]]
菜品sku价格集合的json数据，菜品sku的价格。 菜品价格不能为负数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：更新的菜品sku的库存
更新菜品SKU库存信息
http://test./api/v1/food/sku/stock
/api/v1/food/sku/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，菜品sku的库存。菜品stock不能为负数,也不能为小数,传"*"表示库存无限
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：增加菜品sku的库存
增加菜品SKU库存
http://test./api/v1/food/sku/inc_stock
/api/v1/food/sku/inc_stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，此处stock为菜品sku库存增加值。不能为负数,也不能为小数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：减少菜品sku的库存
减少菜品SKU库存
http://test./api/v1/food/sku/desc_stock
/api/v1/food/sku/desc_stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5"，"stock":"10"},{...}]},{...}]
菜品sku价格集合的json数据，此处stock为菜品sku库存减少值。不能为负数,也不能为小数
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：绑定菜品属性，例如菜品是否需要加热、酸辣程度等；如果菜品已有菜品属性调用此接口后会全量覆盖旧的菜品属性；
properties字段传空则会清空该菜品的所有属性。
绑定菜品属性
http://test./api/v1/food/bind/property
/api/v1/food/bind/property
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
food_property
[{&&&&"app_food_code": "food_0001",&&&&"properties":
[&&&&&&&&{"property_name":"冷热",
&&&&&&&&"values":"["冷", "热"]"},
&&&&&&&&{"property_name":"辣度",
&&&&&&&&"values":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}&&&]},{...}]
菜品属性的json数据
调用成功返回值：{"data" : "ok"}，其余情况请参考
说明：获取菜品属性
获取菜品属性
http://test./api/v1/food/property/list
/api/v1/food/property/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品id
{ "data":[&&&&&&&&{"property_name":"冷热",
&&&&&&&&"values":"["冷", "热"]"},
&&&&&&&&{"property_name":"辣度",
&&&&&&&&"values":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}
查询菜品详情
http://test./api/v1/food/get
/api/v1/food/get
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方菜品id
{ "data": {
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5"
说明：获取菜品属性
批量更新售卖状态
http://test./api/v1/food/sku/sellStatus
/api/v1/food/sku/sellStatus
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
&&&&"app_food_code": "abcd135",
&&&&"skus":[{"sku_id":"abcd135"}]
菜品sku集合的json数据
sell_status
0.上架 1.下架
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：美团有标准的药品分类库（美团标准药品分类参考13.6），三方可以按照标准分类上传药品，如果不能满足三方需求，可自行创建和修改药品分类；在上传药品时，如果使用到了美团标准药品库中的分类，系统会自动将该分类复制到您的门店（未曾使用的不会复制），暂只支持一级类目。
创建药品分类
http://test./api/v1/medicineCat/save
/api/v1/medicineCat/save
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code，门店内不允许重复（包括与美团标准药品分类code都不能重复），最大长度6位字符
category_name
药品分类名称，最大长度128个汉字
药品分类排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：如果想修改在您门店下美团标准的分类信息，必须按照美团标准药品分类库的code进行修改；更新时非必须的参数如果不传，接口会保持原有值不变，如果想改变单个药品的药品分类，请调用5.6更新药品的api。
更新药品分类
http://test./api/v1/medicineCat/update
/api/v1/medicineCat/update
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code，最大长度6位字符
category_name
药品分类名称，最大长度128个汉字
药品分类排序
调用成功返回值：{"data" : "ok"}，其余情况请参考
注意：如果该药品分类下有药品，则不能删除。
删除药品分类
http://test./api/v1/medicineCat/delete
/api/v1/medicineCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_code
药品分类code
调用成功返回值：{"data" : "ok"}，其余情况请参考
默认按照sequence升序排序返回结果
查询门店药品分类列表
http://test./api/v1/medicineCat/list
/api/v1/medicineCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
"app_poi_code": 123,
"code":"901600",
"name": "肠胃不适",
"sequence": "5",
美团有标准的药品库，三方商家上传药品时，系统会根据“UPC+国药准字号”锁定唯一药品，锁定成功后，系统会直接使用药品库中的标准信息（比如药品名称、生产厂商名称、批准文号、电子监管码、用法用量、适应症、适应人群、成分、不良反应、禁忌、注意事项、药物相互作用、儿童用药、妊娠与哺乳用药、老年人用药、性状、包装、剂型、贮藏、药理作用、有效期）
三方在上传药品时，扩展属性比如注意事项、外表特征等等会从标准库中取值，不需要单独上传
创建药品（推荐使用5.7的API，批量创建药品）
http://test./api/v1/medicine/save
/api/v1/medicine/save
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_medicine_code
APP方药品id，最大长度128位字符
medicine_no
国药准字号
药品价格 不能为负数
药品库存 stock不能为负数，也不能为小数
category_code
药品分类code
category_name
药品分类名称
is_sold_out
1：卖光，0：未卖光
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
相关注意事项同5.5API，创建药品；另外，如果相关非必须参数不传，系统API会保持原有值不变，只更新传入有值属性
更新药品（推荐使用5.8的API，批量更新药品）
http://test./api/v1/medicine/update
/api/v1/medicine/update
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_medicine_code
APP方药品id，最大长度128位字符
medicine_no
国药准字号
药品价格 不能为负数
药品库存 stock不能为负数，也不能为小数
category_code
药品分类code
category_name
药品分类名称
is_sold_out
1：卖光，0：未卖光
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
多个药品信息以json格式传递，详细参数请参见接口5.7中的参数定义
批量创建药品
http://test./api/v1/medicine/batchsave
/api/v1/medicine/batchsave
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
[{&&&&&&"app_medicine_code":"medicine_0001",&&&&&&"app_poi_code": "990001",&&&&&&"upc": "02",&&&&&&"medicine_no": "B",&&&&&&"spec": "0.5g*10粒",&&&&&&"price": 10.5,&&&&&&"stock": 0,&&&&&&"category_code": "901600",&&&&&&"category_name": "退烧止痛",&&&&&&"is_sold_out": 1,&&&&&&"sequence": 1},{…}]
同单个药品上传接口描述
调用成功返回值：{"data" : "ok"}，其余情况请参考
药品信息以json格式请求，详细参数请参见接口5.8中的参数定义
说明：批量更新药品接口只存在更新操作：如果上传的某个药品原来没有，API不做任何处理；如果原来有，就会更新此药品，未上传的非必须参数，API会保持原有值，API只更新传入参数值的属性。
批量更新药品
http://test./api/v1/medicine/batchupdate
/api/v1/medicine/batchupdate
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
<pre class="prettyprint prettyprinted active"[{&&&&&&"app_medicine_code":"medicine_0001",&&&&&&"app_poi_code": "990001",&&&&&&"upc": "02",&&&&&&"medicine_no": "B",&&&&&&"spec": "0.5g*10粒",&&&&&&"price": 10.5,&&&&&&"stock": 0,&&&&&&"category_code": "901600",&&&&&&"category_name": "退烧止痛",&&&&&&"is_sold_out": 1,&&&&&&"sequence": 1},{…}]
同更新单个药品接口的描述
调用成功返回值：{"data" : "ok"}，其余情况请参考
http://test./api/v1/medicine/delete
/api/v1/medicine/delete
应用级参数
app_poi_code
APP方门店id
app_medicine_code
APP方药品ID, 最大长度128位字符
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询时，药品的扩展属性会全部展示出来，属性值是美团标准属性库中的code
查询门店药品列表
http://test./api/v1/medicine/list
/api/v1/medicine/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
{ "data": [
"medicine_id": 123,
"name": "布洛芬缓释片",
"app_medicine_code": "buluofen",
"upc":"02",
"medicine_no":"B",
"spec":"0.5g*10粒",
"price": 13.5,
"stock":10,
"category_code": "901600",
"category_name": "退烧止痛",
"is_sold_out": 1,
"sequence":10,
"090015":"孕妇食用，谨遵医生叮嘱",
"090025":"3个月",
更新药品的库存(支持批量更新)
更新药品库存
http://test./api/v1/medicine/stock
/api/v1/medicine/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
medicine_data
[&&{&&&&"app_medicine_code":"medicine_0001",
&&&&"app_poi_code":"990001",&&&&"stock": "0"
&&},&&{…}]
medicine_data中,app_poi_code、app_medicine_code、stock为必传字段。
药品stock不能为负数,也不能为小数,传"*"表示库存无限
调用成功返回值：{"data" : "ok"}，其余情况请参考
更新商品分类
http://test./api/v1/retailCat/update
/api/v1/retailCat/update
如下表（key = value 形式）
category_name_origin字段不为空时，即将category_name_origin对应的商品分类的名称更改为category_name
只允许门店类型为生活超市下的便利店、超市的门店创建二级商品分类，即可以传secondary_category_name字段。
最多只支持两级分类，即不能在一个二级分类下创建子分类。
门店下不论一级或二级分类，都不允许重名。
应用级参数
app_poi_code
APP方门店id
category_name_origin
原始的商品分类名称
category_name
商品分类名称
secondary_category_name
子级商品分类名称
添加时必须
商品分类排序。数字越小，排名越靠前
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除商品分类
http://test./api/v1/retailCat/delete
/api/v1/retailCat/delete
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
category_name
APP方分类名
调用成功返回值：{"data" : "ok"}，其余情况请参考
查询门店商品分类列表
http://test./api/v1/retailCat/list
/api/v1/retailCat/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
调用成功返回值：
"name":"主食",
"sequence":1,
"children":null
"name":"各种炒饭",
"sequence":3,
"children":null
"name":"面类",
"sequence":4,
"children":[
"name":"炒面",
"sequence":4,
"children":null
"name":"凉面",
"sequence":5,
"children":null
"name":"酒水饮料",
"sequence":6,
"children":null
其余情况请参考
新增商品数据接口，支持商品多规格，支持库存、商品物料码、可售时间
注：商品上传接口，分为两步，第一步为上传图片，第二步为创建/更新商品，详细内容如下。（目前接口会兼容原有形式，但新接入时，推荐使用升级后的形式，即分为两步创建/更新商品）
a.目前我们的商品结构支持spu和sku
b.如果三方的商品没有sku信息的话，不用传sku相关信息
c.填写sku信息时，sku_id, price, spec, upc, stock, available_times, location_code必须一一对应，即参数个数一致
d.如果不传sku信息，必须上传name
1.上传图片
调用上传图片接口，详细内容见，会得到一个图片ID，供下一步使用</p
2.上传其他商品信息
创建／更新商品（推荐使用4.7的API，批量更新门店商品）
http://test./api/v1/retail/initdata
/api/v1/retail/initdata
如下表（key = value 形式）
应用级参数
app_poi_code
App方门店ID
app_food_code
APP方商品id(三方商品spu_code值, 不同门店可以重复，同一门店内不能重复)最大长度128
添加时必须
美团定制版
description
这是一个商品
[{&&&"sku_id":"10",&&&"spec":"大",&&&"upc":"273",&&&"price":"23.5",&&&"stock":"10",&&&"available_times":&&&&&&{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"&&&},&&&"location_code":"23"&&&"box_num":"1"&&&"box_price":"0.5"&&&"weight":430&&&},{...}&&&]
App方商品的skus，代表商品下的多个sku信息，使用json格式传递参数，分别包括sku_id(必须),spec(必须),upc(非必须),price(必须),stock(必须),available_times(非必须，默认与门店营业时间一致),location_code(非必须)；sku_id是sku唯一标识，spec表示sku的规格，upc表示sku的upc码，price表示sku的价格，price不能为负数，不能超过10个字，stock表示sku的库存数量，stock不能为负数，也不能为小数，传"*"表示表示库存无限 ，available_times表示sku起售时间，要保证不同时间段之间不存在交集，location_code表示sku的料位码
skus中，只限门店类型为生活超市下的便利店、超市时，可以传weight(重量)字段,单位克/g
如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
商品价格 不能为负数，如果传递了skus价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
如果sku内传递了box_num，本参数不生效
添加时必须
餐盒价格 不能为负数
如果sku内传递了box_price，本参数不生效
category_name
商品分类名
is_sold_out
添加时必须
1：卖光，0：未卖光
2B86BE5A5C237 8 7E0D93 (由第一步获得的图片ID)
商品图片ID（注意：此处的图片ID由步骤1上传图片获得），只支持jpg格式，图片需要小于
当前分类下的排序序号
调用成功返回值：{"data" : "ok"}，其余情况请参考
1）如果商品是在二级分类下面，则category_name为其一级分类，secondary_category_name为其所属分类（二级分类）
2）如果商品是在一级分类下面，则category_name为其所属分类，secondary_category_name字段为空
查询门店商品列表
http://test./api/v1/retail/list
/api/v1/retail/list
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
分页查询偏移量
分页查询每页查询的数量,须小于200
{ "data": [
"name": "立白洗洁精500g",
"app_food_code": "23413",
"price": 3.1
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "瓶",
"category_name": "清洁用品",
"secondary_category_name":"厨卫清洁",
"is_sold_out": 1,
"picture": "",
"sequence": 1,
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139",
"box_num":"1",
"box_price":"0.5",
"weight":500
商品信息以json格式请求，详细参数请参见接口中的参数定义
说明：1）批量更新的商品会和原有商品进行比对：如果某个商品原来没有，就会新增此商品；如果原来有，就会更新此商品。 2）批量更新的商品数量不能超过200。
批量创建／更新商品
http://test./api/v1/retail/batchinitdata
/api/v1/retail/batchinitdata
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
"app_food_code": "food_0001","app_poi_code": "990001","box_num": 1,"box_price": 0.1,"category_name": "商品所属分类","is_sold_out": 0,"min_order_count": 1,"name": "商品3","description": "商品描述","unit": "份","picture":"","sequence":1,
"skus":[{"sku_id":"5","upc":"13","spec":"小","price": "13","stock":"10","available_times":{"monday"："19:00-21:00,23:00-23:59","tuesday":19:00-21:00","wednesday":"23:00-23:59","thursday":"23:00-23:59",friday":"19:00-21:00","saturday":"23:00-23:59","sunday":"19:00-21:00"},"location_code":"34","box_num":"1","box_price":"0.5","weight":500},{...}]
商品集合的json数据，处理逻辑：1）如果商品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
4）skus中，只限门店类型为生活超市下的便利店、超市时，可以传weight(重量)字段,单位克/g
如果skus传递box_num、box_price以skus为准,未传递box_num、box_price以上级参数为准
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001","sku_id":"3452", "error_msg":"存在敏感词"},{{"app_food_code":"food_0002", "error_msg":"参数中包含敏感词, 操作失败, 请检查商品分类名称"}}]}，其余情况请参考
说明：更新的商品sku的价格
更新商品SKU价格信息
http://test./api/v1/retail/sku/price
/api/v1/retail/sku/price
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001","skus":{"sku_id":"5","price":"8.5"},{...}]},{...}[]]
商品sku价格集合的json数据。 商品价格不能为负数
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001", "error_msg":"不存在此商品"},{{"app_food_code":"food_0002","sku_id":"2134","error_msg":"不存在此商品sku"}}]}，其余情况请参考
说明：更新的商品sku的库存
更新商品SKU库存信息
http://test./api/v1/retail/sku/stock
/api/v1/retail/sku/stock
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
[{"app_food_code": "food_0001",skus:[{"sku_id":"5","stock":"10"},{...}]},{...}]
商品sku库存集合的json数据。商品库存stock字段为非负整数,传"*"表示库存无限
全部更新成功，返回：{"data" : "ok",
部分更新成功，返回部分商品更新失败的原因：{"data" : "ok",
"msg":[{"app_food_code":"food_0001", "error_msg":"不存在此商品"},{{"app_food_code":"food_0002","sku_id":"2134","error_msg":"不存在此商品sku"}}]}，其余情况请参考
查询商品详情
http://test./api/v1/retail/get
/api/v1/retail/get
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店id
app_food_code
APP方商品id
{ "data": {
"name": "西红柿鸡蛋面",
"app_food_code": "qwe",
"price": 13.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"secondary_category_name": null,
"is_sold_out": 1,
"picture": "",
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "13.5",
"available_times":{"monday"："19:00-21:00,23:00-23:59",
"tuesday": 19:00-21:00",
"wednesday":"23:00-23:59",
"thursday":"23:00-23:59",
"friday":"19:00-21:00",
"saturday":"23:00-23:59",
"sunday":"19:00-21:00"
"location_code": "139"
"box_num":"1",
"box_price":"0.5",
"weight":500
注:美团目前采用主动推送订单到APP方的形式，需APP方参考第6节提供回调地址
将订单设为商家已收到
http://test./api/v1/order/poi_received
/api/v1/order/poi_received
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家确认订单（商家收到订单并回执，如商家已接入美团配送服务，则调用该接口会自动下发配送单给美团配送，无需再调用下发配送单接口5.12）
http://test./api/v1/order/confirm
/api/v1/order/confirm
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家取消订单（如商家已接入美团配送服务，则调用该接口会自动取消美团配送单，无需再调用取消配送单接口）
http://test./api/v1/order/cancel
/api/v1/order/cancel
如下表（key = value 形式）
应用级参数
reason_code
规范化取消原因code，详情请参考
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单配送中(必接,如接入美团配送则无需接)
http://test./api/v1/order/delivering
/api/v1/order/delivering
如下表（key = value 形式）
应用级参数
courier_name
配送员姓名
courier_phone
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单已送达(如接入美团配送则无需接)
http://test./api/v1/order/arrived
/api/v1/order/arrived
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
订单确认退款请求
http://test./api/v1/order/refund/agree
/api/v1/order/refund/agree
如下表（key = value 形式）
应用级参数
因***原因确认退款
确认退款详情
调用成功返回值：{"data" : "ok"}，其余情况请参考
驳回订单退款申请
http://test./api/v1/order/refund/reject
/api/v1/order/refund/reject
如下表（key = value 形式）
应用级参数
因***原因驳回退款
驳回退款详情
调用成功返回值：{"data" : "ok"}，其余情况请参考
只适用于美团商家APP方配送的情况
获取订单商家补贴款
http://test./api/v1/order/subsidy
/api/v1/order/subsidy
如下表（key = value 形式）
应用级参数
调用成功返回值：
"order_id": 111, 订单ID
"order_total": "527.5", 订单总价
"subsidy": 100, 补偿款
"extras": [{
"reduce_fee": 2.5,
"remark": "满10元减2.5元"
活动说明},
reduce_fee": 2.5,
"remark": "满10元减2.5元"
查询订单状态
http://test./api/v1/order/viewstatus
/api/v1/order/viewstatus
如下表（key = value 形式）
应用级参数
返回值: { "data":
"status": 1 // 订单状态 }
查询活动信息
http://test./api/v1/order/getActDetailByAcId
/api/v1/order/getActDetailByAcId
如下表（key = value 形式）
应用级参数
act_detail_id
调用正确返回值:
"id":71,(活动id)
"poi_policy":"{\"full_price\":15,\"gift_name\":\"么么\",\"gift_price\":1,\"mt_charge\":0.00,\"poi_charge\":1}",(活动内容json)
"remark":"满赠",(活动备注)
"start_time":,(活动开始时间)
"end_time":, (活动结束时间)
"type":5 (活动类型)
更多订单详细信息可以在开发者后台的"基础设置->订单可选字段订阅设置"中设置，设置后推送订单和获取订单详细信息时都会获得订阅信息。
商家主动查询订单状态详细信息
http://test./api/v1/order/getOrderDetail
/api/v1/order/getOrderDetail
如下表（key = value 形式）
应用级参数
is_mt_logistics
是否为美团配送
（当需要查询美团配送的详细信息时此字段需要为1）
调用正确返回值：
"result":"ok"
"order_id": 25217, 订单ID
"wm_order_id_view": 订单展示ID
"app_poi_code": APP方商家ID
"wm_poi_name": 美团商家名称
"wm_poi_address": 美团商家地址
"wm_poi_phone": 美团商家电话
"recipient_address": 收件人地址
"recipient_phone": 收件人电话
"recipient_name": 收件人姓名
"shipping_fee": 门店配送费
"total": 总价
"original_price": 原价
"caution": 忌口或备注
"shipper_phone": 送餐员电话
"status": 订单状态 订单当前状态code，详情请参考13.1节
"city_id": 城市ID(目前暂时用不到此信息)
"has_invoiced": 是否开发票
"invoice_title": 发票抬头
"ctime": 创建时间
"utime": 更新时间
"delivery_time": 用户预计送达时间，“立即送达”时为0
"is_third_shipping": 是否是第三方配送平台配送（0：否；1：是）
"pay_type": 支付类型（1：货到付款；2：在线支付）
"latitude": 实际送餐地址纬度
"longitude": 实际送餐地址经度
"detail": 此字段为Json串，具体格式如下："detail": [{"app_food_code": 1,"food_name": "狗不理","quantity": 6,"price": 100,"box_num":2,"box_price":
1,"unit": "份","food_discount": 0.8 (菜品折扣，只是美团商家、APP方配送的门店才会设置，默认为1。折扣值不参与总价计算。开放平台1.0.3 新增)},{"..."}]
"extras": 此字段为Json串，具体格式如下："extras": [{"act_detail_id":10,(活动id) "reduce_fee": 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "满10元减2.5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟)},{"reduce_fee": 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "新用户立减5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟)},{…}]
"order_send_time": , 用户下单时间
"order_receive_time":
, 商户收到时间
"order_confirm_time":
, 商户确认时间
"order_cancel_time": , 订单取消时间
"order_completed_time": , 订单完成时间
"logistics_status": 20, 配送订单状态code，若is_mt_logistics不为1则此字段为空，详情请参考13.5.1节
"logistics_id": 7, 配送方ID，若is_mt_logistics不为1则此字段为空
"logistics_name": "斑马快送", 配送方名称，若is_mt_logistics不为1则此字段为空
"logistics_send_time": , 配送单下单时间，若is_mt_logistics不为1则此字段为空
"logistics_confirm_time":
, 配送单确认时间，若is_mt_logistics不为1则此字段为空
"logistics_cancel_time": , 配送单取消时间，若is_mt_logistics不为1则此字段为空
"logistics_fetch_time": , 骑手取单时间，若is_mt_logistics不为1则此字段为空
"logistics_completed_time": , 配送单完成时间，若is_mt_logistics不为1则此字段为空
"logistics_dispatcher_name": , 骑手姓名，若is_mt_logistics不为1则此字段为空
"logistics_dispatcher_mobile": , 骑手电话，若is_mt_logistics不为1则此字段为空
商家下发美团配送订单(接入美团配送选接)
http://test./api/v1/order/logistics/push
/api/v1/order/logistics/push
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家取消美团配送订单(接入美团配送选接)
http://test./api/v1/order/logistics/cancel
/api/v1/order/logistics/cancel
如下表（key = value 形式）
应用级参数
调用成功返回值：{"data" : "ok"}，其余情况请参考
配送状态变更回调
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照
需要验证签名才可以访问APP方门店的api。
应用级参数
注意：post的Content-Type字段为text，所有参数均为普通post参数，不是json
logistics_status
配送单状态，详情请参考13.5.1节
该状态对应的时间
dispatcher_name
dispatcher_mobile
调用成功返回值：{"data" : "ok"}，其余情况请参考
商家主动查询配送订单状态
http://test./api/v1/order/logistics/status
/api/v1/order/logistics/status
如下表（key = value 形式）
应用级参数
"result":"ok"
"order_id": 25217, 订单ID
"logistics_status": 20, 配送订单状态code，详情请参考13.5.1节
"logistics_name": "自建", 配送方名称
"send_time": , 配送单下单时间
"confirm_time":
, 配送单确认时间
"cancel_time": , 配送单取消时间
"fetch_time": , 骑手取单时间
"completed_time": , 订单完成时间
"dispatcher_name": , 骑手姓名
"dispatcher_mobile": , 骑手电话
"poi_shipping_fee": 2, 商家承担运费
"shipping_tips": "运费波动为xx元", 商家承担运费的具体说明
"tip_amount": 3.0, 商家给定的小费金额
调用成功返回值：{"data" : "ok"}，其余情况请参考
根据三方门店ID获取当日最新订单流水号
http://test./api/v1/order/getOrderDaySeq
/api/v1/order/getOrderDaySeq
如下表（key = value 形式）
应用级参数
app_poi_code
三方门店ID
调用成功返回值：{
"result":"ok",
"day_seq" : "17"
}，其余情况请参考
根据三方门店ID,日期,流水号获取订单ID（该接口只支持30天内查询）
http://test./api/v1/order/getOrderIdByDaySeq
/api/v1/order/getOrderIdByDaySeq
如下表（key = value 形式）
应用级参数
app_poi_code
三方门店ID
日期,整形数据
订单流水号
调用成功返回值：{
"result":"ok",
"order_id" : ""
}，其余情况请参考
众包配送下单前，先调用该接口查看当前配送费
http://test./api/v1/order/zhongbao/shippingFee
/api/v1/order/zhongbao/shippingFee
如下表（key = value 形式）
应用级参数
订单ID，用英文逗号隔开
调用成功返回值：{
"wm_order_id":"",
"shipping_fee" : "3.0",
"wm_order_view_id" : "",
"shipping_tips" : "浮动价格XX元"
"wm_order_id":"",
"shipping_fee" : "4.0",
"wm_order_view_id" : "",
"shipping_tips" : "浮动价格XX元"
}，其余情况请参考
众包发配送，如配送费较接口查询到的值不同（即配送费变更），则发配送失败
http://test./api/v1/order/zhongbao/dispatch
/api/v1/order/zhongbao/dispatch
如下表（key = value 形式）
应用级参数
shipping_fee
7.18接口查询到的配送费
tip_amount
调用成功返回值：{"data":"ok"}，其余情况请参考
众包配送单追加小费，用于已下发配送但没有配送员接单时，更新小费
http://test./api/v1/order/zhongbao/update/tip
/api/v1/order/zhongbao/update/tip
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
在商家发起部分退款前，查询可被部分退款的商品详情
http://test./api/v1/order/getPartRefundFoods
/api/v1/order/getPartRefundFoods
如下表（key = value 形式）
应用级参数
调用正确返回值：
"app_food_code":"food_0001",
"food_name":"退款商品05",
"sku_id":"sku_0001",
"spec":"份",
"food_price":16, 菜品价格,单位元
"count":2, 菜品数量
"box_num":2, 餐盒数量
"box_price":1, 餐盒价格
"origin_food_price":16, 菜品原价,单位元
"refund_price":16}, 退款价格,单位元
部分退款申请
http://test./api/v1/order/applyPartRefund
/api/v1/order/applyPartRefund
如下表（key = value 形式）
应用级参数
因***原因部分退款
申请部分退原因
&&&&"app_food_code": "abcd135",
&&&&"sku_id": "abcd135",
&&&&"count":2]
没有sku，sku_id为"" ,count不能为0
部分退款菜品详情
调用成功返回值：{
"data":"ok"
}，其余情况请参考
用户在美团外卖下单后，会回调APP方提供的callback_url，请按照以下请求和响应格式实现相应的api
推送已支付状态的订单给APP方
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
注意：①千万不要将判断签名信息是否正确的参数列表写死，以后接口还会升级，如果写死的话后期接口升级那么我们推送的签名信息就会较之前的发生改变，建议这里获取请求的所有参数来作为判断签名信息是否正确的准则 ②正式环境和测试环境接口端口请使用80或8080
应用级参数
注意：①post的Content-Type字段为text，所有参数均为普通post参数，不是json ②美团推送的参数未排序，请将参数排序后再计算sig
订单ID(数据库中请用bigint(20)存储此字段)
wm_order_id_view
订单展示ID
app_poi_code
APP方商家ID
wm_poi_name
美团商家名称
wm_poi_address
美团商家地址
wm_poi_phone
美团商家电话
recipient_address
收件人地址(此字段为用户填写的收货地址，可在开发者中心订阅是否根据经纬度反查地址，若订阅则会在此字段后追加反查结果，并用“@#”符号分割，如：用户填写地址@#反查结果)
recipient_phone
收件人电话
recipient_name
收件人姓名（若用户没有填写姓名，此字段默认为空。可在开发者中心订阅是否用“美团客人”填充此字段）
shipping_fee
门店配送费
original_price
忌口或备注
shipper_phone
送餐员电话
城市ID（目前暂时用不到此信息）
has_invoiced
是否开发票
invoice_title
taxpayer_id
纳税人识别号，该信息默认不推送，如有需求可在开发者中心订阅
delivery_time
用户预计送达时间，“立即送达”时为0
is_third_shipping
是否是第三方配送平台配送（0：否；1：是）
支付类型（1：货到付款；2：在线支付）
取餐类型（0：普通取餐；1：到店取餐）该信息默认不推送，如有需求可在开发者中心订阅
实际送餐地址纬度
实际送餐地址经度
门店当天的推单流水号，该信息默认不推送，如有需求请联系美团
is_favorites
用户是否收藏此门店（true, false），该信息默认不推送，如有需求可在开发者中心订阅
is_poi_first_order
用户是否第一次在此门店点餐（true, false），该信息默认不推送，如有需求可在开发者中心订阅
dinners_number
用餐人数，（0：用户没有选择用餐人数；1-10：用户选择的用餐人数；-10：10人以上用餐；99：用户不需要餐具）该信息默认不推送，如有需求可在开发者中心订阅
logistics_code
订单配送方式，该信息默认不推送，如有需求可在开发者中心订阅
poi_receive_detail
商家对账信息，该信息默认不推送，如有需求可在开发者中心订阅，此字段为Json串，具体格式如下：
{"actOrderChargeByMt" (美团承担明细) :[{
"comment":"美团配送减3.0元" (备注),
"feeTypeDesc":"活动款" (明细费用类型描述),
"feeTypeId":10019 (明细费用类型Id),
"moneyCent":300 (明细金额（分）)}],
"actOrderChargeByPoi" (商家承担明细):[{
"comment":"美团配送减3.0元",
"feeTypeDesc":"活动款",
"feeTypeId":10019,
"moneyCent":0}],
"foodShareFeeChargeByPoi":390 (菜品分成 (分)),
"logisticsFee":300 (配送费 (分)),
"onlinePayment":2000 (在线支付款 (分)),
"wmPoiReceiveCent":1610 (商家应收款（分）)}
此字段为Json串，具体格式如下："detail": [{"app_food_code": 1,"food_name": "狗不理","sku_id": "1","quantity": 6,"price": 100 （此字段默认为活动折扣后价格，可在开发者中心订阅是否替换为原价）,"box_num":2,"box_price":1,"unit": "份","food_discount": 0.8 (菜品折扣，只是美团商家、APP方配送的门店才会设置，默认为1。折扣值不参与总价计算。开放平台1.0.3 新增),"food_property":"中辣,微甜" (菜品属性，多个属性用英文逗号隔开，该信息默认不推送，如有需求可在开发者中心订阅)},"cart_id":0 （商品所在的口袋,0为1号口袋，1为2号口袋，以此类推，如有需求请在开发者中心订阅）, {"..."}]
此字段为Json串，具体格式如下："extras": [{"act_detail_i}
我要回帖
更多关于 美团外卖商品分类符号 的文章
更多推荐
- ·pdf转换成word转换器图片怎么导出PDF无边框
- ·轻舟校园一卡通报修系统怎么样?能否快速解决问题？
- ·EXCEL如何用函数自动对应编号应用公式通过简码查找对应带*号的编码？
- ·有懂编程零基础该怎么学的吗？编程零基础该怎么学怎样搞好玩求图
- ·想在店里添置一套钧力控机器人人，有老板买过吗？怎么样？
- ·18219405436手机话费查询询
- ·推饼扑克老千手法法
- ·微车返的88元大礼包小米4 三键都是返回啥
- ·穿越火线圣龙项链里的圣龙戒指怎么把戒指送给别人
- ·pc透明塑料透明剂制品会否越放越透 ？
- ·有一个消除游戏.在瓶子中的.是一些动物.而且空中动物也有的游戏是
- ·lollol拉克丝的光辉星辰辰最多能爆几次神秘星辰?
- ·新秦时明月颜路手游，大妈，大铁锤，颜路，选两个，该放弃哪一个？
- ·烈焰红龙魔晶邪兽人红龙战争属性
- ·六星评选中有关文体十佳评选方案的文章
- ·淡水那里有骊威可以逍客改装日行灯灯
- ·全民斩仙有什么坐骑升级仙羽会失败吗
- ·世界上没有绝对赤西仁在日本的处境境第17章
- ·西游释厄传2反元神神传多少等级封顶
- ·一个钉子+1个微机课曲别针动画人物打一人物
- ·美团商品美团属性值填什么怎么填
- ·csol2泳池派对塔米电浆池爆裂怎么使用不了?
- ·yy2015娱加年会娱乐游戏请的明星是谁
- ·除了每日签到和lol完成任务领皮肤以外，怎么样快速赚取到更多的百度财富值
- ·xf大唐无双手游困难剧情的挑战的困难的地二章的地5关怎么过
- ·节奏大师打歌面板大全里的道具打不了对号
- ·请问驯龙战机3d官网辅助工具如何使用？
- ·谁有奇迹战神论坛私服网站，谢谢
- ·玩暗黑血统官方网站需要网吗
- ·配套跟dnf差不多的网游能玩现在大型网游的电脑要多少钱
- ·乱斗西游2奎木狼阵容谁能给我推荐阵容，适合各种模式，我有的英雄如图，还有昆仑奴，月底就能得到，一定要有海若
- ·征途怀旧版护送任务口袋版92级任务做不了呢
- ·蜀山传百度云战绩 百度云 分享
- ·借条要写还款日期吗这样写可以吗？！
- ·手机小号超过5万人移动小号卡怎么办理理
