核心功能
ShipStation Order Monitor 是一款面向跨境电商卖家的订单监控工具，支持聚合 Amazon、Etsy、Shopify、TikTok 等多平台订单，实现自动化状态追踪与异常预警。
显著优点
- 多平台聚合：统一管理来自多个电商平台的订单，避免频繁切换后台
- 智能告警机制：自动识别"awaiting_shipment"状态超过48小时的滞留订单、支付验证中的hold订单
- 状态去重：通过
state.json记录已处理订单ID，防止重复告警 - 轻量部署：单Node.js脚本，无需额外依赖，支持crontab或agent心跳集成
- 灵活定制：可调整时间窗口（默认24h）、滞留阈值（默认48h），支持高价值订单等自定义规则
潜在局限
- API版本依赖：使用ShipStation Legacy API V1，未来可能被弃用
- 速率限制：40请求/分钟，高频监控场景需控制检查频率
- 单点状态存储：
state.json本地文件存储，多实例部署需自行解决状态同步 - 无内置通知通道：仅输出JSON结果，需自行集成邮件/短信/Slack等通知
适合人群
- 日均订单量50-5000的中小跨境电商卖家
- 使用ShipStation作为物流中枢的多平台运营团队
- 需要自动化监控但不愿采购昂贵SaaS的精益运营者
常规风险
- 凭证泄露：API Key/Secret明文存储于
.env，需确保.gitignore配置及文件权限 - API配额耗尽：错误配置导致高频请求触发429限流，影响正常业务操作
- 数据漂移：依赖
modifyDateStart筛选，若订单在ShipStation侧未被标记为修改可能漏检 - 单文件依赖：
check-orders.js与state.json耦合紧密，误删状态文件将导致大量重复告警