销售出库查询

系统相关界面

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

请求地址

环境	服务地址(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.outstock.simple.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

系统异常标签,多个逗号隔开,最多支持十组

onlyContain

string

异常查询状态：1:仅包含 2:排除 3:同时包含

types

string

订单类型,多个逗号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=出库单

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

type

string

订单类型,多个逗号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=出库单

receiverCountry

string

收件国家，跨境订单使用（淘系、拼多多订单不返回）

receiverState

string

收件省份（淘系、拼多多订单不返回）

receiverCity

string

收件市（淘系、拼多多订单不返回）

receiverDistrict

string

收件区县（淘系、拼多多订单不返回）

receiverStreet

string

收件街道（淘系、拼多多订单不返回）

receiverAddress

string

收件详细地址（淘系、拼多多订单不返回）

receiverZip

string

收件邮编（淘系、拼多多订单不返回）

receiverMobile

string

收件人手机号（淘系、拼多多订单不返回）

receiverName

string

收件人姓名（淘系、拼多多订单不返回）

receiverPhone

string

收件人固话（淘系、拼多多订单不返回）

buyerNick

string

平台订单上的买家昵称（淘系、拼多多订单不返回）

warehouseId

long

仓库id

warehouseName

string

仓库名称

orders

array

订单商品明细集合

userId

long

订单所属店铺用户ID

tid

string

所属订单的平台编号

type

integer

0 普通商品 1 赠品 是否是赠品不能根据type来判断，而要根据giftNum>0 来判断 2 套件商品 3 组合商品 4 加工商品

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【交易作废】

sysSkuPropertiesName

string

系统SKU的规格属性名称

discountRate

double

折扣率

discountFee

string

优惠金额

payTime

long

付款时间

created

long

下单时间

consignTime

long

子订单发货时间

endTime

long

子订单的交易结束时间

modified

long

子订单平台的修改时间

updTime

long

数据更新时间

numIid

string

平台商品数字编号

num

integer

子订单商品数量

payment

string

实付金额, 公式: 实付金额 = 应付金额 - 优惠金额（单位：元）

source

string

订单来源 tb,tm,jd,sys

shortTitle

string

商品简称

sysTitle

string

系统商品的标题

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

string

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

long

下单时间

必填

insufficientCanceled

integer

是否取消库存缺货异常（INSUFFICIENT,EMPTY,EXCEP）：0 否，1 是

必填

taobaoId

long

订单店铺的平台ID

必填

sysOuterId

string

系统商家编码，如果是商品则为商品的商家编码，如果为SKU则为SKU的商家编码

必填

saleFree

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

平台发货时间

必填

totalFree

string

应付金额, 公式: 应付金额 = 商品数量 * 商品单价 + 手工调整价

必填

sysPicPath

string

系统商品图片链接

必填

skuSysId

long

匹配到的系统规格ID

必填

estimateConTime

long

预计发货时间

必填

endTime

long

子订单的交易结束时间

必填

orderStockProducts

list

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

必填

batchNo

string

批次号

必填

productionDate

long

生产日期

expireDate

long

到期日期

lockNum

long

锁定数量

isPresell

integer

是否为预售订单 0:正常订单，1：是预售；2预售转正常；3：系统预售

uniqueCode

string

uniqueCode

outerSkuId

string

outer_sku_id

sysSkuPropertiesAlias

string

系统SKU规格属性别名

price

string

商品销售价

giftNum

integer

赠品的order数量

stockNum

integer

分配的库存数量

stockStatus

string

当前子订单的库存状态, EMPTY【库存不足】 NORMAL【正常】 UNALLOCATED【商品未分配】 INSUFFICIENT【库存不足】 RELATION_MODIFIED【商品对应关系修改】 EXCEP【库存不足】

id

long

子订单系统编号

adjustFee

string

手工调整金额

skuId

string

平台规格编号

insufficientCanceled

integer

是否取消库存缺货异常（INSUFFICIENT,EMPTY,EXCEP）：0 否，1 是

taobaoId

long

订单店铺的平台ID（淘系、拼多多订单不返回）

diffStockNum

integer

缺货数量=num-stockNum（不需要持久化）

sysSkuRemark

string

系统规格备注

sysOuterId

string

系统商家编码，如果是商品则为商品的商家编码，如果为SKU则为SKU的商家编码

saleFee

string

分销金额

exceptions

string

订单的异常信息

volume

double

单个商品体积

picPath

string

平台商品图片链接

sysItemRemark

string

系统规商品备注

companyId

long

公司编号

unit

string

系统商品数量单位

netWeight

string

子订单中单个商品净重

osGiftCount

string

前N有礼赠品数量

oldStatus

string

子订单旧的平台状态，不做持久化，一般用于订单同步更新时的判断比较

warehouseId

long

子订单商品库存操作时的仓库ID,要保证与所属trade中的warehouseId一致

authorId

long

达人id

authorName

string

达人名称

isVirtual

integer

是否虚拟商品，虚拟商品不需要申请库存，发货时也不需要消费库存、归还库存

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

long

所属主订单的系统编号

forcePackNum

integer

强制验货数量

acPayment

string

不变的实付金额, 进来后不变

sysItemOuterId

string

系统主商家编码

osSortNum

string

前N有礼中奖名次，获得奖品的订单才会有该字段

skuPropertiesName

string

规格属性名

skuUnit

string

系统规格计量单位

cost

double

商品成本价 cost*num 该商品总成本价

isCancel

integer

是否作废，未发货的子订单与所属的trade保持一致

salePrice

string

分销价格

oldPrice

string

原商品销售价，在套件转单品去匹配赠品时候使用

postFee

string

单笔订单运费

identCode

string

识别码

payAmount

string

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

必填

combineId

long

如果是套件单品,则该字段的值为其所属的套件子订单的id,否则为0

ptConsignTime

long

平台发货时间（淘系、拼多多订单不返回）

totalFee

string

应付金额, 公式: 应付金额 = 商品数量 * 商品单价 + 手工调整价

sysPicPath

string

系统商品图片链接

skuSysId

long

匹配到的系统规格ID

outerId

string

商家编码，不做持久化，仅仅只是为了系统订单添加商品使用

estimateConTime

long

预计发货时间

refundId

string

平台退款编号

expressCompanyId

long

快递公司的编号

orderExt

object

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

必填

orderRemark

string

订单商品备注

必填

divideOrderFee

string

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

必填

orderStockProducts

list

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

必填

batchNo

string

批次号

必填

productionDate

long

生产日期

expireDate

long

到期日期

lockNum

long

锁定数量

outSid

string

运单号

expressCode

string

快递公司的编码

expressCompanyName

string

快递公司的名称

expressCompanyId

long

快递公司的编号

postFee

string

邮费：合单的话，取的是主单的邮费

theoryPostFee

double

理论运费

actualPostFee

string

实际运费

poNos

string

唯品会po单号

packmaCost

double

包材成本

payment

string

实付金额（单位：元）

userId

long

店铺用户编号

isRefund

long

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

isExcep

integer

是否异常订单

exceptIds

string

自定义异常标签,多个逗号隔开,最多支持十组

exceptNames

array

自定义异常名称列表

isHalt

integer

是否挂起订单

isUrgent

integer

是否是加急订单

isPresell

integer

是否为预售订单：0:正常订单，1：是预售；2预售转正常；3：系统预售

isCancel

integer

是否为作废订单 1.是 0.否

threePlTiming

integer

3PL有时效订单标，值true 或者 false

isTmallDelivery

integer

天猫直送，值true 或者 false

buyerTaxNo

string

买家税号

status

string

订单的平台状态

paymentDiff

double

订单差额=系统实付金额-平台实收金额 区间值

adjustFee

string

手工调整订单价格

hasSuit

boolean

是否含有套件

itemNum

integer

订单下的商品数量

taxFee

string

税费

isHandlerMessage

integer

是否处理买家留言： 0：未处理 1：已处理

grossProfit

double

毛利润

singleItemKindNum

integer

商品单品种类, 最小粒度

itemKindNum

integer

订单下的商品种类数

exceptMemo

string

异常备注

buyerMessage

string

平台订单上的买家留言（淘系、拼多多订单不返回）

unifiedStatus

string

各平台状态映射后的统一状态

excep

long

订单级别的系统异常，参考itemExcep 目前不明确供销商”、“分销商反审核”、“分销商未付款“

tradeTags

array

订单自定义标签集合

bgColor

string

标签背景颜色

remark

string

标签备注

id

long

标签id

tagName

string

标签名称

fontColor

string

标签前景颜色

shortId

long

订单短号

discountFee

string

优惠

sellerFlagString

string

匹配规则用，用逗号分开

created

long

下单时间

payTime

long

付款时间

consignTime

long

发货时间

endTime

long

完结时间

updTime

long

数据库最后更新时间

modified

long

订单在平台上的修改时间

ptConsignTime

long

平台发货时间（淘系、拼多多订单不返回）

mobileTail

string

手机后四位尾号

source

string

订单来自哪个平台，例如 tb(淘宝或者天猫平台),jd(京东平台),sys(系统手工订单)

tid

string

平台订单号

needInvoice

integer

需要开具发票 1开启，0关闭。已废弃，现在可根据根据tradeTags 已开票的标签

invoiceName

string

发票抬头（淘系、拼多多订单不返回）

invoiceRemark

string

发票备注（淘系、拼多多订单不返回）

invoiceFormat

integer

发票类型 1普通 2增值

invoiceType

string

发票类型

invoiceKind

string

发票种类（ 1 电子发票 2 纸质发票 ）（淘系、拼多多订单不返回）

stockStatus

string

库存状态 EMPTY【库存不足】 NORMAL【正常】 UNALLOCATED【商品未分配】 INSUFFICIENT【库存不足】 RELATION_MODIFIED【商品对应关系修改】 EXCEP【库存不足】

taobaoId

long

平台的卖家账户（淘系、拼多多订单不返回）

weight

double

重量

auditMatchRule

integer

智能审核规则匹配结果

sysOuterId

string

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

saleFee

string

分销金额

exceptions

array

订单的异常信息 店铺停用异常状态: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

volume

double

订单体积

scalping

integer

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

companyId

long

公司编号

netWeight

double

订单净重，由子订单综合计算得出，参照Order#netWeight

sellerMemo

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【交易作废】

chSysStatus

string

订单系统状态的中文说明

manualPaymentAmount

double

手工支付金额

fxIsUpload

integer

分销订单是否在系统上传（供销订单用）

promiseService

string

承诺服务类型，会有多个服务值，以英文半角逗号","切割，其中 tmallpromise.arrival.timing 代表到货承诺时效 tmallpromise.consign.timing代表发货承诺时效

cost

double

订单总成本价,所有商品总成本价之和

timeoutActionTime

long

承诺时间

isHandlerMemo

integer

是否处理卖家备注： 0：未处理 1：已处理

isCancelDistributorAttribute

integer

是否是取消分销属性触发的订单同步，如果是1，则不需要匹配供应商，因为是取消分销属性

tradeFrom

string

订单来源，例如手机端或者PC端

platformPaymentAmount

double

平台支付金额（淘系、拼多多订单不返回）

totalFee

string

总额

wlbTemplateType

integer

供销订单用

expressPrintTime

date

快递单打印时间

必填

deliverPrintTime

date

发货单打印时间

必填

expressStatus

int

快递单打印状态 , 0 : 否， 1:是

必填

deliverStatus

发货单打印状态， 0 : 否， 1:是

必填

timingPromise

string

服务身份标识

splitType

integer

拆单类型 -1:未拆单 1:拆单

splitSid

long

如果splitType等于1。则对应拆单的主单的sid。否则为-1

templateId

long

快递模板id

必填

templateName

string

快递模板名称

必填

logisticsCompanyId

long

用户物流公司ID

必填

logisticsCompanyName

string

用户物流公司名称

必填

isPackage

integer

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

必填

sellerFlag

long

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

必填

salesmanId

long

业务员Id

必填

salesmanName

string

业务员名称

必填

sourceId

long

分销商ID

必填

sourceName

string

订单来源于哪里 分销系统里记为分销商名称

必填

destId

long

供销商ID

必填

destName

string

订单归属于哪里 分销系统里记为供销商名称

必填

payAmount

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

string

邮箱（淘系、拼多多订单不返回）

必填

govSubsidyInfo

object

国补信息

subShopId

string

子店铺id

subShopName

string

子店铺名称

govSubsidyAmount

string

国家补贴金额

govSubsidyDetail

string

订单国补详情数据（json字符串存储,业务方根据平台不同逻辑自行解析取想要的字段做业务）

subShop

object

子店铺信息

id

long

子店铺ID

shopName

string

店铺名称

platformCode

string

所属平台编码

shopCode

string

店铺编码

logisticsCode

string

物流商编码

tradePictureMemoUris

array

订单文件列表

total

long

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

hasNext

boolean

是否有下一页

cursor

string

游标

响应示例

{
	"total": "0",
	"list": [{
		"paymentDiff": "number",
		"buyerNick": "string",
		"threePlTiming": "number",
		"type": "string",
		"receiverCity": "string",
		"invoiceRemark": "string",
		"poNos": "string",
		"packmaCost": "number",
		"receiverPhone": "string",
		"expressCode": "string",
		"payment": "string",
		"adjustFee": "string",
		"isExcep": "number",
		"receiverZip": "string",
		"isTmallDelivery": "number",
		"buyerTaxNo": "string",
		"isHalt": "number",
		"warehouseId": long,
		"isRefund": "number",
		"receiverState": "string",
		"expressCompanyId": "number",
		"status": "string",
		"isUrgent": "number",
		"theoryPostFee": "number",
		"warehouseName": "string",
		"hasSuit": "boolean",
		"itemNum": "number",
		"receiverDistrict": "string",
		"taxFee": "string",
		"isHandlerMessage": "number",
		"grossProfit": "number",
		"postFee": "string",
		"receiverMobile": "string",
		"singleItemKindNum": "number",
		"userId": long,
		"itemKindNum": "number",
		"exceptMemo": "string",
		"ptConsignTime": long,
		"buyerMessage": "string",
		"unifiedStatus": "string",
		"excep": "number",
		"shortId": "number",
		"discountFee": "string",
		"sellerFlagString": "string",
		"payTime": long,
		"mobileTail": "string",
		"source": "string",
		"tradePurchaseAmount": "number",
		"tid": "string",
		"invoiceFormat": "number",
		"consignTime": long,
		"isPresell": "number",
		"receiverCountry": "string",
		"updTime": long,
		"stockStatus": "string",
		"modified": long,
		"invoiceType": "string",
		"created": long,
		"taobaoId": long,
		"weight": "number",
		"auditMatchRule": "number",
		"sysOuterId": "string",
		"list": [{
			"bgColor": "string",
			"remark": "string",
			"id": "number",
			"tagName": "string",
			"fontColor": "string",
		}],
		"saleFee": "string",
		"exceptions": "string[]",
		"outSid": "string",
		"receiverAddress": "string",
		"volume": double,
		"scalping": integer,
		"companyId": long,
		"netWeight": double,
		"sellerMemo": "string",
		"chSysStatus": "string",
		"destName": "string",
		"invoiceName": "string",
		"subSource": "string",
		"sysMemo": "string",
		"shopName": "string",
		"sid": long,
		"cancelFrom": "number",
		"acPayment": "string",
		"sysStatus": "string",
		"manualPaymentAmount": "number",
		"fxIsUpload": "number",
		"promiseService": "string",
		"cost": double,
		"isCancel": integer,
		"receiverName": "string",
		"timeoutActionTime": long,
		"isHandlerMemo": "number",
		"expressCompanyName": "string",
		"isCancelDistributorAttribute": "number",
		"tradeFrom": "string",
		"platformPaymentAmount": "number",
		"totalFee": "string",
		"needInvoice": "number",
		"wlbTemplateType": "number",
		"timingPromise": "string",
		"sourceName": "string",
		"invoiceKind": "string"
	}],
	"success": "boolean",
	"trace_id": "long"
}

异常示例

{
    "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	请根据返回的错误信息进行处理