物流预警任务增量查询接口

系统相关界面

"界面路径：【数据】----【快递揽收信息】"

请求地址

环境	服务地址(HTTP/HTTPS)
V2正式环境（推荐）	https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

请求头

全部展开

参数名

类型

描述

必填

Content-Type

String

application/x-www-form-urlencoded;charset=UTF-8

必填

API接口地址

全部展开

参数名

类型

描述

必填

method

String

erp.report.logistics.task.list.query

必填

请求参数

全部展开

参数名

类型

描述

必填

startTime

Long

开始时间戳（毫秒）

必填

endTime

Long

结束时间戳（毫秒）

必填

lastTime

Long

上次查询的最后时间戳（用于增量查询）

选填

pageSize

Integer

分页大小（1-2000）

必填

响应参数

全部展开

参数名

类型

描述

必填

items

Array

物流任务数据列表

必填

hasMore

Boolean

是否还有更多数据

必填

totalCount

Long

当前返回的数据总数

必填

nextTime

Long

下次查询的时间戳

必填

items数据结构

全部展开

参数名

类型

描述

必填

sid

String

系统订单号

必填

outSid

String

运单号

必填

cpCode

String

物流公司代码,参考cpCodeEnum枚举

必填

logisticsCompany

String

物流公司全称

必填

tid

String

平台订单号

必填

sourceId

Integer

分销商id,用于区分供分销订单

选填

shopId

String

店铺ID

必填

shopName

String

店铺名称

必填

warehouseId

String

仓库ID

必填

warehouseName

String

仓库名称

必填

source

String

订单来源

必填

tradeSource

String

订单平台,参考tradeSourceEnum枚举

必填

sendState

String

发货省份

必填

sendCity

String

发货城市

必填

receiverState

String

收货省份/州

必填

receiverCity

String

收货城市

必填

isMaster

Integer

是否为主运单（1：是,0:否）

必填

expressType

Integer

快递单类型（0：普通订单 1：快递子母单母单 2：快递子母单子单）

必填

consignStatus

Integer

发货状态（1：未发货 2：已发货）

必填

sysStatus

String

系统状态

必填

payTime

Long

支付时间，时间戳（毫秒）

必填

consignTime

Long

发货时间，时间戳（毫秒）,默认值946656000000

选填

ptConsignTime

Long

平台发货时间，时间戳（毫秒）,默认值946656000000

必填

acceptTimeoutTime

Long

揽收超时时间，时间戳（毫秒）,默认值946656000000

必填

acceptUpdateTimeoutTime

Long

揽收更新超时时间，时间戳（毫秒）,默认值946656000000

必填

traceUpdateTimeoutTime

Long

轨迹更新超时时间，时间戳（毫秒）,默认值946656000000

必填

totalTraceNum

Integer

总轨迹数量

必填

transportTraceNum

Integer

运输轨迹数量

必填

acceptAfterTraceNum

Integer

揽收后轨迹数量

必填

lastLogisticsWeight

Integer

最新物流状态权重,参考lastLogisticsWeightEnum枚举

必填

lastLogisticsStatus

String

最新物流状态,参考物流状态对照表

选填

lastSubLogisticsStatus

String

最新物流状态,参考物流状态对照表

选填

masterOutSid

String

主运单号

必填

handleStatus

Integer

处理状态（1:已处理,0:未处理)

必填

enableStatus

Integer

启用状态（1：启用）

必填

logisticsSubscribeStatus

Integer

物流订阅状态（0：订阅失败 1：订阅成功 2：订阅中）

必填

subscribeFailMsg

String

订阅失败原因

选填

payAcceptTimeoutTime

Long

支付揽收超时时间，时间戳（毫秒）,默认值946656000000

必填

created

Long

创建时间，时间戳（毫秒）

必填

modified

Long

修改时间，时间戳（毫秒）

必填

请求示例

示例一：

{
    "startTime": 1640995200000,
    "endTime": 1641081600000,
    "lastTime": 1641078000000,
    "pageSize": 50
}

响应示例

{
  "traceId" : "5336236713275309417",
  "nextTime" : 1768443375000,
  "hasMore" : true,
  "totalCount" : 1,
  "success" : true,
  "items" : [ {
    "sourceId" : 0,
    "payTime" : 1767669900000,
    "sendState" : "浙江省",
    "source" : "2",
    "receiverCity" : "延边朝鲜族自治州",
    "tid" : "5663749838239862-rrjedv",
    "traceUpdateTimeoutTime" : 946656000000,
    "consignTime" : 1767679994000,
    "isMaster" : 1,
    "modified" : 1767679994000,
    "handleStatus" : 0,
    "shopId" : "900029341",
    "tradeSource" : "sys",
    "acceptUpdateTimeoutTime" : 946656000000,
    "created" : 1767669984000,
    "expressType" : 0,
    "transportTraceNum" : 0,
    "consignStatus" : 2,
    "totalTraceNum" : 0,
    "outSid" : "K_707979297088000",
    "acceptAfterTraceNum" : 0,
    "warehouseId" : "12162",
    "receiverState" : "吉林省",
    "enableStatus" : 1,
    "acceptTimeoutTime" : 1767766394000,
    "masterOutSid" : "K_707979297088000",
    "cpCode" : "YTO",
    "sendCity" : "杭州市",
    "lastLogisticsWeight" : 0,
    "shopName" : "斑斑测试店铺简称",
    "warehouseName" : "默认仓库",
    "sid" : "5663720255467000",
    "sysStatus" : "FINISHED",
    "logisticsCompany" : "圆通速递",
    "logisticsSubscribeStatus" : 0,
    "subscribeFailMsg" : "快递助手返回订阅失败",
    "payAcceptTimeoutTime" : 946656000000,
    "ptConsignTime" : 1767679994000
  }]
 }

异常示例

{
    "code": "35",
    "msg": "接口调用频繁，请限制调用次数！",
    "success": false,
    "trace_id": "3553483395423660"
}

错误码解释

错误码	错误信息	解决方案
25	服务方法(erp.report.logistics.task.list.query:1.0)的签名无效	签名参数错误
35	接口调用频繁，请限制调用次数！	接口限流

其他说明

物流状态对照表

序号	物流主状态	状态描述	物流子状态	子状态描述
1	WAIT_ACCEPT	待接收	RECEIVE	接单中
			WAIT_ACCEPT	待接收
2	ACCEPT	已接收	ACCEPT	已接收
3	TRANSPORT	运输中	TRANSPORT	运输中
			SEND_ON	转单或修改地址转寄
			ARRIVE_CITY	到达目的城市
4	DELIVERING	派件中	DELIVERING	派件中
			STA_INBOUND	已放入快递柜或驿站
5	AGENT_SIGN	已代签收	AGENT_SIGN	已代签收
6	SIGN	已签收	SIGN	已签收
			STA_SIGN	从快递柜或者驿站取出
			RETURN_SIGN	退回签收
7	FAILED	包裹异常	FAILED	包裹异常
			REFUSE_SIGN	拒收
			DELIVER_ABNORMAL	派件异常
			RETENTION	滞留件
			ISSUE	问题件
			RETURN	退回件
			DAMAGE	破损
			CANCEL_ORDER	揽件取消

lastLogisticsWeightEnum枚举

枚举值	枚举描述
0	暂无轨迹
100	待揽收
110	已揽收
120	运输中
130	派件中
140	已代签收
150	已签收
160	包裹异常

tradeSourceEnum枚举

枚举值	枚举描述
OTHER	其他
DANGKOU	档口店铺
TB	淘宝
TM	天猫
JD	京东
DD	当当
PP	拍拍
AMAZON	亚马逊
YMX	亚马逊
SN	苏宁
GM	国美
WPH	唯品会
WPHJIT	唯品会JIT
WPHSOV	唯品会SOV
WPHJITX	唯品会JITX
JMYP	聚美优品
MGJ	蘑菇街
YHD	1号店
ALIBABA	阿里巴巴
MIA	蜜芽
TJB	淘宝特价版
WM	微盟
WEIMENG	微盟微商城
WEIMOBIR	微盟零售
MLS	美丽说
FX	淘宝分销
YZ	有赞
CCJ	楚楚街
Z800	折800
WD	微店
SMT	速卖通
BBTMH	贝贝特卖会
ECSHOP	ECSHOP
HPZ	惠品折
PDD	拼多多
QMW	千米网
JP	卷皮
FXG	抖音小店
HZW	孩子王
RRD	人人店
HYK	好衣库
HYK2	好衣库
KUAISHOU	快手
KUAJ	跨境
DVD	大V店
XHS	小红书
GS	环球捕手
YSK	云森客微商城
WSWY	万试无忧
MT	萌推
YUNCANG	云仓
DUODIANWULIAN	多典物联
YHYX	云货优选
AKC	爱库存
JD_VC	京东自营
JD_WD	京东外单
DLJ	达令家
FENQILE	分期乐
XMYP	小米有品
MOKUAI	魔筷
PDD_WD	拼多多外单
TWCN	淘外菜鸟
TUHU	途虎
KML	卡美啦
Alibabac2m	1688C2M
OMALL	洋葱商城
HIPAC	海拍客
DW	得物
DWZF	得物直发
TMGJZY	天猫国际
AliHealth	阿里医药健康

cpCodeEnum枚举

枚举值	枚举描述
POST	中国邮政
EMS	EMS
EYB	EMS经济快递
CHENGBANG	晟邦物流
STO	申通快递
YTO	圆通速递
YUNDA	韵达快递
ZJS	宅急送
BEST	百世物流
FEDEX	联邦快递
DBL	德邦物流
RFD	拼多多:如风达
YZXB	邮政快递包裹
NJCHENGBANG	南京晟邦
EWINSHINE	万象物流
HMJ	黄马甲
ZMKM	芝麻开门
YCGWL	远成快运
INTEREMS	EMS-国际件
ZTKY	中铁物流(飞豹)
RRS	日日顺物流
SNWL	苏宁快递
MYAAE	AAE全球专递
ARAMEX	Aramex
DHLCN	DHL中国
UPS	UPS
CXCOD	传喜物流
D4PX	递四方
HLWL	恒路物流
TMS56	加运美
JIAYI	佳怡物流
CP449455	京广速递
CAE	民航快递
SFWL	盛丰物流
SHENGHUI	拼多多:盛辉物流
MANCOWL	万家物流
YWWL	燕文物流
POSTBK	邮政标准快递
CNPOSTGJ	邮政国际包裹
YDKY	韵达快运
CN7000001000869	安能快运
YMDD	壹米滴答
OTP	承诺达特快
SDSD	D速物流
CP100007887	D速物流
ZTO	中通快递
HTKY	百世汇通
TTKDEX	天天快递
SF	顺丰速运
AIR	亚风速递
DTW	大田物流
CRE	中铁快运
CNEX	佳吉快递
HZABC	飞远(爱彼西)配送
YCT	黑猫宅急便
XB	新邦物流
HOAU	天地华宇
LB	龙邦速递
FAST	快捷快递
UC	优速快递
QRT	增益速递
LTS	联昊通
QFKD	全峰快递
UAPEX	全一快递
BJCS	城市100
JT	极兔快递
CP471906	顺心捷达快运
SFKY	丰网速运
LE09252050	丰网速运
BESTQJT	百世快运
GTO	国通快递
GZLT	飞远配送
POSTB	邮政国内小包
SURE	速尔
XFWL	信丰物流
GZFY	凡宇速递
ERP100004928	如风达
DBKY	德邦快运
RUSTON	俄速通
ANE56	安能快递
ERP5000000007756	邮政国内标准快递
DBKD	德邦快递
JD	京东快递
ZTOKY	中通快运
CN7000001003751	跨越速运
YCKY	远成快运
JYSCM	九曳供应链
JIAJI	佳吉快运
ERP_2744832184_543	壹米滴答
CP468398	圆通承诺达
CP570969	丹鸟
FW	丰网速运
CP446169	加运美-废弃
JYM	加运美快递
JDKD	京东大件物流
JDKY	京东快运
PADTF	平安达腾飞
FEC	银捷速递
SZSA56	圣安物流
YTZG	运通中港快递
JDYWL	筋斗云物流
ONTRAC	OnTrac
CITYLINK	City-Link
COE	COE
EES	百福东方
MBEX	民邦快递
HQKY	华企快运
YFEXPRESS	越丰物流
SZML56	明亮物流
TNT	TNT
USPS	USPS
CP443514	百世云配
LE10032270	韵达同城
SANTAI	三态速递
OCS	OCS
STOKY	申通快运
DHLDE	DHL德国
KERRYEAS	嘉里大通
DHL	DHL全球
FEDEXUS	FedEx美国
FEDEXCN	FedEx中国
ASENDIA	Asendia USA
XLOBO	贝海国际速递
SPSR	中俄快递
SAD	赛澳递
SUIJIAWL	穗佳物流
ROYALMAIL	英国皇家邮政
JKYZ	捷克邮政
BLYZ	波兰邮政
FGYZ	法国邮政
POSTTR	土耳其邮政
POSTCL	智利邮政
POSTBY	白俄罗斯邮政
POSTES	西班牙邮政
POSTUA	乌克兰邮政
POSTNO	挪威邮政
POSTZA	南非邮政
POSTPT	葡萄牙邮政
POSTSA	沙特邮政
POSTIN	印度邮政
POSTBG	保加利亚邮政
POSTAE	阿联酋邮政
POSTAU	澳大利亚邮政
POSTPK	巴基斯坦邮政
POSTMT	马耳他邮政
POSTLB	黎巴嫩邮政
POSTMD	摩尔多瓦邮政
POSTSRB	塞尔维亚邮政
POSTHR	克罗地亚邮政
POSTAM	亚美尼亚邮政
POSTMK	马其顿邮政
POSTFI	芬兰邮政
POSTAR	阿根廷邮政
POSTSK	斯洛伐克邮政
SERPOST	秘鲁邮政
POSTIT	意大利邮政
POSTSI	斯洛文尼亚邮政
POSTHU	匈牙利邮政
POSTMU	毛里求斯邮政
POSTAT	奥地利邮政
POSTAL	阿尔巴尼亚邮政
POSTEE	爱沙尼亚邮政
POSTLV	拉脱维亚邮政
POSTCO	哥伦比亚邮政
POSTBR	巴西邮政
POSTCH	瑞士邮政
BLSYZ	比利时邮政
RBYZEMS	日本邮政
EPOST	韩国邮政
POSTTH	泰国邮政
POSTSE	瑞典邮政

系统相关界面​

请求地址​

请求头​

API接口地址​

请求参数​

响应参数​

items数据结构​

请求示例​

响应示例​

异常示例​

错误码解释​

其他说明​

物流状态对照表​

lastLogisticsWeightEnum枚举​

tradeSourceEnum枚举​

cpCodeEnum枚举​

系统相关界面

请求地址

请求头

API接口地址

请求参数

响应参数

items数据结构

请求示例

响应示例

异常示例

错误码解释

其他说明

物流状态对照表

lastLogisticsWeightEnum枚举

tradeSourceEnum枚举

cpCodeEnum枚举