¶ 对接 stoSolution 打单和查价操作指南
stoSolution 可用于两类操作：
- 打单：向代理申请转单号和面单；一票多件时，系统还会接收代理返回的子单号。
- 查价：根据寄件地、收件地、重量、尺寸和产品代码查询预估运费。
本文只介绍易抵达中的设置方法。域名、appKey、appToken、产品代码及网点代码均由代理提供，请勿自行猜测或复制其他接口的参数。
¶ 使用前准备
请先向代理取得以下资料：
- 接口域名；
- appKey；
- appToken；
- 产品代码（productCode）；
- 网点代码（仅打单接口需要，且为选填项）。
建议先在测试机构完成配置和验证，确认查价、转单号及面单均正常后，再用于正式业务。
¶ 进入接口设置
- 登录易抵达员工端。
- 如当前显示新版首页，点击右上角 回到旧版。
- 依次进入 菜单 → 报价 → 报价管理。
- 在页面上方选择：
- 运费API：设置查价接口；
- 转单API：设置打单接口。
¶ 一、设置 stoSolution 查价接口
¶ 1. 新建接口
- 点击 运费API。
- 点击列表下方的 添加。
- 在 基本 页签填写：
- 类型：选择
stoSolution； - 名称：填写便于识别的名称，例如“stoSolution 查价”；
- 指定代理：选择实际合作的代理。
- 类型：选择
完成后，按图 1 的编号依次核对类型、名称和指定代理。
图 1：stoSolution 运费API“基本”页。
¶ 2. 填写接口参数
切换到 参数设置 页签，按代理提供的内容填写：
- 域名：代理提供的接口域名，必填；
- appKey：代理提供，必填；
- appToken：代理提供，必填；
- 产品代码（productCode）：代理提供，必填。
核对无误后点击 确定 保存。
¶ 3. 查询价格
- 进入 菜单 → 报价 → 价格查询。
- 选择 代理 → 运费API查价。
- 选择刚创建的 stoSolution 查价接口。
- 查价方式选择 国家，选择收货国家并填写重量；件数保持默认的 1 件即可。
- 点击 查询，等待系统返回价格。
查询成功后，页面会显示代理返回的费用和币种：
查询时请注意：
- 按国家查价时，收货国家和重量为必填项，重量必须大于 0；
- 省/州、城市、邮编、寄件人信息及单件尺寸无需填写；
- 返回结果以代理实际返回的总价和币种为准。
¶ 二、设置 stoSolution 打单接口
¶ 1. 新建接口
- 返回 报价管理，点击 转单API。
- 点击列表下方的 添加。
- 在 基本 页签填写：
- 模板：选择
stoSolution； - 模板名称：填写便于识别的名称，例如“stoSolution 打单”；
- 其余选项按本机构实际业务要求设置。
- 模板：选择
完成后，按图 2 的编号依次核对模板名称、模板和获取模式。分公司保持默认值即可。
图 2：stoSolution 转单API“基本”页。
¶ 2. 填写接口参数
切换到 参数设置 页签，填写：
- 域名：代理提供的接口域名，必填；
- appKey：代理提供，必填；
- appToken：代理提供，必填；
- 产品代码（productCode）：代理提供，必填；
- 网点代码：代理有提供时填写，未提供可留空。
核对无误后点击 确定 保存。
¶ 3. 绑定渠道并获取转单号
- 打开需要使用 stoSolution 的代理成本报价或渠道。
- 在该报价或渠道的设置中，绑定刚创建的 stoSolution 转单API。
- 回到运单页面，选择一票资料完整的测试运单。
- 点击 获取转单号。
- 成功后检查：
- 运单已取得主转单号；
- 面单可以正常查看或打印；
- 一票多件时，子单号数量与包裹数量一致。
获取成功后，可打开面单进行检查：
¶ 常见问题
¶ 提示参数不能为空
依次检查域名、appKey、appToken 和产品代码是否均已填写；打单接口的网点代码只有代理要求时才填写。
¶ 查价没有结果
请检查寄件地、收件地、邮编、重量及第一件货物的尺寸是否完整，并确认选择的是 stoSolution 查价接口。仍无结果时，把页面提示原文提供给代理或客服排查。
¶ 获取不到转单号或面单
请先确认渠道已绑定正确的 stoSolution 转单API，再核对运单的收寄件信息、重量、件数和申报资料。不要反复点击，以免代理端产生重复订单。
¶ 参数可以与其他接口共用吗
不建议。不同代理、不同环境的域名和密钥可能不同，应以代理本次提供的参数为准。