当某个承运商或代理接口需要额外参数、特殊规则或字段转换时,使用这类设置文档。
- 确认该设置只适用于指定接口、渠道或代理,避免影响其它渠道。
- 准备一票能覆盖该规则的测试运单。
- 如果涉及报关、带电、保险费、客户单号或重量,先确认代理要求的字段格式。
- 进入对应打单接口、成本价或系统参数页面。
- 按文档说明填写额外参数或开启对应开关。
- 保存后用测试单重新打单或查价。
- 检查接口日志和返回结果,确认字段已经按要求传给代理。
- 确认无误后,再应用到日常业务。
测试结果应体现该特殊设置,例如标签展示客户单号、带电字段传递成功、报关方式转换正确或保险费返回正常。
哲盟 OIS 打单接口针对跨境物流场景,为寄往美国、通过联邦(FEDEX)渠道运输的鞋子类货物提供合规打单支持。系统要求必须上传鞋证文件后,方可完成打单操作,确保货物符合联邦渠道运输规范及美国海关进口相关要求
- 货物类型:鞋子类(含各类鞋履制品)
- 寄达国家:美国
- 物流渠道:联邦(FEDEX)渠道
- 操作场景:通过哲盟 OIS 打单接口提交打单请求
1.登录系统,点击右上角【菜单】,在下拉列表中选择【报价管理】。
2,在报价列表中,双击对应联邦(FEDEX)打单渠道的成本价,进入渠道参数设置界面
- 切换至【转单 API 设置】标签页,在【转单 API 模板】中选择对应打单模板,点击【编辑设置】。
- 在参数配置区域,找到【OTHER 文件来源】,选择「运单文件类型」;【OTHER 对应运单文件类型】选择「其他」,完成配置后保存。
- 进入运单列表页面,双击需要上传鞋证的目标运单,打开运单详情页。
- 切换至【文件】标签页,点击【上传】按钮,唤起文件上传弹窗。
- 在文件类型选项中,勾选【其他】,点击【选择档案】。
- 在本地文件窗口中,选中对应鞋证文件(支持 PDF 等合规格式),点击【打开 (O)】。
- 确认文件信息无误后,点击【确定】,完成鞋证上传。
运单上传鞋证后,使用哲盟 OIS 接口发起打单请求,若配置无误、打单成功,可在报文详情中验证:
- 打单请求报文将包含鞋证文件信息,
annexFiles节点中会显示上传的鞋证文件名、文件路径,annexBusinessType为OTHER;
- 系统返回「请求成功」,代表鞋证已随打单请求正常提交,打单流程完成。