应用场景/功能说明/使用流程
应用场景
2、电商平台、自营电商售后退货退款时，买家通过平台直接预约快递员上门揽件，支持在线支付运费；
功能说明
使用流程
| 功能 | 功能描述 | 应用场景 |
|---|---|---|
| 超区校验接口 | 校验该地区是否支持上门取件，以及3天内可支持的上门取件时间段。 | 场景一：寄件人老七，选择从深圳向北极村寄快递，通过超区检验接口，提前了解到深圳寄北极村线上平台没有快递支持。于是选择线下找快递公司寄快递。 |
| 超区校验接口 | 校验该地区是否支持上门取件，以及3天内可支持的上门取件时间段。 | 场景二：寄件人老七，选择从深圳向北京寄快递，通过超区校验接口，通过校验通知了解到，北京两会期间，停止快递。于是老七决定等两会过去再寄快递。 |
| 超区校验接口 | 校验该地区是否支持上门取件，以及3天内可支持的上门取件时间段。 | 场景三：寄件人老七，选择从深圳向广州寄快递，通过超区校验接口，发现是支持的。并根据支持的预约时段9～14.14～19点，选择14～19点进行下单。 |
| 单渠道预估运费接口 | 用于根据客户收寄地址预估运费，仅做参考，不作为最终结算运费。 | 寄件人老七，在客户平台手机端下单上门取件，在填写完成寄收信息和预估重量后，看到手机端提示预估运费10元，于是选择下单。 |
| 多渠道预估运费接口 | 用于根据客户收寄地址、预估重量计算返回预估运费，仅做参考，不作为最终结算运费，当前端展示多个快递公司预估运费时使用此接口 | 寄件人老七，选择客户的手机端进行寄快递，在填写完寄收信息和预估重量后，看到手机端展示的每家快递公司的快递费是不同的，于是选择申通快递进行下单。 |
| 下单接口 | 1、用于创建客户预约快递上门取件订单（以下文中统称为“订单”） 2、客户创建订单成功后（快递鸟已接收到此订单，但未提交到快递公司），快递鸟智能调度向快递公司下单，结果会通过回调类接口把订单状态、快递公司编码、运单号、网点、快递员等信息回推给客户。 | 场景一：移动端APP、公众号、电商等提供的散客寄件下单模块，通过上门取件直接预约快递员上门揽件，支持在线支付运费。 |
| 下单接口 | 1、用于创建客户预约快递上门取件订单（以下文中统称为“订单”） 2、客户创建订单成功后（快递鸟已接收到此订单，但未提交到快递公司），快递鸟智能调度向快递公司下单，结果会通过回调类接口把订单状态、快递公司编码、运单号、网点、快递员等信息回推给客户。 | 场景二：电商平台、自营电商售后退货退款时，买家通过平台直接预约快递员上门揽件，支持在线支付运费。 |
| 下单接口 | 1、用于创建客户预约快递上门取件订单（以下文中统称为“订单”） 2、客户创建订单成功后（快递鸟已接收到此订单，但未提交到快递公司），快递鸟智能调度向快递公司下单，结果会通过回调类接口把订单状态、快递公司编码、运单号、网点、快递员等信息回推给客户。 | 场景三：保价相关 |
| 订单取消接口 | 1、用于取消客户创建的订单 2、已取件状态后的订单无法取消 | 售后场景： 1、寄件人【老七】，在客户电商平台申请售后审核通过后，选择下单上门取件，因各种原因，取消售后业务（同步取消上门取件）。 1、寄件人【老七】，在客户电商平台申请售后审核通过后，选择下单上门取件，因各种原因，取消上门取件，重新下单（上门取件） |
| 订单取消接口 | 1、用于取消客户创建的订单 2、已取件状态后的订单无法取消 | 正向寄件场景： 1、寄件人【老七】，在客户平台选择下单上门取件，因各种原因，取消上门取件，不再寄快递。 |
| 修改订单接口 | 下单成功并且未取件的订单进行基本信息修改，接口调用成功之后，修改结果通过修改订单通知回推给客户 | 场景一：寄件人老七，选择上门取件时间为周六上午9～11点寄件，下单完成后，发现周六上午没时间，于是修改上门取件新的预约时间为周日的13～15点。 快递员最终在周日14点上门揽件。 |
| 修改订单接口 | 下单成功并且未取件的订单进行基本信息修改，接口调用成功之后，修改结果通过修改订单通知回推给客户 | 场景二：寄件人老七，选择上门取件时间为周六上午9～11点从家里寄件，下单完成后，发现物品在公司，于是修改上门取件新的寄件地点。快递员最终在周六11点在公司上门揽件。 |
| 订单信息查询接口 | 用于查询客户创建成功的订单基本信息 | 用户的上门取件订单下单后，用户查看上门取件订单详情。如：寄收地址信息，预约时段、订单最新状态。 |
| 订单状态查询接口 | 此接口用于快递鸟订单状态列表查询，获取最新订单状态。 | 客户订单状态长时间未更新，可用此接口查询最新订单状态信息，作为订单状态更新的一个补偿机制。 |
| 工单类型查询 | 此接口用于获取快递鸟工单类型，提交工单的时候需要根据此类型进行提交。 | 客户在后台或用户端，通过查询工单类型，查看快递鸟支持的工单类型。然后用户选择对应的工单类型进行提交工单。 |
| 工单提交接口 | 此接口用于提交工单，工单处理结果通过推送工单结果接口推回给客户 | 场景一：对接客户有自己的后台工单系统，为便于统一运营管理，于是对接快递鸟工单接口。 |
| 工单提交接口 | 此接口用于提交工单，工单处理结果通过推送工单结果接口推回给客户 | 场景二：客户的用户端提供工单业务，于是对接快递鸟工单接口，让用户直接使用工单。 |
| 工单详情查询接口 | 此接口用于获取快递鸟工单详情 | 寄件人老七，在客户手机端有多个上门取件工单，老七在进入工单列表页，查看所有的上门取件工单。客户调用此接口，快递鸟返回工单列表给到客户，客户在手机端展示给用户老七。老七点开第一个工单，查看工单详情。 |