feat(t224): add incremental freight sync

2026-07-29 00:26:05 +08:00
parent 433db45100
commit c69879650e
35 changed files with 2085 additions and 156 deletions
@@ -1,7 +1,8 @@
 # 顺运宝 ERP Connector

-内部只读适配器：保持顺运宝验证码/Cookie 会话，按完整单号查询货运列表和详情，
-再输出不含收件人、电话、地址、Cookie、JWT 或原始响应的规范化 JSON。
+内部只读适配器：保持顺运宝验证码/Cookie 会话，按完整单号或最多 7 个自然日的
+创建日期闭区间查询货运列表和详情，再输出不含收件人、电话、地址、Cookie、JWT
+或原始响应的规范化 JSON。

 协议客户端基于同一开发机上已经用本地 HAR 验证的 `shunyunbaoerp 0.1.0` 代码收敛；
 本目录不包含 HAR、真实响应、账号、密码或订单号。
@@ -40,7 +41,17 @@ $env:SHUNYUNBAO_SERVICE_API_KEY = "at-least-32-utf8-bytes"
 3. 调用 `POST /v1/freight/query`：

   ```json
-   {"order_number":"完整单号"}
+   {"mode":"ORDER_NUMBER","order_number":"完整单号"}
+   ```
+
+   日期查询严格使用 Asia/Shanghai 的 `YYYY-MM-DD`：
+
+   ```json
+   {
+     "mode":"CREATED_RANGE",
+     "created_from":"2026-07-22",
+     "created_to":"2026-07-28"
+   }
   ```

 Connector 不自动 OCR 绕过验证码。服务重启或 ERP 会话过期后需重新执行前两步。