社区论坛
交流工具使用、配置与问题一、功能名称
API 下单（feature_id：api_order）
从数据库组装货件数据，调用皓鹏、德立迅、集浩壹起拼等物流商 API 创建运单。
二、实现逻辑
- 入口：
dialogs/api_order_dialog.py → ApiOrderDialog - 读取
configs/api/api_config.json及各物流商*_api_config.json - 字段映射：数据库列 → API JSON 请求体
- 需联网；返回运单号/面单 URL 或本地模板二次生成
三、数据 / 字段 / 配置支撑
configs/api/api_config.json：国家码映射、能力开关haopeng_api_config.json、delixun_api_config.json、jihaoyiqipin_api_config.json数据库.xlsx全业务表- 账号 Token/密钥通常在 API 配置或环境变量（勿提交 Git）
四、使用教程
- 确认 API 配置中账号、endpoint 正确且已联网。
- 打开 API 下单，选择物流商与货件/合同。
- 预览请求 JSON，确认收件人、品名、件数。
- 提交下单，保存返回的运单号与面单。
- 不同物流商支持能力不同，以各 JSON 注释为准。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 「数据库未加载」或缺少出厂时间/货件号列 | 确认 数据库.xlsx 已加载且「备货物流信息」含必需列。 |
| 提示「请先在列表中选择至少一个货件号」 | 勾选至少一行货件后再提交。 |
| 「物流商字段不唯一」 | 同一货件行只能对应一个物流商；修正数据库后重试。 |
| 「未接入执行器：{provider}」 | 在 configs/api/api_config.json → api_enabled_logistics 中启用该物流商，并配置对应 *_api_config.json。 |
| 皓鹏「未配置 ACCESS_TOKEN」 | 在 configs/api/haopeng_api_config.json 填写有效 Token。 |
| 德立迅「无法获取发票数据」 | 先用发票 V2 确认该货件数据完整；API 从发票服务组装请求体。 |
| 「refNum is Exist」（德立迅重复下单） | 该参考号已存在；在物流商后台作废原单后再提交。 |
| 集浩「shippingMark 不能为空」/「唛头重复/已在集浩创建」 | 确认货件唛头字段已填；重复唛头需先作废已有订单。 |
| HTTP 请求失败 / 接口返回非 JSON | 检查网络连接、endpoint 地址及 API 账号是否有效。 |
| 「未生成任何有效 Product 行」 | 产品数据库缺 SKU 或申报信息；补全后重新预览请求 JSON。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复