Skip to content

常见问题 ​

本页汇总使用柠檬跨境ERP 时最常遇到的问题。找不到答案时,可以到 GitHub Issues 提问。

账号与权限 ​

登录后找不到某个模块或页面? ​

顶部导航和侧边栏只显示你有权限的菜单。请管理员在「系统管理 → 角色管理」中给你的角色勾选对应页面;修改后刷新浏览器即可看到。也可以用菜单搜索(⌘ / Ctrl + K)确认页面是否在你的权限范围内。见角色与店铺数据权限。

页面能打开,但看不到某些店铺的订单 / 商品? ​

电商页面按店铺数据权限过滤:只能看到自己负责的店铺(店铺「负责人」)和在店铺授权中被授权的店铺。请管理员把店铺授权给你。超级管理员和角色数据权限为「全部数据」的用户不受限制。

给运营授权了部分店铺,他却能看到全部店铺? ​

检查他的角色数据权限是不是「全部数据」:全部数据会同时放开店铺数据权限。应改为「本部门及以下」等范围,再通过店铺授权控制可见店铺。

平台授权 ​

OAuth 授权后提示失败,或平台提示回调地址不匹配? ​

  1. 确认在平台开发者后台登记了正确的回调地址 <后端地址>/api/ecom/oauth/callback/<平台>,各平台的登记方式不同(虾皮登记域名、eBay 用 RuName、TikTok 在 Partner Center 配置 Redirect URL),见多平台多店铺接入 → 回调地址。
  2. 系统部署在反向代理之后时,要配置 lemon.ecom.public-url(环境变量 LEMON_ECOM_PUBLIC_URL)为包含 /api 的后端外网地址,否则系统推算出的回调地址是内部地址。
  3. 授权链接 30 分钟内有效,超时后重新点「授权」。
  4. 确认店铺的「环境」与应用一致:沙箱应用要选「沙箱 / 测试」,正式应用要选「正式」。

店铺显示「需重新授权」? ​

OAuth 令牌刷新失败(令牌过期、卖家在平台撤销了授权、应用密钥变更等)时,定时任务会把店铺标记为需重新授权,首页「待办与预警」中也会出现「店铺授权失效」。在平台店铺中点「授权」重新授权即可;填写密钥的平台检查密钥后保存,再点「测试授权」。

编辑店铺时授权信息都是空的,是不是丢了? ​

不是。授权信息加密保存、只写不读,保存后输入框显示「已设置,留空表示不修改」。留空保存不会改变原值;要更换就直接填写新值,要清除点「清除授权」。

更换了服务器或 JWT 密钥后,所有店铺授权都失效了? ​

授权信息用 lemon.jwt.secret 派生的密钥加密,更换该密钥后已保存的授权无法解密,需要逐个店铺重新填写或重新授权。迁移服务器时请保留原来的 JWT 密钥配置。

接口是否已经和真实平台联调过? ​

各平台、海外仓、物流商的接口都按官方公开文档实现,并用模拟服务器做了单元测试,但尚未用真实开发者账号联调。正式使用前请先在沙箱或测试店铺上验证拉单、回传发货、回传库存,确认无误后再开启自动同步。

订单同步 ​

订单没有同步进来? ​

按以下顺序排查:

检查项处理
店铺是否启用、是否开启「自动同步订单」停用的店铺不能同步;没开自动同步时只能手工「同步订单」
授权状态在渠道接入中查看授权状态和「拉取订单」最近一次结果,红色表示失败
同步日志店铺行「同步日志」中查看失败原因,例如「xx 授权失败:…」「xx 接口返回 401:…」「渠道授权缺少 xx,请在店铺中补充」
时间范围定时同步是增量的(上次同步时间往前重叠 2 小时)。较早的订单在「同步订单」中指定起始时间重新拉取;Ozon 只能按创建时间过滤,虾皮每次最多 15 天会自动分段
平台限流亚马逊 getOrders 约每分钟 1 次,不要频繁手工同步;系统遇到 429 / 503 会自动退避重试
平台是否有接口选择「其他」平台的店铺提示「平台 xx 还没有渠道接口,请手工导入订单」,用 Excel 导入

同一订单会不会重复导入? ​

不会。订单按「店铺 + 平台订单号」去重,重复拉取或重复导入不会产生重复的订单。

订单状态是「异常」,原因是 SKU 未匹配? ​

订单中的平台 SKU 还没有配对到本地商品。到 SKU 配对 或在线商品中完成配对,然后在订单上「重新匹配」,订单会回到待处理。配对时注意:多规格款式本身不能配对,要配对到具体的规格 SKU;一个平台 SKU 对应多件本地商品时填写「多件装数量」。

审核后进入「缺货」? ​

审核时按发货仓的可用量(空闲库存减去其他未发货包裹已占用的数量)检查库存,不够就进入缺货。补货入库或调整发货仓后,在平台订单中对缺货订单「重新检查库存」。

平台物流的订单为什么不能填运单号回传? ​

Lazada、虾皮 SLS、Ozon、美客多 me2 等平台物流的运单号由平台生成,ERP 不能回传。发货时系统返回「平台物流托管」,能取到时会把平台运单号写入订单和包裹;虾皮 SLS 的揽收需在卖家中心安排。

汇率与金额 ​

提示「没有 USD 在 2026-11 的汇率,请先在「币种汇率」中维护」? ​

订单、结算、广告都按日期所在月的汇率折算本位币,系统不使用默认汇率。到「财务管理 → 期末与设置 → 币种汇率」中为该币种添加对应月份的汇率,然后重新导入 / 同步或重新操作。新增店铺时提示「币种 xx 不存在」,也是要先在这里添加币种。

汇率改了,以前的订单金额会变吗? ​

不会自动变。订单写入时按当时的汇率计算本位币金额并保存。看板、利润分析中的金额都是本位币,基于订单保存的金额统计;广告花费按广告日期所在月的汇率折算。

回款到账金额和结算金额对不上? ​

在「财务管理 → 平台结算 → 回款对账」中,到账金额与应到账金额的差额会拆为「金额差」和「汇兑差」(应到账 × (到账汇率 − 结算汇率)),结算生成过收款单的还会生成差额凭证,汇兑差和金额差记入财务费用。收款平台已结汇(到账为本位币)时差额全部记为汇兑差。

利润口径 ​

订单利润是怎么算的? ​

订单利润 = 实付 × 汇率
         − (平台代扣税 + VAT + 佣金 + 配送费 + 退货处理费 + 其他费用 + 退款)× 汇率
         − 商品成本 − 物流成本
  • 商品成本取出库时的移动加权成本;
  • 物流成本:平台配送(FBA)订单为最近一批已发运头程货件的单件头程成本 × 数量,自发货订单为发货时的运费(按物流渠道费率试算或手工填写,海外仓订单还有尾程运费和操作费);
  • 没有匹配到启用税率的订单,税额为 0。

为什么订单利润和结算后不一样? ​

平台结算之前,佣金按店铺的「佣金率」估算;导入并确认结算后,系统用平台实际的佣金、配送费、退款等覆盖估算值并重算利润。订单列表会标出费用是否已结算。

看板 / 利润分析的利润为什么比订单利润合计低? ​

电商看板的本月利润、利润分析的毛利在订单利润的基础上,还扣除了广告花费(按广告日报)和不挂订单的费用分摊(仓储费、长期仓储费、订阅费、移除费等,按销量或销售额分摊到 SKU)。

利润分析的「订单口径」和「结算口径」有什么区别? ​

  • 订单口径:按下单时间统计期间内未取消的订单,费用取订单上的值(结算前为估算),适合看经营趋势。
  • 结算口径:按结算明细的入账日期统计,金额以平台结算报告为准,适合与回款、账务核对。

两种口径都扣除费用分摊和广告花费。详见利润分析。

结算报告导入时提示「无法识别的费用类型」? ​

平台报告中的原始费用类型名没有对应的系统类型。在「财务管理 → 平台结算 → 费用映射」中添加映射(平台 + 原始类型 → 系统类型),或在导入文件中直接填写系统类型,然后重新导入。同一结算编号只能导入一次,提示「结算编号 xx 已导入过」时,先删除未确认的结算单再导入。

库存 ​

平台显示的库存和系统不一致? ​

情况说明与处理
FBA / 平台仓在「物流管理 → FBA → 平台仓库存」导入平台库存报告,页面并列显示平台可售与系统平台仓库存(÷ 多件装)及差异,核对盘亏盘盈后用仓库的盘点单或其他出入库调整
第三方海外仓「物流管理 → 海外仓 → 海外仓库存」同步后显示差异 = 海外仓(可用 + 锁定)− ERP 账面,可选中行「按海外仓调整」生成其他入库 / 出库
平台前台的可售数(自发货)回传库存每 15 分钟只推送有变化的商品,可售 = ⌊默认发货仓空闲库存 ÷ 多件装⌋ − 保留数量;店铺未开启「自动回传库存」、商品未配对或已下架时不回传。也可以在店铺上手工「回传库存」
在途头程货件发运后库存处于在途,签收后才进入平台仓;海外仓入库收货完成后系统自动签收

平台订单发货了,库存为什么没减? ​

库存在**发货(出库)**时减少:包裹发货时每个订单生成一张销售出库单。审核、打单阶段只占用可用量,不减库存。平台配送订单从店铺的平台仓出库,店铺没有设置平台仓时不能出库。

组合商品的库存怎么算? ​

组合商品按组件折算:可用量取各组件「库存 ÷ 用量」的最小值;出库、补货采购时按用量拆到各组件物料。

店铺与基础资料 ​

店铺不能删除? ​

已有在线商品或订单的店铺不能删除,提示「店铺「xx」已有在线商品或订单,不能删除,可以停用」。停用后不能再导入 / 同步订单。新建店铺时自动建立的客户(编码 ST-店铺编码)也被店铺引用,不能单独删除。

平台仓和默认发货仓有什么区别? ​

默认发货仓是本地仓,自发货订单从它出库、头程货件默认从它调出、回传库存按它计算;平台仓是 FBA 仓或平台海外仓,平台配送订单从它出库、头程货件调入它。两者不能是同一个仓库。

演示数据 ​

看板上没有「生成演示数据」按钮? ​

按钮只在当前租户本月和今天都没有订单、且还没生成过演示数据时显示,并且需要「生成演示数据」权限(超级管理员、电商运营)。已经生成过(存在 DEMO- 开头的店铺)时提示「已经生成过演示数据,不能重复生成」。

演示店铺同步订单、测试授权都失败? ​

正常现象。演示店铺的授权是占位值,接口地址指向本机不可用的端口,并关闭了自动同步,不会访问真实平台;「需重新授权」「同步异常」等状态是故意构造的演示场景。见演示数据。

能删除演示数据吗? ​

没有一键删除功能。演示数据会写入真实的库存、单据和凭证,正式使用的租户不要生成;SaaS 模式下建议新建一个体验租户来生成,单租户部署要清除只能重新初始化数据库。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com