社区论坛
交流工具使用、配置与问题一、功能名称
箱唛仓单下载（feature_id：label_downloader）
按出厂日期批量调用 API 或本地规则下载箱唛、入仓单 PDF。
二、实现逻辑
- 入口：
LabelDownloaderDialog - 配置：
configs/api/label_downloader_config.json - 从数据库取货件列表，逐票请求面单接口或生成下载任务
三、数据 / 字段 / 配置支撑
label_downloader_config.json：物流商、保存路径、命名规则数据库.xlsx → 备货物流信息：货件号、出厂日期、物流商
四、使用教程
- 配置 label_downloader_config.json 中的 API 与输出目录。
- 选择出厂日期范围。
- 批量下载，检查 output 中 PDF 是否齐全。
- 缺失项回到 API 下单或物流商后台补打。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 提示「请先勾选至少一行货件」/「勾选行无有效货件号」 | 在列表中勾选含有效货件号的行。 |
| 「均未对接标签 API」 | 确认货件对应物流商已在 api_config.json → api_enabled_logistics 中启用。 |
| 「勾选中包含皓鹏货件：请填写 ACCESS_TOKEN」 | 在界面或配置文件中填写皓鹏 API Token。 |
| 提示「请选择或填写输出文件夹」 | 指定有效的 PDF 保存目录。 |
| 「超时时间必须大于 0」 | 在界面设置合理的下载超时秒数。 |
| 「labels-pod 未返回…」（集浩） | 确认该货件已在集浩完成入仓下单；未下单无法下载面单。 |
| 「base64 解码失败」/ HTTP 下载失败 | 检查网络连接；重试或联系物流商确认面单是否已生成。 |
| 批量下载部分缺失 | 查看日志逐票原因；缺失项回到「API 下单」补单或在物流商后台补打。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复