订单查询(非淘系,拼多多)

系统相关界面

界面路径：【交易】----【订单查询】

接口备注

此接口不包含淘系、拼多多订单数据，如需获取淘系、拼多多订单，需申请奇门、方舟appkey获取。注：各平台敏感信息受平台政策影响会有不返回或者加密返回的情况，如有需要接入前可确认 点击前往奇门申请说明

请求地址

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

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

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称	参数类型	是否必须	参数描述
method	string	是	API接口名称
appKey	string	是	分配给应用的AppKey
timestamp	string	是	时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
format	string	否	响应格式。默认为json格式，可选值：json
version	string	是	API协议版本 可选值：1.0
sign_method	string	否	签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
sign	string	是	签名
session	string	是	授权会话信息 （即access_token，由系统分配）

请求头

全部展开

参数名

类型

描述

必填

Content-Type

string

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

必填

API接口地址

全部展开

参数名

类型

描述

必填

method

string

erp.trade.list.query

必填

请求参数

全部展开

参数名

类型

描述

必填

默认值

sid

string

系统订单号，多个逗号隔开

tid

string

平台订单号，多个逗号隔开

timeType

string

查询的时间类型：[created:下单时间]--[pay_time:付款时间]--[consign_time:发货时间]--[audit_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

useCursor

boolean

传true时开启游标查询 , 仅queryType不为1时有效

cursor

string

useCursor传true时,第一次查询该参数不传，之后的每次查询传上一次接口返回的cursor

请求示例

示例一：

{
    "pageNo": "number",
    "userIds": "string",
    "timeType": "string",
    "pageSize": "number",
    "startTime": "string",
    "endTime": "string",
    "tid": "string",
    "sid": "string",
    "status": "string"
}

响应参数

全部展开

参数名

类型

描述

必填

success

boolean

示例：true

trace_id

string

示例：3553483395407017

list

array

list

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.否

exceptIds

string

自定义异常标签,多个逗号隔开

exceptNames

array

自定义异常名称列表

receiverZip

string

收件邮编

isTmallDelivery

integer

天猫直送，值true 或者 false

buyerTaxNo

string

买家税号

isHalt

integer

是否挂起订单 1.是 0.否

warehouseId

long

仓库编号

isRefund

long

1.是 0.否 是否存在退款，退款关闭或者退款成功时该数据不返回

receiverState

string

收件省份

orders

array

订单商品明细集合

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 加工商品

suits

array

套件明细(每个套件的实付金额、数量)

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

单位kg，子订单中单个商品净重

必填

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

子订单的交易结束时间

必填

orderStockProducts

list

生产信息（批次、生产日期）

必填

batchNo

string

批次号

必填

productionDate

long

生产日期

expireDate

long

到期日期

lockNum

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

单位kg，子订单中单个商品净重

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

快递公司的编号

orderExt

object

order扩展信息（订单商品备注）

必填

orderRemark

string

订单商品备注

必填

payAmount

string

商品买家已付金额（单位：元）

必填

divideOrderFee

string

平台实付(平台分摊之后的实付金额)（单位：元）

必填

orderStockProducts

list

生产信息

必填

batchNo

string

批次号

必填

productionDate

long

生产日期

expireDate

long

到期日期

lockNum

long

锁定数量

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 目前不明确供销商”、“分销商反审核”、“分销商未付款“

tradeTags

array

订单自定义标签集合

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

返回订单下第一个有匹配关系的商品编码，若都未匹配返回设定值：zzzzzz^随机数字,随机数字

saleFee

string

分销金额

exceptions

string

订单的异常信息, 店铺停用异常状态:EX_USER_UNACTIVE, 订单挂起:EX_HALT, 换地址:EX_CHANGE_ADDRESS, 退款:EX_REFUND, 部分退款:EX_PART_REFUND, 商品未匹配异常状态:EX_UNALLOCATED, 库存不足异常状态:EX_INSUFFICIENT, 商品对应关系修改异常状态:EX_RELATION_MODIFIED, 换商品的异常状态:EX_CHANGE_ITEM, 风控异常订单:EX_RISK_ORDER, 套件修改异常:EX_SUITE_CHANGE, 普通商品转加工:EX_ITEM_PROCESS_EXCEP, 货单付款重复订单异常:EX_COD_REPEAT, 平台修改备注:EX_UPDATED_SELLERMEMO, 黑名单的异常状态:EX_BLACK, 发货异常:EX_DELIVER, 上传发货异常:EX_UPLOAD_DELIVER, pdd缺货已处理异常:EX_STOCK_OUT, 发货异常:EX_WAITING_RETURN_WMS, 不明确供销商:EX_AMBIGUITY_FX, 分销商反审核:EX_UNAUDIT_FX, 分销商未付款:EX_WAITEPAY_FX, 供销商打回:EX_REPULSE_FX, 外仓商品待拆分:EX_PLATFORM_FX_SPLIT, 等待合并异常:EX_WAIT_MERGE, 商品停用异常:EX_ITEM_SHUTOFF, 天猫超时缺货回告异常:EX_TMCS_STOCK_OUT, 唯一码下架异常:EX_UNIQUE_CODE_OFFSHELF, 天猫国际直营缺货回告异常:EX_TMGJZY_STOCK_OUT, 得物直发物流模板匹配异常:EX_POISON_NOT_MATCH_EXPRESS_TEMPLATE, 唯品会未匹配常态合作码异常:EX_VIP_COOPERATION_CODE_NOT_MATCH

outSid

string

运单号

receiverAddress

string

收件详细地址

volume

double

订单体积

scalping

integer

是否空单; 1=是; 0=否

companyId

long

公司编号

netWeight

double

单位kg，订单净重，由子订单综合计算得出，参照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

承诺时间

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

快递模板名称

必填

logisticsCompanyId

long

用户物流公司ID

必填

logisticsCompanyName

string

用户物流公司名称

必填

isPackage

integer

订单是否打包 0.未打包 1.打包

必填

sellerFlag

integer

平台上的卖家旗帜 0:灰, 1:红, 2:黄, 3:绿, 4:蓝, 5:紫, 6:橙, 7:浅蓝, 8:浅粉, 9:深绿, 10:桃红

必填

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

奇门店铺订单关联的平台店铺名称

必填

selfBuiltPaymentReceivable

string

代收金额

selfBuiltDepositAmount

string

定金

selfBuiltPayment

string

货到付款总金额

tradeInvoice

object

订单发票信息

必填

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

邮箱

必填

subShop

object

子店铺信息

id

long

子店铺ID

shopName

string

店铺名称

platformCode

string

所属平台编码

shopCode

string

店铺编码

logisticsCode

string

物流商编码

tradePictureMemoUris

array

订单文件列表

total

long

总数 仅在非归档订单查询（请求参数useHasNext，useCursor都不为true时）第一页返回

hasNext

boolean

是否有下一页

cursor

string

游标

响应示例

{
  "traceId": "1876936694781585983",
  "list": [
    {
      "buyerNick": "XXXXX",
      "threePlTiming": 0,
      "type": "4,99,0",
      "receiverCity": "杭州市",
      "packmaCost": 0,
      "expressCode": "YUNDA",
      "payment": "42",
      "isExcep": 1,
      "receiverZip": "223700",
      "isTmallDelivery": 0,
      "isHalt": 0,
      "warehouseId": XXXX,
      "isRefund": 0,
      "receiverState": "浙江省",
      "orders": [
        {
          "discountRate": 100,
          "discountFee": "0.00",
          "payTime": 1592967330000,
          "num": 2,
          "source": "sys",
          "sysTitle": "12罐 美甲饰品天然鲍鱼贝壳片不规则指甲贴碎片 日系幻彩光疗甲",
          "type": 0,
          "tid": "XXXXXXX",
          "isPresell": 0,
          "consignTime": 946656000000,
          "updTime": 1592967337000,
          "price": "21.00",
          "giftNum": 0,
          "stockNum": 2,
          "modified": 946656000000,
          "stockStatus": "NORMAL",
          "payment": "42.00",
          "id": XXXXXXX,
          "created": 1592967330000,
          "insufficientCanceled": 0,
          "taobaoId": 0,
          "sysOuterId": "SKU000817",
          "saleFee": "0.0",
          "volume": 0,
          "picPath": "XXXXXXX",
          "netWeight": 0,
          "companyId": XXXXXX,
          "isVirtual": 0,
          "sysConsigned": 0,
          "oid": XXXXX,
          "itemSysId": XXXXXXX,
          "sid": XXXXXXX,
          "forcePackNum": 0,
          "sysStatus": "FINISHED_AUDIT",
          "sysItemOuterId": "XXXXXXX",
          "priceDouble": 21,
          "cost": 0,
          "isCancel": 0,
          "salePrice": "0.0",
          "combineId": 0,
          "ptConsignTime": 946656000000,
          "totalFee": "42.00",
          "sysPicPath": "XXXXXXX",
          "skuSysId": -1,
          "endTime": 946656000000
        }
      ],
      "expressCompanyId": 102,
      "isUrgent": 0,
      "theoryPostFee": 0,
      "warehouseName": "默认仓库",
      "itemNum": 2,
      "receiverDistrict": "滨江区",
      "taxFee": "0",
      "isHandlerMessage": 0,
      "grossProfit": 0,
      "salePrice": "0.00",
      "postFee": "0",
      "receiverMobile": "66876387840",
      "userId": 0,
      "splitType": -1,
      "itemKindNum": 1,
      "ptConsignTime": 946656000000,
      "endTime": 946656000000,
      "excep": 0,
      "splitSid": -1,
      "shortId": 63,
      "discountFee": "0.00",
      "payTime": 1592967330000,
      "mobileTail": "7840",
      "source": "sys",
      "templateId": XXXXXX,
      "tid": "XXXXXXX",
      "isPresell": 0,
      "consignTime": 946656000000,
      "updTime": 1632984391000,
      "modified": 946656000000,
      "stockStatus": "NORMAL",
      "created": 1592967330000,
      "taobaoId": 0,
      "weight": 0,
      "sysOuterId": "XXXXXXX",
      "saleFee": "0.00",
      "exceptions": [
        "EX_DELIVER"
      ],
      "volume": 0,
      "receiverAddress": "道588号恒鑫大厦10F光云科技349866876387841",
      "scalping": 0,
      "netWeight": 0,
      "companyId": XXXXXX,
      "sid": XXXXXX,
      "sysStatus": "WAIT_SEND_GOODS",
      "cost": 0,
      "isCancel": 0,
      "receiverName": "XXXXXXX",
      "isHandlerMemo": 0,
      "timeoutActionTime": 946656000000,
      "isPackage": 0,
      "expressCompanyName": "韵达快递",
      "totalFee": "42",
      "templateName": "K_韵达快递标准"
    }
  ],
  "total": 1,
  "success": true
}

异常示例

{
    "code": "25",
    "msg": "服务方法(item.single.get:1.0)的签名无效",
    "success": false,
    "trace_id": "3553483395423660"
}

错误码解释

错误信息	错误码	解决方案
资源异常,请联系管理员!	400	检查参数是否合法
非法参数!	50	检查参数类型等是否合法
查询的时间类型不合法！created: 下单时间, pay_time：付款时间，consign_time：发货时间，audit_time：审核时间，upd_time：修改时间]字段：[timeType]	50	检查参数是否合法
店铺ID格式不正确！	20014	检查参数是否合法
店铺ID数量最大支持10组！	20015	参数过长
订单状态不合法！[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：交易关闭]字段：[status]	50	检查参数是否合法
标签ID格式不正确	20101	检查参数是否合法
查询指定标签ID数量最大支持10组	20102	检查参数是否合法
标签ID格式不正确	20103	检查参数是否合法
排除标签ID数量最大支持10组	20104	检查参数是否合法
自定义异常标签ID格式不正确	20105	检查参数是否合法
自定义异常标签ID数量最大支持10组	20106	检查参数是否合法
系统异常标签ID数量最大支持10组	20108	检查参数是否合法
异常查询状态不合法！[1:仅包含 2:排除 3:同时包含]	50	检查参数是否合法
订单查询失败	30077	请根据返回的错误信息进行处理