帮助中心

2024-查询商城订单(批量)

2021-11-23

接口编号 2024

接口说明

  1. 批量获取订单数据。分页获取,每页返回50条,pageIndex最小1,最大2147483647。

  2. pageIndex验证必填,OrderTimeStart、OrderTimeEnd必填,但未做验证,OrderStatus默认0

  3. 待发货订单Dtls中的Quantity,显示为可发货数量(并排除数量为0明细),其它状态订单显示为购买数量

  4. DeliverQuantity&RefundQuantity,仅待发货并传入IsDeliver=true,显示发货和未发货退款数量

  5. 订单已关闭指全部退款退货

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:api/morder/ordgetbatch

订单状态

0:已取消  1:待付款  2:待发货  4:已发货  8:交易成功  16:交易完成 20:已关闭 1200:定金支付成功

订单金额字段算法:

主表:

  • TotalMoney(商品总金额)=商品数量*商品单价

  • DiscountAmount(支付优惠金额):订单参与满减和优惠券抵扣的总优惠金额

  • PayAmount(支付总金额,包含运费)

  • TotalMoney - DiscountAmount = PayAmount - 运费

明细:

  • Amount:商品支付金额(Amount = Quantity*PriceSell)

  • DiscountAmount:商品参与满减,抵扣券优惠金额DiscountAmount= Amount -AvgAmount)

请求参数

字段类型为空长度描述
OrderTimeStartDateTime
开始时间
OrderTimeEndDateTime
结束时间
OrderStatusInt
如果不传默认查找全部  0:已取消  1:待付款  2:待发货  4:已发货  8:交易成功  16:交易完成 20:已关闭 1200:定金支付成功
HaveOrderDetailbool
是否返回订单明细(默认不返回明细)
IsGetDiscountAmountDtlbool
是否返回支付优惠详情(默认不返回,需要才传入true)
IsExcludeRefundProbool
导出订单时是否排除已产生退款单(且退款单未取消)的订单明细(默认false排除)
PageIndexInt
页号,默认为1
ShopCodestring
DelivTypeint
不传默认查找全部状态(物流方式字段: 0:快递,1:自提)
IsDeliverbool
待发货订单显示明细全部,默认false
OrderOriginint
订单来源(0驿氪,1JD 2 Pdd)默认0
IsLivebool
是否返回直播信息
FxHandlerint1默认-1全部,0未完成分销,1完成分销
OrderTypeint
默认0,1卖券订单,2商城订单
IsGetPrdAttrbool
是否返回商品大类码属性


请求参数示例代码(json对象)

{

"OrderTimeStart": "2016-02-03 00:00:00",

"OrderTimeEnd": "2016-05-03 23:59:59",

"HaveOrderDetail": "true",

"PageIndex": "1",

}

返回参数 订单数据


字段类型描述
Codestring订单号
OrderTypestring订单类型(MALL:商城订单,BNEG卖券订单)
ShopCodestring门店代码(多门店情况下为仓库代码)
StoreCodestring多门店门店代码
StoreTypeint门店类型(默认0,1:商场店)
FlowChannelint流量渠道来源,0、默认值;1、西瓜商城;2、视频号
TotalMoneydecimal商品总金额
DiscountMoney(弃用)decimal折扣优惠金额
DiscountAmountdecimal支付优惠金额
ReturnQuantityint退货数量
OrderTimestring下单时间
OrderPreShipTimestring订单预售发货时间(只有预售订单才有)
IsPayedbool是否付款完成
PayTimestring付款时间
PayAmountdecimal支付金额
UseCouponNostring使用券号
UseCouponValuedecimal使用券面额
RewardFeedecimal分销佣金
UseBonusint抵现积分
ExpressFeedecimal快递费用
ExpressFeeTypestring快递费用类型(MY:人民币 BS:积分)
IsCodbool是否货到付款
CodServiceFeedecimal货到付款服务费
BuyerCodestring买家线上卡号
BuyerOldCodestring买家线下卡号
VipCodestring买家线上卡号
BuyerEmailstring买家email
BuyerNickstring买家昵称
BuyerMobilestring买家手机号
WxUnionIDstring微信UnionID
ActTypestring活动类型 OG-开团,JG-参团,BA-砍价,LC-限券购,DOG-多品团开团,DJG-多品团参团,PRE-预售,DPRE-定金预售
ActIdint活动Id
LiveActIdint直播活动Id
LiveActTypeint直播类型(1:腾讯直播(直播插件))
RecvConsigneestring收货联系人
RecvMobilestring收货人手机
RecvTelstring收货人电话
RecvAddressstring收货人地址
RecvProvincestring收货省份
RecvCitystring收货城市
RecvCountystring收货区县
OrderStatusint订单状态:0:已取消  1:待付款  2:待发货  4:已发货  8:交易成功  16:交易完成 20:已关闭
BuyerRemarkstring买家备注
OrderRemarkstring订单备注
ServiceSalerCodestring服务导购(需要开启导购销售)
ServiceSalerNamestring服务导购名称(需要开启导购销售)
ServiceChannelCodestring服务导购所属门店
SellerCodestring分销员(弃用
SellerSysShopCodestring分销员所属系统门店(弃用
SelfFetchShopCodestring自提门店编码
DelivTypeint0:快递,1:自提
DelivTypeDescstring内容为“快递”或者“自提”
DeliveryCodestring自提订单核销码
DtlsList<SalesOrderDtlGetResInfo>订单明细
fxComResListList<SalesFxCommssionGetResInfo>导购分销信息
FxHandlerint0:分销逻辑未处理,1:分销逻辑处理完成
useCouponNoListList<String>使用券号List(多张券)
LiveIdint直播间ID
LiveNamestring直播间名称
LastModifystring最后修改时间
ExchangeRefCodeList<string>换货关联单号
OrderTagstring订单标签 默认为空,0、换货订单(发生换货行为的订单) 1、换货发货单(换货成功商品生成的0元订单)
BuyerNamestring购买人姓名
UsePrepaidCardAmountdecimal使用储值卡金额
UsePrepaidCardGiftAmountdecimal使用储值卡赠送金额
RelExchangeReturnCodestring换货订单的退货单号
TradeNostring支付流水号
IsValetOrderbool是否是代客下单
DataOriginint0:线下门店,1:品牌自有商城,2:品牌线上官网,3:PC销售,4:APP销售,6:EZR微商城,7:EZR微信小程序,9:第三方商城订单,10:淘宝,11:京东,20:EZR支付宝小程序
ChangeDiscountAmountdecimal改价优惠金额合计

订单明细数据 Dtls

字段类型描述
ItemNostring商品货号
BarCodestring商品条码
PriceOriginaldecimal原始单价
PriceSelldecimal销售单价
Quantityint订购数量
Amountdecimal支付金额
DiscountMoney(弃用)decimal折扣优惠金额
DiscountAmountdecimal支付优惠总金额
FrDiscountAmountdecimal满减支付优惠金额(只有接口传入IsGetDiscountAmountDtl=true才处理)
CouponDiscountAmountdecimal券支付优惠金额(只有接口传入IsGetDiscountAmountDtl=true才处理)
RewardFeedecimal分销佣金
UseBonusint抵现积分
IsGiftbool是否赠品
GiftTypestring赠品信息(GS:"赠品";EX:"加价购";PA:"套餐";FI:"一口价";OG:"拼团";JG:"拼团";BA:"砍价";LC:"限券购";PRE:"预售";)
ReturnQuantitydecimal退货数量
ReturnPricedecimal退货单价
ReturnMoneydecimal退货金额
RetailPricedecimal吊牌价
OrderCouponAmountdecimal订单券金额
ProCouponAmountdecimal商品券金额
AvgAmountdecimal小计
WxProCouponAmountdecimal微信优惠券商品券抵扣额
WxOrderCouponAmountdecimal微信优惠券订单券抵扣额
DeliverQuantityint已发货数量
RefundQuantityint未发货退款数量
CommissionTypeint0导购分销1会员分销2导购分销自购3会员分销自购-1无
FxTypeint分销类型:-1无 0 导购;1 会员;2 合伙人
SgCodestring导购工号
SgShopCodestring导购门店编码
VipCodestring会员卡号
RelationTypeint关系类型:-1无 0 会员分享关系  1  会员邀请关系  2  服务导购关系  3 导购分享链接关系
ProductBrandIdint商品品牌
ProductBrandCodestring商品品牌
AttrInfosList<SalesOrderProductAttrInfo>商品大类码
SkuActTypeint活动类型=9为积分兑换活动
ChangeDiscountAmountdecimal改价优惠金额
VipDiscountAmountdecimal商品的会员折扣金额

 

导购分销信息 fxComResList


字段类型描述
SellerSysShopCodestring分销员所属系统门店
SellerCodestring分销员编号


SalesOrderProductAttrInfo:


字段类型描述
AttrCodestring属性
AttrNamestring属性名称
AttrValInfosList<SalesOrderProductAttrValInfo>属性值信息


SalesOrderProductAttrValInfo:


字段类型描述
AttrIdint属性值Id
AttrValstring属性值



系统级返回结果示例(json)

{

"Status": true,

"StatusCode": 200,

"Msg": "成功",

"Timestamp": "20150622093101",

"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

"PageCount": 2,

"Result": 见业务返回结果示例,

}

业务返回结果示例(json对象):

 [

{

    "Code": "E0125175719011600012",

    "OrderType": "MALL",

    "TotalQty": 1,

    "TotalMoney": 100,

    "DiscountAmount": 0,

    "ReturnQuantity": 0,

    "ReturnMoney": 0,

    "OrderTime": "2019-01-16 18:01:23",

    "OrderPreShipTime": "",

    "IsPayed": true,

    "PayTime": "2019-01-16 18:01:25",

    "HasSendTime": "0001-01-01 00:00:00",

    "FinishTime": "0001-01-01 00:00:00",

    "PayAmount": 0.1,

    "UseCouponValue": 0,

    "RewardFee": 0,

    "UseBonus": 0,

    "ExpressFee": 0,

    "ExpressFeeType": "MY",

    "ExpressCost": 0,

    "IsCod": false,

    "CodServiceFee": 0,

    "BuyerCode": "13262568563",

    "BuyerOldCode": "",

    "BuyerNick": "Ren_xz",

    "RecvConsignee": "aaa",

    "RecvMobile": "13262568563",

    "RecvAddress": "不得不对不对",

    "RecvProvince": "上海市",

    "RecvCity": "上海市",

    "RecvCounty": "宝山区",

    "OrderStatus": 0,

    "BuyerRemark": "",

    "ShopCode": "sh0948844",

    "StoreCode": "345566",

    "SellerSysShopCode": "",

    "SellerCode": "",

    "DelivTypeDesc": "快递",

    "DelivType": 0,

    "useCouponNoList":["EZR00001"],

    "LiveId":1111111,

    "LiveName":"1号直播间",

    "Dtls": [

        {

            "ItemNo": "ezr678890878687",

            "BarCode": "hghg88766688",

            "ProductName": "test_自提00111",

            "PriceOriginal": 22.67,

            "PriceSell": 100,

            "Quantity": 1,

            "Amount": 0.1,

            "DiscountAmount": 99.9,

            "FrDiscountAmount": 0,

            "CouponDiscountAmount": 0,

            "RewardFee": 0,

            "UseBonus": 0,

            "UseCouponValue": 0,

            "IsGift": true,

            "ReturnQuantity": 0,

            "ReturnPrice": 0,

            "ReturnMoney": 0,

            "RetailPrice": 1001,

            "OrderCouponAmount": 0,

            "ProCouponAmount": 0,

            "AvgAmount": 0.1,

            "WxProCouponAmount":0,

            "WxOrderCouponAmount":0,

            "DeliverQuantity":0,

            "RefundQuantity":0,

            "AttrInfos": [

                        {

                            "AttrCode": "sy01",

                            "AttrName": "适用群众",

                            "AttrValInfos": [

                                {

                                    "AttrId": 65745667,

                                    "AttrVal": "大人"

                                }

                            ]

                        }

                    ]

        }

    ],

    "fxComResList": [{

        "SellerSysShopCode":"SHA_test",

        "SellerCode":"fenxiao001"

    }],

    "VipCode": "",

    "SelfFetchShopId": 0,

    "SelfFetchShopCode": ""

},

...

]

18140