zoukankan      html  css  js  c++  java
  • 快递上门取件接口,支持单号查询-申通快递

    调用快递鸟提供的申通上门取件API标准接口,申通快递员可上门服务,同时支持申通快递单号的轨迹查询,其它100多家包括四通一达等快递公司的物流轨迹也可查询,本篇文章重点实现<申通快递>的上门取件接口

    首先我们准备需要用到的对接资源,先注册一个快递鸟账号,

    注册地址:http://kdniao.com/reg

    然后完成基本的身份认证,认证的流程可以打开腾讯视频,爱奇艺视频,新浪视频查看教程

    这里推荐大家去爱奇艺查看视频教程:

    https://www.iqiyi.com/v_19rxcwtwk0.html(如何从注册到认证,最快1小时完成上百家物流轨迹查询)

     

    测试商户ID

    test1617571

    测试API key

    554343b2-7252-439b-b4eb-1af42c8f2175(Key仅限测试环境使用)

    API测试地址:

    http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

     

    接下来,我们讲解一下请求参数

    一、接口描述/说明

    1)上门取件接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。
    2)为客户解决在线发货需求,商户通过网络选择快递公司发送请求通知快递公司有快递要发货。
    3) 客户把数据通过此接口转发到快递鸟,由快递鸟为您安排快递员上门取件的服务。
    4)订单编号(OrderCode)不可重复提交,重复提交系统会返回具体错误代码。


    请求系统级参数说明:

    参数名称

    类型

    说明

    必须要求

    RequestData

    String

    请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。

    R

    EBusinessID

    String

    商户ID,请在我的服务页面查看。

    R

    RequestType

    String

    请求指令类型:1801

    R

    DataSign

    String

    数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。

    R

    DataType

    String

    请求、返回数据类型:只支持JSON格式

    R

    备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)

    二、接口参数

    请求内容字段定义:

    参数

    类型

    说明

    必须要求

    WarehouseID

    String

    仓库标识

    O

    WarehouseAddress

    String

    仓库地址

    O

    CallBack

    String

    商户标识

    O

    MemberID

    String

    会员标识

    O

    OrderCode

    String

    订单编号

    R

    PayType

    Int

    邮费支付方式:1-现付,2-到付,3-月结,4-第三方支付

    R

    MonthCode

    String

    月结编码

    C

    ExpType

    Int

    快递类型:1-标准快件

    R

    IsReturnSignBill

    Int

    签收回单:1-需要,0-不需要,默认为0

    O

    Receiver

    Company

    String

    收件人公司

    O

    Name

    String

    收件人

    R

    Tel

    String

    电话与手机,必填一个

    R

    Mobile

    String

    PostCode

    String

    收件人邮编

    O

    ProvinceName

    String

    收件省(如广东省,不要缺少“省”)

    R

    CityName

    String

    收件市(如深圳市,不要缺少“市”)

    R

    ExpAreaName

    String

    收件区(如福田区,不要缺少“区”或“县”)

    O

    Address

    String

    收件人详细地址

    R

    Sender

    Company

    String

    发件人公司

    O

    Name

    String

    发件人

    R

    Tel

    String

    电话与手机,必填一个

    R

    Mobile

    String

    PostCode

    String

    发件人邮编

    O

    ProvinceName

    String

    发件省(如广东省,不要缺少“省”)

    R

    CityName

    String

    发件市(如深圳市,不要缺少“市”)

    R

    ExpAreaName

    String

    发件区(如福田区,不要缺少“区”或“县”)

    O

    Address

    String

    发件人详细地址(实际取件)

    R

    SenderShowAddress

    String

    发件人详细地址

    O

    StartDate

    String

    上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同

    O

    EndDate

    String

    O

    Weight

    Double

    物品总重量kg

    O

    Quantity

    Int

    件数/包裹数

    O

    Volume

    Double

    物品总体积m3

    O

    Remark

    String

    备注

    O

    AddServices

    AddService

    Name

    String

    增值服务名称

    O

    Value

    String

    增值服务值

    O

    CustomerID

    String

    客户标识(选填)

    O

    Commoditys

    Commodity

    GoodsName

    String

    商品名称

    R

    GoodsCode

    String

    商品编码

    O

    Goodsquantity

    Int

    商品数量

    O

    GoodsPrice

    Decimal

    商品价格

    O

    GoodsWeight

    Decimal

    商品重量

    O

    GoodsDesc

    String

    商品描述

    O

    GoodsVol

    Double

    商品体积m3

    O

    PackingType

    Int

    包装类型:包装类型(快运字段)默认为 0; 0- 纸 1- 纤 2- 木 3- 托膜 4- 木托 99-其他

    O

    DeliveryMethod

    Int

    送货方式:0-自提,1-送货上门(不含上楼)2-送货上楼。(适用于快运类型订单,物流公司可能会收取费用),默认为0

    O

    返回参数定义:

    参数名称

    类型

    说明

    必须要求

    EBusinessID

    String

    用户ID

    R

    Order

    OrderCode

    String

    订单编号

    R

    KDNOrderCode

    String

    快递鸟订单编号

    R

    ShipperCode

    String

    快递公司编码

    R

    LogisticCode

    String

    快递单号

    O

    Success

    Bool

    成功与否

    R

    ResultCode

    String

    结果编码

    R

    Reason

    String

    失败原因

    O

    UniquerRequestNumber

    String

    唯一标识

    R

    三、示例

    请求示例 JSON

    {
    "OrderCode":"012657018199",
    "ShipperCode":"SF",
    "PayType":1,
    "MonthCode":"1234567890",
    "ExpType":1,
    "Sender":{
    "Company":"LV",
    "Name":"Taylor",
    "Mobile":"15018442396",
    "ProvinceName":"上海",
    "CityName":"上海市",
    "ExpAreaName":"青浦区",
    "Address":"明珠路"
    },
    "Receiver":{
    "Company":"GCCUI",
    "Name":"Yann",
    "Mobile":"15018442396",
    "ProvinceName":"北京",
    "CityName":"北京市",
    "ExpAreaName":"朝阳区",
    "Address":"三里屯街道"
    },
    "Commodity":[
    {
    "GoodsName":"鞋子",
    "Goodsquantity":1,
    "GoodsWeight":1
    }
    ],
    "AddService":[
    {
    "Name":"COD",
    "Value":"1020",
    "CustomerID":"1234567890"
    }
    ],
    "Weight":1,
    "Quantity":1,
    "Volume":0,
    "Remark":"小心轻放",
    "StartDate":"2020-04-21 11:00:00",
    "EndDate":"2020-04-21 17:00:00",

    }

    请求的完整报文(URL编码以后):RequestData=%7b%0d%0a++++%22OrderCode%22%3a%22012657018199%22%2c%0d%0a++++%22ShipperCode%22%3a%22STO%22%2c%0d%0a++++%22PayType%22%3a1%2c%0d%0a++++%22MonthCode%22%3a%221234567890%22%2c%0d%0a++++%22ExpType%22%3a1%2c%0d%0a++++%22Sender%22%3a%7b%0d%0a++++++++%22Company%22%3a%22LV%22%2c%0d%0a++++++++%22Name%22%3a%22Taylor%22%2c%0d%0a++++++++%22Mobile%22%3a%2215018442396%22%2c%0d%0a++++++++%22ProvinceName%22%3a%22%e4%b8%8a%e6%b5%b7%22%2c%0d%0a++++++++%22CityName%22%3a%22%e4%b8%8a%e6%b5%b7%e5%b8%82%22%2c%0d%0a++++++++%22ExpAreaName%22%3a%22%e9%9d%92%e6%b5%a6%e5%8c%ba%22%2c%0d%0a++++++++%22Address%22%3a%22%e6%98%8e%e7%8f%a0%e8%b7%af%22%0d%0a++++%7d%2c%0d%0a++++%22Receiver%22%3a%7b%0d%0a++++++++%22Company%22%3a%22GCCUI%22%2c%0d%0a++++++++%22Name%22%3a%22Yann%22%2c%0d%0a++++++++%22Mobile%22%3a%2215018442396%22%2c%0d%0a++++++++%22ProvinceName%22%3a%22%e5%8c%97%e4%ba%ac%22%2c%0d%0a++++++++%22CityName%22%3a%22%e5%8c%97%e4%ba%ac%e5%b8%82%22%2c%0d%0a++++++++%22ExpAreaName%22%3a%22%e6%9c%9d%e9%98%b3%e5%8c%ba%22%2c%0d%0a++++++++%22Address%22%3a%22%e4%b8%89%e9%87%8c%e5%b1%af%e8%a1%97%e9%81%93%22%0d%0a++++%7d%2c%0d%0a++++%22Commodity%22%3a%5b%0d%0a++++++++%7b%0d%0a++++++++++++%22GoodsName%22%3a%22%e9%9e%8b%e5%ad%90%22%2c%0d%0a++++++++++++%22Goodsquantity%22%3a1%2c%0d%0a++++++++++++%22GoodsWeight%22%3a1%0d%0a++++++++%7d%0d%0a++++%5d%2c%0d%0a++++%22Weight%22%3a1%2c%0d%0a++++%22Quantity%22%3a1%2c%0d%0a++++%22Volume%22%3a0%2c%0d%0a++++%22Remark%22%3a%22%e5%b0%8f%e5%bf%83%e8%bd%bb%e6%94%be%22%0d%0a%7d%0d%0a&EBusinessID=1365742&RequestType=1801&DataSign=ZTcxNTBkNjNhNjkxYjkzMGViNDcxZTRjNzc3NzlkNjI%3d&DataType=2

    URL解码的请求报文:

    RequestData={

        "OrderCode":"012657018199",

        "ShipperCode":"STO",

        "PayType":1,

        "MonthCode":"1234567890",

        "ExpType":1,

        "Sender":{

            "Company":"LV",

            "Name":"Taylor",

            "Mobile":"15018442396",

            "ProvinceName":"上海",

            "CityName":"上海市",

            "ExpAreaName":"青浦区",

            "Address":"明珠路"

        },

        "Receiver":{

            "Company":"GCCUI",

            "Name":"Yann",

            "Mobile":"15018442396",

            "ProvinceName":"北京",

            "CityName":"北京市",

            "ExpAreaName":"朝阳区",

            "Address":"三里屯街道"

        },

        "Commodity":[

            {

                "GoodsName":"鞋子",

                "Goodsquantity":1,

                "GoodsWeight":1

            }

        ],

        "Weight":1,

        "Quantity":1,

        "Volume":0,

        "Remark":"小心轻放"

    }

    &EBusinessID=1365742&RequestType=1801&DataSign=ZTcxNTBkNjNhNjkxYjkzMGViNDcxZTRjNzc3NzlkNjI=&DataType=2

    附上详细的接口文档给大家:

    http://www.kdniao.com/documents

    提供源码下载:

    https://download.csdn.net/download/yanghanwen/12139326

    调用第三方物流接口,替换自己的key就能直接使用,主要实现了物流在线轨迹查询,订单订阅,轨迹推送,支持上百家家的快递查询接口,包括主流的四通一达,支持上门取件服务,其他接口调用,修改调用指令和参数就能实现。

    源码运行演示截图:

     

  • 相关阅读:
    Openjudge-NOI题库-简单算术表达式求值
    洛谷-求同构数的个数-NOIP2013提高组复赛
    洛谷-拼数-NOIP1998提高组复赛
    洛谷-统计数字-NOIP2007提高组复赛
    洛谷-谁拿了最多奖学金-NOIP2005提高组复赛
    Openjudge-NOI题库-字符串移位包含问题
    洛谷-乘积最大-NOIP2000提高组复赛
    NOIP2015-普及组复赛-第一题-金币
    Tyvj-超级书架
    Openjudge-NOI题库-出书最多
  • 原文地址:https://www.cnblogs.com/51api/p/12447964.html
Copyright © 2011-2022 走看看