如何知道我在美团买电影票购买的商品id号?
点击联系发帖人
时间：2014-10-01 10:20
在美团上购买东西是怎么一回事？是不是付了款之后就可以去实体店给商家看了？_百度知道淘宝网的商品id号在哪个位置？？_百度知道为什么在app store搜索不到美团外卖_百度知道请登陆后使用
只需一步，快速开始
吧友自助信息发布区，请自行甄别
查看: 704|回复: 4
1个ios设备，为啥美团能知道我登录了美团外卖帐号，猫眼电影帐 ..
不是说ios的app不会启动一个全家都启动吗，怎么美团连我手机安装了美团外卖，猫眼电影都知道，而且还知道帐号，可以直接登录不用密码什么的
共享一个授权信息而已，IOS的程序其实也开着，不是启动软件，只启动一个唤醒进程，连接到苹果服务器的
每个设备有独立的udid，美团和猫眼是一家，自然可以知道
你安装完app首次连网打开时，你的手机唯一识别id被送到美团服务器了，然后美团在苹果服务器上注册一个定向于你手机的消息推送服务。所以，当然知道你装没装，另外推送消息是独立于app的，并不和你手机上对应app有关联，所以有时你会发现，你app上的消息处理完了，推送却才刚刚到。
Powered by美团开放平台开发文档
美团外卖开放平台是基于美团外卖平台的业务流程，为第三方平台及众多的餐饮公司，提供更加便捷的信息传递方式，以及信息管理方式，致力于提升消费者的服务体验，并增加消费者用餐选择。
美团外卖是美团网旗下的网上订餐平台，于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_code=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上面推送订单信息；商家确认订单是指三方接单后告知美团
不使用美团配送，订单状态更新是否有下发通知？
如果接了推送接口，就会推送，如对接了订单取消，订单退款等接口就会推送信息。
退款接口是否必须接入？前期能否先通过平台客服进行自动退款？
可以根据情况接入，如果用客服来处理退款，使用商家后台也可以，但是需注意，24小时不处理的退款，会被默认同意退款。
实收金额，接口没有对应字段，实际情况是需要商家计算吗？开放平台有没有订单状态更新的接口？
财务相关的接口，开放平台目前不涉及，不过我们的商家客户端有财务模块，订单和账单表都有，如果有需要，去那里面下载更方便。 订单相相关的接口对接了的话，订单状态更新会推送的。
商家通过接口接到的订单，需不需要商家通过接口回传完成的状态？
订单完成的这个状态，商家是没法实现的，不用传。开放平台的订单状态和跟商家客户端一样的，没什么差别。
如何获取订单状态?
可以通过+ viewstatus接口查询。
回调端口改为8080后是否会立即生效？
推单会立即生效。但是url监控第二天才会开始。
开发平台向商家连续推单的时间间隔是多少？
美团每分钟调用商家的接口给商家传空过去的时候，商家应该怎么给美团返回？
这是美团对对商家url存活的检测，http的code 能返回200 就ok。
order/getOrderDetail接口中，"delivery_time": 用户预计送达时间，“立即送达”时为0 这个字段是以什么为单位？
秒。order/getOrderDetail 这个接口只推送status字段，没有order_status字段。status字段参考13.1；logistics_status参考13.+。
什么版本以下的app下单时不会上报经纬度？
因为客户的手机上装的美团外卖的app的版本太低；老版本是不会上传经纬度的 ；美团外卖APP（+）和美团APP（+）以下不会上传经纬度。
订单推送过来计算sig的时候detail和extras两个参数值是json数组， json数组里的key也是按字母顺序排列之后再计算sig么？
detail 和 extras 里面的json 数据不需要排序。
在线支付退款流程？
在线支付的单，用户在线申请退款，然后商家可以同意或者拒绝退款，需在24小时内除处理，否则会被系统默认同意退款。若是驳回顾客的退款请求后，顾客还有一次退款申诉（第二次申请退款）的机会，申诉后，商家可以选择同意退款，如果不同意，就等待12小时内美团客服会介入处理。
商家设置满减活动时，设置多个梯度：比如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/qualify/save
/api/v1/poi/qualify/save
如下表（key = value 形式）
注：美团的门店资质增加了审核流程，新上传的门店资质不会直接生效，只有通过美团员工审核的资质，才会生效。生效的同时，资质图片会打上美团外卖的水印
应用级参数
app_poi_code
APP方门店id
资质证照的类型（1：营业执照；2：餐饮服务许可证；3：健康证；4：法人身份证）
qualification_url
http://p1.meituan.net/crm/__82979.jpg
资质图片地址（门店资质只能上传一张，必须为jpg格式，图片大小不能超过10M，分辨率需要在以上，以下，推荐，否则审核会不通过）
valid_date
资质证照的有效期截止日，必须符合yyyy-MM-dd的格式
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店资质证书上传
http://test./api/v1/poi/qualify/save
/api/v1/poi/qualify/save
如下表（key = value 形式）
注：现对资质证书上传接口进行升级，老接口仍旧可以使用，新接入的门店请使用本接口，本次升级将门店资质证书上传分为两步，第一步为上传图片，第二步为上传资质，详细内容如下。
调用上传图片接口，详见，得到图片ID
美团的门店资质增加了审核流程，新上传的门店资质不会直接生效，只有通过美团员工审核的资质，才会生效。生效的同时，资质图片会打上美团外卖的水印
应用级参数
app_poi_code
APP方门店id
资质证照的类型（1：营业执照；2：餐饮服务许可证；3：健康证；4：法人身份证）
qualification_url
2B86BE5A5CA(由第一步获得的图片id)
资质图片ID，由第一步上传资质图片成功后返回的图片ID（图片大小不能超过10M，分辨率需要在以上，以下，推荐，否则审核会不通过）
valid_date
资质证照的有效期截止日，必须符合yyyy-MM-dd的格式，type为1，2，3时需要传此字段，type为4时不需要
经营地址，type为1，2时需要传此字段，type为3，4时不需要
证照编号，type为1，2，3，4时都需要传此字段
调用成功返回值：{"data" : "ok"}，其余情况请参考
同步门店预计送达时长
http://test./api/v1/poi/sendtime/save
/api/v1/poi/sendtime/save
如下表（key = value 形式）
注：APP方可以根据自身运力、天气、订单量等因素，通过调整预计送达时长来让用户有适合的心理预期，进而避免客诉。
应用级参数
app_poi_codes
APP方门店id，可以批量同步，以逗号分隔
预计送达时长（单位分钟，如50表示50分钟送达）
调用成功返回值：{"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" }
，其余情况请参考
创建／更新门店配送范围
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"&&&},{...}&&&]
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价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
添加时必须
餐盒价格 不能为负数
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": 12.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "12.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"
菜品信息以json格式请求，详细参数请参见参数定义
说明：批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品；如果原来有的菜品不在此次更新的数据中，就会删除原来的菜品。
批量创建／更新菜品
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格式请求，详细参数请参见接口中的参数定义
说明：批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品。
批量创建／更新菜品
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"},{...}],"unit": "份","picture":"","sequence":1},{....},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
调用成功返回值：{"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"&&&},{...}&&&]
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":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}
注意：美团有标准的药品分类库（美团标准药品分类参考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": 12.5,
"stock":10,
"category_code": "901600",
"category_name": "退烧止痛",
"is_sold_out": 1,
"sequence":10,
"090015":"孕妇食用，谨遵医生叮嘱",
"090025":"3个月",
注:美团目前采用主动推送订单到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
配送单状态，详情请参考12.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，详情请参考12.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/prepare
/api/v1/order/zhongbao/dispatch/prepare
如下表（key = value 形式）
应用级参数
old_shipping_fee
6.18接口查询到的配送费
tip_amount
调用成功返回值：{
"data": "ok"
}，失败返回： {
"data":"ng",
"code":"1",
"msg":"运费变更",
"wm_order_view_id:"45645",
"new_shipping_fee":"4.0",
"count_start":"",
"count_down":"30"}
返回值code含义：0 成功(自动确认发配送)
1 价格有变动
3 商家余额不足
返回值count_start：倒计时开始时间戳
返回值count_down：新运费保值时间段,在此时间段内保证运费不会再变更
众包配送确认下单，在预下单因为运费变更失败时调用
http://test./api/v1/order/zhongbao/dispatch/confirm
/api/v1/order/zhongbao/dispatch/confirm
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
众包配送单追加小费，用于已下发配送但没有配送员接单时，更新小费
http://test./api/v1/order/zhongbao/update/tip
/api/v1/order/zhongbao/update/tip
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
根据订单id查询订单评价信息
http://test./api/v1/order/comment/order
/api/v1/order/comment/order
如下表（key = value 形式）
应用级参数
调用成功返回值：{"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/order/comment/add_reply
/api/v1/order/comment/add_reply
如下表（key = value 形式）
应用级参数
comment_id
"感谢您的支持"
商家回复内容
调用成功返回值：{"data":"ok",
"code":0,"msg":"success" }，其余情况请参考
用户在美团外卖下单后，会回调APP方提供的callback_url，请按照以下请求和响应格式实现相应的api
推送已支付状态的订单给APP方
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
注意：①千万不要将判断签名信息是否正确的参数列表写死，以后接口还会升级，如果写死的话后期接口升级那么我们推送的签名信息就会较之前的发生改变，建议这里获取请求的所有参数来作为判断签名信息是否正确的准则 ②正式环境和测试环境接口端口请使用80或8080
应用级参数
注意：①post的Content-Type字段为text，所有参数均为普通post参数，不是json ②美团推送的参数未排序，请将参数排序后再计算sig
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
delivery_time
用户预计送达时间，“立即送达”时为0
is_third_shipping
是否是第三方配送平台配送（0：否；1：是）
支付类型（1：货到付款；2：在线支付）
实际送餐地址纬度
实际送餐地址经度
门店当天的推单流水号，该信息默认不推送，如有需求请联系美团
is_favorites
用户是否收藏此门店（true, false），该信息默认不推送，如有需求可在开发者中心订阅
is_poi_first_order
用户是否第一次在此门店点餐（true, false），该信息默认不推送，如有需求可在开发者中心订阅
dinners_number
用餐人数，该信息默认不推送，如有需求可在开发者中心订阅
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":"中辣,微甜" (菜品属性，多个属性用英文逗号隔开，该信息默认不推送，如有需求可在开发者中心订阅)}, {"..."}]
此字段为Json串，具体格式如下："extras": [{"act_detail_id":10,(活动id) "reduce_fee": 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)
"mt_charge":1.5, (优惠金额中美团承担的部分，可在开发者中心订阅，不订阅则不会推送)
"poi_charge":1.5, (优惠金额中商家承担的部分，可在开发者中心订阅，不订阅则不会推送) "remark": "满10元减2.5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟)},{"reduce_fee": 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "新用户立减5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟)}, {"rider_fee":10 (骑手应付款，只对美团配送线上支付线下结算的商家有效，可在开发者中心订阅，不订阅则不会推送) }
调用成功返回值：{"data" : "ok"}，其余情况请参考
推送已确认状态的订单给APP方
系统级参数和应用级参数同已支付订单推送规则，订阅字段对已支付订单、已确认订单、已完成订单三种状态同时生效
推送已完成状态的订单给APP方
系统级参数和应用级参数同已支付订单推送规则，订阅字段对已支付订单、已确认订单、已完成订单三种状态同时生效
美团外卖会在以下情况取消订单：
用户在订单没有被确认前，取消订单
客服取消订单，包括订单已确认的情况（一般是接到用户投诉，也跟APP方沟通后才会发起这个动作）
如用户提交订单在5分钟内没有被确认，美团系统取消订单
所以，需APP方提供一个取消订单的URL，便于美团系统进行回调。
需要注意的是，美团调用APP方取消订单的URL后，APP方避免再回调美团取消接口，以免发生循环调用。
注意：正式环境和测试环境接口端口请使用80或8080
请按照以下请求和响应格式实现相应的api
美团方取消订单URL
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
应用级参数
reason_code
规范化的订单取消code，详情请参考12.2节
调用成功返回值：{"data" : "ok"}，其余情况请参考
例如请求 curl “http://yourapp/cancelorder?app_id=1×tamp=&order_id=1233&reason_code=1001&reason=测试&sig=234ee3232” 返回{"data":"ok"}
同步结算公司信息，商户可以挂在结算公司下，系统会根据商户的结算公司信息完成结算和账单通知等
创建或更新结算公司信息
http://test./api/v1/company/save
/api/v1/company/save
如下表（key = value 形式）
应用级参数
北京结算公司
结算公司名称
finance_contact
财务联系人
finance_phone
财务联系人电话
结算时间类型，1:周期结算,2:固定日期结算
pay_day_of_month
每月的几号进行结算，仅当pay_type=2时此字段有效，最大可取值为范围1-31
pay_period_num
仅当pay_type=1此字段有用，结算周期单位数量
pay_period_unit
仅当pay_type=1此字段有用，结算周期单位（1=周、2=月、3=天）
branchname
北京大望路农业银行支行
收款支行名称
acc_cardno
收款银行账号，卡号或存折号
收款银行账户名
法人公司邮箱
app_org_id
三方法人公司唯一标志
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除法人公司
http://test./api/v1/company/delete
/api/v1/company/delete
如下表（key = value 形式）
应用级参数
app_org_id
三方法人公司唯一标志
调用成功返回值：{"data" : "ok"}，其余情况请参考
美团外卖针对在线支付订单，会在以下情况发起退款流程:
用户在线支付的订单没有被确认前，取消订单，直接退款
客服取消在线支付订单，包括在线支付订单已确认的情况（一般是接到用户投诉，也跟APP方沟通后才会发起这个动作）
美团外卖会在以下情况确认或者驳回退款申请：
在线支付订单确认后由用户和客服沟通取消订单，确认或者驳回退款申请
所以，需APP方提供一个接收在线支付订单退款的URL，便于美团系统进行回调。
确认前取消订单是直接退款的，只会调用APP方的取消接口，不会调用退款申请接口
调用申请退款接口后，通过 订单确认退款请求 和 订单驳回退款请求 接口确认或者驳回
需要注意的是，美团调用APP方在线支付订单退款的URL后，APP方避免再回调美团退款接口，以免发生循环调用4. 注意：正式环境和测试环境接口端口请使用80或8080
用户第一次发起退款申请，可以进行确认和驳回。若用户在驳回后再次发起退款申诉，则商家不能驳回只能确认。商家可以选择不确认，等待12小时后美团客服介入并最终处理
用户在申请退款过程中可以主动取消退款申请
请按照以下请求和响应格式实现相应的api
美团订单退款URL
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
应用级参数
notify_type
通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉
调用成功返回值：{"data" : "ok"}，其余情况请参考
请求示例： curl “http://yourapp/refund?app_id=1×tamp=&order_id=1233¬ify_type=apply&reason=woyaotuikuan&sig=234ee3232” 返回 {"data":"ok"}
图片上传，上传图片后，会得到一个图片ID，使用该图片ID代替图片URL（注意：1.请勿重复上传图片2.即使是同一个图片url，每次上传后得到的图片ID是不同的，请注意记录图片ID）
http://test./api/v1/image/upload
/api/v1/image/upload
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店ID
[1],[21],[11]
图片字节流，不参与签名
注意：img_data的字节流不参与签名
返回值： {"data":" 2B86BE5A5CA"}
用户已提交订单
可推送到APP方平台也可推送到商家
商家已收到
商家已确认
美团外卖APP方订单状态流转图：
美团发送的取消原因列表
系统取消，超时未确认
系统取消，在线支付订单30分钟未支付
用户取消，在线支付中取消
用户取消，商家确认前取消
用户取消，用户退款取消
客服取消，用户下错单
客服取消，用户测试
客服取消，重复订单
客服取消，其他原因
APP方发出、美团接收的取消原因列表
APP方商家超时接单
APP方非顾客原因修改订单
APP方非顾客原因取消订单
APP方配送延迟
APP方售后投诉
APP方用户要求取消
APP方其他原因取消（未传code，默认为此原因）
美团订单ID
recipient_address
收件人地址
recipient_phone
收件人电话
recipient_name
收件人姓名
shipping_fee
门店配送费
忌口或者备注
shipper_phone
送餐员电话
has_invoiced
订单是否要发票
invoice_title
订单详细类目列表
订单活动类目列表
美团商家ID
wm_poi_name
美团商家名称
wm_poi_address
美团商家地址
wm_poi_phone
美团商家电话
is_third_shipping
是否是第三方配送平台配送
支付类型。1：货到付款，2：在线支付
app_food_code
APP方菜品id
APP方菜品名称
打包餐盒数量
打包餐盒单价
food_discount
菜品折扣，只是美团商家，APP方配送的门店才会设置，默认为1。折扣值不参与总价计算
reduce_fee
优惠活动说明
优惠活动类型（1-新用户立减；2-满减；3-抵价券；4-套餐赠送；5-满赠；6-超时赔付；10-代金券；11-提前下单立减活动；16-满免配送费）
app_poi_code
APP方门店id
呼叫中心电话
standby_tel
备用电话号码
shipping_fee
shipping_time
promotion_info
门店公告栏
invoice_support
是否支持发票
invoice_min_price
支持开发票的最小订单价
invoice_description
发票相关说明
is_bookable
门店的状态 1-可配送，3-休息中
有效性 0-管理员删除，1-系统可用，2-待管理员审核，3-对接系统删除的数据
创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
app_poi_code
APP方门店id,不同门店可以重复，同一门店内不能重复
app_food_code
APP方菜品ID（最大长度128个字符）
description
min_order_count
最小购买量，最小为1
打包餐盒数量
category_name
is_sold_out
0:未卖光 1:卖光
菜品图片，只支持jpg格式
在当前分类下的序号
创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
app_poi_code
APP方门店id
菜品分类名
菜品分类排序
菜品分类创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
菜品分类更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
缺少参数，数据不完整
app_id不存在
签名验证错误
没有权限操作这条数据
参数格式错误
缺少品类信息
已经存在此门店，不能重复创建
不能修改门店经纬度
不存在此门店
已经存在此菜品，不能重复创建
不存在此菜品
不存在此订单
同一个城市内的门店名字重复
操作失败（如订单在操作时，状态已变更等情况）
门店营业状态受到美团控制，无法恢复营业
门店上线状态受到美团控制，无法上线
门店无资质信息，无法上线
营业时间范围内预下单开启后不可关闭
logistics_status
配送单发往配送
配送单已确认
骑手已取餐
骑手已送达
配送单已取消
logistics_code
美团专送-加盟
美团专送-自建
美团配送-众包
美团专送-城市代理
糖尿病并用药
高血压血脂
生产厂商code和品牌code是三方如果在使用了美团标准库的情况下，需要传入药品使用的标准库生产厂商code和品牌code（必须和相应的名称对应上），美团暂时还没有药品的生产厂商和品牌的标准库，这两个code暂时可以不传，只传入生产厂商和品牌名称即可。
药品通用名称
生产厂商名称
生产厂商code（预留生产厂商字典code）
品牌code（预留品牌字典code）
电子监管码
药物相互作用
妊娠与哺乳用药
老年人用药
为了方便APP方接入测试，加快接入速度，现开发了测试平台供APP方使用，如有更多好的、可以加速接入、测试速度的建议和需求，我们会不断的补充和完善。
测试平台地址：
测试工具地址：
注意：该平台只可在线下使用}
只需一步，快速开始
吧友自助信息发布区，请自行甄别
查看: 704|回复: 4
1个ios设备，为啥美团能知道我登录了美团外卖帐号，猫眼电影帐 ..
不是说ios的app不会启动一个全家都启动吗，怎么美团连我手机安装了美团外卖，猫眼电影都知道，而且还知道帐号，可以直接登录不用密码什么的
共享一个授权信息而已，IOS的程序其实也开着，不是启动软件，只启动一个唤醒进程，连接到苹果服务器的
每个设备有独立的udid，美团和猫眼是一家，自然可以知道
你安装完app首次连网打开时，你的手机唯一识别id被送到美团服务器了，然后美团在苹果服务器上注册一个定向于你手机的消息推送服务。所以，当然知道你装没装，另外推送消息是独立于app的，并不和你手机上对应app有关联，所以有时你会发现，你app上的消息处理完了，推送却才刚刚到。
Powered by美团开放平台开发文档
美团外卖开放平台是基于美团外卖平台的业务流程，为第三方平台及众多的餐饮公司，提供更加便捷的信息传递方式，以及信息管理方式，致力于提升消费者的服务体验，并增加消费者用餐选择。
美团外卖是美团网旗下的网上订餐平台，于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_code=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上面推送订单信息；商家确认订单是指三方接单后告知美团
不使用美团配送，订单状态更新是否有下发通知？
如果接了推送接口，就会推送，如对接了订单取消，订单退款等接口就会推送信息。
退款接口是否必须接入？前期能否先通过平台客服进行自动退款？
可以根据情况接入，如果用客服来处理退款，使用商家后台也可以，但是需注意，24小时不处理的退款，会被默认同意退款。
实收金额，接口没有对应字段，实际情况是需要商家计算吗？开放平台有没有订单状态更新的接口？
财务相关的接口，开放平台目前不涉及，不过我们的商家客户端有财务模块，订单和账单表都有，如果有需要，去那里面下载更方便。 订单相相关的接口对接了的话，订单状态更新会推送的。
商家通过接口接到的订单，需不需要商家通过接口回传完成的状态？
订单完成的这个状态，商家是没法实现的，不用传。开放平台的订单状态和跟商家客户端一样的，没什么差别。
如何获取订单状态?
可以通过+ viewstatus接口查询。
回调端口改为8080后是否会立即生效？
推单会立即生效。但是url监控第二天才会开始。
开发平台向商家连续推单的时间间隔是多少？
美团每分钟调用商家的接口给商家传空过去的时候，商家应该怎么给美团返回？
这是美团对对商家url存活的检测，http的code 能返回200 就ok。
order/getOrderDetail接口中，"delivery_time": 用户预计送达时间，“立即送达”时为0 这个字段是以什么为单位？
秒。order/getOrderDetail 这个接口只推送status字段，没有order_status字段。status字段参考13.1；logistics_status参考13.+。
什么版本以下的app下单时不会上报经纬度？
因为客户的手机上装的美团外卖的app的版本太低；老版本是不会上传经纬度的 ；美团外卖APP（+）和美团APP（+）以下不会上传经纬度。
订单推送过来计算sig的时候detail和extras两个参数值是json数组， json数组里的key也是按字母顺序排列之后再计算sig么？
detail 和 extras 里面的json 数据不需要排序。
在线支付退款流程？
在线支付的单，用户在线申请退款，然后商家可以同意或者拒绝退款，需在24小时内除处理，否则会被系统默认同意退款。若是驳回顾客的退款请求后，顾客还有一次退款申诉（第二次申请退款）的机会，申诉后，商家可以选择同意退款，如果不同意，就等待12小时内美团客服会介入处理。
商家设置满减活动时，设置多个梯度：比如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/qualify/save
/api/v1/poi/qualify/save
如下表（key = value 形式）
注：美团的门店资质增加了审核流程，新上传的门店资质不会直接生效，只有通过美团员工审核的资质，才会生效。生效的同时，资质图片会打上美团外卖的水印
应用级参数
app_poi_code
APP方门店id
资质证照的类型（1：营业执照；2：餐饮服务许可证；3：健康证；4：法人身份证）
qualification_url
http://p1.meituan.net/crm/__82979.jpg
资质图片地址（门店资质只能上传一张，必须为jpg格式，图片大小不能超过10M，分辨率需要在以上，以下，推荐，否则审核会不通过）
valid_date
资质证照的有效期截止日，必须符合yyyy-MM-dd的格式
调用成功返回值：{"data" : "ok"}，其余情况请参考
门店资质证书上传
http://test./api/v1/poi/qualify/save
/api/v1/poi/qualify/save
如下表（key = value 形式）
注：现对资质证书上传接口进行升级，老接口仍旧可以使用，新接入的门店请使用本接口，本次升级将门店资质证书上传分为两步，第一步为上传图片，第二步为上传资质，详细内容如下。
调用上传图片接口，详见，得到图片ID
美团的门店资质增加了审核流程，新上传的门店资质不会直接生效，只有通过美团员工审核的资质，才会生效。生效的同时，资质图片会打上美团外卖的水印
应用级参数
app_poi_code
APP方门店id
资质证照的类型（1：营业执照；2：餐饮服务许可证；3：健康证；4：法人身份证）
qualification_url
2B86BE5A5CA(由第一步获得的图片id)
资质图片ID，由第一步上传资质图片成功后返回的图片ID（图片大小不能超过10M，分辨率需要在以上，以下，推荐，否则审核会不通过）
valid_date
资质证照的有效期截止日，必须符合yyyy-MM-dd的格式，type为1，2，3时需要传此字段，type为4时不需要
经营地址，type为1，2时需要传此字段，type为3，4时不需要
证照编号，type为1，2，3，4时都需要传此字段
调用成功返回值：{"data" : "ok"}，其余情况请参考
同步门店预计送达时长
http://test./api/v1/poi/sendtime/save
/api/v1/poi/sendtime/save
如下表（key = value 形式）
注：APP方可以根据自身运力、天气、订单量等因素，通过调整预计送达时长来让用户有适合的心理预期，进而避免客诉。
应用级参数
app_poi_codes
APP方门店id，可以批量同步，以逗号分隔
预计送达时长（单位分钟，如50表示50分钟送达）
调用成功返回值：{"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" }
，其余情况请参考
创建／更新门店配送范围
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"&&&},{...}&&&]
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价格，本参数可不传
min_order_count
添加时必须
最小购买量
添加时必须
添加时必须
打包盒数量
添加时必须
餐盒价格 不能为负数
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": 12.5
"min_order_count": 1,
"box_price": 1.5,
"box_num": 1,
"unit": "碗",
"category_name": "面食",
"is_sold_out": 1,
{"sku_id": "1",
"spec": "大",
"upc": "12",
"stock": "2",
"price": "12.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"
菜品信息以json格式请求，详细参数请参见参数定义
说明：批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品；如果原来有的菜品不在此次更新的数据中，就会删除原来的菜品。
批量创建／更新菜品
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格式请求，详细参数请参见接口中的参数定义
说明：批量更新的菜品会和原有菜品进行比对：如果某个菜品原来没有，就会新增此菜品；如果原来有，就会更新此菜品。
批量创建／更新菜品
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"},{...}],"unit": "份","picture":"","sequence":1},{....},{…}]
菜品集合的json数据，处理逻辑：1）如果菜品原来不存在就新增；2）如app_food_code存在就更新；3）picture 可以是调用上传图片接口后返回的图片ID, 也可以是url地址,推荐使用图片 ID的形式。
调用成功返回值：{"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"&&&},{...}&&&]
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":"["辣", "微辣", "不辣]"},
&&&&&&&&{...}
注意：美团有标准的药品分类库（美团标准药品分类参考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": 12.5,
"stock":10,
"category_code": "901600",
"category_name": "退烧止痛",
"is_sold_out": 1,
"sequence":10,
"090015":"孕妇食用，谨遵医生叮嘱",
"090025":"3个月",
注:美团目前采用主动推送订单到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
配送单状态，详情请参考12.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，详情请参考12.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/prepare
/api/v1/order/zhongbao/dispatch/prepare
如下表（key = value 形式）
应用级参数
old_shipping_fee
6.18接口查询到的配送费
tip_amount
调用成功返回值：{
"data": "ok"
}，失败返回： {
"data":"ng",
"code":"1",
"msg":"运费变更",
"wm_order_view_id:"45645",
"new_shipping_fee":"4.0",
"count_start":"",
"count_down":"30"}
返回值code含义：0 成功(自动确认发配送)
1 价格有变动
3 商家余额不足
返回值count_start：倒计时开始时间戳
返回值count_down：新运费保值时间段,在此时间段内保证运费不会再变更
众包配送确认下单，在预下单因为运费变更失败时调用
http://test./api/v1/order/zhongbao/dispatch/confirm
/api/v1/order/zhongbao/dispatch/confirm
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
众包配送单追加小费，用于已下发配送但没有配送员接单时，更新小费
http://test./api/v1/order/zhongbao/update/tip
/api/v1/order/zhongbao/update/tip
如下表（key = value 形式）
应用级参数
tip_amount
调用成功返回值：{
"data":"ok"
}，其余情况请参考
根据订单id查询订单评价信息
http://test./api/v1/order/comment/order
/api/v1/order/comment/order
如下表（key = value 形式）
应用级参数
调用成功返回值：{"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/order/comment/add_reply
/api/v1/order/comment/add_reply
如下表（key = value 形式）
应用级参数
comment_id
"感谢您的支持"
商家回复内容
调用成功返回值：{"data":"ok",
"code":0,"msg":"success" }，其余情况请参考
用户在美团外卖下单后，会回调APP方提供的callback_url，请按照以下请求和响应格式实现相应的api
推送已支付状态的订单给APP方
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
注意：①千万不要将判断签名信息是否正确的参数列表写死，以后接口还会升级，如果写死的话后期接口升级那么我们推送的签名信息就会较之前的发生改变，建议这里获取请求的所有参数来作为判断签名信息是否正确的准则 ②正式环境和测试环境接口端口请使用80或8080
应用级参数
注意：①post的Content-Type字段为text，所有参数均为普通post参数，不是json ②美团推送的参数未排序，请将参数排序后再计算sig
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
delivery_time
用户预计送达时间，“立即送达”时为0
is_third_shipping
是否是第三方配送平台配送（0：否；1：是）
支付类型（1：货到付款；2：在线支付）
实际送餐地址纬度
实际送餐地址经度
门店当天的推单流水号，该信息默认不推送，如有需求请联系美团
is_favorites
用户是否收藏此门店（true, false），该信息默认不推送，如有需求可在开发者中心订阅
is_poi_first_order
用户是否第一次在此门店点餐（true, false），该信息默认不推送，如有需求可在开发者中心订阅
dinners_number
用餐人数，该信息默认不推送，如有需求可在开发者中心订阅
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":"中辣,微甜" (菜品属性，多个属性用英文逗号隔开，该信息默认不推送，如有需求可在开发者中心订阅)}, {"..."}]
此字段为Json串，具体格式如下："extras": [{"act_detail_id":10,(活动id) "reduce_fee": 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)
"mt_charge":1.5, (优惠金额中美团承担的部分，可在开发者中心订阅，不订阅则不会推送)
"poi_charge":1.5, (优惠金额中商家承担的部分，可在开发者中心订阅，不订阅则不会推送) "remark": "满10元减2.5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟)},{"reduce_fee": 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)"remark": "新用户立减5元",（优惠说明）“type":1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟)}, {"rider_fee":10 (骑手应付款，只对美团配送线上支付线下结算的商家有效，可在开发者中心订阅，不订阅则不会推送) }
调用成功返回值：{"data" : "ok"}，其余情况请参考
推送已确认状态的订单给APP方
系统级参数和应用级参数同已支付订单推送规则，订阅字段对已支付订单、已确认订单、已完成订单三种状态同时生效
推送已完成状态的订单给APP方
系统级参数和应用级参数同已支付订单推送规则，订阅字段对已支付订单、已确认订单、已完成订单三种状态同时生效
美团外卖会在以下情况取消订单：
用户在订单没有被确认前，取消订单
客服取消订单，包括订单已确认的情况（一般是接到用户投诉，也跟APP方沟通后才会发起这个动作）
如用户提交订单在5分钟内没有被确认，美团系统取消订单
所以，需APP方提供一个取消订单的URL，便于美团系统进行回调。
需要注意的是，美团调用APP方取消订单的URL后，APP方避免再回调美团取消接口，以免发生循环调用。
注意：正式环境和测试环境接口端口请使用80或8080
请按照以下请求和响应格式实现相应的api
美团方取消订单URL
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
应用级参数
reason_code
规范化的订单取消code，详情请参考12.2节
调用成功返回值：{"data" : "ok"}，其余情况请参考
例如请求 curl “http://yourapp/cancelorder?app_id=1×tamp=&order_id=1233&reason_code=1001&reason=测试&sig=234ee3232” 返回{"data":"ok"}
同步结算公司信息，商户可以挂在结算公司下，系统会根据商户的结算公司信息完成结算和账单通知等
创建或更新结算公司信息
http://test./api/v1/company/save
/api/v1/company/save
如下表（key = value 形式）
应用级参数
北京结算公司
结算公司名称
finance_contact
财务联系人
finance_phone
财务联系人电话
结算时间类型，1:周期结算,2:固定日期结算
pay_day_of_month
每月的几号进行结算，仅当pay_type=2时此字段有效，最大可取值为范围1-31
pay_period_num
仅当pay_type=1此字段有用，结算周期单位数量
pay_period_unit
仅当pay_type=1此字段有用，结算周期单位（1=周、2=月、3=天）
branchname
北京大望路农业银行支行
收款支行名称
acc_cardno
收款银行账号，卡号或存折号
收款银行账户名
法人公司邮箱
app_org_id
三方法人公司唯一标志
调用成功返回值：{"data" : "ok"}，其余情况请参考
删除法人公司
http://test./api/v1/company/delete
/api/v1/company/delete
如下表（key = value 形式）
应用级参数
app_org_id
三方法人公司唯一标志
调用成功返回值：{"data" : "ok"}，其余情况请参考
美团外卖针对在线支付订单，会在以下情况发起退款流程:
用户在线支付的订单没有被确认前，取消订单，直接退款
客服取消在线支付订单，包括在线支付订单已确认的情况（一般是接到用户投诉，也跟APP方沟通后才会发起这个动作）
美团外卖会在以下情况确认或者驳回退款申请：
在线支付订单确认后由用户和客服沟通取消订单，确认或者驳回退款申请
所以，需APP方提供一个接收在线支付订单退款的URL，便于美团系统进行回调。
确认前取消订单是直接退款的，只会调用APP方的取消接口，不会调用退款申请接口
调用申请退款接口后，通过 订单确认退款请求 和 订单驳回退款请求 接口确认或者驳回
需要注意的是，美团调用APP方在线支付订单退款的URL后，APP方避免再回调美团退款接口，以免发生循环调用4. 注意：正式环境和测试环境接口端口请使用80或8080
用户第一次发起退款申请，可以进行确认和驳回。若用户在驳回后再次发起退款申诉，则商家不能驳回只能确认。商家可以选择不确认，等待12小时后美团客服介入并最终处理
用户在申请退款过程中可以主动取消退款申请
请按照以下请求和响应格式实现相应的api
美团订单退款URL
系统级参数
构造签名方法跟APP方门店访问美团openapi方式相同，请参照第0章
需要验证签名才可以访问APP方门店的api。
应用级参数
notify_type
通知类型，apply：发起退款agree：确认退款reject：驳回退款cancelRefund：用户取消退款申请cancelRefundComplaint :取消退款申诉
调用成功返回值：{"data" : "ok"}，其余情况请参考
请求示例： curl “http://yourapp/refund?app_id=1×tamp=&order_id=1233¬ify_type=apply&reason=woyaotuikuan&sig=234ee3232” 返回 {"data":"ok"}
图片上传，上传图片后，会得到一个图片ID，使用该图片ID代替图片URL（注意：1.请勿重复上传图片2.即使是同一个图片url，每次上传后得到的图片ID是不同的，请注意记录图片ID）
http://test./api/v1/image/upload
/api/v1/image/upload
如下表（key = value 形式）
应用级参数
app_poi_code
APP方门店ID
[1],[21],[11]
图片字节流，不参与签名
注意：img_data的字节流不参与签名
返回值： {"data":" 2B86BE5A5CA"}
用户已提交订单
可推送到APP方平台也可推送到商家
商家已收到
商家已确认
美团外卖APP方订单状态流转图：
美团发送的取消原因列表
系统取消，超时未确认
系统取消，在线支付订单30分钟未支付
用户取消，在线支付中取消
用户取消，商家确认前取消
用户取消，用户退款取消
客服取消，用户下错单
客服取消，用户测试
客服取消，重复订单
客服取消，其他原因
APP方发出、美团接收的取消原因列表
APP方商家超时接单
APP方非顾客原因修改订单
APP方非顾客原因取消订单
APP方配送延迟
APP方售后投诉
APP方用户要求取消
APP方其他原因取消（未传code，默认为此原因）
美团订单ID
recipient_address
收件人地址
recipient_phone
收件人电话
recipient_name
收件人姓名
shipping_fee
门店配送费
忌口或者备注
shipper_phone
送餐员电话
has_invoiced
订单是否要发票
invoice_title
订单详细类目列表
订单活动类目列表
美团商家ID
wm_poi_name
美团商家名称
wm_poi_address
美团商家地址
wm_poi_phone
美团商家电话
is_third_shipping
是否是第三方配送平台配送
支付类型。1：货到付款，2：在线支付
app_food_code
APP方菜品id
APP方菜品名称
打包餐盒数量
打包餐盒单价
food_discount
菜品折扣，只是美团商家，APP方配送的门店才会设置，默认为1。折扣值不参与总价计算
reduce_fee
优惠活动说明
优惠活动类型（1-新用户立减；2-满减；3-抵价券；4-套餐赠送；5-满赠；6-超时赔付；10-代金券；11-提前下单立减活动；16-满免配送费）
app_poi_code
APP方门店id
呼叫中心电话
standby_tel
备用电话号码
shipping_fee
shipping_time
promotion_info
门店公告栏
invoice_support
是否支持发票
invoice_min_price
支持开发票的最小订单价
invoice_description
发票相关说明
is_bookable
门店的状态 1-可配送，3-休息中
有效性 0-管理员删除，1-系统可用，2-待管理员审核，3-对接系统删除的数据
创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
app_poi_code
APP方门店id,不同门店可以重复，同一门店内不能重复
app_food_code
APP方菜品ID（最大长度128个字符）
description
min_order_count
最小购买量，最小为1
打包餐盒数量
category_name
is_sold_out
0:未卖光 1:卖光
菜品图片，只支持jpg格式
在当前分类下的序号
创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
app_poi_code
APP方门店id
菜品分类名
菜品分类排序
菜品分类创建时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
菜品分类更新时间（当前距离Epoch（日） 以秒计算的时间，即unix-timestamp）
缺少参数，数据不完整
app_id不存在
签名验证错误
没有权限操作这条数据
参数格式错误
缺少品类信息
已经存在此门店，不能重复创建
不能修改门店经纬度
不存在此门店
已经存在此菜品，不能重复创建
不存在此菜品
不存在此订单
同一个城市内的门店名字重复
操作失败（如订单在操作时，状态已变更等情况）
门店营业状态受到美团控制，无法恢复营业
门店上线状态受到美团控制，无法上线
门店无资质信息，无法上线
营业时间范围内预下单开启后不可关闭
logistics_status
配送单发往配送
配送单已确认
骑手已取餐
骑手已送达
配送单已取消
logistics_code
美团专送-加盟
美团专送-自建
美团配送-众包
美团专送-城市代理
糖尿病并用药
高血压血脂
生产厂商code和品牌code是三方如果在使用了美团标准库的情况下，需要传入药品使用的标准库生产厂商code和品牌code（必须和相应的名称对应上），美团暂时还没有药品的生产厂商和品牌的标准库，这两个code暂时可以不传，只传入生产厂商和品牌名称即可。
药品通用名称
生产厂商名称
生产厂商code（预留生产厂商字典code）
品牌code（预留品牌字典code）
电子监管码
药物相互作用
妊娠与哺乳用药
老年人用药
为了方便APP方接入测试，加快接入速度，现开发了测试平台供APP方使用，如有更多好的、可以加速接入、测试速度的建议和需求，我们会不断的补充和完善。
测试平台地址：
测试工具地址：
注意：该平台只可在线下使用}
我要回帖
更多推荐
- ·苹果15pro怎么设置苹果左侧静音键设置关闭？
- ·人死了以后人走了有灵魂吗会去哪里？
- ·来个人说下大学毕业了，不知道从事什么行业呢，请问新能源行业如何创业移动充电机器人合作有了解的吗？
- ·您好，请问有机物的挥发性有机物是指哪些和其分子质量有关吗，是不是超过多少分子量其便不具有挥发性有机物是指哪些？
- ·excel如何设计函数判断是否四次考勤打卡时间怎么计算出勤工时迟到，早退，未打卡？
- ·c f官网修罗要修罗在哪里买买
- ·稳定170长期稳定的复古传奇奇有吗?来一个吧。谢谢了。
- ·梦幻西游，梦幻西游2哪个区好玩好玩
- ·我PSP不能ipad不在充电怎么回事是怎么会事
- ·里程芯片在魁拔3之战神崛起称霸塞有用么
- ·dnf黑暗武士技能中断技能加伤
- ·暗黑破坏神3暗黑2暗金装备升级带星
- ·刀锋之影：泰隆 怎么玩微信？
- ·武商摩尔城城稻草人在几楼?
- ·我用逗游游戏宝库下的圣安地列斯的汽车音乐打包下载的文件夹在哪？
- ·进击的巨人同人小说人
- ·海王星娯乐城超市 现在是不是都在玩啊
- ·如何知道我在美团买电影票购买的商品id号?
- ·在普及二公主蓝宝石公主号怎么样店蓝宝石公主号怎么样会是假的么
- ·影之刃 银龙裁决船坞怎么打
- ·虎扑论坛交易区交易区如何筛选
- ·求中型中型rpg单机游戏戏
- ·玩新天龙八部3d绑定元宝，我玩的是天山，现在85级，现在装备都没弄。很垃圾。我打算充4000元宝，请问我该怎么
- ·谁有NDS心跳回忆女生版2（中文汉化）版第二季的游戏文件或者安装包？？
- ·dnf你dnf剑魂pk教学技能栏怎么放的 技能那么多 装不了啊 怎么放技能 哪些技能不要 注意 地
- ·实况足球2010修改器怎么进入黑屏
- ·额亏PvP他去 老梁故事汇就啊去咯他7天
- ·JK饲育白书cg图片的CG
- ·蜀山战纪技能攻略带波斯舞姫怎么打技能
- ·CS文件快递货物损坏怎么办，怎么办
- ·反恐精英电浆轨道炮测评光线无限穿吗？
- ·CF求个狙击大手牵小手师父山一的
- ·汪峰战队四强名单谁是冠军
