¶ 入口
菜单 → 报价管理 → 转单 API → 找到新智慧对应的转单 API 配置 → 自定义功能 → 报关方式字典映射
¶ 一、功能说明
新智慧转单 API 已支持“报关方式字典映射”。
当新智慧接口要求的报关方式编码，和易抵达系统内的报关方式不一致时，可以在对应的新智慧转单 API 配置里维护映射关系。
系统打单时会按以下优先级处理：
优先查“报关方式字典映射表”
如果当前运单的系统报关方式命中映射，则把配置的“代理字段值”传给新智慧
如果未配置或未命中，则继续走系统原有默认规则
¶ 二、配置步骤
¶ 步骤1、打开新智慧转单 API 配置
在“转单 API”列表中找到客户实际使用的新智慧 API 配置，进入编辑页面。
¶ 步骤2.新增映射
点击“报关方式字典映射”按钮，系统会弹出“报关方式字典映射表”。
点击“新增映射”，逐行填写：
| 系统报关方式 | 选择易抵达系统里的报关方式 | 必填 |
| 代理字段值 |
填写新智慧接口要求接收的值 按数字格式读取，不要传“001”这种带前导零的值 |
必填 |
| 备注 | 用于说明该映射用途 | 选填 |
系统保存时会校验:1.报关方式不能为空、2.代理字段值不能为空、3.同一个报关方式不能重复配置
¶ 步骤3.保存映射和转单 API 配置
填写完成后点击“确定”。如果不想保存本次修改，点击“取消”。
映射弹窗确定后，还需要保存转单 API 配置本身，否则配置不会最终生效。
¶ 三、打单生效逻辑
运单打单时，系统会读取当前运单的报关方式，并按映射表查找对应代理字段值。
例如当前运单报关方式为“9710报关”，映射表配置为：9710报关 → 2
则推送给新智慧时，报关方式字段会传：exportwith = 2
如果当前运单报关方式没有命中映射表，则走系统旧默认映射，避免影响原有新智慧配置
¶ 四、注意事项
- 这个配置只对对应的新智慧转单 API 生效，不是全局配置。
- 运单本身仍选择系统内的报关方式，不要把系统报关方式改成代理编码。
- 不建议用推单前脚本改 $waybill.baoGuanFangShi，因为后端组装新智慧报文时会重新处理报关方式，脚本结果可能被覆盖。
- 如果客户有多个新智慧 API 配置，需要分别维护映射。
- 修改配置后，已打单成功的运单不会自动重推；需要重新打单/重推时，才会按新配置传值。
¶ 五、验证方式
配置完成后，可以用一票测试单验证：
- 运单选择对应报关方式
- 使用配置了映射的新智慧发货渠道打单
- 查看转单 API 请求报文
- 确认新智慧字段 exportwith 是否等于映射后的代理字段值