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

一、 快递查询地图轨迹

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回格式支持JSON，xml，text，html数据。

1.2 请求地址

https://poll.kuaidi100.com/poll/maptrack.do

请求参数：

param数据结构：

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 返回结果

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 运单签收状态服务说明

1.7 轨迹链接应用示例

1.8 错误返回示例

{
"result":false,
"returnCode":"400",
"message":"找不到对应公司"
}

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

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

通过调用地图轨迹接口，可展示地图轨迹、物流节点信息、预计到达时间、快递单状态等信息，多样化物流信息展示维度，提高客户查询体验。

二、快递查询地图轨迹API应用场景

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

三、快递查询地图轨迹API收费模式

1.收费方式

快递查询地图轨迹属于增值类服务，该服务同时支持物流文字信息以及地图链接，即包含了实时查询接口的功能。注册快递100企业账号后可以在企业管理后台查看地图轨迹套餐价格并购买。

2.收费价格

新品限时特惠，活动时间：2021年1月1日-2021年3月31日，充值后即可开通使用。

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

3.开具发票

快递100支持开具增值税发票，用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票，1000元以上可支持开具增值税专用发票。

官方源文档：

http://api.kuaidi100.com/document/5ff2c2b9ba1bf00302f5612d.html

http://api.kuaidi100.com/document/5ff2c3e7ba1bf00302f5612e.html