¶ 大迈未来轨迹收货信息同步操作指南
适用场景：使用 大迈未来 抓取运单轨迹，并希望同时查看代理提供的备注、查验图片及实际收货重量、尺寸。
¶ 一、功能说明
开启本功能后，系统在成功抓取轨迹时，可同步代理返回的以下信息：
- 代理备注：财务备注、收货/操作备注、发货/单证备注会追加到运单原有备注中，不会覆盖已有内容；相同内容不会重复添加。
- 查验图片：代理返回的查验图片会自动保存到对应运单的档案中；已成功保存的图片不会重复新增。
- 实际收货重量和尺寸：系统会同步代理实际收货的单件重量、长、宽、高，并按本机构设置的计量单位换算后写入收货数据。
若代理未返回数据、箱数与系统单件数不一致、计量单位缺失或详情查询失败，系统会跳过该项不可靠数据；正常轨迹抓取不受影响。
¶ 二、使用前准备
- 已配置并可正常使用 大迈未来 轨迹接口。
- 运单应通过大迈未来打单接口创建，并已自动取得代理运单标识。系统查询收货详情时使用运单的 其他单号1；该字段为空时只抓取轨迹，不同步代理收货详情。
- 如需同步重量和尺寸，请先确认系统中的单件数量与代理实际接收箱数一致。
¶ 三、开启同步功能
¶ 第 1 步：进入轨迹接口设置
在系统顶部点击 菜单，选择 轨迹接口，打开轨迹接口配置窗口。
¶ 第 2 步：选择“大迈未来”接口
在接口列表中选择 大迈未来。如贵司尚未配置该接口，请先联系系统管理员完成代理接口授权配置。
¶ 第 3 步：打开参数页
点击配置窗口顶部的 参数 标签。
¶ 第 4 步：按需勾选同步项目
按图示操作：
- 点击 参数。
- 勾选 同步代理备注、查验图片：将代理备注追加到运单，并把查验图片保存至运单档案。
- 勾选 抓取代理重量尺寸：将代理实际收货的单件重量、长、宽、高同步到运单收货信息。
完成后点击 确定 保存。
¶ 四、抓取轨迹
完成配置后，按原有流程抓取轨迹即可：
- 在主页或运单页面选中需要处理的运单。
- 直接点击主页面的 立即爬取轨迹。
也可以继续使用系统已有的自动抓取或批量抓取方式，无需额外操作。
¶ 五、查看同步结果
¶ 1. 查看代理备注
进入运单详情，在备注区域查看代理同步的财务、收货/操作及发货/单证备注。系统以“追加”方式写入，原备注会保留。
¶ 2. 查看查验图片
进入运单详情的 运单档案，查看自动保存的查验图片。
¶ 3. 查看实际收货重量和尺寸
进入运单详情的 收货信息，查看实际收货的单件重量、长、宽、高。
¶ 4. 查看轨迹
在轨迹页面查看轨迹节点。即使代理详情数据未能同步，正常轨迹抓取结果仍会保留。
¶ 六、常见情况说明
| 情况 | 系统处理方式 |
|---|---|
| 未勾选同步项目 | 仅按原有方式抓取轨迹，不同步收货信息。 |
| 运单的“其他单号1”为空 | 不查询代理收货详情，只保留正常轨迹抓取结果。 |
| 代理未返回备注、图片或收货数据 | 不写入空数据。 |
| 同一图片或备注已同步过 | 不重复新增。 |
| 代理箱数与系统单件数不一致 | 跳过重量、尺寸同步，避免错误更新。 |
| 重量或尺寸存在数据，但代理未返回对应计量单位 | 跳过重量、尺寸同步，避免错误换算。 |
| 代理详情查询失败 | 跳过本次收货信息同步，不影响轨迹抓取。 |
¶ 七、使用建议
- 首次使用时，建议先选取一票测试运单验证备注、档案和收货信息。
- 如只需查看原始轨迹，不希望同步代理收货数据，请取消勾选上述两个选项。
- 如发现信息未同步，请依次检查同步选项、运单 其他单号1、代理侧数据、箱数和计量单位。
- 更多轨迹接口文档请查看轨迹服务商接口。