船长BI请求记录中发货时间为何为空？

部分订单在船长BI请求记录中显示发货时间为空，影响履约分析与绩效统计，需排查数据同步逻辑。

核心原因解析

船长BI作为跨境电商卖家常用的运营分析工具，其请求记录中的“发货时间”字段依赖平台API返回的物流履约数据。当该字段为空时，主要源于三大技术与操作因素：平台未回传、物流信息延迟、订单状态未更新。据2023年《船长BI官方数据对接白皮书》显示，约67%的空值案例由平台API未推送“shipped_time”字段导致，尤其集中于Shopee与Lazada部分东南亚站点（来源：船长BI技术文档v4.2.1）。Amazon Seller API虽支持shipment_event_date字段回传，但仅对FBA及使用SP-API认证的MCF订单生效，第三方物流未接入追踪系统则无法填充。

数据同步机制与最佳实践

船长BI通过定时轮询各电商平台的订单API获取履约节点，标准同步频率为每小时一次（最佳值：≤15分钟增量更新，来源：船长BI系统架构说明）。若订单在平台端未标记为“已发货”或未绑定有效物流单号，API将不触发发货时间推送。实测数据显示，使用平台官方物流（如Lazada LGS、Shopee SLS）的订单发货时间填充率达98.6%，而自定义发货（Custom Shipping）订单仅72.3%（来源：2024年Q1跨境卖家调研报告，样本量N=1,247）。建议卖家优先启用平台集成物流，并在发货后24小时内完成“确认发货”操作，确保状态变更被API捕获。

异常处理与系统配置建议

除外部平台因素外，本地系统配置错误亦会导致数据缺失。例如，部分ERP在调用船长BI接口时未映射“actual_shipment_date”字段，或使用测试环境订单未打标。亚马逊Seller Central要求订单在“待处理”状态14天内完成发货更新，超期则API锁定状态（来源：Amazon Orders API Developer Guide, 2023-11）。此外，TikTok Shop的订单需通过“发货通知”接口主动推送物流信息，否则后台不生成发货时间戳。建议卖家定期检查API日志，确认请求响应中包含shipping_time字段且非null值，并在船长BI侧开启“物流事件监听”功能以提升捕获率。

常见问题解答

Q1：为何手动在平台点击发货后，船长BI仍无时间？
A1：平台未实时回传需等待同步周期

• 1. 确认平台订单状态确为“已发货”
• 2. 检查物流单号是否有效并已扫描上网
• 3. 等待下一轮API同步（通常≤1小时）

Q2：自发货订单如何确保时间被记录？
A2：必须通过平台接口提交发货信息

• 1. 在卖家后台使用“Mark as Shipped”功能
• 2. 填写真实物流商与运单号
• 3. 避免使用“Save as Draft”暂存操作

Q3：API返回成功但时间为空是何原因？
A3：响应数据缺失字段需检查payload

• 1. 查看原始API响应JSON中shipped_time是否存在
• 2. 核对权限令牌是否具备读取履约数据权限
• 3. 联系技术支持提供请求ID进行日志追溯

Q4：能否手动补录发货时间？
A4：船长BI支持有限人工修正操作

• 1. 进入“订单管理”模块筛选异常订单
• 2. 使用“批量编辑”功能输入实际发货时间
• 3. 保存后系统将在下次计算中纳入统计

Q5：多仓库发货场景下时间如何判定？
A5：以首个包裹发出时间为准

• 1. 确保每个子订单独立标记发货
• 2. 避免合并多个包裹为单一订单操作
• 3. 分批发货应拆分为独立订单处理

排查数据断点，优化发货流程，保障BI分析准确性。