xiaodian.trade.get

  • 免费
  • 需要授权

API功能描述(支持get和post)

查询单笔订单详情

公共参数

名称 类型 必选 描述
app_key Long 接入时申请的app_key
method String 接口名称
access_token String Oauth2.0授权获得的access_token
sign String 对 API 调用参数(除sign外)进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 时间戳,使用Unix时间戳格式
format String 响应格式。默认为json格式,固定
sign_method String 参数的加密方法选择,当前只支持Md5
version String API协议版本,固定值为:1.0

输入参数

名称 类型 必选 描述 示例值
openApiOrderDetailReqDto Object openApiOrderDetailReqDto 的json格式为:
{
    "shopOrderId":"123456"
}
shopOrderId  Long   订单号

返回参数

名称 类型 描述 默认值
shopOrderId Number 店铺级订单ID
orderStatus String 订单状态,包括:ORDER_CREATED": "已下单",ORDER_CANCELLED": "订单取消",ORDER_PAID":                        "已支付",ORDER_SHIPPED": "已发货",ORDER_RECEIVED": "已收货",ORDER_COMPLETED": "订单完成",ORDER_CLOSED":                        "订单关闭"                    
createdStr String 订单创建时间,格式:yyyy-MM-dd HH:mm:ss
payTimeStr String 订单支付时间,格式:yyyy-MM-dd HH:mm:ss
shipTimeStr String 订单发货时间,格式:yyyy-MM-dd HH:mm:ss
receiveTimeStr String 订单收货时间,格式:yyyy-MM-dd HH:mm:ss
buyerName String 买家昵称,是用户自己设置的,不唯一
buyerAccountId String 买家账户ID,是用户登录的账号,唯一
sellerName String 卖家昵称
sellerAccountId String 卖家账户ID
shopOrderType String 订单市场类型,包括:MOGUJIE_MARKET:蘑菇街市场、DEFAULT_MARKET:默认市场、GO_MARKET:番茄炒蛋
shopOrderPrice Number 订单价格(分),商品订单价格之和- 店铺优惠+shipExpense(运费) + tariff(关税)。含运费和关税,需除以100
promotionAmount Number 支付级优惠(分)
number Number 包含的商品级订单数量
isRate Boolean 订单是否已经评价
buyerComment String
sellerComment String 卖家备注
shipType Number 发货类型:0   快递1   小店卖家直接发货2   海淘-转运 3    海淘-商业快件 4    虚拟交易 5    保税仓 
receiverName String 收货人姓名
receiverMobile String 收货人手机
receiverProvince String 收货人省份
receiverCity String 收货人城市
receiverArea String 收货人区
receiverAddress String 收货人地址
receiverZip String 收货人邮编
receiverPhone String 收货人联系电话,固话
shipExpressId String 快递编号
shipExpressName String 快递公司名
stageStatus String 多阶段订单的状态,目前包括:UN_PRE_PAY、WAITING_TAIL_PAY_OPEN、UN_TAIL_PAY、TAIL_PAY_SUCCESS                    
payOrderId Number 支付级订单ID
shopPromotionAmount String 店铺优惠(分)
platformPromotionAmount String 平台优惠(分)
updatedStr String 订单更新时间,格式:yyyy-MM-dd HH:mm:ss
payTransactionId String 微信支付交易流水号
bindMobile String 用户绑定的手机号
unionId String 用户的微信unionId
realPrice String 订单实际付款金额,三方定制字段,请勿使用
distributorNickName String 分销员名称
distributorTel String 分销员手机号
distributorId Number 分销员Id
distributorUserId Number 分销员用户Id
thirdInnerId String 分销员的员工标识ID
distributorThirdName String 分销员员工姓名
distributorArea String 分销员所在地区
distributorWechatId String 分销员微信号
distributorShopCode String 分销员店铺编码
distributorRemark String 分销员备注
distributorParentName String 分销员邀请人昵称
isDistributeOrder Number 是否分销订单:0:非分销订单;1:分销订单
itemOrderInfos Object[] 商品级订单信息
itemOrderId Number 商品级订单Id
orderStatus String 订单状态,包括:ORDER_CREATED": "已下单",ORDER_CANCELLED": "订单取消",ORDER_PAID":                        "已支付",ORDER_SHIPPED": "已发货",ORDER_RECEIVED": "已收货",ORDER_COMPLETED": "订单完成",ORDER_CLOSED":                        "订单关闭"                    
itemId String 商品Id
itemCode String 商品编码
skuId String skuId
skuCode String sku编码
price Number 商品原价(分)
nowPrice Number 商品现价(分)(折后价/拼团价...)
itemTotalPromotionAmount Number 优惠额度(分)(商品级自带的+上两级分摊的,不包含运费改价)
refundCashAmount Number 退款现金额度
number Number 商品数量
title String 商品标题
img String 商品图片url(商品主图)
imgUrl String 完整的图片url(商品主图)
skuAttributes Object[] sku属性
key String sku-Key
value String sku-value
refundStatus String 退款状态
distributorNickName String 分销员名称
distributorTel String 分销员手机号
distributorId Number 分销员Id
distributorUserId String 分销员用户Id
thirdInnerId String 分销员员工标识ID
distributorThirdName String 员工姓名
distributorArea String 分销员所在地区
distributorWechatId String 分销员微信号
distributorShopCode String 分销员所在店铺编码
distributorRemark String 分销员备注
distributorParentName String 分销员邀请人昵称
isDistributeOrder Number 是否分销订单:0非分销订单;1分销订单
distriCommissionAmount String 本单分销佣金(元)
inviteCommissionAmount String 本单邀请佣金(元)
realPrice String 本单真实付款(元)
sellerFinalPrice Number 商品级订单卖家实收金额,含平台补贴+买家实付,不包含运费(分)
skuDistriCommissionAmount String 单个sku商品的分销佣金(元),skuDistriCommissionAmount = distriCommissionAmount / number;
skuInviteCommissionAmount String 单个sku商品的邀请佣金(元),skuInviteCommissionAmount = inviteCommissionAmount / number;
skuRealPrice String 单个sku真实付款(元)
brand String 商品品牌
supplier String 商品供应商
skuCustomRealPrice String 第三方定制价格字段
integralNum Number 本笔商品订单消费的积分
shopPromotionAmount Number 本单的店铺级优惠分摊金额(分)
itemPromotionAmountSingle Number 单个商品的商品级优惠金额(分)
orderTags String 商品级订单标签
orderTagsDesc String 商品级订单标签描述
thirdOutletCode String 三方门店编码
customExtra Object 商家扩展字段json格式,请使用map解析,具体格式单独约定
skuCostPrice String sku级商品成本价
outLetCode String
itemOrderPromotionDetail Object 商品单优惠明细,含商品级优惠、店铺级分摊优惠、支付级分摊优惠; JSON 格式,请使用Map解析。key-String(优惠类型),value-Long(优惠金额/分);以下为优惠枚举: TradePintuanResource - 商品级 - 拼团, TradeTimeLimitDiscountResource - 商品级 - 限时折扣, DepositExpand - 商品级 - 定金膨胀, Bargain - 商品级 - 砍价, TradeFullCut - 店铺级 - 满元减元, TradeFullAmountCutPrice - 店铺级 - 满件减元, TradeFullAmountDiscount - 店铺级 - 满件打折, TradePackagingSell - 店铺级 - 打包卖, IntegralDeduction - 店铺级 - 积分抵扣, TradeShopCouponResource - 店铺级 - 店铺优惠券, FriendsDivisibleCoupon - 店铺级 - 好友瓜分券(优惠券), FissionCoupon - 店铺级 - 裂变优惠券(优惠券), TradeModifyOrder - 店铺级 - 订单改价, TradePlatformCouponResource - 支付级 - 平台优惠券,
actualPrice String 商品的实付款金额 (分摊后计算出来的实际金额,可用于退货退款)
sharePromotionPrice String 商品的分摊优惠金额 (优惠券等优惠分摊到每个商品的优惠金额)
shipExpense String 快递运费(分)    
customRealPrice String 第三方定制价格字段
integralNum Number 本笔订单使用的积分数
orderTags String 订单级订单标签
orderTagsDesc String 订单级订单标签描述
outLetCode String 门店编码
customExtra Object 商家扩展字段json格式,请使用map解析,具体格式单独约定
thirdMemberId String 三方系统的会员id
orderStatusEx String 订单扩展子状态,比如订单最终完成即状态不会再变;枚举有:订单最终完成=COMPLETED_AND_SUCCESS;
vipName String 会员等级名称
integralDeductPrice String 积分抵扣金额优惠(分)

请求参数示例

1).
{ "openApiOrderDetailReqDto": { "shopOrderId":1234567890 } }

返回示例

1).
{ "result": { "data": { "isRate": true, "payOrderId": 80229330039403, "shipTimeStr": "", "sellerName": "xd18767140998", "orderStatus": "ORDER_CLOSED", "createdStr": "2020-10-10 15:00:00", "receiveTimeStr": "", "receiverProvince": "浙江省", "shipExpressName": "", "receiverCity": "杭州市", "buyerAccountId": "时沙2008", "marketType": "独立小程序", "payTransactionId": "4200000754202010109404101498", "number": 1, "payType": "微信支付", "receiverPhone": "13704444666", "updatedStr": "2020-10-10 15:36:51", "receiverZip": "310013", "unionId": "oUZti5jqIEpPBASNIpjPgT0wFPIs", "outLetCode": "1s9y", "receiverName": "时沙测试", "shipExpense": "0", "receiverMobile": "13704444666", "receiverArea": "西湖区", "sellerUserId": 325497729, "buyerName": "时沙2008", "platformPromotionAmount": 0, "sellerAccountId": "江南的风小店", "orderTags": ["SELF_DELIVER"], "receiverAddress": "西湖边上", "bindMobile": "17326075128", "itemOrderInfos": [{ "img": "/mlcdn/65397a/200929_2g80f0lel98khkidl17hi1i9hdke9_468x702.jpg", "itemCode": "", "orderStatus": "ORDER_CLOSED", "refundStatus": "refund_or_return_deal_agreed", "itemOrderId": 80229330059403, "title": "跳刀测试2(勿动)", "skuCustomRealPrice": "0.01", "number": 1, "nowPrice": 1, "skuInviteCommissionAmount": "0.00", "itemPromotionAmountSingle": 0, "price": 1, "skuId": "119kms3e", "itemTotalPromotionAmount": 0, "skuCostPrice": "3.03", "itemTag": "自营", "refundCashAmount": 0, "outLetCode": "1s9y", "skuDistriCommissionAmount": "0.00", "itemSupplier": "{\"specialTips\":\"\",\"jumpUrl\":\"\"}", "orderTags": [], "imgUrl": "http://s5.mogucdn.com/mlcdn/65397a/200929_2g80f0lel98khkidl17hi1i9hdke9_468x702.jpg", "itemId": "1qmlsu4", "orderTagsDesc": [], "skuAttributes": [], "skuRealPrice": "0.01", "isDistributeOrder": 0, "shopPromotionAmount": 0, "sellerFinalPrice": 1, "skuCode": "", "customExtra": { "channel": "17326075128", "orderFrom": "A0000001", "prizeChannel": 1 }, "realPrice": "0.01" }], "orderTagsDesc": ["门店自提"], "shipExpressId": "", "shopOrderId": 80229330049403, "shopOrderPrice": 1, "shipType": 0, "isDistributeOrder": 0, "payTimeStr": "2020-10-10 15:00:15", "shopPromotionAmount": 0, "buyerUserId": 1525299403, "customRealPrice": "0.01", "promotionAmount": 0, "customExtra": { "consultantIntegral": 0, "channel": "17326075128", "orderFrom": "A0000001" }, "realPrice": "0.01", "shopOrderType": "INDEPENDENCE_MARKET" } }, "success": true, "status": { "msg": "调用成功", "code": "0000000" } }
2).
{ "result": { "data": { "buyerAccountId": "九丐", "buyerName": "九丐", "buyerUserId": 125339319, "createdStr": "2017-12-28 10:06:16", "isRate": false, "itemOrderInfos": [ { "img": "/mlcdn/c45406/171226_1kcgfj43c1a4l86j0kebk82d615a0_1080x1440.jpg", "imgUrl": "http://s3.mogucdn.com/mlcdn/c45406/171226_1kcgfj43c1a4l86j0kebk82d615a0_1080x1440.jpg", "itemCode": "0012", "itemId": "1lob9qc", "itemOrderId": 73928569059319, "nowPrice": 1, "number": 1, "orderStatus": "ORDER_SHIPPED", "price": 1, "skuCustomRealPrice":1, "refundStatus": "", "brand":"", "supplier":"", "skuAttributes": [ { "key": "颜色", "value": "金色" }, { "key": "尺码", "value": "均码" } ], "skuCode": "0012", "skuId": "1ygm306", "title": "毛衣123" } ], "number": 1, "orderStatus": "ORDER_SHIPPED", "orderTags": [], "payOrderId": 73928569039319, "payTimeStr": "2017-12-28 10:08:26", "platformPromotionAmount": 0, "processResponseDTO": { "inputTag": "0", "itemTag": "0", "itemTypeTag": "0", "marketTag": "8", "sellerTag": "0", "userTag": "0" }, "promotionAmount": 0, "receiveTimeStr": "1970-01-01 08:00:00", "receiverAddress": "dfasl的费拉达斯健康", "receiverArea": "建昌县", "receiverCity": "葫芦岛市", "receiverMobile": "13398782832", "receiverName": "简单", "receiverPhone": "13398782832", "receiverProvince": "辽宁省", "receiverZip": "313000", "sellerAccountId": "jiwan2", "sellerName": "jiwan2", "sellerUserId": 62542216, "shipExpense": "0", "shipExpressId": "2131321321", "shipExpressName": "huitongkuaidi", "shipTimeStr": "2017-12-28 10:35:22", "shipType": 0, "shopOrderId": 73928569049319, "shopOrderPrice": 1, "realPrice":1, "customRealPrice":1, "shopOrderType": "MOGUJIE_MARKET", "shopPromotionAmount": 0, "stageStatus": "ORDER_SHIPPED", "updatedStr": "2017-12-28 10:35:22" } }, "status": { "code": "0000000", "msg": "调用成功" }, "success": true }

异常示例

1).
{ "result": {}, "status": { "code": "1200001", "msg": "该参数无结果值" } }