乐趣区

关于api:快递100快递查询地图轨迹API接口案例代码

jiezi

一、快递查问地图轨迹

1.1 接口格局

提供对立格局的 HTTP POST 或 GET 调用接口, 并返回格局反对 JSON，xml，text，html 数据。

1.2 申请地址

https://poll.kuaidi100.com/po…

申请参数：

参数名 是否必填 类型 阐明
customer 是 string 受权码，请申请企业版获取
sign 是 string 签名，用于验证身份，按 param + key + customer 的程序进行 MD5 加密（留神加密后字符串肯定要转 32 位大写），不须要加上“+”号
param 是 param 由其余字段拼接

param 数据结构：

参数名 是否必填 类型 阐明
com 是 string 查问的快递公司的编码，一律用小写字母
num 是 string 查问的快递单号，单号的最大长度是 32 个字符
phone 否 string 收、寄件人的电话号码（手机和固定电话均可，只能填写一个，顺丰单号必填，其余快递公司选填。如座机号码有分机号，分机号无需上传。）
from 是 string 出发地信息，如：广东省深圳市南山区金蝶软件园
to 是 string 目的地信息，如：北京朝阳区国际金融大厦
show 否 string 返回格局：0：json 格局（默认），1：xml，2：html，3：text
order 否 string 返回后果排序:desc 降序（默认）,asc 升序
orderTime 否 string 订单下单工夫，格局为（yyyy-MM-dd HH:mm:ss）如：2020-12-16 12:59:59

1.3 申请实例 

customer=**
  sign=**
  param={
    "com":"ems",
    "num":"em263999513jp",
    "phone":"13868688888",
    "from":"广东省深圳市南山区金蝶软件园",
    "to":"北京朝阳区国际金融大厦",
    "show":"0",
    "order":"desc",
    "orderTime":"2020-12-16 12:59:59"
  }

1.4 返回后果

字段名称 类型 字段含意
message String 音讯体，请疏忽
state Integer 快递单以后状态，包含 0 在途，1 揽收，2 疑难，3 签收，4 退签，5 派件，6 退回，7 转单，10 待清关，11 清关中，12 已清关，13 清关异样，14 收件人拒签等 13 个状态
status Integer 通信状态，请疏忽
condition String 快递单明细状态标记，暂未实现，请疏忽
ischeck Integer 是否签收标记，请疏忽，明细状态请参考 state 字段
com String 快递公司编码, 一律用小写字母
nu String 单号
trailUrl String 轨迹地图链接
arrivalTime String 预计达到工夫
totalTime String 均匀耗时
remainTime String 达到还需多少工夫
isLoop Boolean 是否存在环路
ΘrouteInfo 路由信息
└Θfrom 出发地行政区信息
└number 政区信息编码
└name 政区信息名
└Θcur 以后地行政区信息
└number 政区信息编码
└name 政区信息名
└Θto 目的地行政区信息
└number 政区信息编码
└name 政区信息名
Θdata data 最新查问后果，数组，蕴含多项，全量，倒序（即工夫最新的在最前），每项都是对象，对象蕴含字段请开展
└ context String 内容
└ time String 工夫，原始格局
└ ftime String 格式化后工夫
└status String 本数据元对应的签收状态，只有实时查问接口中提交 resultv2 标记后才会呈现
└areaCode String 本数据元对应的行政区域的编码，只有实时查问接口中提交 resultv2 标记后才会呈现
└areaName String 本数据元对应的行政区域的名称，只有实时查问接口中提交 resultv2 标记后才会呈现

1.5 提供数据内容 

{
    "message": "ok",
    "nu": "YT4781863654577",
    "ischeck": "1",
    "com": "yuantong",
    "status": "200",
    "data": [{
        "time": "2020-11-30 13:19:56",
        "context": "圆通单干点【喵站】快件已达到财产金街院里 3 号底商驿站, 联系电话 18744663997",
        "ftime": "2020-11-30 13:19:56",
        "areaCode": null,
        "areaName": null,
        "status": "在途"
    }, {
        "time": "2020-09-12 17:40:58",
        "context": "【广东省深圳市平湖公司】已收件 取件人: 刘杰珍 (18128837173)",
        "ftime": "2020-09-12 17:40:58",
        "areaCode": "CN440307003000",
        "areaName": "广东, 深圳市, 龙岗区, 平湖",
        "status": "揽收"
    }],

    "state": "3",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN4403",
            "name": "广东, 深圳市"
        },
        "cur": {
            "number": "CN6101",
            "name": "陕西, 西安市"
        },
        "to": {
            "number": "CN6101",
            "name": "陕西, 西安市"
        }
    },
    "isLoop": false,
       "trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
    "arrivalTime": "2020-12-19 12:00",
    "totalTime": "2 天 1 小时",
    "remainTime": "1 天 2 小时"
}

1.6 运单签收状态服务阐明

状态值 名称 含意
0 在途 快件处于运输过程中
1 揽收 快件已由快递公司揽收
2 疑难 快递 100 无奈解析的状态，或者是须要人工染指的状态，比方说收件人电话谬误。
3 签收 失常签收
4 退签 货物退回发货人并签收
5 派件 货物正在进行派件
6 退回 货物正处于返回发货人的途中
7 转投 货物转给其余快递公司邮寄
10 待清关 货物期待清关
11 清关中 货物正在清关流程中
12 已清关 货物已实现清关流程
13 清关异样 货物在清关过程中出现异常
14 拒签 收件人明确拒收

1.7 轨迹链接利用示例

<img src=”https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/782a47be14834488bd62d3bd4163c37d~tplv-k3u1fbpfcp-zoom-1.image” style=”zoom:60%”>

1.8 谬误返回示例 

{
"result":false,
"returnCode":"400",
"message":"找不到对应公司"
}
信息代码 信息内容形容 起因及倡议解决形式
200 查问胜利 查问胜利
400 参数权限问题 数据不残缺，找不到对应公司，非法 IP，请申请受权，不反对此快递公司，单号问题等
500 查问无后果，请隔段时间再查 示意查问失败，去快递公司没获取无效数据
501 服务器谬误 快递 100 的服务器出理间隙或临时性异样，有时如果因为不按标准提交申请，比方快递公司参数没有依照文档规定填写等，也会报此谬误
502 服务器忙碌 快递 100 的服务器出理间隙或临时性异样，请分割快递 100 排查起因
503 验证签名失败 请查看加密形式，param + key + customer 的程序进行 MD5 加密，加密后字符串转大写
601 没该性能权限 没有可用单量或没有开启权限

一、快递查问地图轨迹 API 产品介绍

快递 100 快递查问地图轨迹接口提供给企业及最终用户快递单号的地图轨迹展现、物流节点文字信息及预计送达工夫，可视化展现物流轨迹信息。

通过调用地图轨迹接口，可展现地图轨迹、物流节点信息、预计达到工夫、快递单状态等信息，多样化物流信息展现维度，进步客户查问体验。

二、快递查问地图轨迹 API 利用场景

  1. 在电商网页 /APP/ 小程序中，顾客在订单详情里查看购买商品的物流地图轨迹；
  2. 和物流轨迹文字信息一起展现给顾客，可视化订单的在途状态；
  3. 取得物流路径城市的信息，监控快递时效；
  4. 预估包裹的达到工夫，以及提醒包裹还需多长时间达到，辨认快递状态·，发送揭示客户签收短信；

三、快递查问地图轨迹 API 免费模式

1. 免费形式

快递查问地图轨迹属于增值类服务，该服务同时反对物流文字信息以及地图链接，即蕴含了实时查问接口的性能。注册快递 100 企业账号后能够在企业治理后盾查看地图轨迹套餐价格并购买。

2. 免费价格

新品限时特惠，流动工夫：2021 年 1 月 1 日 -2021 年 3 月 31 日，充值后即可开明应用。

原价 / 元 优惠价 / 元 单量 赠送 / 单 优惠单价 / 元
3000 2000 20000 5000 0.08
1500 1000 10000 2000 约 0.084
750 500 5000 500 约 0.09
150 100 1000 0.1

快递查问地图轨迹按单计费，一个天然月内同一个运单屡次查问只收一次费用。该接口独自计费。

3. 开具发票

快递 100 反对开具增值税发票，用户购买实现后可在企业治理后盾 - 费用核心 - 领取记录 - 申请开票。默认开具电子增值税普通发票，1000 元以上可反对开具增值税专用发票。

官网源文档：

http://api.kuaidi100.com/docu…

http://api.kuaidi100.com/docu…

退出移动版