FBA 退货订单

01 功能说明

从「ERP → FBA退货订单」查询已保存的退货明细、查看详情与汇总，并按当前条件导出。具备同步权限的人员可以拉取数据和管理每日计划、历史补齐。

02 使用前确认

• 确认租户、店铺与日期范围，账号需要对应读取权限；同步与计划管理还需相应操作权限。
• 首次使用时先核对希望补齐的起止日期与店铺，再提交历史补齐任务。页面只展示已成功发布的源数据。

03 页面区域与关键对象

• 看板提供所选日期、昨日、前7天的FBA退货件数、订单数及退货/总销量参考比率；支持日周月趋势、多维TOP50与原因分布，按国家、店铺、MSKU筛选，点击排名或日期查看对应退货订单。
• MSKU 页签按商品查询 ERP 退货统计，包含 FBA 与 FBM，可切换退货时间和下单时间；与订单明细各自查询。
• 工具栏提供筛选、查询、导出与同步入口；列表和详情用于核对订单、商品、店铺、时间及来源信息。
• 同步面板展示真实分页进度；每日计划和历史补齐分别显示各自状态，历史补齐可查看已完成窗口。
• 标签字典按钮查看分类说明与示例；建议标签列打开备注/退货原因依据、建议、人工结论与历史。

04 推荐操作顺序

1. 在 MSKU 页签选择日期后点击“拉取数据”，一次提交自动完成全部分页；可按店铺、Listing负责人和 ERP 商品分类筛选，查看指标、分布与当前产品引用字段。每天需要刷新的滚动范围在“每日更新”中配置并开启。
2. 选择店铺、日期及其他筛选条件，查看明细、汇总和记录详情。
3. 需要更新时提交手动拉取，检查分页进度与最终成功或失败提示。
4. 首次补齐历史时确认店铺与起止日期；按店铺、月份从近到远处理，已完成窗口可先查询。
5. 需要中断时暂停历史任务；修复失败原因后续传，并核对剩余窗口是否完成。
6. 按业务需要维护每日计划，在后续查询中抽查店铺和日期覆盖。
7. 勾选当前页明细后点击生成标签，在打标任务中查看进度；有备注仅分析备注，无备注按明确退货原因映射。无备注且无原因不打标，未知原因显示未配置映射。
8. 打开建议标签审核，成功建议自动放入待确认标签；逐项核对备注原文或退货原因，点“添加其他标签”补充遗漏。完整采纳可直接“确认并下一个”；人工调整或保存待判断需填写说明。
9. 标签字典中可只读查看当前原因映射，也可按权限维护标签说明和示例；“到智能协同管理提示词”进入 Prompt 管理，选择退货备注打标并发布新版本。提示词与字典版本独立，旧结果和人审保留原版本。
10. 确认后只在当前页向后打开下一条待处理记录，跳过无备注且无有效原因、已确认及同组明细；若已保存但读取下一条失败，只需重试打开下一条。
11. 导出筛选结果保留每条源明细，并包含建议标签、已确认人工标签、建议来源和映射版本。

05 权限与状态边界

• 看板以已发布FBA退货订单明细按退货日期统计，订单按店铺和非空订单号去重；销量取对应店铺/MSKU总销量（含FBA和FBM），参考比率不等于订单同期退货率。MSKU分析仍保留来源接口口径。pp表示百分点，零分母或缺失数据显示 —。
• 看板默认前30天截至昨日，昨日/前7天按北京时间、不含今天。趋势从退货明细聚合，周从周一开始，月按自然月，首尾按选区裁剪；未发布日期留空。退货上升/改善和问题占比变化用结束日所在月月初至结束日，对比上月整月，上上月作为参考。标签分析采用人工确认优先，三个问题层级同时展示；人工存疑不回退自动结果，数据或分类未完整时不判断改善。
• MSKU 日期包含结束日，最多 366 天，默认近 30 天截至前天（北京时间）；退货率环比差异以百分点显示。失败保留上次完整结果，日期口径与范围不同的结果各自拉取，不能直接相加。
• MSKU 的“主要退货原因”与买家之声字段不同，空值表示源数据未提供。仅退货时间可跳转已同步 FBA 明细，明细数量可能与含 FBM 的统计不同。
• 同步保留来源重复行，不应按订单号自行去重。一次窗口的全部分页成功后才发布，失败保留此前成功结果。
• 没有退货的日期也可完成覆盖；空结果与同步失败需要结合窗口状态区分。每日到期任务优先于历史补齐。
• 源接口没有快照标识，任务完成表示所选范围已拉取并发布，仍需结合源系统留存范围核对历史完整性。
• 同店铺、订单、MSKU、完全相同买家备注（无备注还须相同退货原因）的明细共享标签和人工审核，不合并明细及件数；缺关键字段时仅绑定当前记录。
• AI/原因映射建议需要人工核对，重跑与轮询不会覆盖人工修改。已保存的审核需点“修改审核”才能编辑；并发冲突保留草稿，核对最新结果后重新载入。

06 操作后验证

• 核对所选店铺、日期、窗口状态与列表记录；不能仅凭总行数判断所有历史范围已经完成。
• 导出后抽查筛选范围和明细；暂停、失败恢复后确认此前成功窗口仍可查询。

07 常见异常处理

• 看不到数据：检查筛选范围、店铺权限和窗口完成状态，再确认源系统是否有该范围记录。
• 同步或补齐失败：先查看错误提示，修复店铺授权或来源问题后续传，避免重复提交同一范围。
• 分析失败：查看备注审核中的具体原因，从打标任务进度进入智能协同任务中心，在“退货备注打标”的详情抽屉中按原配置重试本批失败备注；历史批次在同一业务任务的“任务日志”查看。认证失败需先修复服务配置，证据或标签校验失败可人工审核。原失败批次保留历史，后续批次记录恢复结果。
• 打标一直排队：请确认 Agent Worker 已启动且模型配置可用。标签功能未初始化时需运维完成指定迁移。

08 常见问题