Skip to content

平台店铺 ​

平台店铺是电商模块的起点:每个在平台上开设的店铺(如「亚马逊美国站 A 店」「Shopee 马来西亚站」)在这里建一条档案,记录平台、站点、结算币种、发货仓、平台仓和渠道授权。订单、在线商品、广告、结算、补货都按店铺归属,店铺的授权决定能否通过接口自动同步。

系统支持亚马逊、速卖通、eBay、Shopee(虾皮)、Lazada、Shopify、TikTok Shop、Temu、沃尔玛、Ozon、美客多 11 个平台的接口;平台下拉中的「其他」用于没有接口的平台,只能手工导入订单和在线商品。各平台需要的授权信息、沙箱与回调地址见多平台多店铺接入。

页面入口 ​

运营管理 → 店铺管理 → 平台店铺

平台店铺列表

列表 ​

查询条件:店铺(编码或名称)、平台、状态。

工具栏:

  • 「新增店铺」:打开新增表单。
  • 授权概况:「已授权」「需重新授权」「未授权」「同步异常」各有几个店铺;有需重新授权或同步异常的店铺时显示「渠道总览」链接,点击打开渠道接入并只显示有问题的店铺。
  • 右侧为导出、显示 / 隐藏查询区、刷新、表格密度、列设置。

列表列:

列说明
店铺平台图标、店铺名称(点击打开编辑;没有编辑权限时打开同步日志)和编码。演示数据生成的店铺带紫色「演示」标签:不调用平台接口,定时任务跳过
平台平台标签。平台还没有接口实现时,旁边显示断开图标(悬停提示「该平台没有接口」)
站点店铺所在的站点 / 市场,如美国、德国、马来西亚
环境沙箱(橙色)或正式(蓝色)
授权状态未授权 / 已授权 / 需重新授权。已授权时下方显示授权时间(如「授权于 38 分钟前」)。令牌刷新失败、授权被平台吊销时变为「需重新授权」
同步健康最近一次接口操作(拉取订单、回传发货、回传库存、拉取商品、授权)及时间;24 小时内有失败时显示「24h 失败 N」红色标签,下方红字显示最近失败的原因。悬停显示各接口最近一次的结果,点击打开同步日志
币种、对应客户、默认发货仓、平台仓、在线商品数、负责人、状态、备注默认隐藏的列可在列设置中打开

行操作(图标按钮,悬停显示名称;不常用的在「更多」中):

操作说明
编辑打开编辑表单
授权OAuth 授权的平台(eBay、Shopee、Lazada、TikTok Shop、美客多)显示。在新窗口打开平台授权页,登录并同意后平台回调本系统保存令牌;回到本页在弹窗中点「我已完成授权」刷新状态
测试授权填写密钥的平台(亚马逊、速卖通、Shopify、Temu、沃尔玛、Ozon)直接显示,OAuth 平台在「更多」中。用保存的授权调一次平台接口,成功提示「XX 授权有效」,失败提示平台返回的原因
同步订单打开「同步订单」弹窗手工拉取订单,见下文
同步商品(更多)拉取平台上的在线商品,提示取到、新增、更新的条数;不覆盖已有的 SKU 映射,平台 SKU 与物料编码相同时自动映射
回传库存(更多)把默认发货仓的可售数回传平台,见下文
同步日志(更多)打开该店铺的同步日志抽屉
启用 / 停用(更多)停用的店铺不能导入、同步订单,接口操作按钮置灰
删除(更多)已有在线商品或订单的店铺不能删除,只能停用

没有填写授权、店铺已停用或平台不支持该能力时,对应按钮置灰,悬停显示原因(如「请先在编辑中填写渠道授权」「店铺已停用」「平台不支持」)。

新增 / 编辑店铺 ​

点击「新增店铺」或店铺名称,表单占满内容区,分为基本信息、渠道接口、仓库与补货、自动同步、其他五部分。

编辑店铺

基本信息 ​

字段必填说明
店铺编码是1~32 位字母、数字、下划线或短横线,如 US01。保存后作为 Excel 导入订单、结算、广告时的店铺标识
店铺名称是如「美国站 A 店」
平台是选择后下方「渠道接口」按该平台显示授权方式和授权字段
负责人否店铺的运营负责人。负责人自动能看到该店铺的数据(不需要再在店铺授权中授权),也是运营绩效、运营目标按人员统计的依据
站点是店铺所在的站点 / 市场,可在「系统管理 → 业务字典」的「电商站点」中扩展
币种是店铺结算币种,订单、结算、广告金额默认按它记录。币种需先在「财务管理 → 币种汇率」中添加
时区否如 America/Los_Angeles,平台报告中的时间按此时区换算;广告分时策略也按店铺时区计算时段
卖家 ID否平台卖家 ID(亚马逊 Seller ID 等)

新建店铺时系统自动建立一个对应的客户(编码「ST-店铺编码」),平台订单出库生成的销售出库单、应收、结算收款都挂在这个客户下;店铺改名时客户名称同步修改。

渠道接口 ​

上方灰色区域显示该平台的接口信息:授权方式(OAuth 授权 / 填写密钥)、支持的能力(拉取订单、回传发货、回传库存、拉取商品)、开发者文档链接,以及平台特有的说明(如回调地址、订单同步的时间窗口限制)。平台还没有接口实现时提示只能手工导入,授权信息可以先按 JSON 登记备用。

授权信息:按平台显示需要填写的字段(如亚马逊的区域、Marketplace ID、LWA Client ID、LWA Client Secret、Refresh Token)。

  • 密钥、令牌等敏感字段用密码框,保存后不再显示内容,只显示「已设置」;编辑时留空表示不修改。
  • OAuth 平台的 Access Token、Refresh Token 等字段只读(提示「由平台授权回调自动写入」),保存店铺后在列表中点「授权」完成授权,令牌自动回填并定时刷新。
  • 已配置授权时显示绿色提示「已配置渠道授权,留空保存表示不修改」和「清除授权」链接;清除后该店铺只能手工导入订单。

接口环境:

字段说明
环境正式 / 沙箱(测试)。下方显示该环境的默认接口地址;没有公开沙箱的平台提示用平台提供的测试店铺验证后再切换为正式
自定义接口地址高级设置,私有网关或测试用的模拟服务器,留空按环境使用默认地址;必须以 http:// 或 https:// 开头

仓库与补货、自动同步

仓库与补货 ​

字段必填说明
默认发货仓是自发货订单从它出库,头程货件默认从它调出;回传库存按它的可用库存计算
平台仓否FBA / 平台海外仓(在仓库管理中建的一个仓库)。平台配送订单从它出库,头程货件调入它;不能与默认发货仓相同。为空时平台配送订单不能出库
佣金率否预估平台佣金率(%,默认 15)。结算报告回写实际费用前,订单利润按它估算佣金
补货周期否从下单采购 / 发运到平台仓可售的天数(默认 30),用于补货建议
安全天数否补货建议在补货周期之外再保留的销售天数(默认 15)

自动同步 ​

字段说明
自动同步订单开启后定时任务每 30 分钟拉取一次新订单(增量拉取,与上次同步时间重叠 2 小时,重复拉取不会重复入库)
自动回传库存开启后每 15 分钟把默认发货仓的可售数回传平台,只回传有变化的
保留数量回传数 = 可用库存 ÷ 多件装 − 保留数量,用于给其他渠道留出库存

平台接口不支持某项能力时,对应开关下方提示「该平台接口不支持……」。

同步订单与回传库存 ​

同步订单:点行上的「同步订单」打开弹窗,「起始时间」可以留空(从上次同步时间开始,第一次同步默认取最近 30 天),也可以选一个时间拉取该时间之后创建或更新的订单。完成后提示「取到 N 条订单,新增 N 条,更新 N 条」。拉取的订单进入平台订单,按 店铺 + 平台 SKU 匹配在线商品的映射物料,未匹配的订单为「异常」。

同步订单

回传库存:弹窗说明可售数的算法:可售数 = 默认发货仓的可用库存(扣除冻结与已预留)÷ 多件装 − 保留数量,向下取整、不小于 0;只回传自发货、在售、已映射物料的在线商品。默认只回传和上次不同的,勾选「全部重新回传」时全部回传。

同步日志 ​

点「同步健康」列或「更多 → 同步日志」打开该店铺的日志:开始时间、类型(拉取订单 / 回传发货 / 回传库存 / 拉取商品 / 授权)、触发(定时任务 / 手工)、结果、条数(取到 / 新增 / 更新)、耗时、说明(失败原因)。可按类型、结果筛选。日志保留 90 天。全部店铺的日志在渠道接入的「同步日志」页签中查看。

同步日志

注意事项 ​

授权信息的安全

渠道授权加密保存、只写不读:列表和详情只显示是否已授权。服务器更换 JWT 密钥后已保存的授权无法解密,需要重新填写或重新授权。

  • 各平台接口按官方公开文档实现,并用模拟服务器做了测试,接入真实店铺前请先在沙箱或测试店铺上验证一次。
  • 亚马逊 getOrders 限速约每分钟 1 次,自动同步间隔不要短于默认的 30 分钟;虾皮订单列表每次最多查 15 天,同步时自动分段;Ozon 只能按创建时间过滤,定时同步额外回看 7 天。
  • 部署在反向代理后时,OAuth 回调地址需要按多平台多店铺接入配置后端外网地址并在平台开发者后台登记。
  • 店铺平台仓、默认发货仓被引用后不能直接删除对应仓库。

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