配置完成后,操作人员可在运单获取转单号且资料完整后,手动执行运单回传,将订单信息推送至FOMS系统。
登录易抵达系统,通过菜单路径进入配置页面:
菜单路径:菜单 → 报价管理→ 转单API/运费API→ 运单回传接口

1. 在报价管理页面,切换至【运费 API/转单API】标签页,点击【运单回传】;
2. 点击「添加」按钮,新建运单回传配置项。
3. 在弹窗「编辑设置」下拉选项中,选中【FOMS】;
4. 自定义填写模板名称(便于后续区分识别),完成基础模板创建。
| 参数名称 | 说明 |
| 模板名称 | 自定义命名,用于后续模板检索识别 |
| API名称 | 固定选择:FOMS |

注意:
1. FOMS用户名,FOMS密码这两个是对方开放的登录账号。只有客户才可以提供。
2.仓库编号和物流商编码由 FOMS/客户侧提供,根据客户需要推送的仓库填写。
3. 回传事件选择手动即可。
绑定规则:仅将FOMS绑定至代理成本类型报价后,订单选用该报价操作运单回传时,系统才会调用FOMS接口将订单信息回传给FOMS系统。
1. 在报价列表筛选【类型 = 代理成本】,双击打开需要配置的目标代理成本报价;
2. 在报价详情页,切换标签至【基本】;
3. 在运单回传模板下拉框,选中已配置完成的FOMS 运单回传模板;
4. 点击【确认】,完成报价与FOMS 运单回传接口的绑定关系。

回传前请先确认该运单使用的报价已绑定“FOMS”运单回传接口,确认无误后,勾选该运单,点击转单回传,系统会将运单信息提交至FOMS。
注意:操作回传前,请确保订单信息无误。
回传的内容:运单必须有客户单号
运单必须有申报币种
运单必须有申报明细
申报明细里 SKU、单价、数量要完整
寄件人公司/姓名/地址/城市/国家/电话/邮箱,以及收件人姓名/地址/城市/国家/电话等关键字段要完整

订单推送成功后,可在对应运单的查看文件-运单回传报文,中查看本次推送FOMS的请求与响应结果。如 FOMS返回业务码 200/201/202 ,系统认为本次订单推送成功。

其次,对方收到我们推送的信息后,会在封包订舱后回传主提单号,大包号和订单状态信息。
需注意:对方回传给我们时需要FOMS系统方设置回传接口:https://<机构域名>/itdida-api/open/foms/order/status
机构域名:由易抵达客服提供
配置回调地址需要由FOMS IT配置
需要先由实施/运维开启 FOMS 回调配置开关
到系统参数生成 FOMS 专用 appKey
提供给 FOMS:机构回调地址 + 请求头 appKey
FOMS 回调时需要在请求头传 appKey,appKey 由易抵达客服/实施在系统参数的 FOMS订单状态回调接口中生成后提供。
FOMS 回调成功后,系统会将 mawb_number、outerbox_number、status 写入运单配货信息。

