¶ 对接 OSM 打单接口操作指南
本文用于在易抵达中新增 OSM 转单 API，并获取 OSM 转单号和面单。适合实施、客服及日常操作人员使用。
使用前，请先向 OSM 获取接口地址、APIKey、RatingKey、客户编号、客户密钥、costCenter、MID 等资料。密钥只应保存在系统配置中，不要发到群聊或文档里。
¶ 一、进入转单 API 设置
- 登录易抵达旧版系统。
- 进入 报价管理。
- 点击页面上方的 转单API。
¶ 二、新增 OSM 模板
- 在“报价对接设置”窗口中选择 转单API，点击 添加。
- 填写一个便于识别的模板名称，例如“OSM 打单”。
- “模板”选择 OSM。
- “获取模式”保持 同步。
- 按实际使用范围选择分公司；如需限制报价，也在本页设置。
¶ 三、填写 OSM 参数
切换到 参数设置，按 OSM 提供的资料填写。带“必填”提示的项目不能留空。
常用字段说明：
- 域名：OSM 提供的接口地址。
- APIKey、RatingKey：OSM 提供的接口凭证。
- 客户编号、客户密钥、costCenter：按 OSM 分配的信息填写。
- serviceLevel：可选择 OSM Premium、Priority Mail 或 Ground Advantage；按实际购买的服务选择。
- mailClass：可选择 Parcel Select、Lightweight Parcel、BPM、Marketing Parcel 或 Media Mail。
- OSMDestination：选择 OSM 指定的接收站点。站点选错可能产生计费差异，不能凭经验选择。
- MID：填写 OSM 提供的 MID。
- labelSize：按打印机纸张选择 4X6 或 4X3。
- 签名：按业务需要选择无需签名、需要签名或需要成人签名。
- 是否软包、delcon：按 OSM 业务要求选择；不确定时先向 OSM 确认。
¶ 四、填写发件人信息
切换到 发件人信息，填写真实、完整的发件资料，包括联系人、公司、电话、邮箱、国家简码、省州、城市、地址和邮编等。
注意：
- 国家简码使用两位国家代码，例如美国填写
US。 - 地址、城市、省州和邮编须相互匹配。
- 如勾选“使用运单寄件人”，系统会按运单中的寄件资料传给 OSM；请先确认运单资料完整。
¶ 五、保存并使用
- 检查模板、参数和发件人信息后，点击 确定 保存。
- 将该转单 API 绑定到需要使用的报价或渠道。
- 正常创建运单并补齐收件人、件数、重量、尺寸和申报信息。
- 选中运单，执行 获取转单号。
- 调用成功后，系统会回填 OSM 转单号，并保存 OSM 返回的面单；随后即可打印面单。
¶ 六、常见问题
¶ 1. 提示必填项为空
回到“参数设置”，重点检查域名、APIKey、RatingKey、OSMDestination、MID 和 labelSize，并核对 OSM 要求的客户信息。
¶ 2. 获取转单号失败
依次检查：
- 当前报价或渠道是否已绑定 OSM 转单 API。
- 收件地址、邮编、重量、尺寸和申报信息是否完整。
- OSM 接口资料是否仍有效。
- serviceLevel、mailClass 和 OSMDestination 是否与 OSM 开通的业务一致。
如仍失败，请保留报错时间、系统运单号和报错提示，联系技术支持；不要在群聊中发送 APIKey 或客户密钥。
¶ 3. 费用与预期不一致
优先核对 OSMDestination。系统页面已提示：未使用正确的 OSM 站点可能导致计费差异。