本文说明物流公司如何完成通途对接，以及使用通途 ERP 的客户如何绑定物流商、配置易抵达抓单并检查订单和面单结果。
¶ 使用前先确认
本文涉及两种操作人，请不要混用账号：
- 物流公司管理员：使用物流公司的通途物流商／开放平台账号，以及易抵达员工账号，完成第 1～3 节。应用和系统公共参数通常由物流公司统一维护，不需要每位客户重复注册。
- 使用通途 ERP 的客户：使用自己的通途 ERP 账号，以及物流公司为自己开通的易抵达客户端账号，完成第 4～6 节。
完整顺序：物流商入驻并发布应用 → 配置公共参数和渠道 → 准备客户账号与客户代码 → 客户在通途绑定物流商 → 客户在易抵达配置抓单 → 验证订单、转单号和面单。
已完成的公共配置不必重复修改。已经对接成功的客户，不要为了套用本文示例而更改原有授权码。
¶ 三类参数不要混淆
- AppKey、AppSecret：从物流公司在通途开放平台创建的应用中获取，填入易抵达的通途公共设置。
- 客户代码／客户授权码：用于识别具体客户。本指引统一使用易抵达客户档案中的【编号】作为客户授权码，并在通途 ERP 和易抵达抓单配置中填写同一个值。不是联系人登录名，也不是物流商编号。
- 渠道名称／渠道代码：通途的【渠道名称】是给客户看的名称；本接入方式下，通途的【渠道代码】用于对应易抵达的【收货渠道名称】。两者不要填反。
本文系统参数与抓单参数配图为当前界面实拍；通途及部分客户档案配图为历史界面示意，已重新裁剪、脱敏。不要照抄图片中的公司资料、客户编号或渠道示例值。
¶ 1. 物流公司：在通途完成物流商入驻和应用发布
¶ 1.1 注册并通过物流商资料审核
- 打开通途物流商注册页面。
- 使用物流公司的手机号码完成注册，身份选择【我是第三方物流】。
- 登录通途物流商平台，进入【个人中心】。
- 按页面要求填写物流商资料并提交审核。
- 等待资料状态显示【审核通过】，再创建应用。
¶ 1.2 创建、发布应用并等待上架
- 进入通途开放平台的【应用管理】。如当前在其他平台，可从页面右上角的平台切换入口进入开放平台。
- 点击【添加应用】。
- 填写应用名称、图片、简介和页面要求的资料。应用名称、公司介绍、标志等使用物流公司自己的信息。
软著材料下载：如通途要求提供易抵达系统的软著材料，可下载下方证书并按页面要求上传；其他资料仍以通途当前审核要求为准。
- 按实际接入资料填写测试地址、回调地址和 IP 白名单。域名使用本物流公司的实际地址，IP 白名单由物流公司管理员按实际对接要求设置。
- 在【接口申请】中勾选物流平台下本对接所需的整组接口，避免漏掉获取包裹、回写处理结果、回写发货信息和渠道相关接口。
- 保存应用资料。
- 发布应用并等待通途审核。
- 确认应用在【已上架】列表中显示后，再继续配置。
注意：物流商资料审核和应用上架审核是两个环节。仅注册成功或仅创建应用，不代表接口已经可以使用。
¶ 1.3 获取应用 AppKey 和 AppSecret
- 在通途开放平台打开【应用管理 → 已上架】。
- 找到本物流公司使用的应用，复制它的【APP Key】。
- 在同一个应用中点击【获取 secret】，按页面要求获取 AppSecret。
- 将两项参数交给负责易抵达系统设置的管理员。
不要把应用 AppKey、AppSecret 填到客户授权码栏，也不要将密钥发到客户群。
¶ 1.4 导入物流渠道
- 登录通途物流商平台。
- 打开【渠道管理】。
- 点击【批量导入】，下载页面提供的导入模板。
- 按模板一行填写一个渠道：
- 【渠道名称】：填写希望在通途 ERP 中展示给客户的名称。
- 【渠道代码】：填写对应的易抵达【收货渠道名称】，保持一致；按本指引的通途渠道要求，使用不含中文的名称。
- 【是否有跟踪号】：按此接入模板填写
1。
- 保存模板并上传到通途。
- 刷新渠道列表，确认渠道已经导入。
例如，易抵达为本次对接准备的收货渠道名称为 TESTCHANNEL001，则通途模板【渠道代码】也填写 TESTCHANNEL001；通途展示用的【渠道名称】可以另取易懂的名称。此值仅为虚构示例。
如果现有收货渠道名称含中文，先由物流公司管理员确认用于本次对接的渠道及名称，再填写模板，不要自行改动正在使用的渠道。还应确认该客户能够使用对应的易抵达收货渠道及报价。
¶ 2. 物流公司：在易抵达填写通途公共参数
操作人：物流公司管理员，使用易抵达员工账号。
- 登录物流公司的易抵达系统。
- 打开【菜单 → 系统参数】。
- 切换到【电商对接】。
- 找到【通途】卡片，点击【设置】。
- 将第 1.3 节获取的通途应用【APP Key】填入【AppKey】。
- 将同一个应用获取的 secret 填入【AppSecret】。
- 点击【通途设置】弹窗中的【确定】。
- 回到【系统参数】弹窗，再点击右下角的【保存】，完成公共参数保存。
这里配置的是物流公司的应用参数，不是某个客户的客户代码。 当前界面不需要照旧文说明从浏览器查找 token。若你的系统仍显示旧版 token 字段，请先联系易抵达服务人员核对版本和参数来源，不要直接把 AppKey 当作 token 填入。
¶ 3. 物流公司：准备客户档案、登录账号和权限
操作人：物流公司管理员。每个需要接入的客户分别检查一次。
¶ 3.1 查找该客户自己的客户代码
- 打开【菜单 → 客户档案】。
- 如果客户档案尚未建立，先按客户档案及客户端账号说明创建；已有档案则直接使用，不要重复新建。
- 双击对应客户档案，打开【基本】页签。
- 查看【编号】并记录。本指引将该值称为“客户代码”。
请核对这是本次接入客户的档案。不要使用其他客户的编号，也不要使用截图中的历史编号。
¶ 3.2 确认客户端账号和权限
- 在该客户档案的【联系人】中确认已有可登录客户端的联系人账号；没有账号时，按上述账号说明开通。
- 打开【菜单 → 角色权限】。
- 选中该联系人账号实际使用的客户角色。
- 检查【外贸授权】及【抓单 API】相关操作权限，按该客户的业务需要开通。
- 保存权限配置，并将客户端登录地址、联系人登录账号和客户代码分别告知客户。密码通过双方约定的私密方式交付。
客户端登录账号用于登录系统；客户代码用于本次通途绑定。两者用途不同，不要互相代替。
¶ 4. 客户：在通途 ERP 绑定物流商和渠道
操作人：使用通途 ERP 的客户，使用自己的通途 ERP 账号。
- 从通途 ERP 入口登录并进入 ERP。
- 打开【基础设置 → 物流设置】。
- 在【第三方物流】中搜索物流公司提供的物流商名称。
- 选择正确的物流商，点击【启用】。如果已经启用，直接打开对应物流商。
- 点击已启用的物流商名称，进入该物流商的 API 配置区域。
- 在物流商用于识别客户的授权参数栏填写第 3.1 节取得的客户代码。该字段名称取决于物流商在通途设置的参数名称，历史界面可能显示为 Token 或客户授权码；这里填写的是客户识别值，不是应用 AppKey、AppSecret。
- 勾选本次需要使用的渠道。
- 点击【保存】。
保存后，还需要完成易抵达抓单配置和订单验证，不能仅凭此处保存成功就判断整个对接已经成功。
¶ 5. 客户：在易抵达客户端配置通途抓单
操作人：使用通途 ERP 的客户，使用物流公司为自己开通的易抵达客户端账号，不是物流公司的通途账号。
- 打开物流公司提供的易抵达登录地址。
- 使用第 3.2 节准备的联系人登录账号和密码登录客户端。
- 打开【抓单接口】，新建一条通途抓单配置。若该入口不可见，先请物流公司检查当前账号的客户角色权限。
- 在【基本】页签选择类型【通途】，填写便于识别的名称。
- 切换到【参数】页签。
- 在【客户授权码】中填写第 3.1 节取得的客户代码，与第 4 节通途 ERP 中填写的客户识别值保持完全一致。
填写示例：若客户代码为虚构值 TEST000001，则通途 ERP 的客户授权参数和易抵达抓单接口的【客户授权码】都填写 TEST000001。不要填写客户名称、联系人登录名或应用密钥。
- 按实际业务设置其余选项：
- 【是否主动获取转单号】：选【是】表示抓单后需要通过收货渠道主动打单；选【否】表示仅抓单，不通过收货渠道主动打单。通途本身返回的转单号和面单仍会保存。
- 【是否走 Y2 业务】：只在物流公司明确采用该业务模式时按约定设置，不要仅因为要接入通途就自行开启。开启后，拉单成功会向通途回传处理成功状态。
- 点击【保存】。
- 在抓单配置列表中确认该配置已启用、处于运行状态。
抓单范围：默认查询近 1 个月、状态为“待上传／待确认”的通途运单，并按客户授权码匹配本客户订单。 不是通途账号里的所有历史订单都会进入易抵达。
如果此前已经成功使用另一组约定的客户授权码，先核对现有两端配置；不要只修改其中一端，也不要直接替换正在使用的值。
¶ 6. 双方配合：用一笔订单验证对接结果
以下是配置后的验证方法。保存成功、抓单成功、获取转单号成功和面单可用，是不同的检查点，应分别确认。
¶ 6.1 在通途提交测试订单
- 客户准备一笔双方约定用于验证的订单。
- 选择第 4 节启用的正确物流商和渠道。
- 将订单提交到通途的物流商下单流程。
- 记录该订单的通途包裹号。抓入易抵达后，该包裹号对应易抵达的【客户单号】，用于双方定位同一笔订单。
提交后还需确认订单属于抓单要求的时间和状态范围，不要将不符合条件的历史订单作为首次验证对象。
¶ 6.2 在易抵达确认订单已经抓入
- 检查该客户通途抓单配置的最近抓取结果；有失败提示时先查看具体原因。
- 打开运单列表，选择【全部】，避免只查看某个状态而漏掉运单。
- 按刚才记录的通途包裹号搜索【客户单号】。
- 检查运单是否属于正确客户，以及收货渠道、收件资料是否对应。
不要把“客户代码”和“客户单号”混为一谈：客户代码识别客户；客户单号定位具体订单。仅搜到该客户的其他运单，不能证明这笔测试订单已经抓入。
¶ 6.3 分别确认转单号和面单
- 如果本次业务需要易抵达主动打单，确认【是否主动获取转单号】已按第 5 节设置，且对应收货渠道具备正确的打单配置。
- 在易抵达检查这笔订单的转单号和面单结果；失败时记录完整错误提示。
- 回到通途 ERP 检查同一订单是否取得预期的转单号和面单。
- 打开或预览面单，核对单号与本笔订单一致。
只有订单进入正确客户和渠道，且本次业务要求的转单号、面单均可正常取得，才算完成该业务场景的对接验证。 如果本次仅验证抓单，请将结论写为“抓单验证通过”，不要同时声称取号和面单验证通过。
¶ 7. 常见问题
¶ 找不到物流商或渠道
先检查物流商名称是否正确、物流商资料与应用是否通过审核，以及渠道是否已导入并启用。不要选择名称相近的其他物流商代替。
¶ 提示接口未授权
检查应用是否已经发布、审核通过并上架，以及是否漏申请本对接需要的接口。物流商资料审核通过不等于应用已经上架。
¶ 提示 AppKey／AppSecret 未配置，或应用鉴权失败
由物流公司管理员核对第 2 节：两项参数是否来自同一个已上架应用，是否先点通途设置的【确定】，再点系统参数的【保存】。不要用客户代码代替应用参数。
¶ 抓单没有报错，但找不到订单
依次检查：抓单配置是否运行 → 订单是否在近 1 个月及待上传／待确认范围内 → 两端客户授权码是否一致 → 通途所选物流商是否正确 → 易抵达是否已切换【全部】并按对应客户单号查找。
¶ 抓到订单，但渠道不对或无法取号
核对通途【渠道代码】与易抵达【收货渠道名称】的对应关系、客户可用报价和渠道打单配置，再检查【是否主动获取转单号】选项。抓单成功不能代替取号成功。
¶ 登录成功，但看不到抓单入口
请物流公司检查当前联系人账号实际所属的客户角色，以及外贸授权和抓单 API 相关权限；不要直接改用其他客户的账号。