本页说明“创建佐川打单接口”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
## 入口
菜单-报价管理-转单API
¶ 功能说明
- 如果您还不熟悉怎么创建一个打单接口，请先参阅 绑定转单号自动获取接口。
- 日本佐川的官网为： https://www.e-service.sagawa-exp.co.jp/, 你必须有官网账号，并熟悉在官网打单的操作，并且曾经成功在官网打过单。
- 如果您还不熟悉怎么打单，请先参阅 打单。
¶ 操作流程
1、菜单-报价管理，进行报价列表页面
- 点击转单 API点新建
新建转单API
- 模版选取
选择模板
- 参数设置，输入登录佐川官网的用户名和密码
参数设置，输入登录佐川官网的用户名和密码
2、点击自定义功能，填写相关信息；
在自定义包裹描述内：设置公式（可以将客户单号、sku*数量 …等信息，推送至佐川包裹描述）
公式：T(com.alibaba.fastjson.JSON).toJSONString(T(com.itdida.core.utils.CollUtil).unionObjects(@shenBaoXinXiService.toStringList(shenBaoXinXiList, 'shuLiang + " x " + sku'), keHuDanHao))
在【自定义包裹描述】 设置好公式，这样可以将 【客户单号】 和 【SKU * 数量】推至佐川的包裹描述。
3、建立打单接口之后，使用打单接口进行打单，如果设置无误，将会出佐川面单。
- 如果您还不熟悉怎么打单，请先参阅 打单。
