本页说明“对接顺丰GTS操作指引”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 运单回传
¶ 入口
- 代理系统：获取appKey、appSecret、AES密钥、来源系统编码、代理标识
- 易抵达系统：在菜单-报价管理-运单回传-顺丰速运
¶ 操作流程
1、创建运单回传接口
- 进入报价管理-转单API界面，切换至运单回传页面，点击新建
- 类型搜索顺丰速运
- 填写参数
| 参数名称 | 备注 |
| 模板名称 | 自拟，以便后续对接时查找 |
| 域名 | 咨询代理获取 |
| app Key | |
| app Secret | |
| AES密钥 | |
| 来源系统编码 | |
| 代理标识 | |
| 代理单号选择 | 根据自身业务进行选择。 选啥回传啥，无值也会正常回传请求 |
| 回传触发事件 | 根据自身业务进行选择。控制什么时候触发自动回传，不管选哪个都能进行手动回传 |
| 脚本 | 如有特殊需求，可咨询对应客服获取 |
2、找到需要配置的代理报价，双击进入编辑
- 切换至基本tab
- 找到运单回传字段，选择新建的顺丰速运接口进行配置
3、回到主列表，确认运单信息后
- 操作运单回传
¶ 成功效果
推送成功提示
推送失败提示
turbo not success, ADES数据校验失败[ADES Data Validation Failed]: 数据不存在[data not exist]
¶ 轨迹回传
¶ 入口
- 代理系统：获取系统应用标识，签名Token
- 易抵达系统：在菜单-报价管理-轨迹回传-顺丰GTS
¶ 操作流程
1、创建轨迹回传接口
- 进入报价管理-转单API界面，切换至轨迹回传页面，点击新建
- 类型搜索顺丰GTS
- 填写参数
| 参数名称 | 备注 |
| 模板名称 | 自拟，以便后续对接时查找 |
| 地址 | 输入：https://ibu-gts.sf-express.com |
| 系统应用表示 | 咨询代理获取 |
| 签名token | 咨询代理获取 |
| 主单号类型 | 根据自身业务进行选择。tips： 请和回传单号类型选择框 配合使用 |
| 匹配回传 | 通过条件匹配的轨迹才能进行回传，同时携带匹配回传后面的参数，可写多条 |
| 默认回传 | 针对未通过匹配回传的轨迹，进行默认回传，过滤条件可以过滤不需要默认回传的轨迹，同样可以携带后面的参数，只能写一条 |
2、找到需要配置的代理报价，双击进入编辑
- 切换至基本tab
- 找到轨迹回传字段，选择新建的顺丰GTS接口进行配置渠道配置回传
3、轨迹将自动推送，过一段时间查看运单轨迹即可
- 支持手动手动推送，选中对应运单，点击重推轨迹等待片刻，查看推送失败轨迹即可
¶ 推送效果
- 点击推送失败轨迹，则可以看到轨迹推送结果
