商品已经绑定情况下，重推异常订单仍提示"商品未绑定"

原因1：

订单明细中的商品和OMS门店商品中的商品【商品名称】或【规格名称】不一致。

重推时商品根据【商品名称】和【规格名称】匹配（美团外卖的单规格商品仅根据【商品名称】匹配）

原因1解决方案：

两种方法取其一：

① 三方平台修改此商品【商品名称】、【规格名称】和订单一致，重新读取后重推

② OMS商品库修改此商品【商品名称】、【规格名称】和订单一致，重新同步后重推

原因2：

存在两个同名的商品，其中一个绑定，一个未绑定，订单中的是未绑定的商品

原因2解决方案：

重新读取，将未绑定的商品重新绑定后重推

原因3：

商品原来是同步过去的，规格值是“单规格”，单规格商品在美团平台修改过规格（如：份量和价格），规格值就会变成“XXX克”，导致重推失败

原因3解决方案：

现已更改规则为：若OMS商品库的商品是单规格的，订单重推进行匹配时只进行商品名称的匹配（仅美团），其余平台单规格和多规格仍需按商品名称和规格名称匹配

原因4：

商品库商品未填写【商品编码】或【商品编码】与ama商品的系统编码匹配不上

原因4解决方案：

商品库商品填写或修改【商品编码】，同步商品或解绑重新绑定后再重推

原因5：

平台门店商品绑定的商品库商品已被删除，但是绑定关系仍存在

原因5解决方案：

商品匹配处将商品解绑，重新绑定商品库商品后再重推

原因6：

客户修改了门店名称，实际门店商品未绑定

原因6解决方案：

重新绑定一下即可

异常订单失败原因为“商品未绑定”，但是商品都是绑定了的，直接重推也可以成功

原因1：

订单第一次推送AMA是根据订单明细中的商品的和OMS门店商品的【第三方SKU编码】、商品名称、规格名称进行匹配（饿百多规格商品仅根据【第三方SKU编码】【规格名称】匹配）；

若在三方平台增加、删除商品规格或修改【店内码/货号】（美团闪购）并保存，第三方平台商品【第三方SKU编码】就会发生改变，导致和OMS匹配不上，变成异常订单；

重推时商品根据【商品名称】和【规格名称】匹配（美团外卖的单规格商品仅根据【商品名称】匹配）

原因1解决方案：

异常订单重推即可。

未防止再次成为异常订单，把提示未绑定的商品抓取后再重新绑定

原因2：

商品绑定时间在下单时间之后

原因2解决方案：

异常订单重推即可

异常订单失败原因：找不到商品资料:商品编号[XXXXX]没有匹配商品或商品已删除

商品编号[XXXXX]对应线下的系统编码，系统编码为XXXXX的线下商品已被删除

需要在商品库重新绑定一个线下商品，然后在商品匹配重新解绑绑定一下，再重推即可

OMS库存未同步至第三方平台

若提示“通过sku无法找到美团门店商品”，则有可能为原因3

OMS2.0库存同步规则：

• 每分钟定时查询OMS库存（库存查询处的库存）是否发生改变，若发生了改变，则触发库存同步至三方平台。

• 开启三方平台库存同步开关、开启商品规格库存同步开关、商品同步、绑定操作后触发库存同步。

• 修改商品绑定关系或者规格换算率后，需要重新同步或解绑该商品并重新绑定才可触发库存同步。

原因1：

【库存查询】-【库存设置】，相应平台的开关未打开

原因1解决方案：

【库存查询】-【库存设置】，打开相应平台的开关，再重新变更一下AMA库存

原因2：

三方平台商品未绑定商品库商品

原因2解决方案：

三方平台商品绑定商品库商品再变更一下线下库存

原因3：

平台接口可调用次数不足

原因3解决方案：

购买平台接口可调用次数

原因4：

线下库存变更之后才绑定的商品，不会再次同步至第三方

原因4解决方案：

AMA重新变更一下库存

原因5：

商品开启库存同步后，未在AMA变更过库存

原因5解决方案：

AMA重新变更一下库存

• 按照 券、经理折扣分摊规则说明 文档中公式

• 单品分摊金额 = 单品实际销售金额 / 单据中所有商品销售金额合计 * 分摊金额

• 最后一个商品分摊金额 = 分摊总金额 - 前面所有分摊金额

进行计算，得不出账单中的分摊金额，客户需要第三方平台订单的分摊金额计算公式

订单中部分商品在三方平台有优惠活动，AMA的账单合计和经理折扣需要减去这部分优惠后再用公式计算

领鲜红豆味面包 60g/个，该商品原价3.5，商品折扣2.58，实际金额0.92

所以计算时，商品实际销售额、账单合计和经理折扣都需要减去2.58

因此该商品分摊金额为 [(3.5-2.58)/(29.3-2.58)]×(12.22-2.58)+2.58=2.91

领鲜松松蛋糕肉松味，该商品原价4.8，无商品折扣，实际金额4.8

所以计算时，仅账单合计和经理折扣需要减去2.58

因此该商品分摊金额为 [4.8/(29.3-2.58)]×(12.22-2.58)=1.73

其余商品类似

无需解决

商品同步失败原因为

该商品的规格编码在三方平台商家后台已存在

修改该商品规格编码

商品绑定提示“”该商品库商品已绑定门店商品[xxxx]，请检查商品code是否一致

一个商品库商品只能绑定一个门店商品

换一个商品库商品绑定

设置了自动重推没有重推，但是手动重推又可以

触发自动重推的时候商品是未绑定状态，手动重推的时候商品才绑定上，即商品绑定时间在自动重推设置的时间和手动重推之间

无需解决

商品同步提示请求参数错误

某商品的价格值太大了，超出了OMS价格范围

修改该商品价格

订单在美团、新零售显示已经同意退款，在线下erp订单中没有显示此退款订单的记录；美团商家在客户没有申请退款的情况下，直接退款给客户，然后发现乐檬零售里的线上销售额还是有这个数据。

订单属于退差单，退差单没有数量的，产品原先设计没有数量的退单不会推送AMA

无需解决

外卖订单商品销售数量和外卖平台导出数据不一致

外卖平台是以下单时间统计，AMA是以确认收货时间统计

无需解决

平台今日无订单，AMA已结账单中多了一笔订单

订单是今天之前下单的，但推送时成为了异常订单，今天重推成功了才会推送至AMA已结账单

无需解决

平台新建活动商品-读取同步到乐檬-进行绑定能正常接单，但是在取货结算的时候pos前台商品报红。前台没办法取货结算全都显示在异常订单内。

商品库商品未绑定erp（AMA商品）

外卖平台的订单不支持取货结算，顾客在app端确认收货才算订单完成

将商品库商品绑定erp（AMA商品），并重新绑定商品库商品

第三方平台软件内先创建好商品，读取到我方软件内会归类到未同步商品内，再通过我方软件同步后，美团内商品的分类、图片都会被清空。

分类和图片是会同步商品库的分类和图片

分类要不变的话需要修改商品库的分类和第三方平台一致

图片要不想更新的话需要勾选不同步图片选项

订单线下核销的商品跟商品库绑定的不一致

原因1：（现已修改逻辑为：订单推AMA直接取商品库最新信息，该原因不会再发生）

只在商品库修改了erp绑定关系或基本数量，未重新绑定或同步

原因1解决方案：

重新绑定或同步商品以更新数据

原因2：

订单推AMA时，商品未绑定会读取默认商品的信息来推送

原因2解决方案：

绑定一下商品

同步商品提示gw.QosAPIFrequencyLimit

一次同步过多商品，限流了

重新同步即可

oms同步错误：参数格式错误:。sku_id:参数格式错误|sku_id字段为空

平台门店商品的数据中存在第三方SKU编码为空的数据，这些是原来老OMS系统生成的数据。

需要将这些商品在商品匹配页面重新绑定下

AMA已结账单明细里的商品金额和零售明细统计中的商品实际销售额不一致

零售明细统计中的商品实际销售额显示的是商家商品的折扣金额

无需解决

OMS异常订单，重推失败，提示失败原因：For input string: "xxxxxxxxxxxxxxxxxxxxx"

原因1：

商品商品库商品编码超出了long类型范围

原因1解决方案：

修改商品商品库商品编码，再重新同步

原因2：

绑定的线下门店编号多了特殊字符

原因2解决方案：

修改线下门店编号，再重推

订单在零售系统中发货，在已结账单中没有没有销售的单据，只有退款的数据

订单是送达成功后取消配送，推送到AMA的退款订单为“平台编号 + 1 + 订单号”

无需解决

商品同步到三方平台，商品图片裂开

图片不符合平台规定

更换图片

按规格编码匹配，共1890条未匹配的第三方商品, 商品库中可匹配商品150条, 成功135条, 失败0条。
这个执行记录得逻辑需要确认下

可匹配商品是商品库中和商品匹配列表中规格编码一致的商品，由于商品库中的规格编码是自定义的，可能会有多个一致的规格编码的商品，但实际绑定成功的只能有一个

无需解决

同步错误原因“如需同步upc，要求upc值非空”

订单聚合同步失败错误原因：商品更新,存在异常:{"errorCode":2026,"errorMsg":"poiId[14061367] spuId[0] 

spuName[山楂罐头1罐红甜红]={标签={}, sku={poiId[14061367] spuId[0] skuId[0] skuSpec[1罐]=

{upc=不能为空, 图片={}}}, 图片={}}","name":"山楂罐头1罐红甜红","setBussinessExtendModel":false,"setErrorCode":true,"setErrorMsg":true,"setName":true,"

setSku_source_food_code":true,"setSpu_source_food_code":true,"setWm_poi_id":true,

"setWm_product_sku_id":true,"setWm_product_spu_id":true,"

sku_source_food_code":"1022311150004734","spu_source_food_code":"1012311150003887",

"wm_poi_id":14061367,"wm_product_sku_id":0,"wm_product_spu_id":0}|

商品库商品【规格编码】未填写

填写商品库商品【规格编码】

若商品无需填写upc，则在同步设置勾选不同步upc的选项

异常订单失败原因为：订单聚合参数未开启

AMA-档案-OMS设置-【接收OMS订单】未开启

开启 AMA-档案-OMS设置-【接收OMS订单】

OMS同步报错：参数格式错误:|sku_id数值重复

商品的 skuId 重复了

商家后台把该商品的其中一个 skuId 修改下

新零售V2配置打印机，提示“打印机编号和用户不匹配”

飞鹅云那边打印机授权被取消了

重新去订单聚合保存一下打印机

同步提示“如需同步upc，要求upc值不能重复”

商品库商品多个规格的规格编码相同或该规格编码在三方后台已存在

修改重复的规格编码

库存同步部分平台门店不同步，部分能同步

三方平台商品代码发生改变，导致库存修改失败

重新绑定下商品

修改门店分组顺序失败：
商品库分组-[xxxxxxxxx], 门店-xxxxxxxxxx，分类信息未同步

批量更新门店分组顺序时，只会更新商品库已同步过去的分组，未同步的分组会提示失败

先同步商品把分组同步过去，再批量更新分组顺序

第三方平台订单后台已送达，用户已收餐，但是订单聚合里还是 待打包 等状态

骑手已送达、用户已收餐不代表订单已完成，订单状态仍然为待发货。订单变更为完成状态为商家接单后 4-8 小时。属于正常范围。

点击订单后方的刷新可以重新获取订单状态

若同步失败原因为以下形式：

原因1：

平台门店设置的授权平台为美团外卖，但实际门店已经升级为美团闪购了。

（若已经升级成了闪购门店，但授权的还是美团外卖平台，即使商品库商品设置了类目，同步时也不会传类目。）

商品库商品填写的【规格编码】不符合标准（同步时美团闪购平台会对UPC进行校验，填写不符合标准的【规格编码】会被判空）

如何判断UPC是否符合标准？

快捷方法：打开美团外卖商家后台，新建商品，将需要验证的UPC输入到条形码中，填写其他必填项，保存商品，若能保存成功则UPC符合标准。

详细规则：

如何判断是否为闪购门店？

打开美团外卖商家后台，看左边一列是否有【闪购培训】。

原因1：

① 将平台授权改为美团闪购

② 若商品本身是有upc的（例如包装食品），则需在商品库商品【规格编码】填写符合标准的UPC（填写不符合标准的【规格编码】会被判空）后再同步。

若商品本身是没有upc的（例如散装称重类商品），则在商品库设置条形码非必填的类目，再进行同步。

如何判断某个类目对应的条形码是否必填？

可在闪购后台新建商品，选择类目之后，查看商品的条形码是否带有星号，若有则该类目【规格编码】必填

原因2：

规格编码中有特殊字符（可能在商品库中看不出来，复制到文本编辑器中可以看出）

原因2：

重新输入规格编码

原因3：

同步设置处勾选了“不同步UPC”选项

原因3：

取消勾选“不同步UPC”选项

情况1：

美团商家后台订单没有同步到OMS，打印机正常出票

情况2：

商品同步失败或拉取异常订单等操作提示“非法令牌”

情况3：

美团授权经常自动解绑

原因1：

美团门店授权被打印机抢占

原因1解决方案：

临时解决方案：重新授权美团门店。

彻底解决方案：检查客户的打印设备是否绑定在美团客户端，若是，则将其解绑，绑定到OMS系统中。

原因2：

默认赠送的2000笔订单要先进入【平台授权】页面才能生效，订单是在为进入该页面之前下单的

原因2解决方案：

进入一下【平台授权】页面

若情况1、2、3同时发生，则必定为原因1；

若只发生情况1，则原因1（大概率）、2（小概率）都有可能

商品库商品同步至美团平台，平台只显示一张商品图片，商品详情和买点并未同步

当前该门店绑定的是美团外卖平台，需要将该门店换绑为美团闪购平台，可以同步多张图片和图文详情，图文详情需要在商品库填写商品详情。商品买点暂不支持同步。

将该美团外卖门店换绑为美团闪购平台

oms门店绑定状态、打印机配置都是正常的，打印机网络也是连接好的，目前门店下单会出单，退款不出单

美团下单一分钟内退款属于取消订单，不会打印退款单

下单一分钟以后，取消订单按钮变成申请退款，这时候退款会打印

无需解决

新零售商品批量更新失败

商品未同步至第三方平台

商品需要先同步到第三方平台才能使用批量更新功能

美团后台订单已送达，用户已收餐，但是订单聚合里还是待确认送达

骑手已送达、用户已收餐不代表订单已完成，美团订单状态仍然为待发货。美团订单变更为完成状态为商家接单后 4-8 小时。属于正常范围。

无需解决

绑定时提示：数中存在非餐饮生态APP，让商户联系美团商务解绑其他外卖平台

根据以下方法核实平台是否为“闪购”

目前已知此情况原因为闪购平台绑定美团平台导致报错，绑定闪购即可

同步失败原因为以下形式：（以下两个问题可能不会再发生，原因：闪购方可能调整为所有类目条形码都可为空）

或

商品库商品未设置类目或设置了错误的类目，同步时平台会根据商品名称自动设置或修正类目。

若平台自动设置或修正后的类目对应的条形码必填且商品库商品填写的【规格编码】不符合标准（同步时美团闪购平台会对UPC进行校验，填写不符合标准的【规格编码】会被判空），则会同步失败。

如何判断UPC是否符合标准？

快捷方法：打开美团外卖商家后台，新建商品，将需要验证的UPC输入到条形码中，填写其他必填项，保存商品，若能保存成功则UPC符合标准。

详细规则：

若商品本身是有upc的（例如包装食品），则需在商品库商品【规格编码】填写符合标准的UPC（填写不符合标准的【规格编码】会被判空）后再同步。

若商品本身是没有upc的（例如散装称重类商品），则在商品库设置条形码非必填的类目，再进行同步。

如何判断某个类目对应的条形码是否必填？

可在闪购后台新建商品，选择类目之后，查看商品的条形码是否带有星号，若有则该类目【规格编码】必填

商品已填写规格编码，同步到美团闪购，商家后台查看条形码为空

条形码不符合标准，OMS会将其过滤为空，详细规则见上方

输入符合标准的条形码

手动绑定和商品匹配提示绑定自定义商品编码失败，需要手动设置

美团后台商品分组变化或商品是删除后重新建的，OMS门店商品未读取最新商品信息，导致找不到该商品

重新读取后绑定

商品同步失败，提示”禁止调整商品分类的层级：category_name=xxxxxx“

闪购平台父分类A有商品情况下，无法将商品库父分类A的子分类B中的商品同步过去（闪购平台一级分类下有商品时，无法在此一级分类下创建二级分类）

将闪购平台父分类A中商品移到别的分组，再同步

同步美团闪购提示参数报错，参数格式错误:[ {"app_spu_code":"1012311140003862","blockFlag":1,"error_msg":"picture字段未上传"}]

原因1：

未同步图片

原因1解决方案：

1、检查商品库商品图片有没有上传，若没传，上传并保存

2、检查同步设置是否开启了【不同步图片】，若勾选了，取消勾选再同步

原因2：

图片太大，闪购限制5Mb

原因2解决方案：

压缩图片至5Mb以内

闪购添加门店报错

授权已经过期，请联系商家重新授权

闪购授权码有时效性。

点击去授权，重新授权下这个店即可。

美团闪购已存在该UPC，请先处理

闪购平台店铺商品中有与同步商品条码相同的商品

调整对应问题商品的条码或同步时勾选不同步UPC

分组互斥

分组改名了但不会修改分组的ID

删除其中一个分组后在进行同步

商城绑定饿了么绑定不了。

提示账号正在开店审核。

账号是饿百零售平台的，无法绑定饿了么平台（“饿了么零售商家版”是原“饿百零售”，“饿了么商家版”是”饿了么外卖“）

选择饿百零售平台绑定

oms-同步管理-同步部分商品至第三方平台，在饿了么平台查询商品无图片无包装费

1、图片必须正方形才能同步到饿了么（饿了么的要求）

2、商品同步目前没有同步包装费的功能，商品批量更新可以更新餐盒费（包装费）

商品库图片更改为正方形

商品同步到饿百门店提示：商家产品已存在-已存在条码为【XXXXXXXXXXXXXXX】的商家产品

饿百方程序问题导致

临时解决：同步失败后，点击【重新同步】

彻底解决：需饿百方后续优化

饿百授权门店失败

原因1：

应用未关联门店

原因1解决方案：

进行此操作https://open-retail.ele.me/?spm=a2f86.b661348.0.0.7608225fxTJfHp#/guide?topic=hpqfwu

原因2：

应用未设置为主应用

原因2解决方案：

应用需设置为主应用

饿百接不到新订单

应用地址填写错误

授权回调地址：https://oms.nhsoft.cn/webhooks/eb_redirect

下行推送地址：https://oms-new.nhsoft.cn/oms/webhooks/eb_webhook

单规格商品同步到饿百变成了多规格商品

OMS商品库商品规格名称不是“单规格”，饿百会识别为多规格商品。

商品只有一个规格且规格名称为“单规格”同步到饿百才为单规格商品

将OMS商品库商品规格名称改为“单规格”再同步

饿百零售报错：gw.APIACLDecline

饿百2023.7.10起，需要手动申请权限包。

饿了么零售开放平台 (ele.me)

申请图中所示权限

饿百零售授权报错：gw.AppKeyNotFound

饿百绑定门店要输appid和appsecret，不是门店账号密码

绑定门店输appid和appsecret

OMS，同步至第三方平台，提示商品同步失败，查看原因显示：gw.ISPInvokeError

饿百接口繁忙超时异常，应该是偶发的

重新同步

饿百授权报错gw.SignatureInvalid

饿百同步商品图片没有同步过去，同步里设置的参数看是没问题的

饿百现在需要审核商品图片，需等待审核通过才会显示商品图片

等待审核通过即可

情况1：

同步无法完成，提示：”自定义分类下有子分类，不能添加商品“

情况2：

同步无法完成，提示"openapi一级自定义分类下有商品，不允许在此一级自定义分类下创建二级自定义分类"

情况1：

饿百平台父分类有子分类情况下，无法往父分类同步商品

情况1解决方案：

将商品库商品的分类改为饿百平台对应的子分类再同步

情况2：

饿百平台父分类A有商品情况下，无法将商品库父分类A的子分类B中的商品同步过去

情况2解决方案：

在饿百平台父分类A下手动创建一个子分类B（A中商品会自动移到B），再同步

同步后覆盖其他商品

调整了商品库商品的名称或饿百方的商品名称，导致根据商品id查询商品时不一致情况，且没有没有同步图片，图片就错乱了

商品匹配重新绑定对应的商品

饿百平台同步商品时失败了，失败原因：店铺分类名称最多12个字符。

该商品一级或二级分类名称太长

将该商品一级或二级分类名称改到12个字符以内（一个汉字、标点、字母都算一个字符）

同步商品提示：多规格商品不允许后台变更类目

饿百同步接口限制

调整oms和饿百后台的商品类目一致后再次同步

同步饿百报错，【API】通过入参未查询到商户信息，请确认店铺已入淘且通过审批

原因1：

客户时间段内绑定门店过多，饿百方商户绑定接口超出限制，导致有些门店未和oms匹配绑定上。

原因1解决方案：

重新在OMS授权页面授权饿百

原因2：

饿百方数据问题

原因2解决方案：

联系研发给饿百方提工单修复

添加饿了么店铺的时候，提示账号密码错误。但是在饿了么后台能正常用该账号密码登录

饿了么零售是饿百，不是饿了么。

平台门店设置处授权应选饿百，授权时需输入 appid 和 appsecret

饿了么退款订单应收金额和ERP退款金额对不上

目前平台推送的退款消息是推给顾客的钱。

推给商家的钱可能包含饿了么佣金。

两者金额会有一定的出入。

商品同步至京东到家平台失败，提示“贵司无此商品经营权限接口执行失败，请重试”

商品库类目未配置或配置有误或京东商家后台-经营范围未配置此类目的的经营权限

OMS商品库商品填写正确的类目或京东商家后台-经营范围配置此类目的的经营权限

新零售OMS显示京东订单预计收入33.9 实付26.1，推送到ama显示实收26.9，且已结账单经理折扣有4.2元

经理折扣是商家满免运费优惠 + 包装费。不一致问题是因为 自配送，自配送运费计入商家收入，AMA 不处理配送费的，所以和新零售oms显示的不一致。

无需解决

京东到家平台，做商品同步，勾选同步商品至第三方平台时，不同步商品UPC，同步报错， 不勾选同步也报错，实际条码检查正确

可能是京东类目填写有误

修改一下京东类目

同步商品到京东时，商品名称自动把规格名称、规格值也添加到名称中了

京东到家只支持单规格，OMS多规格商品同步到京东会将规格值添加到商品标题上

单规格商品需要将规格值名称修改为“单规格”，否则将作为多规格商品处理

京东到家无图片

图片格式错误，图片像素格式应大于 600 * 600

修改图片像素

抖音同步提示“实付价不能大于最高售价"

规格类目属性的商品搭配里的【菜品价格×总数】是原价，商品售价是实付价，原价必须大于实付价

设置规格类目属性的商品搭配里的【菜品价格×总数】大于商品售价

商品同步报错”mobile字段缺失“

基础设置-基础信息，客服电话未填写

基础设置-基础信息，填写客服电话