本页说明“对接Shopee 的操作指南”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 系统参数绑定
¶ 入口
菜单—系统参数—其他—Shopee设置
¶ 操作流程
1、在系统参数—其他—对接模块
- 点击 Shopee设置— 填入参数
| 参数名称 | 说明 |
| Account | Shopee 平台申请的账户 |
| AppSecret | Shopee提供的密钥 |
| 客户联系人登录账号 | 易抵达客户账号 |
| 默认收货渠道公式 | 易抵达收货渠道名称 |
¶ 二、运单回传接口操作流程
¶ 入口
1、菜单—报价管理页面-点击转单API—切换至运单回传接口—添加 —填入参数
| 参数名称 | 说明 |
| API名称 | 选择Shopee干线 |
| 模板名称 | 自定义模板名称 |
| 请求地址 | 咨询平台方 |
| version | 咨询平台方 |
| Account、AppSecret | 咨询平台方 |
| departureRegion（离开区域） | 启运国家二字代码 |
| ccBrokerName（报关代理名） | 报关代理名 |
| ccPortCode（报关口岸代码） | 报关口岸代码 |
2、双击需要绑定的代理成本
- 切换至基本，找到代理成本，绑定建好的运单回传接口
¶ 三，轨迹回传接口操作流程
¶ 入口
菜单-报价管理
1、点击转单API—切换至轨迹回传接口—添加 —填入参数
| 参数名称 | 说明 |
| API名称 | 选择shopee |
| 模板名称 | 自定义模板名称 |
| 回传类型 | 客户单号 |
| 请求地址 | 回传给shopee的地址 |
| Account、SecretKey | 咨询平台方 |
| version(路径版本) | 咨询平台方 |
| 回传轨迹描述 | 根据需要回传的轨迹填公式(找客服处理) |
3、双击需要绑定的代理成本
- 切换至基本，找到代理成本，绑定建好的轨迹回传接口
¶ 四，客户档案设置
¶ 入口
菜单-客户档案
¶ 操作流程
1.双击客户—点开详情
- 禁用API下单时的参数检查：选择是
- API下单根据客户单号做幂等：选择是
¶ 五，更多说明
¶ Q1: 运输配载预报，以包的维度推送过来，
A1:其shopee大箱号存放在易抵达其他单号1字段上
¶ Q2：清关信息预报，以运单的维度推送过来
- 小包号-> 客户单号
- 大箱号-> 其他单号1
¶ Q3 F300节点回传
- 该回传是以快递维度进行的回传，需添加轨迹描述及收货地点
- 轨迹描述：揽收
- 地点：根据收货仓库的位置填写
¶ Q4：配载预报信息回传
回传方式：空运 -> 轨迹 -> Carton装载信息回传
- 该回传是以空运提单维度进行的回传
- 需回传：提单号、航空公司、起飞地、目的地、航班号、预计起飞时间、预计到港时间、提单重量、关区代码、代理计费重
¶ Q5： 大包报关回传
回传方式：空运 -> 轨迹 -> 大包报关回传
- 该回传是以空运提单维度进行的回传
- 回传节点： F339
- 轨迹描述：出口清关完成
- 地点：根据报关口岸的位置填写
¶ Q6： F341节点回传
回传方式：空运 -> 轨迹
该回传是以空运提单维度进行的回传
- 轨迹描述： 空运起飞
- 地点：根据起飞的位置填写
¶ Q7：F360节点回传
该回传是以空运提单维度进行的回传
- 轨迹描述： 空运抵达
- 地点：根据抵达的位置填写
¶ Q9： 退件
A1 ：1个大箱内只装有1个小包裹的情况下
- 需要从提单做解绑（空运做移除）不用回传节点直接线下退给仓库即可
A2 ：一个箱内装有多个包裹的情况下
- 需要从提单做解绑（空运做移除）后，再快递业务做解绑即可
¶ Q10： 异常件
该回传是以快递维度进行的回传
- 回传节点：F418
- 时间：根据异常件的实际产生时间填写
- 轨迹描述：详细描述放在虾皮G sheet可操作粘贴
- 地点：根据异常件所在的位置填写
