"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

快递单号查询 / 物流跟踪

这里有两种使用场景,首先你要做下区分,明确你需要的业务是属于哪一种业务场景,继而找到相应的解决方案,更好的解决并满足你的需求:


  1. 你的订单是使用的 “api工厂” 的订单体系,也就是说你是使用的  “api工厂” 的创建订单接口创建的订单。那么这种情况下, “api工厂” 自带物流跟踪功能的,用户下单以后,后台填写快递单号发货后,系统自动为你进行物流跟踪。
  2. 你仅仅是需要一个通过快递单号查询快递信息的接口,或者说你希望为你现有的系统寻求这么一个查询接口。


以上两种场景,均需要开通并购买快递查询服务:

左侧菜单,工厂设置,模块管理,搜索 “快递”,启用以后,点击购买套餐购买即可

场景一:


管理员在后台订单详情中,点击 “发货” 按钮,选择快递公司并且填写快递单号,之后系统自动启用物流跟踪功能。


前端接口 “订单详情接口” ,会返回当前订单的快递(物流)跟踪信息,你可以将此信息在你的 网页/小程序/android/ios 前端程序中进行展示,方便用户实时了解快递情况。


后台发货填写了快递单,为什么没有快递物流数据?


“api工厂” 的物流跟踪信息是采用的 “订阅 --> 通知” 方式采集的

您在后台发货填写了快递单号,我们会将你的这个快递单向上游快递信息中心订阅快递轨迹当快递状态发生变化的时候,信息中心会推送最新的快递数据给 “api工厂” ;

也就是说,如果快递状态没有改变, api工厂 将接收不到快递的推送信息,快递轨迹数据也就不会更新;


所以,如果您是以下几种情况中的任意一种,将看不到快递信息更新:


  1. 刚刚填写快递单号,没有数据 (快递状态改变需要一些时间,请给点耐心)
  2. 填写的错误的快递单号(这个没的说,肯定不行)
  3. 填写了已经签收的快递单(单子都签收了,结束了!状态不会再变了!“api工厂” 再也接收不到快递数据了!)


下单为何没有提示填写收货地址?

后台订单详情为啥没有 “发货” 按钮?


后台发布/编辑商品,有一个选项 “物流模板” ,也就是 “运费模板”

如果您选择的是 “不使用物流” ,那么系统将认为该商品是虚拟商品;

虚拟商品,类似手机充值、游戏装备、服务等等,都是不需要快递的,也就没有必要提示用户填写收货地址的了!

如果您希望你的商品是需要快递的,或者希望用户下单的时候必须填写快递地址(收货地址),那么:

建议您设置至少一个合适的运费模板,然后编辑商品,选择一个运费模板即可。


场景二:


你可以将查询快递信息接口,集成到你自己的系统里面去,实现实时查询快递信息状态


登录你的 “api工厂” 后台,左侧菜单 “工厂设置” --> “模块管理”  ,启用 “快递信息查询” 模块,并在该模块处购买api查询套餐,即可使用 快递单号查询接口


api接口地址


https://api.it120.cc/gate/express/query


POST 方式提交

本接口提交参数一律使用 application/x-www-form-urlencoded ,不要使用 JSON 格式提交参数


参数:


merchantNo


“api工厂” 后台的商户号,登录后台 “工厂设置” --> “商户信息” 可查看


merchantKey


“api工厂” 后台的商户秘钥,登录后台 “工厂设置” --> “商户信息” 可查看


com


快递公司编码,该参数可传也可不传,不过建议传该参数,具体快递公司编码可查询下面的对应表


number


快递单号


快递查询接口快递公司编码列表


Copyright © 杭州于芯科技有限公司

浙ICP备15041833号