奇门订单查询（列表）

查询订单列表。本文根据《快麦ERP奇门自定义接口V2.6.docx》整理。

接入说明

调用前请先阅读奇门自定义接口接入说明，配置 target_app_key、customerId 和 warehouseCode。

请求地址

环境	服务地址
正式环境	http://33c367ryyg.api.taobao.com/router/qm

API接口地址

参数名	值	说明
method	kuaimai.order.list.query	查询订单列表

请求参数

以下为接口业务参数；false 表示非必填。奇门系统参数和路由参数见接入说明。

名称	类型	是否必须	描述
pageNo	Integer	false	页码
pageSize	Integer	false	页面大小（每页数据条数）
status	String	false	订单状态 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:交易关闭
startTime	String	false	开始时间（yyyy-MM-dd HH:mm:ss） （默认更新时间）
endTime	String	false	结束时间（yyyy-MM-dd HH:mm:ss） （默认更新时间）
dateType	Integer	false	查询时间类型 默认0 0:修改时间 1:创建时间 2:线上下单时间 3:发货时间
userId	Long	false	店铺编号
warehouseId	Long	false	订单分仓id
sid	string	false	系统订单号
tid	string	false	平台订单号
tagIds	string	false	查询指定标签ID集合,多个逗号隔开,最多支持十组
types	string	false	订单类型包含,多个逗号隔开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=出库单

响应参数

以下按原文的字段层级展示，各子表标题表示字段所属的对象路径。

顶层字段

名称	类型	描述
total	Long	总数
pageNo	Integer	页码
pageSize	Integer	页面大小（每页数据条数）
hasNextPage	Boolean	是否有下一页（默认否）
trades	List	系统订单

trades（系统订单）

名称	类型	描述
paymentDiff	Integer	订单差额=系统实付金额-平台实收金额 区间值
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=京东直发; 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	实付金额
adjustFee	String	手工调整订单价格
isExcep	Integer	是否异常订单
receiverZip	String	收件邮编
isTmallDelivery	Integer	天猫直送，值true 或者 false
buyerTaxNo	String	买家税号
isHalt	Integer	是否挂起订单
warehouseId	Long	仓库编号
isRefund	Integer	是否包含退款订单
receiverState	String	收件省份
payAmount	String	订单买家已付金额
orders	List	订单商品明细集合
expressCompanyId	Long	快递公司的编号
status	String	订单的平台状态
isUrgent	Integer	是否是加急订单
theoryPostFee	Double	理论运费
warehouseName	String	仓库名称
hasSuit	Boolean	是否含有套件
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	各平台状态映射后的统一状态
excep	Integer	订单级别的系统异常，参考itemExcep
tradeTags	List	订单自定义标签集合
shortId	Long	订单短号
discountFee	String	优惠
sellerFlagString	String	匹配规则用，用逗号分开
payTime	String	付款时间
mobileTail	String	手机后四位尾号
source	String	订单来自哪个平台，例如 tb(淘宝或者天猫平台),jd(京东平台),sys(系统手工订单)
tradePurchaseAmount	Double	订单实收金额
tid	String	平台订单号
invoiceFormat	Integer	发票类型 1普通 2增值
consignTime	String	发货时间
isPresell	Integer	是否为预售订单： 0:正常订单， 1：是预售； 2预售转正常； 3：系统预售
receiverCountry	String	收件国家，跨境订单使用
updTime	String	数据库最后更新时间
stockStatus	String	库存状态
modified	String	订单在平台上的修改时间
invoiceType	String	发票类型
created	String	下单时间
taobaoId	Long	平台的卖家账户
weight	Double	重量
auditMatchRule	Integer	智能审核规则匹配结果
sysOuterId	String	订单下第一个匹配系统商品的子订单的系统商家编码，若都没有匹配，则直接取第一个商品的平台商家编码
saleFee	String	分销金额
exceptions	List	订单的异常信息
outSid	String	运单号
receiverAddress	String	收件详细地址
volume	Double	订单体积
scalping	Integer	是否空单; 1=是; 0=否
companyId	Long	公司编号
netWeight	Double	订单净重，由子订单综合计算得出，参照Order#netWeight
sellerMemo	String	平台上的卖家备注
chSysStatus	String	订单系统状态的中文说明
destName	String	订单归属于哪里 分销系统里记为供销商nname（不持久化）
invoiceName	String	发票抬头
subSource	String	次来源地 jd 保存订单来源
sysMemo	String	订单系统备注
shopName	String	店铺名称
sid	Long	系统订单号
cancelFrom	Integer	供销订单使用,分销作废来源 0,取消分销属性 1，分销订单作废
acPayment	String	不变的实付金额
sysStatus	String	订单的系统状态，平台订单的系统状态由所有平台子订单综合计算得出
manualPaymentAmount	Double	手工支付金额
fxIsUpload	Integer	分销订单是否在系统上传（供销订单用）
promiseService	String	承诺服务类型，会有多个服务值，以英文半角逗号","切割，其中 tmallpromise.arrival.timing 代表到货承诺时效 tmallpromise.consign.timing代表发货承诺时效
cost	Double	订单总成本价,所有商品总成本价之和
isCancel	Integer	是否为作废订单
receiverName	String	收件人姓名
timeoutActionTime	String	平台timeout_action_time
isHandlerMemo	Integer	是否处理卖家备注： 0：未处理 1：已处理
expressCompanyName	String	快递公司的编号
isCancelDistributorAttribute	Integer	是否是取消分销属性触发的订单同步，如果是1，则不需要匹配供应商，因为是取消分销属性
tradeFrom	String	订单来源，例如手机端或者PC端
platformPaymentAmount	Double	平台支付金额
totalFee	String	总额
needInvoice	Integer	需要开具发票 1开启，0关闭
wlbTemplateType	Integer	供销订单用
timingPromise	String	服务身份标识
sourceName	String	订单来源于哪里 分销系统里记为分销商name（不持久化）
invoiceKind	String	发票种类（ 1 电子发票 2 纸质发票

trades.orders（订单商品明细）

名称	类型	描述
sysSkuPropertiesName	String	系统SKU的规格属性名称
discountRate	Double	折扣率
discountFee	String	优惠金额
payTime	String	付款时间
numIid	String	平台商品数字编号
num	Integer	子订单商品数量
source	String	订单来源 tb,tm,jd,sys
shortTitle	String	商品简称
sysTitle	String	系统商品的标题
type	Integer	0普通商品 1赠品 是否是赠品不能根据type来判断，而要根据giftNum>0来判断 2套件商品 3组合商品 4加工商品
tid	String	所属订单的平台编号
isPresell	Integer	是否为预售订单 0:正常订单， 1：是预售； 2预售转正常； 3：系统预售
consignTime	String	子订单发货时间
uniqueCode	String	订单商品唯一码
outerSkuId	String	outer_sku_id
sysSkuPropertiesAlias	String	系统SKU规格属性别名
price	String	商品销售价
updTime	String	数据更新时间
giftNum	Integer	赠品的order数量
stockNum	Integer	分配的库存数量
stockStatus	String	当前子订单的库存状态,如库存正常(NORMAL),库存不足(INSUFFICIENT)
modified	String	子订单平台的修改时间
payment	String	实付金额,公式:实付金额 =应付金额 -优惠金额
id	Long	子订单系统编号
adjustFee	String	手工调整金额
skuId	String	平台规格编号
created	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	Double	子订单中单个商品净重
osGiftCount	String	前N有礼赠品数量
oldStatus	String	子订单旧的平台状态，不做持久化，一般用于订单同步更新时的判断比较
warehouseId	Long	子订单商品库存操作时的仓库ID,要保证与所属trade中的warehouseId一致
isVirtual	Integer	是否虚拟商品，虚拟商品不需要申请库存，发货时也不需要消费库存、归还库存
status		子订单平台状态
sysConsigned	Integer	是否在系统发货 1是，0否
soid	String	子订单平台编号（由于某些平台的子订单号为字符类型，需要用此字段保存，后续可将oid修改为String类型）
refundStatus	String	子订单退款状态
oid	Long	子订单平台编号(淘宝有, 京东没有)
itemSysId	Long	匹配到的系统商品ID
title	String	商品标题
sid	Long	所属主订单的系统编号
forcePackNum	Integer	强制验货数量
acPayment	String	不变的实付金额,进来后不变
sysStatus	String	订单系统状态
sysItemOuterId	String	系统主商家编码
osSortNum	String	前N有礼中奖名次，获得奖品的订单才会有该字段
skuPropertiesName	String	规格属性名
skuUnit	String	系统规格计量单位
cost	Double	商品成本价
isCancel	Integer	是否作废，未发货的子订单与所属的trade保持一致
salePrice	String	分销价格
oldPrice	String	原商品销售价，在套件转单品去匹配赠品时候使用
identCode	String	识别码
combineId	Long	如果是套件单品,则该字段的值为其所属的套件子订单的id,否则为0
userId	Long	订单所属店铺用户ID
ptConsignTimeString	String	平台发货时间
totalFee	String	应付金额,公式:应付金额 =商品数量 商品单价 +手工调整价
sysPicPath	String	系统商品图片链接
skuSysId	Long	匹配到的系统规格ID
outerId	String	商家编码，不做持久化，仅仅只是为了系统订单添加商品使用
endTime	String	子订单的交易结束时间
estimateConTime	String	预计发货时间
refundId	String	平台退款编号
postFee	String	单笔订单运费
authorId	string	达人id
actualPostFee	string	实际运费
splitType	int	拆单类型 -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紫
payAmount	String	商品买家已付金额

trades.tradeTags（订单自定义标签）

名称	类型	描述
bgColor	String	标签背景颜色
remark	String	标签备注
id	Long	标签id
tagName	String	标签名称
fontColor	String	标签前景颜色

原文说明

trades.orders.status 的类型在原文中为空；trades.orders.endTime 在原文中出现两次，分别为 String（子订单的交易结束时间）和 string（完结时间）。以上均按原文保留。