本页说明“极兔海外仓系统对接指南”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 入口
- 菜单-基数数据-仓库-新建仓库
- 海外仓入仓以及出仓（对应系统快进快出、一件代发、中转、退货换标业务）
- 菜单-系统设置-轨迹接口
¶ 功能说明
极兔海外仓数据对接，覆盖SKU创建、入仓管理、出仓运单推送、取消入仓单、取消出仓单等核心业务场景，确保系统信息实时互通，提升海外仓连接性。
¶ 设置虚拟仓仓库
- 进入菜单-基数数据-仓库管理-新建
- 易抵达海外仓和海豚云海外仓对接是通过仓库来对接，需要新建仓库
- 填写仓库的基本参数
| 参数名称 | 说明 |
| 名称 | 自拟，以便后续对接 |
| 类型 | 选择 虚拟仓 |
| 站点 | 选择对应的 仓库站点 |
| 接口 | 选择极兔 |
| 二次获取 | 根据自身业务进行勾选即可 |
2.切换到接口设置tab，填写接口参数信息，并保存
| 参数名称 | 说明 | |
|---|---|---|
| 1 | 域名、签名秘钥key、公司编号、货主编号、仓库编码 | 请咨询代理后填写 |
¶ 入仓单对接
1.创建入仓单，选择刚刚创建的仓库进行预报
¶ 成功效果
- 运单预报成功，有创建sku和创建入仓单报文；推送成功，运单有成功下单日志
1.下单成功日志：
2.创建sku报文：
3.创建入仓单报文：
¶ 仓库同步
- 1.预报后，请联系代理海外仓审核运单并在海外仓上架
- 2.代理操作上架，系统对应入仓单运单状态变更为已上架
¶ 成功效果
仓库同步成功后，有对应报文（需要确认发货后易抵达系统才会同步代理仓库）；
¶ 出仓单对接
1.设置发货渠道虚拟仓，和极兔海外仓进行对接
- 在报价管理页面，设置前要先建立好发货渠道和排货规则。详见/zh/create-cost-price
2.预报选好上述创建的仓库和收货渠道，将自动识别发货渠道的虚拟仓参数进行推送
¶ 成功效果
- 运单预报成功，有创建出仓单报文；推送成功，运单有成功下单日志
1.成功下单日志：
2.创建出仓单报文：
- 操作确认分拣后，查询代理海外仓对应出仓单
¶ 入仓单取消
1.主界面点击对应运单，点击删除按钮（已上架运单不支持删除）
删除运单后易抵达系统运单已经被删除了，所以看不见报文信息，可以咨询代理核查是否取消成功
¶ 出仓单取消
1.主界面点击对应运单，点击删除按钮（已出仓的运单不支持删除）
删除运单后易抵达系统运单已经被删除了，所以看不见报文信息，可以咨询代理核查是否取消成功