API 列表

xiaodian.logistics.online.send

  • 免费
  • 需要授权

API功能描述(支持get和post)

发货接口(和xiaodian.logistics.send的实现一样，目前小店没有拆单场景，暂不支持拆单，后期会支持拆单)

公共参数

名称 类型 必选 描述
app_key Long 是 接入时申请的app_key
method String 是 接口名称
access_token String 是 Oauth2.0授权获得的access_token
sign String 是 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 是 时间戳，使用Unix时间戳格式
format String 是 响应格式。默认为json格式，固定
sign_method String 否 参数的加密方法选择，当前只支持Md5
version String 否 API协议版本，固定值为：1.0

输入参数

名称 类型 必选 描述 示例值
openAPIOrderConsignReqDTO Object 是 {
    "shipType": 0, //固定值，写死传入0 
    "needSplit": true, //是否需要拆单。false的时候忽略传入itemOrderList，会把shopOrderId传入的这笔订单发货。true只发货itemOrderList传入订单 
     " itemOrderList":[34343,1333],//拆单的商品级子订单,在needSplit=true起效 shopOrderId:1111, //店铺订单
       "idexpressCode":"",//物流公司编码
         "expressId":"",//运单号
}
shipType Number 是 发货类型（物流发货：0，虚拟发货：1） 0
itemOrderList Number[] 否 子订单ID（不拆单发货时不用填写）
shopOrderId Number 是 店铺订单ID
expressCode String 是 快递公司编码:expressCode,如"zhaijisong"就代表宅急送,各个快递公司对应的编码为:    
[
    {
        "expressIcon":"http://s8.mogucdn.com/pic/141118/logo_ieydcy3cgqzgiobzmqytambqgyyde_100x100.jpg",
        "expressUrl":"http://www.yto.net.cn",
        "expressName":"圆通速递",
        "expressCode":"yuantong"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/pic/141118/logo_ieygiyldgqzgiobzmqytambqmeyde_100x100.jpg",
        "expressUrl":"http://www.zto.cn",
        "expressName":"中通速递",
        "expressCode":"zhongtong"
    },
    {
        "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieygeylbgqzgiobzmqytambqgyyde_100x100.jpg",
        "expressUrl":"http://www.sto.cn",
        "expressName":"申通快递",
        "expressCode":"shentong"
    },
    {
        "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieygkntegqzgiobzmqytambqmeyde_100x100.jpg",
        "expressUrl":"http://www.yundaex.com",
        "expressName":"韵达快运",
        "expressCode":"yunda"
    },
    {
        "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4wmnrqmy2wemztguzdambqgqyde_100x100.png",
        "expressUrl":"http://www.800bestex.com",
        "expressName":"百世汇通",
        "expressCode":"huitongkuaidi"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydkobsguzgiobzmqytambqgiyde_100x100.jpg",
        "expressUrl":"http://www.ttkdex.com",
        "expressName":"天天快递",
        "expressCode":"tiantian"
    },
    {
        "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieydgyjrguzgiobzmqytambqmmyde_100x100.jpg",
        "expressUrl":"http://www.sf-express.com/cn/sc/",
        "expressName":"顺丰速运",
        "expressCode":"shunfeng"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydimteguzgiobzmqytambqgyyde_100x100.jpg",
        "expressUrl":"http://www.qfkd.com.cn",
        "expressName":"全峰快递",
        "expressCode":"quanfengkuaidi"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydanryguzgiobzmqytambqhayde_100x100.jpg",
        "expressUrl":"http://www.ems.com.cn",
        "expressName":"EMS",
        "expressCode":"ems"
    },
    {
        "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieydqy3fguzgiobzmqytambqgiyde_100x100.jpg",
        "expressUrl":"http://www.fastexpress.com.cn",
        "expressName":"快捷速递",
        "expressCode":"kuaijiesudi"
    },
    {
        "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieydem3ggqzgiobzmqytambqgiyde_100x100.jpg",
        "expressUrl":"http://yjcx.chinapost.com.cn",
        "expressName":"邮政包裹",
        "expressCode":"youzhengguonei"
    },
    {
        "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieydqnddguzgiobzmqytambqmeyde_100x100.jpg",
        "expressUrl":"http://www.uc56.com",
        "expressName":"优速快递",
        "expressCode":"youshuwuliu"
    },
    {
        "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieygmzlggqzgiobzmqytambqgyyde_100x100.jpg",
        "expressUrl":"http://www.gto365.com",
        "expressName":"国通快递",
        "expressCode":"guotongkuaidi"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydemruguzgiobzmqytambqgiyde_100x100.jpg",
        "expressUrl":"http://www.zjs.com.cn",
        "expressName":"宅急送",
        "expressCode":"zhaijisong"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/pic/150325/19b0oi_ie2gmzbrmiyginrsgazdambqgiyde_1024x814_100x100.jpg",
        "expressUrl":"https://www.usps.com",
        "expressName":"USPS",
        "expressCode":"usps"
    },
    {
        "expressIcon":"http://s16.mogucdn.com/p1/151202/upload_ie4ggojvmu3wenztguzdambqgiyde_100x100.png",
        "expressUrl":"http://www.ztky.com/GoodsTrace?funcid=14&companyid=1",
        "expressName":"中铁物流",
        "expressCode":"zhongtielogistic"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieytkmjqmzsdmnzugezdambqmeyde_100x100.jpg",
        "expressUrl":"http://adaexpress.com.au/wp",
        "expressName":"明大快递",
        "expressCode":"adaexpress"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieztmmrvmjtdinzugezdambqgyyde_100x100.jpg",
        "expressUrl":"http://www.pcaexpress.com.au/zh",
        "expressName":"PCA",
        "expressCode":"pcaexpress"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_ie2dkmbxmy3gcnrugezdambqgiyde_100x100.jpg",
        "expressUrl":"http://www.cnpex.com.au",
        "expressName":"cnpex中邮快递",
        "expressCode":"cnpex"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ie2winjuga3wcnrugezdambqhayde_100x100.jpg",
        "expressUrl":"http://auspost.com.au",
        "expressName":"Australiapost",
        "expressCode":"auspost"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieytknbsgm3wcnrugezdambqmeyde_100x100.jpg",
        "expressUrl":"http://www.parcelforce.com",
        "expressName":"Parcelforce",
        "expressCode":"parcelforce"
    },
    {
        "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ie2gmmlege3wcnrugezdambqgiyde_100x100.jpg",
        "expressUrl":"http://www.cn.dhl.com/zh/express.html",
        "expressName":"dhl",
        "expressCode":"dhlen"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_ie2dqolgga3wcnrugezdambqgiyde_100x100.jpg",
        "expressUrl":"http://www.chronopost.fr/transport-express/livraison-colis",
        "expressName":"法国邮局",
        "expressCode":"chronopostfren"
    },
    {
        "expressIcon":"http://s7.mogucdn.com/p1/150520/1iaxbq_iezgendegvrtinzugezdambqmmyde_100x100.jpg",
        "expressUrl":"http://www.colissimo.fr/particuliers/home.jsp",
        "expressName":"colissimo",
        "expressCode":"colissimo"
    },
    {
        "expressIcon":"http://s21.mogucdn.com/p1/150520/1iaxbq_ieytomjzmzstqnzugezdambqmeyde_100x100.jpg",
        "expressUrl":"http://www.sundarexpress.com",
        "expressName":"美国顺达快递",
        "expressCode":"sundarexpress"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_iezdgmbume3tqnzugezdambqmmyde_100x100.jpg",
        "expressUrl":"http://www.ajexpress.com.au",
        "expressName":"捷记方舟",
        "expressCode":"ajexpress"
    },
    {
        "expressIcon":"http://s16.mogucdn.com/p1/150610/upload_ie2gimrvmzsdsmtcgezdambqgiyde_100x100.jpg",
        "expressUrl":"http://www.arkexpress.com.au",
        "expressName":"方舟速递",
        "expressCode":"arkexpress"
    },
    {
        "expressIcon":"http://www.changjiangexpress.com/Home/Query",
        "expressName":"长江国际速递",
        "expressCode":"changjiang"
    },
    {
        "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4gmyzrmu4tanbtguzdambqgiyde_100x100.png",
        "expressUrl":"https://www.doortodoor.co.kr/m/sub/sub_006.jsp",
        "expressName":"CJ物流",
        "expressCode":"doortodoor"
    },
    {
        "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie3tsnjzmq4tanbtguzdambqgayde_100x100.png",
        "expressUrl":"http://www.ilogen.com/d2d/index.jsp",
        "expressName":"logen路坚",
        "expressCode":"ilogen"
    },
    {
        "expressIcon":"http://s18.mogucdn.com/p1/151201/upload_ifrwgzrqmq4tanbtguzdambqhayde_100x100.png",
        "expressUrl":"http://www.post.japanpost.jp/index.html",
        "expressName":"日本郵便",
        "expressCode":"japanposten"
    },
    {
        "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4wkzjxmm4tanbtguzdambqgqyde_100x100.png",
        "expressUrl":"http://www.kuronekoyamato.co.jp/top.html",
        "expressName":"ヤマト運輸",
        "expressCode":"yamato"
    },
    {
        "expressIcon":"http://s17.mogucdn.com/p1/151208/upload_ifrdeyjygq4dqnrvguzdambqmeyde_100x100.jpg",
        "expressUrl":"http://www.sagawa-exp.co.jp",
        "expressName":"佐川急便",
        "expressCode":"sagawa"
    },
    {
        "expressIcon":"http://s16.mogucdn.com/p1/151208/upload_ifqwmzrqgu4dqnrvguzdambqgyyde_100x100.jpg",
        "expressUrl":"http://www.seino.co.jp/seino",
        "expressName":"西濃運輸",
        "expressCode":"seino"
    },
    {
        "expressIcon":"http://s18.mogucdn.com/p1/151207/upload_ie4tmmtcmy3wemzvguzdambqgqyde_100x100.jpg",
        "expressUrl":"http://www.xlobo.com",
        "expressName":"贝海国际速递",
        "expressCode":"xlobo"
    },
    {
        "expressIcon":"http://s18.mogucdn.com/p1/151221/upload_ifqtmn3bmrrwcojzguzdambqgyyde_100x100.jpg",
        "expressUrl":"http://www.koreapost.go.kr/kpost/sub/subpage.jsp?contId=010101100000",
        "expressName":"韩国邮政",
        "expressCode":"koreapost"
    },
    {
        "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydomjrgyzgiobzmqytambqmeyde_100x100.jpg",
        "expressUrl":"",
        "expressName":"其它",
        "expressCode":"others"
    },
    {
        "expressIcon":"http://s16.mogucdn.com/p1/151201/upload_ie4ggzjwgq4tenbtguzdambqgiyde_100x100.png",
        "expressUrl":"http://www.deppon.com",
        "expressName":"德邦物流",
        "expressCode":"debangwuliu"
    },
    {
        "expressIcon":"http://s2.mogucdn.com/mlcdn/c45406/170322_4iia16g23l9a715ebcf682i8hb626_100x100.png",
        "expressUrl":"http://www.ane56.com/search/waybilltrack.jsp",
        "expressName":"安能物流",
        "expressCode":"annengwuliu"
    },
    {
        "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/170927_31k6h88cee84b0aj452j9b7c709f4_100x100.jpg",
        "expressUrl":"http:ots.exfresh.net/",
        "expressName":"安鲜达",
        "expressCode":"exfresh"
    },
    {
        "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/171026_7ld4afdfa06a17ee47f7bgi87428b_100x100.png",
        "expressUrl":"http://www.ky-express.com/",
        "expressName":"跨越速运",
        "expressCode":"kuayue"
    },
    {
        "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/171024_2ihj94kl73541ebl9b3giii3476h4_100x100.png",
        "expressUrl":"http://www.jdwl.com/",
        "expressName":"京东快递",
        "expressCode":"jd"
    }
]
expressId String 是 运单号
needSplit Boolean 是 是否需要拆单

返回参数

名称 类型 描述 默认值
result Object 发货返回结果
data String 发货是<br/>否成功 true
status Object 返回状态描述
code String 状态码 0000000
msg String 描述 操作成功

请求参数示例

1).
{
  "openAPIOrderConsignReqDTO": {
    "shipType": "0",
    "itemOrderList": [],
    "shopOrderId": "",
    "expressCode": "",
    "expressId": "",
    "needSplit": "false"
  },
  "userId": ""
}

返回示例

1).
{
         "result": {
                "data": {hasShipSuccess:true}
         },
         "status": {
                "code": "0000000",
                "msg": "发货成功 "
        }
}

异常示例

1).
 {
         "result": {
                "data": {“hasShipSuccess”:false }
         },
         "status": {
                "code": "0000000",
                "msg": "发货失败 "
         }
}

API测试工具