订单查询(非淘系)
POST
请求地址/router
系统相关界面
接口备注
请求地址
公共参数
请求头
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填
API接口地址
application/x-www-form-urlencoded参数名
类型
描述
必填
method
string
erp.trade.list.query
必填
请求参数
参数名
类型
描述
必填
默认值
sid
string
系统订单号,多个逗号隔开
可选
tid
string
平台订单号,多个逗号隔开
可选
timeType
string
查询的时间类型:created: 下单时间, pay_time: 付款时间,upd_time:修改时间;与startTime、endTime同时使用,时间跨度建议不超过一天
可选
startTime
string
起始时间:格式yyyy-MM-dd HH:mm:ss,与timeType、endTime同时使用,时间跨度建议不超过一天
可选
endTime
string
截止时间:格式yyyy-MM-dd HH:mm:ss,与timeType、startTime同时使用,时间跨度建议不超过一天
可选
userIds
string
店铺ID,多个逗号隔开
可选
pageSize
integer
每页多少条,最大支持200,不能小于20
可选
20
pageNo
integer
页码
可选
1
status
string
系统状态,对应响应参数的sysStatus订单系统状态(支持多个,逗号隔开).WAIT_BUYER_PAY:待付款,WAIT_AUDIT:待审核,WAIT_FINANCE_AUDIT:待财审,FINISHED_AUDIT:审核完成, WAIT_EXPRESS_PRINT:待打印快递单,WAIT_PACKAGE:待打包,WAIT_WEIGHT:待称重,WAIT_SEND_GOODS:待发货, WAIT_DEST_SEND_GOODS:待供销商发货,SELLER_SEND_GOODS:卖家已发货,FINISHED:交易完成,CLOSED:交易关闭
可选
tagIds
string
查询指定标签ID集合,多个逗号隔开,最多支持十组
可选
exceptIds
string
自定义异常标签,多个逗号隔开,最多支持十组
可选
exceptionStatus
string
系统异常标签,多个逗号隔开,最多支持十组
可选
types
string
订单类型,多个逗号0=普通订单;1=货到付款;3=平台订单;4=线下订单;6=预售订单;7=合并订单;8=拆分订单;9=加急订单;10=空包订单;11=合单提示;12=门店订单;13=换货订单;14=补发订单;16=海外仓订单;17=Lazada;18=报损单;19=领用单;20=调整单;21=客户订单;22=天猫直送;23=平台预售;24=京东直发;25=京东供销;33=分销订单;34=供销订单;35=京配订单;36=平台分销;50=天猫淘宝店铺预售;51=抖音厂商代发;53=亚马逊FBA;54=亚马逊FBM;55=亚马逊多渠道;56=奇门订单;57=得物普通现货;58=得物极速现货;60=全款预售;61=得物直发订单;62=Lazada-FBL;66=平台拆单;99=出库单
可选
onlyContain
string
异常查询状态:1:仅包含 2:排除 3:同时包含
可选
consignedType
integer
发货方式 0.非ERP发货 1.ERP发货
可选
buyerNick
string
买家ID
可选
queryType
integer
订单查询范围类型 0.三个月内订单 1.三个月之前订单
可选
0
outSids
string
运单号,多个逗号隔开
可选
useHasNext
boolean
传true时不会返回total(不统计总数), 返回hasNext用以判断是否有下一页数据,传false时按原来逻辑只返回total
可选
请求示例
响应参数
参数名
类型
描述
success
boolean
示例:true
trace_id
string
示例:3553483395407017
paymentDiff
double
订单差额=系统实付金额-平台实收金额 区间值
buyerNick
string
平台订单上的买家昵称
threePlTiming
integer
3PL有时效订单标,值true 或者 false
type
string
订单类型,多个逗号0=普通订单;1=货到付款;3=平台订单;4=线下订单;6=预售订单;7=合并订单;8=拆分订单;9=加急订单;10=空包订单;11=合单提示;12=门店订单;13=换货订单;14=补发订单;16=海外仓订单;17=Lazada;18=报损单;19=领用单;20=调整单;21=客户订单;22=天猫直送;23=平台预售;24=京东直发;25=京东供销;33=分销订单;34=供销订单;35=京配订单;36=平台分销;50=天猫淘宝店铺预售;51=抖音厂商代发;53=亚马逊FBA;54=亚马逊FBM;55=亚马逊多渠道;56=奇门订单;57=得物普通现货;58=得物极速现货;60=全款预售;61=得物直发订单;62=Lazada-FBL;66=平台拆单;99=出库单
receiverCity
string
收件市
invoiceRemark
string
发票备注
poNos
string
唯品会po单号
packmaCost
double
包材成本
receiverPhone
string
收件人固话
expressCode
string
快递公司的编码
payment
string
实付金额
payAmount
string
订单买家已付金额(单位:元)
adjustFee
string
手工调整订单价格
isExcep
integer
是否异常订单 1.异常订单 0.否
receiverZip
string
收件邮编
isTmallDelivery
integer
天猫直送,值true 或者 false
buyerTaxNo
string
买家税号
isHalt
integer
是否挂起订单 1.是 0.否
warehouseId
long
仓库编号
isRefund
long
是否包含退款订单 1.是 0.否
receiverState
string
收件省份
sysSkuPropertiesName
string
系统SKU的规格属性名称
discountRate
double
折扣率
discountFee
string
优惠金额
payTime
long
付款时间
numIid
string
平台商品数字编号
num
integer
子订单商品数量
source
string
订单来源 tb,tm,jd,sys
shortTitle
string
商品简称
sysTitle
string
系统商品的标题
type
integer
0 普通商品 1 赠品 是否是赠品不能根据type来判断,而要根据giftNum>0 来判断 2 套件商品 3 组合商品 4 加工商品
sysSkuPropertiesName
string
系统SKU的规格属性名称
discountRate
double
折扣率
discountFee
string
优惠金额
payTime
long
付款时间
numIid
string
平台商品数字编号
num
integer
子订单商品数量
source
string
订单来源 tb,tm,jd,sys
shortTitle
string
商品简称
sysTitle
string
系统商品的标题
type
integer
0 普通商品 1 赠品 是否是赠品不能根据type来判断,而要根据giftNum>0 来判断 2 套件商品 3 组合商品 4 加工商品
cost
double
该商品总成本价
outerSkuId
string
外部skuID
combineId
long
如果是套件单品,则该字段的值为其所属的套件子订单的id,否则为0
payAmount
string
商品买家实付金额
tid
string
所属订单的平台编号
consignTime
long
子订单发货时间
isPresell
integer
是否为预售订单 0:正常订单,1:是预售;2预售转正常;3:系统预售
price
string
商品销售价
updTime
long
数据更新时间
giftNum
integer
赠品的order数量
stockStatus
string
当前子订单的库存状态,如库存正常(NORMAL),库存不足(INSUFFICIENT)
modified
long
子订单平台的修改时间
payment
string
实付金额, 公式: 实付金额 = 应付金额 - 优惠金额
id
long
子订单系统编号
adjustFee
string
手工调整金额
skuId
string
平台规格编号
created
string
下单时间
insufficientCanceled
integer
是否取消库存缺货异常(INSUFFICIENT,EMPTY,EXCEP):0 否,1 是
taobaoId
long
订单店铺的平台ID
sysOuterId
string
系统商家编码,如果是商品则为商品的商家编码,如果为SKU则为SKU的商家编码
saleFee
string
分销金额
picPath
string
平台商品图片链接
volume
double
单个商品体积
sysItemRemark
string
系统规商品备注
companyId
long
公司编号
netWeight
double
子订单中单个商品净重
unit
string
系统商品数量单位
isVirtual
integer
是否虚拟商品,虚拟商品不需要申请库存,发货时也不需要消费库存、归还库存
status
string
子订单平台状态
sysConsigned
integer
是否在系统发货 0.否 1.是 2.其他erp发货
refundStatus
string
子订单退款状态
oid
long
子订单平台编号(淘宝有,京东没有)
title
string
商品标题
itemSysId
long
匹配到的系统商品ID
sid
long
所属主订单的系统编号
forcePackNum
integer
强制验货数量
sysStatus
string
订单系统状态
divideOrderFee
string
平台实付(平台分摊之后的实付金额)
skuPropertiesName
string
规格属性名
cost
double
商品成本价
isCancel
integer
是否作废,未发货的子订单与所属的trade保持一致
salePrice
string
分销价格
combineId
long
如果是套件单品,则该字段的值为其所属的套件子订单的id,否则为0
ptConsignTime
long
平台发货时间
totalFee
string
应付金额, 公式: 应付金额 = 商品数量 * 商品单价 + 手工调整价
sysPicPath
string
系统商品图片链接
skuSysId
long
匹配到的系统规格ID
estimateConTime
long
预计发货时间
endTime
long
子订单的交易结束时间
tid
string
所属订单的平台编号
isPresell
integer
是否为预售订单 0:正常订单,1:是预售;2预售转正常;3:系统预售
consignTime
long
子订单发货时间
uniqueCode
string
uniqueCode
outerSkuId
string
outer_sku_id
sysSkuPropertiesAlias
string
系统SKU规格属性别名
price
string
商品销售价
updTime
long
数据更新时间
giftNum
string
赠品的order数量
stockNum
integer
分配的库存数量
stockStatus
string
当前子订单的库存状态, EMPTY【库存不足】 NORMAL【正常】 UNALLOCATED【商品未分配】 INSUFFICIENT【库存不足】 RELATION_MODIFIED【商品对应关系修改】 EXCEP【库存不足】
modified
long
子订单平台的修改时间
payment
string
实付金额, 公式: 实付金额 = 应付金额 - 优惠金额
id
long
子订单系统编号
adjustFee
string
手工调整金额
skuId
string
平台规格编号
created
long
下单时间
insufficientCanceled
integer
是否取消库存缺货异常(INSUFFICIENT,EMPTY,EXCEP):0 否,1 是
taobaoId
string
订单店铺的平台ID
diffStockNum
integer
缺货数量=num-stockNum(不需要持久化)
sysSkuRemark
string
系统规格备注
sysOuterId
string
系统商家编码,如果是商品则为商品的商家编码,如果为SKU则为SKU的商家编码
saleFee
string
分销金额
exceptions
string
子订单异常信息
volume
string
单个商品体积
picPath
string
平台商品图片链接
sysItemRemark
string
系统规商品备注
companyId
long
公司编号
unit
string
系统商品数量单位
netWeight
string
子订单中单个商品净重
osGiftCount
string
前N有礼赠品数量
oldStatus
string
子订单旧的平台状态,不做持久化,一般用于订单同步更新时的判断比较
warehouseId
string
子订单商品库存操作时的仓库ID,要保证与所属trade中的warehouseId一致
authorName
string
达人名称
isVirtual
string
是否虚拟商品,虚拟商品不需要申请库存,发货时也不需要消费库存、归还库存
status
string
子订单平台状态
sysConsigned
integer
是否ERP发货 0:未发货,1:ERP发货,2:其他ERP发货
soid
string
子订单平台编号(由于某些平台的子订单号为字符类型,需要用此字段保存,后续可将oid修改为String类型)
refundStatus
string
子订单退款状态 CLOSED:退款关闭 NO_REFUND:未退款 SELLER_CONTINUE_CONSIGN:卖家已发货退款 SELLER_REFUSE_BUYER:卖家拒绝退款 WAIT_SELLER_AGREE:待卖家同意退款 WAIT_BUYER_RETURN_GOODS:待买家退货 WAIT_SELLER_CONFIRM_GOODS:待卖家确认收货 SUCCESS:退款成功
oid
long
子订单平台编号(淘宝有,京东没有)
itemSysId
long
匹配到的系统商品ID
title
string
平台商品名称
sid
string
所属主订单的系统编号
forcePackNum
string
强制验货数量
acPayment
string
不变的实付金额, 进来后不变
sysStatus
string
订单系统状态 WAIT_BUYER_PAY【待付款】 WAIT_AUDIT【待审核】 WAIT_FINANCE_AUDIT【等待财审】 WAIT_MANUAL_AUDIT【等待人工审核】 FINISHED_AUDIT【审核完成】 WAIT_EXPRESS_PRINT【待打印快递单】 SYS_STATUS_WAIT_DELIVERY_PRINT【待打印发货单】 WAIT_PACKAGE【待打包】 WAIT_WEIGHT【待称重】 WAIT_SEND_GOODS【待发货】 WAIT_DEST_SEND_GOODS【待供销商发货】 SELLER_SEND_GOODS【卖家已发货】 FINISHED【交易完成】 CLOSED【交易关闭】 CANCEL【交易作废】
sysItemOuterId
string
系统主商家编码,暂不做持久化
osSortNum
string
前N有礼中奖名次,获得奖品的订单才会有该字段
skuPropertiesName
string
规格属性名
skuUnit
string
系统规格计量单位
cost
double
商品成本价 cost*num 该商品总成本价
isCancel
string
是否作废,未发货的子订单与所属的trade保持一致
salePrice
string
分销价格
oldPrice
string
原商品销售价,在套件转单品去匹配赠品时候使用
postFee
string
单笔订单运费
identCode
string
识别码
combineId
string
如果是套件单品,则该字段的值为其所属的套件子订单的id,否则为0
authorId
string
达人id
userId
long
订单所属店铺用户ID
ptConsignTime
long
平台发货时间
totalFee
string
应付金额, 公式: 应付金额 = 商品数量 * 商品单价 + 手工调整价
sysPicPath
string
系统商品图片链接
skuSysId
long
匹配到的系统规格ID
outerId
string
商家编码,不做持久化,仅仅只是为了系统订单添加商品使用
endTime
string
子订单的交易结束时间
estimateConTime
string
预计发货时间
refundId
string
平台退款编号
expressCompanyId
快递公司的编号
payAmount
string
商品买家已付金额(单位:元)
divideOrderFee
string
平台实付(平台分摊之后的实付金额)(单位:元)
expressCompanyId
long
快递公司的编号
status
string
订单的平台状态,详情查看各平台开放平台
isUrgent
integer
是否是加急订单 1.是 0.否
theoryPostFee
double
理论运费
warehouseName
string
仓库名称
hasSuit
boolean
是否含有套件 true.是 false.否
itemNum
integer
订单下的商品数量
receiverDistrict
string
收件区县
taxFee
string
税费
isHandlerMessage
integer
是否处理买家留言: 0:未处理 1:已处理
grossProfit
double
毛利润
postFee
string
邮费:合单的话,取的是主单的邮费
receiverMobile
string
收件人手机号
singleItemKindNum
integer
商品单品种类, 最小粒度
userId
long
店铺用户编号
itemKindNum
integer
订单下的商品种类数
exceptMemo
string
异常备注
ptConsignTime
string
平台发货时间
buyerMessage
string
平台订单上的买家留言
unifiedStatus
string
各平台状态映射后的统一状态 待付款:WAIT_BUYER_PAY 待发货:WAIT_SEND_GOODS 卖家部分发货:SELLER_CONSIGNED_PART 卖家已发货:SELLER_SEND_GOODS 交易完成:FINISHED 交易关闭:CLOSED
excep
long
订单级别的系统异常,参考itemExcep 目前不明确供销商”、“分销商反审核”、“分销商未付款“
bgColor
string
标签背景颜色
remark
string
标签备注
id
long
标签id
tagName
string
标签名称
fontColor
string
标签前景颜色
shortId
long
订单短号
discountFee
string
优惠
sellerFlagString
string
匹配规则用,用逗号分开
payTime
long
付款时间
mobileTail
string
手机后四位尾号
source
string
订单来自哪个平台,例如 tb(淘宝或者天猫平台),jd(京东平台),sys(系统手工订单)
tid
string
平台订单号
consignTime
long
发货时间
isPresell
integer
是否为预售订单:0:正常订单,1:是预售;2预售转正常;3:系统预售
receiverCountry
string
收件国家,跨境订单使用
updTime
long
数据库最后更新时间
stockStatus
string
库存状态 EMPTY【库存不足】 NORMAL【正常】 UNALLOCATED【商品未分配】 INSUFFICIENT【库存不足】 RELATION_MODIFIED【商品对应关系修改】 EXCEP【库存不足】
modified
long
订单在平台上的修改时间
created
long
下单时间
taobaoId
long
平台的卖家账户
weight
double
重量
auditMatchRule
integer
智能审核规则匹配结果
sysOuterId
string
订单下第一个匹配系统商品的子订单的系统商家编码,若都没有匹配,则直接取第一个商品的平台商家编码
saleFee
string
分销金额
exceptions
string
订单的异常信息
outSid
string
运单号
receiverAddress
string
收件详细地址
volume
double
订单体积
scalping
integer
是否空单; 1=是; 0=否
companyId
long
公司编号
netWeight
double
订单净重,由子订单综合计算得出,参照Order#netWeight
sellerMemo
string
平台上的卖家备注
chSysStatus
string
订单系统状态的中文说明
subSource
string
次来源地 jd 保存订单来源
sysMemo
string
订单系统备注
shopName
string
店铺名称
sid
long
系统订单号
cancelFrom
integer
供销订单使用,分销作废来源 0,取消分销属性 1,分销订单作废
acPayment
string
不变的实付金额
sysStatus
string
订单系统状态 WAIT_BUYER_PAY【待付款】 WAIT_AUDIT【待审核】 WAIT_FINANCE_AUDIT【等待财审】 WAIT_MANUAL_AUDIT【等待人工审核】 FINISHED_AUDIT【审核完成】 WAIT_EXPRESS_PRINT【待打印快递单】 SYS_STATUS_WAIT_DELIVERY_PRINT【待打印发货单】 WAIT_PACKAGE【待打包】 WAIT_WEIGHT【待称重】 WAIT_SEND_GOODS【待发货】 WAIT_DEST_SEND_GOODS【待供销商发货】 SELLER_SEND_GOODS【卖家已发货】 FINISHED【交易完成】 CLOSED【交易关闭】 CANCEL【交易作废】
manualPaymentAmount
double
手工支付金额
fxIsUpload
integer
分销订单是否在系统上传(供销订单用) 1.是 0.否
promiseService
string
承诺服务类型,会有多个服务值,以英文半角逗号","切割,其中 tmallpromise.arrival.timing 代表到货承诺时效 tmallpromise.consign.timing代表发货承诺时效
cost
double
订单总成本价,所有商品总成本价之和
isCancel
integer
是否为作废订单 1.是 0.否
receiverName
string
收件人姓名
timeoutActionTime
string
平台timeout_action_time
isHandlerMemo
integer
是否处理卖家备注: 0:未处理 1:已处理
expressCompanyName
string
快递公司的名称
isCancelDistributorAttribute
integer
是否是取消分销属性触发的订单同步,如果是1,则不需要匹配供应商,因为是取消分销属性
tradeFrom
string
订单来源,例如手机端或者PC端
platformPaymentAmount
double
平台支付金额
totalFee
string
总额
wlbTemplateType
integer
供销订单用
timingPromise
string
服务身份标识
actualPostFee
string
实际运费
splitType
integer
拆单类型 -1:未拆单 1:拆单
splitSid
long
如果splitType等于1。则对应拆单的主单的sid。否则为-1
endTime
string
完结时间
templateId
long
快递模板id
templateName
string
快递模板名称
isPackage
integer
订单是否打包 0.未打包 1.打包
sellerFlag
integer
平台上的卖家旗帜 0.灰 1.红 2.橙 3.绿 4.蓝 5紫
salesmanId
long
业务员ID
salesmanName
string
业务员名称
sourceName
string
订单来源于哪里 分销系统里记为分销商名称
sourceId
long
分销商ID
destName
string
订单归属于哪里 分销系统里记为供销商名称
destId
long
供销商ID
expressPrintTime
date
快递单打印时间
deliverPrintTime
date
发货单打印时间
expressStatus
int
快递单打印状态 , 0 : 否, 1:是
deliverStatus
int
发货单打印状态 , 0 : 否, 1:是
sellerNick
string
奇门店铺订单关联的平台店铺名称
invoiceType
string
发票抬头类型:1个人 2企业
invoiceKind
string
发票类型:1纸质普通 2纸质专票 3电子普通 4电子专票
invoiceName
string
发票抬头
buyerTaxNo
string
买家税号
invoiceRemark
string
发票备注
buyerAddress
string
购方地址
buyerPhone
string
购方电话
buyerBank
string
购方开户行
buyerBankAccount
string
购方开户行账号
invoiceAmount
string
开票金额
email
邮箱
hasNext
boolean
是否有下一页