¶ 功能说明
本功能支持通过易抵达集团版轨迹接口，在执行运单轨迹抓取操作时，自动获取对应运单的实际收货重量与尺寸信息，并将数据按规则同步回填至当前运单的发货数据中。
系统可同步抓取并回填的字段包括：
- 单件明细发货数据：实重、长、宽、高
- 运单级：发货实重（由代理返回的
receiveWeight字段控制）
功能启用后，系统将以易抵达集团版接口返回的真实收货数据为准，按规则覆盖运单中原有的发货重量、尺寸信息，确保后续计费、数据核对环节的数据源准确一致。
¶ 核心处理规则
- 触发条件：仅在执行运单轨迹抓取操作时触发数据回填，开启功能后不会立即自动回填，也不支持独立的手动同步动作。
- 单件明细处理：
- 系统不会自动新增单件明细；仅当本系统运单已有单件明细时，按代理接口返回的
pcsList顺序逐件覆盖对应单件的重量尺寸。 - 代理返回件数超过本系统已有件数的部分会被忽略，不会新增单件。
- 系统不会自动新增单件明细；仅当本系统运单已有单件明细时，按代理接口返回的
- 无效数据过滤：当代理返回的单件
weight/length/width/height为空值或≤0 时，系统会保留运单 / 单件的原有数据，不会执行覆盖操作。 - 单号匹配规则：系统优先使用本系统运单的转单号查询代理运单明细；若转单号为空，则使用轨迹抓取传入的单号进行查询匹配。
- 运单级实重更新：
- 单件明细数据回填后，系统会按发货口径重算运单级数据。
- 当代理接口返回
receiveWeight字段时，该字段会覆盖运单的发货实重，但仅在单件明细数据发生变化时才会触发保存逻辑；若代理仅返回receiveWeight，但pcsList为空或单件长宽高 / 重量无变化，则receiveWeight不会单独触发保存。
¶ 适用场景
适用于需要以代理方 / 易抵达集团版系统中的实际收货数据为基准，同步更新本系统运单发货数据的业务场景，尤其适合以下业务需求：
- 以代理实际称重数据作为最终计费依据
- 多系统间运单数据的一致性核对
- 批量运单的重量、尺寸信息自动化同步
¶ 前置使用条件
使用本功能前，需确认已满足以下全部前提：
- 发货渠道已完成易抵达集团版轨迹接口的配置
- 当前操作账号拥有「轨迹接口」模块的操作权限
- 对应运单已在易抵达集团版系统完成收货操作，可查询到对应的重量、尺寸数据
¶ 操作步骤
第一步：进入轨迹接口配置页面
- 登录系统，在菜单栏找到并点击【轨迹接口】，进入轨迹接口配置页面。
- 在接口列表中，找到并选中已配置的「易抵达集团版」轨迹接口，打开接口配置弹窗。
第二步：开启「抓取代理重量尺寸」功能
- 在接口配置弹窗中，切换至【参数】标签页。
- 在参数列表中，勾选「抓取代理重量尺寸」选项。
- 确认配置无误后，点击弹窗右下角的【确定】按钮，保存配置。
✅ 配置生效说明：开启后，系统在执行运单轨迹抓取操作时，将自动同步调用易抵达集团版接口，获取对应运单的实际收货重量与尺寸信息。
第三步：执行运单轨迹抓取
接口功能开启后，系统将在运单轨迹抓取时自动发起数据拉取，无需人工手动操作。完成数据获取后，系统将按接口返回的单件明细，逐件同步实重、长宽高信息至对应运单的单件明细中，同时在系统日志自动留存数据变更记录。
可进入运单「日志」标签页，查看操作记录：
- 成功记录将显示「已同步代理发货实重、长、宽、高」，同时标注实重变更前后的数值。
- 一票一件与一票多件运单均会生成对应日志，可用于数据追溯与核对。
- 异常失败记录将显示「抓取代理重量尺寸」相关的失败原因（如转单号为空、接口未返回匹配运单等），便于问题排查。
一票一件运单日志
一票多件运单日志
¶ 查看回填结果
抓取成功后，可在运单「单件明细」标签页中查看回填后的发货数据：
- 系统会将抓取到的重量、尺寸信息，直接覆盖到运单发货数据中。
- 一票一件运单：单件明细的重量尺寸数据会直接覆盖，运单级数据由系统发货口径重算；代理返回
receiveWeight时会覆盖运单发货实重（需满足单件明细发生变化才会触发保存）。 - 一票多件运单：系统将按接口返回的单件明细，逐件同步更新对应单件的实重、长、宽、高数据，运单级数据由系统发货口径重算。
一票一件回填后的发货数据
一票多件回填后的发货数据
