非邮推送教程1.13号版本.docx

             非邮接口推送教程

一、对接。 （ 邮局是货代的客户，交货到物流公司 ）

对接非邮需要在华磊系统针对邮局新建一个客户账号密码 ，将 账号密码以及产品 id （能正常获取单号和面单的产品）接收订单的地址： http:// IP /logistics/feiyou/order （ I P 替换成你们自己的服务器 I P ） , 提供给邮局进行对接 。

对接完成后 ， 邮局 会提供一个产品代码，填写在系统里给邮局下单的产品上面。邮局下单就会推送到系统来。

Api对接需要技术在服务器上配置：url、accesskey、A ES _ key 三个信息，由客户找邮局提供。

二 ．推送收货费用、收货重量到邮局：

1 . 非邮 订单操作收货后 ，系统 自动计费 ， 可将费用推送给邮局 ， 需要在系统 费用种类管理里面配置邮局费用代码。费用代码参照邮局对接文档。

2. 推送费用给邮局，财务管理 --- 清单查询 --- 财务清单查询 --- 更多操作 ---- 推送非邮附加费、推送非邮重量。

a. 系统 的费用是外币的，我们会换算成人民币金额推送。

b . 重量 推送的收货计费重、实重、单件材积重。

推送完成，邮局 会通过接口确认费用或者重量。系统会记录确认日志。

三．                推送非邮轨迹：

  非 邮轨迹 支 持手动推送和自动推送两种 情 况。

1. 手动推送：

1）手动推送非邮轨迹需要影射好轨迹模板： MailTrajectoryMapping .xlsx 保存在TMS目录下，模板名称不能改动。

单个渠道影射时， s heet的名字用系统 里的渠道名称命名；
有多个渠道轨迹映射内容是一样的，可以使用公共sheet表，sheet命名为CommonFYTrackMapping    

当订单的渠道名称在excel里面找不到对应的sheet时，就会取CommonFYTrackMapping这个sheet表里的影射信息。

2） 轨迹 影射可支持精准匹配和模糊匹配（匹配在不同的列），

精准匹配 ：模板的追踪信息必须和系统的轨迹内容一致，

模糊匹配 ： 只填写轨迹关键字，系统的轨迹内容包含模板的追踪信息，就会推送这条轨迹。

模板中的状态代码必填，说明 — 英文和说明列填其一，轨迹城市不能空。

3)      手动推送，如图在轨迹查询界面搜索出需要推送的单号勾选推送 .

2 . 自运推轨迹 ：

1 ）自动推送需要先到系统设置 --- 基础数据维护 --- 轨迹推送规则界面

新建推送规则：

规则名称： 自定义

频率 ： 指隔多少分钟推送一次。（程序每次推送 5 00 条信息，建议频率设为 1 0 分钟）

出货时间 ： 出货时间指的是推送这个时间段之后的出货订单。

单号类型 ： 订单号、转单号、渠道转单号、内部单号，邮局的跟踪单号对应在系统的哪个单号，这里就选择哪个单号推送轨迹。

产品名称 ： 订单收货的产品。

渠道名称： 对应订单出货的渠道名称。（必填）

客户名称 ： 推送订单号所属的客户，选择之后只推送该客户的单。

保存以上规则之后，在下面列表找到平台接口， 配置：url、accesskey、A ES _ key 三个信息， （邮局提供）

填写完整保存、关掉界面 ，搜索出设置的规则，操作 启用 规则 。

2 ）打开系统设置—基础数据维护—轨迹影射关系界面，新建轨迹影射关系

红色框为必填项

出货渠道： 选择需要推送轨迹 的渠道。 （必填）

国家： 填轨迹发生的国家（如果不填，则取订单的收件国家）

轨迹 发生地点： 填轨迹发生的城市。（不填就取系统里轨迹的发生城市）

原轨迹 内容： 填系统里显示的整条轨迹信息（必须完整复制系统的轨迹内容填写，包括符号）。 （必填）

推送的轨迹 代码： 填邮局文档里对应的轨迹代码。（非必填）

推送的轨迹 内容： 填推送到邮局的轨迹内容。 （必填）

模糊轨迹内容： 填轨迹 关键词，系统轨迹里包含了这个关键词的，就会推送。

推送轨迹 的状态码： 填邮局文档里对应的轨迹代码。 （必填）

轨迹影射关系这里，每一条需要推送的轨迹 都要单独设置影射。全部设置好以后，系统搜索到符合条件的轨迹就会自动推送。

3) . 系统 还可以支持批量导入轨迹映射关系。

在批量导入界面下载模板，把每一条需要推送的轨迹内容填写在模板上。具体填写规则同手动添加界面一致。参见 第 2 ) 条 。填写完模板，点击浏览读取模板进来，保存。