¶ 优品轨迹接口配置与查询操作指引
本指引适用于需要在易抵达查询优品物流进展的用户。接口配置请由有权限的管理员完成。新版首页可先点击“回到旧版”，再按以下步骤操作。
¶ 一、这个功能能做什么
设置完成后，系统可以用客户单号向优品查询物流进展，并整理为日期、位置和描述，便于查看。
目前支持优品维护的运输节点，以及优品返回的末端承运商节点。例如开船、到港、交付快递、派送和签收，具体以优品实际返回为准。
请特别注意：优品的入库操作记录目前尚未接入展示。“收货中、已收货、已确认、出库中”等记录，如果只存在于优品的入库操作记录里，不会出现在本功能的抓取结果中。这不是按“出库”筛选轨迹，也不能靠修改抓取条件补齐。
¶ 二、使用前准备
- 向优品取得您所用系统的接口域名和 API Key（接口密钥）。两者需对应同一套优品环境。
- 准备一个在优品系统中能查询到的客户单号，并确认易抵达运单的“客户单号”与它一致。
- 由有权限的员工设置“轨迹接口”。没有入口或找不到“优品”时，请联系系统管理员或客服核实开通情况。
¶ 三、配置优品轨迹接口
¶ 第 1 步：打开轨迹接口
点击右上角“菜单”，在“系统设置”区域点击“轨迹接口”。
¶ 第 2 步：选择优品
在“基本”页签的“接口”下拉框中选择“优品”。接口较多时，可在下拉框内输入“优品”查找。
图中编号：①选择“优品”；②进入“参数”；③核对“抓取条件”。
“抓取条件”决定从什么业务阶段开始自动抓取，可按实际业务选择“发货后”“收货后”或“预报后”。它不决定抓取入库还是出库记录，不能补齐当前不支持的入库操作记录。
¶ 第 3 步：填写接口域名
点击“参数”页签，在“优品接口域名”填写优品提供的接口地址。
不要把优品的文档网址或网页登录地址当作接口域名；测试环境、正式环境及上海分公司可能使用不同地址，以优品提供的为准。
¶ 第 4 步：填写接口密钥
在同一页面的“优品 API Key”填写优品系统“API Key 工具”取得的密钥。请勿将真实密钥放入公开文档或发送给无关人员。
图中编号：①接口域名；②接口密钥。
¶ 第 5 步：确认配置
核对域名和密钥无误后，点击弹窗底部“确定”。
¶ 四、为运单设置查询方式
¶ 第 1 步：选中需要查询的运单
在运单列表中勾选目标运单。
¶ 第 2 步：打开轨迹对接设置
点击列表下方的“轨迹对接设置”。
图中编号：①设置查询方式；②需要立即查询时使用。
¶ 第 3 步：选择优品
在“轨迹设置”弹窗的“承运商”中选择“优品”。
¶ 第 4 步：选择客户单号
将“单号类型”设为“客户单号”。
不要仅因为运单上有转单号，就改用“转单号”。本功能按客户单号向优品匹配订单，所选单号必须与优品记录一致。
图中编号：①优品；②客户单号；③保存。
¶ 第 5 步：保存运单设置
核对选择后点击“保存”。
¶ 五、查询并核对结果
¶ 第 1 步：发起查询
选中已设置好的运单，点击列表下方的“立即爬取轨迹”，然后等待系统处理。
自动抓取还受“抓取条件”等设置影响。修改设置后，原有且未变动的运单不会因此自动触发抓取；需要立即检查旧运单时，使用上面的手动入口。
¶ 第 2 步：核对查询单号
确认本次使用的是该运单的客户单号，且在优品系统中能查到同一笔订单。
¶ 第 3 步：核对物流节点
核对返回轨迹的日期、位置和描述。节点可能来自优品自身或末端承运商，不要求两类一定同时返回，也不要求每票返回相同数量。
没有报错不等于一定有轨迹。优品没有返回节点时，仍需检查客户单号、接口配置和优品侧记录。
¶ 六、常见问题
¶ 优品已经收货，为什么这里没有入库轨迹？
当前没有接入优品独立的入库操作记录。如果“收货中、已收货”等状态仅在这组记录中，就不会显示；需要补充开发支持，修改抓取条件不能解决。
¶ 为什么有运输节点，却没有派送或签收节点？
末端节点取决于优品实际返回的数据。先到优品系统核实该单的末端进度是否已经更新，不要仅凭节点缺少就判断系统故障。
¶ 提示“优品未返回客户单号对应的轨迹数据”怎么办？
核对客户单号是否填错、是否属于这套优品账号及接口环境，并在优品系统中查询同一单号。
¶ 提示接口域名或 API Key 未配置怎么办？
请有权限的管理员进入“轨迹接口 → 优品 → 参数”，填写优品提供的接口域名和 API Key，并保存。