接口名称

thisshop.express.trajectory.get

功能描述

物流轨迹查询

访问路径

/api/shop/router/rest

数据格式

json

请求方式

Post

请求示例报文

//备注：appId、nonce、timestamp、token为公共参数

{
    "appId":"TF10000",
    "nonce":"8ds9a921",
    "timestamp":"1564630934531",
    "token":"46DE554983BA4E41BB59A61FA50CCE",
    "data":{
        "orderId":"519495831478349824"
    },
    "method":"thisshop.express.trajectory.get"
}

返回数据

错误

{
    "transactionStatus":{
        "errorCode":"1",
        "replyCode":"10000",
        "replyText":"请求参数错误",
        "memo":null,
        "appName":"tft-shop-server",
        "success":false
    },
    "page":null,
    "result":null
}

成功

{
    "transactionStatus":{
        "errorCode":"0",
        "replyCode":null,
        "replyText":null,
        "memo":null,
        "appName":"tft-shop-server",
        "success":true
    },
    "page":null,
    "result":{
        "carrierId":"kerry",
        "carrierName":"kerry",
        "carrierLogo":"http://sss.jpg",
        "waybillNo":"waybillNo99",
        "status":1,
        "dataList":[
            {
                "waybillNo":"waybillNo99",
                "trajectoryStatus":1,
                "trajectoryDesc":"gsdigsdsd",
                "createTime":1645957691
            }
        ]
    }
}

interface name

thisshop.express.trajectory.get

Function description

Query logistics tracking status

access path

/api/shop/router/rest

Data Format

json

request method

Post

Request sample message

//Note: appId , nonce, timestamp,   token are public parameters

{
    "appId":"TF10000",
    "nonce":"8ds9a921",
    "timestamp":"1564630934531",
    "token":"46DE554983BA4E41BB59A61FA50CCE",
    "data":{
        "orderId":"519495831478349824"
    },
    "method":"thisshop.express.trajectory.get"
}

return data

mistake

{
    "transactionStatus":{
        "errorCode":"1",
        "replyCode":"10000",
        "replyText":"请求参数错误",
        "memo":null,
        "appName":"tft-shop-server",
        "success":false
    },
    "page":null,
    "result":null
}

success

{
    "transactionStatus":{
        "errorCode":"0",
        "replyCode":null,
        "replyText":null,
        "memo":null,
        "appName":"tft-shop-server",
        "success":true
    },
    "page":null,
    "result":{
        "carrierId":"kerry",
        "carrierName":"kerry",
        "carrierLogo":"http://sss.jpg",
        "waybillNo":"waybillNo99",
        "status":1,
        "dataList":[
            {
                "waybillNo":"waybillNo99",
                "trajectoryStatus":1,
                "trajectoryDesc":"gsdigsdsd",
                "createTime":1645957691
            }
        ]
    }
}

orderId

String

32

订单编号

Y

订单编号

orderId

String

32

order number

Y

order number

transactionStatus

Object

交易响应对象

page

Object

页码对象

该接口没有分页对象

result

Object

集合对象

errorCode

String

错误标识

0：正确；1：错误

replyCode

String

错误代码

replyText

String

错误信息

memo

String

备注

appName

String

服务名称

success

boolean

是否成功

true:成功 false:失败

carrierId

String

物流公司id

carrierName

String

物流公司名称

carrierLogo

String

物流公司logo

waybillNo

String

运单号

status

Integer

状态

1：拣货中

2：已打包

4：已出仓

8：已揽收

16：在途

32：已签收

64：退货中

128：退货完成

256：已取消

dataList[]

List

物流轨迹列表

waybillNo

String

运单号

trajectoryStatus

Integer

轨迹状态

1：拣货中

2：已打包

4：已出仓

8：已揽收

16：在途

32：已签收

64：退货中

128：退货完成

256：已取消

trajectoryDesc

String

轨迹描述

createTime

String

创建时间

时间戳（秒）

transactionStatus

Object

Transaction response object

page

Object

page number object

There is no paging object for this interface

result

Object

collection object

errorCode

String

error flag

0: correct;

1: incorrect

replyCode

String

error code

replyText

String

error message

memo

String

Remark

appName

String

service name

success

boolean

whether succeed

true: success false: failure

carrierId

String

logistics company id

carrierName

String

Logistics company name

carrierLogo

String

Logistics company logo

waybillNo

String

Waybill number

status

Integer

state

1: Picking

2: Packaged

4: out of the warehouse

8: Received

16: On the way

32: Signed for

64: Returning

128: Return completed

256: Cancelled

dataList [ ]

List

Logistics track list

waybillNo

String

Waybill number

trajectoryStatus

Integer

track status

1: Picking

2: Packaged

4: out of the warehouse

8: Received

16: On the way

32: Signed for

64: Returning

128: Return completed

256: Cancelled

trajectoryDesc

String

Trajectory description

createTime

String

creation time

timestamp (seconds)