`
喵喵大神
  • 浏览: 37383 次
文章分类
社区版块
存档分类
最新评论

常用快递API及快递在线下单API分享

阅读更多

1.常用快递API

支持顺丰、EMS、申通、圆通、韵达、汇通、中通、天天、德邦、全峰等主流快递公司。

文档地址:https://www.juhe.cn/docs/api/id/43

1.1常用快递查询API

接口地址:http://v.juhe.cn/exp/index
支持格式:json/xml
请求方式:http post/get
请求示例:http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
  com string 需要查询的快递公司编号
  no string 需要查询的订单号
  key string 应用APPKEY(应用详细页查询)
  dtype string 返回数据的格式,xml或json,默认json
返回参数说明:   名称 类型 说明
  参考JSON返回示例 - -
JSON返回示例:
{
"resultcode":"200",/*返回标识码*/
"reason":"查询成功!",
"result":{
    "company":"顺丰",
    "com":"sf",
    "no":"575677355677",
    "list":[
        {
        "datetime":"2013-06-25 10:44:05",   /*时间*/
        "remark":"已收件",                 /*描述*/
        "zone":"台州市"                        /*区域,视快递公司情况,不保证一定有信息*/
        },
        {
        "datetime":"2013-06-25 11:05:21",
        "remark":"快件在 台州 ,准备送往下一站 台州集散中心 ",
        "zone":"台州市"
        },
        {
        "datetime":"2013-06-25 20:36:02",
        "remark":"快件在 台州集散中心 ,准备送往下一站 台州集散中心 ",
        "zone":"台州市"
        },
        {
        "datetime":"2013-06-25 21:17:36",
        "remark":"快件在 台州集散中心 ,准备送往下一站 杭州集散中心 ",
        "zone":"台州市"
        },
        {
        "datetime":"2013-06-26 12:20:00",
        "remark":"快件在 杭州集散中心 ,准备送往下一站 西安集散中心 ",
        "zone":"杭州市"
        },
        {
        "datetime":"2013-06-27 05:48:42",
        "remark":"快件在 西安集散中心 ,准备送往下一站 西安 ",
        "zone":"西安市/咸阳市"
        },
        {
        "datetime":"2013-06-27 08:03:03",
        "remark":"正在派件..",
        "zone":"西安市/咸阳市"
        },
        {
        "datetime":"2013-06-27 08:51:33",
        "remark":"派件已签收",
        "zone":"西安市/咸阳市"
        },
        {
        "datetime":"2013-06-27 08:51",
        "remark":"签收人是:已签收 ",
        "zone":"西安市/咸阳市"
        }
        ]
        "status": "1", /*0或1。0表示此单号信息还有更新的可能;1表示此单号信息不会再更新
(签收、退回等最终状态),您可将单号信息存入数据库,不必再次往聚合发送更新请求。*/
    }
}
 XML返回示例:
<root>
    <resultcode>200</resultcode>
    <reason>查询成功!</reason>
    <result>
        <company>顺丰</company>
        <com>sf</com>
        <no>575677355677</no>
        <list>
            <item>
                <datetime>2013-06-25 10:44:05</datetime>
                <remark>已收件</remark>
                <zone>台州市</zone>
            </item>
            <item>
                <datetime>2013-06-25 11:05:21</datetime>
                <remark>快件在 台州 ,准备送往下一站 台州集散中心</remark>
                <zone>台州市</zone>
            </item>
            <item>
                <datetime>2013-06-25 20:36:02</datetime>
                <remark>快件在 台州集散中心 ,准备送往下一站 台州集散中心</remark>
                <zone>台州市</zone>
            </item>
            <item>
                <datetime>2013-06-25 21:17:36</datetime>
                <remark>快件在 台州集散中心 ,准备送往下一站 杭州集散中心</remark>
                <zone>台州市</zone>
            </item>
            <item>
                <datetime>2013-06-26 12:20:00</datetime>
                <remark>快件在 杭州集散中心 ,准备送往下一站 西安集散中心</remark>
                <zone>杭州市</zone>
            </item>
            <item>
                <datetime>2013-06-27 05:48:42</datetime>
                <remark>快件在 西安集散中心 ,准备送往下一站 西安</remark>
                <zone>西安市/咸阳市</zone>
            </item>
            <item>
                <datetime>2013-06-27 08:03:03</datetime>
                <remark>正在派件..</remark>
                <zone>西安市/咸阳市</zone>
            </item>
            <item>
                <datetime>2013-06-27 08:51:33</datetime>
                <remark>派件已签收</remark>
                <zone>西安市/咸阳市</zone>
            </item>
            <item>
                <datetime>2013-06-27 08:51</datetime>
                <remark>签收人是:已签收</remark>
                <zone>西安市/咸阳市</zone>
            </item>
        </list>
        <status>1</status>
    </result>
</root>
 

1.2快递公司编号对照表

接口地址:http://v.juhe.cn/exp/com
支持格式:json/xml/jsonp
请求方式:http post get
请求示例:http://v.juhe.cn/exp/com?key=key
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
         
返回参数说明:   名称 类型 说明
       
JSON返回示例:
{
"resultcode":"200",
"reason":"成功的返回",
"result":[
    {
    "com":"顺丰",
    "no":"sf"
    },
    {
    "com":"申通",
    "no":"sto"
    },
    {
    "com":"圆通",
    "no":"yt"
    },
    {
    "com":"韵达",
    "no":"yd"
    },
    {
    "com":"天天",
    "no":"tt"
    },
    {
    "com":"EMS",
    "no":"ems"
    },
    {
    "com":"中通",
    "no":"zto"
    },
    {
    "com":"汇通",
    "no":"ht"
    }
]
}
 

2.快递在线下单

应用场景:普通用户在线向快递公司在线下单,快递公司收到申请快递员上门取件

接口文档:https://www.juhe.cn/docs/api/id/229

2.1获取快递公司列表

接口地址:http://v.juhe.cn/expressonline/test/getCarriers.php
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/expressonline/test/getCarriers.php?key=APPKEY
接口备注:获取支持的快递公司列表
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  ex_category string recommend:推荐快递公司;
返回参数说明:   名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
    "reason": "查询成功",
    "result": [
        {
            "carrier_code": "ems",/*快递公司代码*/
            "carrier_phone": "11183",/*快递公司电话*/
            "carrier_name": "EMS"/*快递公司名称*/
        },
        {
            "carrier_code": "zhongtong",
            "carrier_phone": "021-39777777",
            "carrier_name": "中通快递"
        },
        {
            "carrier_code": "yuantong",
            "carrier_phone": "021-69777888",
            "carrier_name": "圆通速递"
        },
        {
            "carrier_code": "zjs",
            "carrier_phone": "400-6789-000",
            "carrier_name": "宅急送"
        },
        {
            "carrier_code": "debang",
            "carrier_phone": "400-830-5555",
            "carrier_name": "德邦物流"
        },
        {
            "carrier_code": "huitong",
            "carrier_phone": "021-62963636",
            "carrier_name": "百世汇通"
        },
        {
            "carrier_code": "shunfeng",/*快递公司编码*/
            "carrier_phone": "400-811-1111",/*快递公司电话*/
            "carrier_name": "顺丰速运"/*快递公司名称*/
        },....
    ],
    "error_code": 0
}
 XML返回示例:
<?xml version="1.0" encoding="utf-8"?>
<root>
    <reason>查询成功</reason>
    <result>
        <item>
            <carrier_code>ems</carrier_code>
            <carrier_phone>11183</carrier_phone>
            <carrier_name>EMS</carrier_name>
        </item>
        <item>
            <carrier_code>zhongtong</carrier_code>
            <carrier_phone>021-39777777</carrier_phone>
            <carrier_name>中通快递</carrier_name>
        </item>
        <item>
            <carrier_code>yousu</carrier_code>
            <carrier_phone>400-1111-119</carrier_phone>
            <carrier_name>优速快递</carrier_name>
        </item>
        <item>
            <carrier_code>quanfeng</carrier_code>
            <carrier_phone>400-100-0001</carrier_phone>
            <carrier_name>全峰快递</carrier_name>
        </item>
        <item>
            <carrier_code>yuantong</carrier_code>
            <carrier_phone>021-69777888</carrier_phone>
            <carrier_name>圆通速递</carrier_name>
        </item>
        <item>
            <carrier_code>zjs</carrier_code>
            <carrier_phone>400-6789-000</carrier_phone>
            <carrier_name>宅急送</carrier_name>
        </item>
        <item>
            <carrier_code>debang</carrier_code>
            <carrier_phone>400-830-5555</carrier_phone>
            <carrier_name>德邦物流</carrier_name>
        </item>
        <item>
            <carrier_code>huitong</carrier_code>
            <carrier_phone>021-62963636</carrier_phone>
            <carrier_name>百世汇通</carrier_name>
        </item>
        <item>
            <carrier_code>shunfeng</carrier_code>
            <carrier_phone>400-811-1111</carrier_phone>
            <carrier_name>顺丰速运</carrier_name>
        </item>
    </result>
    <error_code>0</error_code>
</root>
 

2.2在线下单发快递

接口地址:http://v.juhe.cn/expressonline/test/expressSend.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/test/expressSend.php?key=APPKEY&send_method=addOrderInfoMes&order_no=......所有参数(请转换成post形式提交)
接口备注:提供两种模式,(1)普通发快递:在线向快递公司在线下单;(2)异步发快递: 用户将订单信息提交到平台
注:开发测试,下单成功后请及时撤销订单,否则快递公司会打电话上门取件
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  send_method string 接口方法名称
(addOrderInfoMes:普通发快递,
(1)普通用户在线向快递公司在线下单,
(2)快递公司收到申请快递员上门取件;
addOrderInfoAsy:异步发快递,
(1)用户将订单信息提交到开放平台,
(2)开放平台通过订单状态推送用户发件结果,
(3)快递公司收到申请快递员上门取件)
  order_no string 订单编号10-32位唯一的数字字符串(例:20160129121200956523)
  isWaybill string 是否为电子运单( 1 普通订单(默认为1),暂仅支持普通)
  carrier_code string 快递公司编码.建议使用宅急送(zjs)进行功能和流程测试
  sender_name string 发件人姓名
  sender_telphone string 发件人手机号码
  sender_phone string 发件人固定电话
  sender_province_name string 发件地址省名称
  sender_city_name string 发件地址市名称
  sender_district_name string 发件地址区名称
  sender_address string 发件地址详细信息
  sender_post_code string 发件地址邮政编码
  receiver_name string 收件人姓名
  receiver_telphone string 收件人手机号码
  receiver_phone string 收件人固定电话
  receiver_province_name string 收件地址省名称
  receiver_city_name string 收件地址市名称
  receiver_district_name string 收件地址区名称
  receiver_address string 收件地址详细信息
  receiver_org_name string 收件机构
  receiver_post_code string 收件地址邮政编码
  remark string 备注
  item_weight double 重量(double,单位kg)
  item_name string 货物名称
  item_spec string 规格
  send_start_time string 预约开始时间(时间格式为:yyyy-MM-dd HH:mm:ss)
  send_end_time string 预约结束时间(时间格式为:yyyy-MM-dd HH:mm:ss)
返回参数说明:   名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
    "reason": "下单成功",
    "result": {
         "order_no":"20160129121200956523",/*订单编号*/
         "carrier_code":"zjs"/*快递公司编号*/
    },
    "error_code": 0
}
 

2.3撤销订单

接口地址:http://v.juhe.cn/expressonline/test/cancleSend.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/test/cancleSend.php?key=APPKEY&
接口备注:用户下单后,不想发快递了,可以及时取消;由于快递公司IT系统原因,暂支持 宅急送、优速、百世汇通、圆通、中通、德邦快递公司撤销发件
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  order_no string 订单编号 10-32位唯一的数字字符串
  carrier_code string 快递公司编码
返回参数说明:   名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
    "reason": "取消成功",
    "result": {
        "order_no": "20160129121200956523",/*订单号*/
        "carrier_code": "zjs"/*快递公司编码 (宅急送)*/
    },
    "error_code": 0
}
 

2.4推送接口设置

接口地址:http://v.juhe.cn/expressonline/setPush.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/setPush.php?key=APPKEY&
接口备注:用户设置订单状态更新信息推送接口 (测试阶段不予以推送状态更新)
调用样例及调试工具:API测试工具
请求参数说明:   名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  name string 公司名
  state_method string 订单状态更新推送地址
  content_method string 物流信息更新推送地址
返回参数说明:   名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
    "reason": "成功的返回",
    "result": {
        "name": "",/*公司名称或其他说明文字*/
        "state_method": "您接收订单状态更新信息推送的接口(例:http://test.com/test.php)",/*订单状态更新推送地址*/
        "content_method": "您接收订物流信息更新推送的接口(例:http://test.com/test.php)",/*物流信息更新推送地址*/
        "key": APPKEY
    },
    "error_code": 0
}
 
 
 
/*订单状态推送,数据格式以及参数说明.(注:操作完成后输出:success字符串)*/
{
"orders": [
        {
        "order_no": "20160201090120458263",/*订单号*/
        "carrier_code": "zjs",/*快递公司编码*/
        "status": "4",/*订单状态:0:下单成功,1:下单失败,2:撤单成功,3:撤单失败,4:接单成功,5:接单失败,
6:揽收成功,7:揽收失败,8:在途,9:派件扫描,10:签收成功,11:签收失败*/
        "time": "2015-01-15 09:33:32",/*操作时间*/
        "content": "工业园区网点接单,电话1234568"/*内容*/
        }
    ]
}
 
 
 
/*物流信息推送,数据格式以及参数说明.(注:操作完成后输出:success字符串)*/
{
"orders": [
        {
            "order": {
                "bill_code": "350301727598", /*快递公司运单号*/
                "order_no": "20160201090120458263", /*订单号*/
                "carrier_code": "zjs", /*快递公司编码*/
                "status": "4"
            },
            "data": [/*物流信息list*/
                {
                    "time": "2014-11-14 15:51:59",/*操作时间*/
                    "content": "到太原市【太原分拨中心】"/*操作内容*/
                },
                {
                    "time": "2014-11-14 01:57:02",
                    "content": "北京市【北京分拨中心】,正发往【太原分拨中心】"
                },
                {
                    "time": "2014-11-14 01:55:27",
                    "content": "到北京市【北京分拨中心】"
                }
            ]
        }
    ]
}
 
 
分享到:
评论

相关推荐

    常用快递API接口方案.doc

    本篇将详细阐述常用快递API接口的使用和对接过程,以及如何实现诸如在线下单、快递轨迹查询、签收通知等功能。 一、对接流程 1. **快递鸟申请接口**:首先,电商企业需要在快递鸟官网注册并申请成为开发者,获取专...

    基于C# .NET的常用快递接口调用代码实例

    // "zone": "" /* 快件当时所在区域,由于快递公司升级,现大多数快递不提供此信息 */ // }, // } // { // "datetime": "2016-06-20 17:55:00", // "remark": "投递并签收,签收人:单位收发章 *【毕节...

    丰桥APIdemo

    这个项目的核心是通过SDK(Software Development Kit)来简化与丰桥API的交互,使得开发者能够高效地在自己的应用程序中实现快递查询、下单等操作。 SDK,全称为软件开发工具包,是一系列程序接口、工具和文档的...

    快递鸟接口技术文档v5.40.pdf

    快递鸟接口技术文档是关于如何通过编程接口(API)与快递鸟平台进行交互,实现物流信息管理的详细指南。文档主要面向需要集成快递鸟服务的软件开发人员,特别是那些在电商、仓储系统和物流工具等平台上工作的开发者...

    顺丰开放平台C#api反编译修改后sdk

    1. **下单接口**:允许开发者通过编程方式创建寄送订单,输入寄件人和收件人的信息,选择相应的服务类型,如标准快递、次晨达等。 2. **物流信息查询接口**:提供了实时查询快件状态的功能,开发者可以通过快件号...

    顺丰丰桥平台接口+面单打印SDK自定义类

    在.NET环境中,DataTable是一种常用的数据存储和操作结构,它可以方便地与XML或JSON格式的数据进行交互,适合处理API返回的结构化数据。 最后,重点介绍了“调用顺丰面单打印SDK打出快递单”。顺丰提供了SDK,使得...

    寄快递小程序.rar

    2. 后端开发:常用的技术栈包括Node.js、Python、Java等,负责处理数据、计算运费、存储订单信息等,通常采用RESTful API进行前后端通信。 3. 数据库设计:MySQL、MongoDB等数据库用于存储用户信息、订单数据和快递...

    毕业设计 微信小程序设计 寄快递小程序

    3. **快递公司选择**:提供常用快递公司的列表供用户选择,可以利用API获取快递公司的服务信息和价格。 4. **运费预估**:根据物品详情和快递公司选择,动态计算运费,可调用快递公司的公开API完成。 5. **下单...

    快递物流源码

    - **API接口设计**:RESTful API规范,用于前后端通信及与其他系统交互。 - **地理信息系统(GIS)**:如Google Maps API或高德地图API,用于地图展示和路径规划。 - **消息队列**:如RabbitMQ或Kafka,处理异步...

    电子商务快递单号在线交易网站源码

    【电子商务快递单号在线交易网站源码】是一个用于搭建电子商务平台中快递单号交易功能的软件开发基础。源码是编程中的核心元素,它包含了实现特定功能的所有代码,使得开发者可以理解和修改系统的内部逻辑,以适应...

    java ssm校园快递代取App 毕业论文 PPT.zip

    SSM(Spring、SpringMVC、MyBatis)是Java Web开发中常用的一套框架组合,主要用于构建企业级Web应用程序。这个毕业论文PPT的主题聚焦于利用SSM框架开发一个校园快递代取App,让我们来深入探讨这个项目可能涉及的...

    基于SSM的智能快递分lian系统.rar

    "微信小程序"可能意味着此系统还包含了与微信小程序的集成,方便用户通过微信平台进行快递查询、下单等操作。 【压缩包子文件的文件名称列表】 虽然没有提供具体的文件列表,但根据通常的项目结构,我们可以假设...

    Delphi XE IDHTTP短信平台接口文档

    这些接口包括但不限于订单分发、在线下单、智选物流、推送服务等。开发者可以通过这些接口集成快递查询功能到自己的系统中。 5. **接口版本管理**:描述中提到了接口的版本更新历史,每次更新都针对不同功能进行了...

    基于Yii2的企业级商城系统源码和微信小程序.zip

    物流跟踪则与快递公司API对接,提供物流状态更新。 3. **SSM框架**: 标签中提到的SSM是Spring、SpringMVC和MyBatis的组合,是Java Web开发中常用的技术栈。Spring负责整体的依赖注入和事务管理,SpringMVC处理...

    同城跑腿配送系统uniapp+web端

    1. 帮取:用户可下单请求他人帮忙取物,系统会自动匹配附近的跑腿员进行物品取件。 2. 帮送:跑腿员根据订单信息将物品安全送达指定地点,确保快速准确。 3. 帮买:用户可以指定购买的商品,跑腿员将代购并送达,...

    基于springboot的网上购物商城系统源码数据库.zip

    《基于SpringBoot的网上购物商城系统源码及数据库解析》 在现代信息技术的快速发展中,电商平台已经成为商业领域不可或缺的一部分。本篇文章将详细解读一个基于SpringBoot框架构建的网上购物商城系统的源码和数据库...

    Java综合性校园跑腿系统源码.zip

    通过这个系统,学生可以方便地在线下单,而其他学生则可以接单完成任务,实现校园内的互助服务。下面将详细介绍这个系统可能涉及的技术和知识点: 1. **Java编程语言**:作为系统的主要开发语言,Java以其跨平台、...

    融成Java后台网站内容管理系统 v3.2.1.rar

    7.实现了与顺丰、ems、中通、申通、圆通、韵达等104家国内主要快递物流系统的api接口对接,客户下单后可以实时查询和追踪订单的物流状态; 8.评论管理部分实现客户的购物用户的商品评论功能。 9.增加网站数据分析...

Global site tag (gtag.js) - Google Analytics