快递发发与物流公司合作方案

1. 合作方式

1.1 接口合作

快递发发与物流快递公司之间的合作形式为标准接口对接，包括

1) 网点/业务员信息接口

2) 在线下单接口

3) 电子运单接口（可选）

4) 物流轨迹跟踪查询接口

通过调用接口与物流公司进行交互，以对信息进行更加灵活的处理，帮助企业用户实现快递信息化管理，提升用户体验。快递发发业务流程图如下：

1.2 代收货款合作（可选）

快递发发平台与企业客户签订《服务协议》，收取客户的相关资料，为其提供货款金融服务：

1) 个人商户及散户，提供银行卡信息、身份证资料，快递发发为其提供平台货款直退服

务。

2) 企业商户及大客户，提供银行卡信息、企业三证资料、负责人身份证资料，快递发发

审核通过后为其提供平台货款垫付服务，并根据企业资质情况审核给予相应的垫付额

度。日后将根据客户的发件情况，按标准规则进行额度的控制。

快递发发与合作快递物流公司针对代收货款件的合作方式为：

1)双方签订《合作协议》；2)凡通过快递发发系统对接推送的代收货款快递订单，需

特殊标识；3)订单在快递被签收后Ｔ＋1日12:00前直退至快递发发的企业帐户中。

正常被签收的快件，如非按时放款、无放款或货款差错所产生的客户纠纷，由快递发

发全权负责，与快递物流公司无关。凡因丢件、损坏件、拒收等物流问题导致的客户纠纷的，由快递发发协调客户与物流公司之间处理、合作快递物流需配合处理。合作快递物流公司有权保留一份快递发发与服务客户之间的《服务协议》复件。

1.3电子运单合作（可选）

快递发发可根据快递公司的需求设计电子运单模板或由快递发发直接提供电子运单模板（快递公司需审核接收快递发发平台电子运单的编号规则），还为客户及快递员提供电子运单打印设备，在客户下单时可直接选择电子运单打印，将订单信息同步推送至快递公司系统，免除大量的纸质运单成本，降低纸质运单的浪费，免除网点录单环节，提高发件效率。

快递发发还可根据网点电子运单收件数量，提供给中心与网点电子运单费用的结算服务。电子运单的收费标准由快递公司自行制定并公布网点，快递发发不参与。

2. 合作流程

3. 接口功能需求

3.1 网点信息

网点信息接口是物流公司向快递发发平台提供的内部物流网点基本资料信息的数据接口，包括网点名称、联系电话、经纬度、网点业务员信息等，用于快递发发客户下单选择查询以及下单后订单分发使用。

业务要求：

1、提供快递公司全国范围内的收派件网点及相应的网点信息。

2、快递公司提供所有到与不到地址库，避免用户下单后快递业务无法支撑导致用户投诉。 相关参数：

1、网点信息接口：快递公司、网点名、网点地址（省、市、区、街道、大厦及门牌号）、取件电话、查件电话、收派范围、不收派范围

2、业务员信息接口：员工编号、员工密码、员工姓名、网点编号、网点名称、取件电话、查件电话、收派范围、不收派范围

3.2 在线下单

3.2.1提交订单接口

用户通过网络在线提交订单，上传快递业务需求，同步的调用快递公司的提交订单接口。 业务要求：

（1） 服务区域：下单接口支持全国所有具备收件能力的快递网点。

（2） 响应时效：下单处理时间为2小时内。

3.2.2修改以及撤销订单

修改订单：订单在未揽收成功状态之前，客户可以进行订单基本信息修改

撤销订单：用户在物流公司还未对订单进行受理前，用户填写原因，传递给物流公司。 业务要求：

(1) 修改订单只有在揽收成功状态受理之前才能进行，对于揽收失败、撤销的订单不允许修改，

只有在未受理下允许。

(2) 由于订单状态的同步可能存在不及时性，需双方系统都判断是否在未受理和已受理状态

(3) 订单的当前状态、物流编号不允许修改。

(4) 可允许对同一个订单进行多次修改。

(5) 需要特别注意避免订单修改接口跟业务系统开单后发生修改的并发性问题。

(6) 撤销订单只有在已受理状态之前才能进行。

(7) 采用同步访问接口的方式，应建立多次同步的重试，如果访问过程中发生请求失败，直接

返回错误。

(8) 请求失败后，发邮件给物流公司的接口人，进入异常处理流程。

相关参数：处理结果、订单编号、物流单号、成功与否、失败原因

3.2.3订单状态更新

订单到物流公司之后，会发生很多业务，首先是进行受理，受理成功后上门揽件，再就是

运输、签收，这些业务的变化会伴随着订单或运单状态的变化，为了能够让用户及时的查看到订单的当前状态，快递发发需要通过物流公司接口获取到当前订单的最新状态。

订单状态包括：

1. 未受理 2. 已受理 3. 已撤销 4. 已开单

5. 运输中 6. 已到达 7. 签收成功 8. 签收失败

业务要求：

(1) 物流公司的订单状态发生变化后，每1分钟把状态变更信息同步到数据库，并以SDK向

快递发发开放。

(2) 快递发发系统主动向物流公司系统发出订单通知请求，传递最大的状态变更时间，并通过

物流公司的SDK验证，返回第三方订单状态信息与其它处理结果信息。

(3) 快递发发每次至少可获取物流50个订单的状态

(4) 对于下单后超过20分钟没有收到订单更新的数据，物流公司需传递失败信息以短信或邮

件形式通知快递发发技术或者商务人员。

3.2.4绑定运单接口

根据客户需求把客户提供订单号和运单号添加联系，绑定在一起。

业务要求：运单绑定后，将对应运单号推送给快递公司。

3.3 电子面单接口（可选）

3.3.1电子面单获取接口

快递发发提供单号规则，快递公司授权快递发发运单号可用，快递发发分配给用户使用。需要快递公司能接收快递发发推送过去的电子面单参数。

例如快递发发运单号KD[1**********]001

面单必备信息：

发件人信息：地址，姓名，电话

收件人信息：地址、姓名、电话、运单类型、支付方式、货物名称，总数量，总重量、体积、面单号.

3.3.2发货反馈接口

查询出运单的物流轨迹， 已打印面单上传数据更新。

3.3.3发货修改接口

修改发货面单信息。

3.3.4发货取消接口

取消已打印好的面单。

3.3.5电子面单模板

快递公司提供电子面单打印模板，或适用模板规则由快递发发设计供用户使用。

3.4 物流轨迹跟踪查询

3.4.1轨迹信息查询

查询订单或运单物流轨迹的最新信息：

1、查询接口支持按照运单号查询(物流轨迹、路由信息)。

2、返回的信息包含运单号、物流跟踪信息:

3、返回的物流跟踪信息按照发生的时间顺序排列。

3.4.2订阅推送接口

快递发发以订阅（支持批量）的方式，向快递公司订阅运单轨迹状态，快递公司运单轨迹一旦更新，即时（支持批量）推送给快递发发。

3.4.3运单状态查询

通过查询接口，快递公司向快递发发返回运单配送状态

1、在途中 2

、派件中（派件人及电话）

3、已签收（签收人） 4、问题件（拒收、丢包等原因）

3.4.4运单信息查询

查询快递包裹收件、派件地址【省、市、区】及发货包裹重量验实核对。应用于用户与快递公司对账结算参考。

返回参数：1、包裹重量 2、包裹收件地址 3、包裹派件地址

4. 交互要求

1) 安全性

对于远程交互，安全第一，需要避免数据在传输过程中被篡改，避免接口被其他方调用，保证数据的隔离性。

2) 稳定性

接口交互需要稳定性保证，避免不稳定导致的异常流程发生，对于异常流程有些很难控制，并且很容易对客户产生影响。

3) 可扩展性

物流业务会存在较多的变化，特别是对于增值服务、运输方式、运输范围等，对于可能的变化，接口设计的尽量兼容。

4）数据及时性

订单信息更新通知接口调用要达到准实时，让用户能够及时的了解运单情况。

5）系统升级维护

有关系统的升级需要提前通知接入方技术接口人，提前安排相关配合。