淘宝开放平台

登录
文档中心 > API类目 > 五道口API

五道口API

alibaba.wdk.order.get (交易订单详情查询)

五道口三江单据查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
id_list_query_req IdListQueryRequest 可选 系统自动生成
  • └ biz_id_list
  • Number []
  • 可选
  • 13233
  • 中台订单号
  • └ tb_biz_id_list
  • Number []
  • 可选
  • 12123
  • 淘系订单号
  • └ order_from
  • Number
  • 可选
  • 3
  • 渠道来源
  • └ shop_id
  • String
  • 可选
  • 12343561
  • 渠道店id
  • └ store_id
  • String
  • 可选
  • CSDRF01001
  • 经营店id
  • └ out_order_id_list
  • String []
  • 可选
  • 渠道单号

响应参数

名称 类型 示例值 描述
result Result [] 返回数据
  • orders
  • Order []
  • 订单列表
  • └ biz_order_id
  • Number
  • 1
  • 业务订单号
  • └ discount_amt
  • Number
  • 1
  • 商品优惠总额
  • └ original_amt
  • Number
  • 1
  • 商品总金额（优惠前）
  • pay_channels
  • PayChannel []
  • 支付渠道列表
  • └ biz_order_id
  • Number
  • 1
  • 所属淘宝主订单号
  • └ order_channel
  • String
  • 1
  • 销售渠道（POS，APP);订单来源（淘宝、京东、三江购物网）。如：APP|淘宝
  • └ pay_amount
  • Number
  • 1
  • 当前渠道付款金额(分)
  • └ pay_type
  • Number
  • 1
  • 当前渠道付款类型：0-付款码支付，1-盒马在线码－普通支付（pos），2-盒马在线码－免密协议支付（pos），3-银联刷卡（旧pos），4-现金（pos），5-支付宝离线码（pos），6-支付宝快捷支付（app），7-支付平台, 8-国际支付宝, 9-支付宝当面付, 10-网商银行信任付, 11-支付宝, 12-支付宝, 13-网商银行融易收, 14-现金, 15-银行卡, 16-支票, 17-三江购物券, 18-三江赊销
  • └ pos_no
  • String
  • 1
  • 交易订单POS机器号
  • └ store_id
  • String
  • 1
  • 门店编码
  • └ trd_type
  • Number
  • 1
  • 销售类型（正向销售1：逆向销售2。本接口应返回2）
  • └ actual_pay_amount
  • Number
  • 1
  • 实付抹分金额(分)
  • └ adjust_amount
  • Number
  • 1
  • adjustAmount
  • └ promotion_card_info
  • String
  • 1
  • promotionCardInfo
  • └ pay_attributes
  • String
  • “{\"btn\":\"C001\"}
  • "扩展属性，根据payType不同，可存放相关内容。MAP的json化字符串子订单列表,key列表 "btn" // 银行卡凭证号,bank_trade_no "bmi" // 银行卡商户号,bank_merchant_id "bti" // 银行卡终端号,bank_term_id "brn" // 银行卡系统参考号,bank_ref_no "damt" // 优惠金额，discount_amount "tno" // 支付工具号tool_no "tsn" // 支付工具流水号，tool_serail_no"
  • └ pmt_alipay_promotion_amt
  • Number
  • 1
  • 支付宝优惠金额，单位分
  • └ pmt_alipay_reduce_amt
  • Number
  • 1
  • 支付宝随机立减金额，单位分
  • └ pmt_koubei_coupon_amt
  • Number
  • 1
  • 口碑券的优惠金额，单位分
  • └ koubei_coupon_info
  • String
  • [{\"couponAmt\":6,\"couponId\":\"2017120400073002651800Q2UVCD\",\"couponName\":\"秦月单品折扣券\",\"couponType\":\"ALIPAY_ITEM_VOUCHER\",\"investDetails\":{\"PLATFORM\":1,\"merchantInvest\":5},\"itemCodeList\":[\"101292002\"]},{\"couponAmt\":15,\"couponId\":\"2017120500073002651800Q9WPIU\",\"couponName\":\"秦月减至券测试\",\"couponType\":\"ALIPAY_ITEM_VOUCHER\",\"investDetails\":{\"merchantInvest\":15},\"itemCodeList\":[\"103074008\"]},{\"couponAmt\":6,\"couponId\":\"2017120500073002651800Q9WPIV\",\"couponName\":\"秦月减至券0.05-1201\",\"couponType\":\"ALIPAY_ITEM_VOUCHER\",\"investDetails\":{\"PLATFORM\":1,\"merchantInvest\":5},\"itemCodeList\":[\"101294003\"]},{\"couponAmt\":20,\"couponId\":\"2017120500073002651800Q9WPIW\",\"couponName\":\"秦月品类满减券\",\"couponType\":\"ALIPAY_ITEM_VOUCHER\",\"investDetails\":{\"PLATFORM\":1,\"merchantInvest\":19},\"itemCodeList\":[\"103082007\"]},{\"couponAmt\":16,\"couponId\":\"2017120500073002651800Q9WPIX\",\"couponName\":\"秦月自出资单品折扣券\",\"couponType\":\"ALIPAY_ITEM_VOUCHER\",\"investDetails\":{\"merchantInvest\":16},\"itemCodeList\":[\"103138010\"]}]
  • 口碑优惠信息，是一个json数组
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 成交时间
  • └ post_fee
  • Number
  • 1
  • 配送费
  • └ store_id
  • String
  • 1
  • 门店编码
  • sub_orders
  • SubOrder []
  • 1
  • 子订单列表
  • └ biz_order_id
  • Number
  • 1
  • 业务子订单id
  • └ promotion_discount_amt
  • Number
  • 1
  • 促销优惠总金额
  • └ item_code
  • Number
  • 1
  • 商品id
  • └ original_amt
  • Number
  • 1
  • 正向：售价金额（购买数量*原售价）。逆向：退款金额
  • └ parent_id
  • Number
  • 1
  • 父订单id
  • └ price
  • Number
  • 1
  • 商品原价
  • └ promotion_info
  • String
  • 1
  • 促销信息(json格式)。例如:[{"activity_id":"1234","activity_name":"五一促销","activity_type":1,"activity_desc":"优惠卡券"}]
  • └ quantity
  • Number
  • 1
  • 购买数量
  • └ store_id
  • String
  • 1
  • 门店编码
  • └ trd_type
  • Number
  • 1
  • 销售类型（正向销售1：逆向销售2。本接口应返回2）
  • └ member_discount_amt
  • Number
  • 1
  • 会员价优惠金额
  • └ share_discount_amt
  • Number
  • 1
  • 其它分摊优惠金额
  • └ sell_unit
  • String
  • kg
  • 非标品销售单位
  • └ ns_quantity
  • String
  • 1.1
  • 非标品购买数量
  • └ tb_biz_order_id
  • Number
  • 1234
  • 淘宝子订单号
  • └ pick_amount_stock
  • String
  • 1.1
  • 库存单位拣货数量
  • └ buy_amount_stock
  • String
  • 2.2
  • 库存单位购买数量
  • └ member_point
  • String
  • 5
  • memberPoint
  • └ order_type
  • String
  • COMMON
  • 子订单类型，当前取值[COMMON|GIFT],分别表示 普通|赠品 订单
  • └ txd_pmt_amt
  • Number
  • 1
  • 淘鲜达平台优惠券中平台出资金额，单位分
  • └ pick_amt
  • Number
  • 100
  • 拣货金额
  • └ order_status
  • String
  • 子订单的状态
  • 揽件
  • └ status_change_time
  • String
  • {"PACKAGED":"2020-01-01 15:23:29",}
  • statusChangeTime
  • └ stock_unit
  • String
  • kg
  • 库存单位
  • └ sale_unit
  • String
  • g
  • 销售单位
  • └ trade_sub_attributes
  • String
  • {"point":"2"}
  • tradeSubAttributes
  • └ sku_code
  • String
  • 098771
  • 商品skuCode
  • └ out_order_id
  • String
  • ele12324355
  • 外部订单号
  • └ out_sku_code
  • String
  • 123
  • 外部skucode
  • └ trd_type
  • Number
  • 1
  • 销售类型（正向销售1：逆向销售2。本接口应返回2）
  • └ member_discount_amt
  • Number
  • 1
  • 会员价优惠总金额
  • └ member_card_num
  • String
  • 1234
  • 会员卡号
  • └ operator_id
  • String
  • 12
  • 收银员编号
  • └ tb_biz_order_id
  • Number
  • 1234
  • 淘宝主订单号
  • └ operator_name
  • String
  • a
  • 收银员名字
  • └ merchant_code
  • String
  • TEST
  • merchantCode
  • └ order_status
  • String
  • PAID
  • orderStatus
  • └ member_point
  • String
  • 1.5
  • memberPoint
  • └ package_time
  • Date
  • 2000-01-01 00:00:00
  • 打包时间
  • └ gift_coupon
  • String
  • 1123424_1000
  • 赠券，格式为 券ID_券金额， 金额单位为分
  • └ duty_code
  • String
  • 一串字符串
  • 一串唯一的字符串
  • └ trade_attributes
  • String
  • {"point":"2"}
  • map格式的json字符串，部分key含义如下。wdkMemberValue:手机号或者卡号 wdkMemberSource:carNum or phoneNum memDegrade：1表示在线降级，2表示离线降级
  • └ open_uid
  • String
  • 123456
  • 买家open_uid
  • └ order_from
  • Number
  • 3
  • 渠道来源
  • └ shop_id
  • String
  • 123
  • 渠道店id
  • └ out_shop_id
  • String
  • 1223
  • 外部门店id
  • └ out_order_id
  • String
  • 12324343
  • 外部订单号
  • └ order_client
  • String
  • app
  • app或pos
  • └ pay_amt
  • Number
  • 20
  • 支付金额，单位分
  • └ return_code
  • String
  • SUCCESS
  • returnCode
  • └ return_msg
  • String
  • success
  • returnMsg
  • └ total_number
  • Number
  • 10
  • 返回本查询条件下的数据总数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkOrderGetRequest req = new AlibabaWdkOrderGetRequest();
AlibabaWdkOrderGetRequest.IdListQueryRequest obj1 = new AlibabaWdkOrderGetRequest.IdListQueryRequest();
obj1.setBizIdList(new Long[] { 13233 };
);
obj1.setTbBizIdList(new Long[] { 12123 };
);
obj1.setOrderFrom(3L);
obj1.setShopId("12343561");
obj1.setStoreId("CSDRF01001");
obj1.setOutOrderIdList("");
req.setIdListQueryReq(obj1);
AlibabaWdkOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_wdk_order_get_response>
    <result>
        <orders>
            <order>
                <biz_order_id>1</biz_order_id>
                <discount_amt>1</discount_amt>
                <original_amt>1</original_amt>
                <pay_channels>
                    <pay_channel>
                        <biz_order_id>1</biz_order_id>
                        <order_channel>1</order_channel>
                        <pay_amount>1</pay_amount>
                        <pay_type>1</pay_type>
                        <pos_no>1</pos_no>
                        <store_id>1</store_id>
                        <trd_type>1</trd_type>
                        <actual_pay_amount>1</actual_pay_amount>
                        <adjust_amount>1</adjust_amount>
                        <promotion_card_info>1</promotion_card_info>
                        <pay_attributes>“{\&quot;btn\&quot;:\&quot;C001\&quot;}</pay_attributes>
                        <pmt_alipay_promotion_amt>1</pmt_alipay_promotion_amt>
                        <pmt_alipay_reduce_amt>1</pmt_alipay_reduce_amt>
                        <pmt_koubei_coupon_amt>1</pmt_koubei_coupon_amt>
                        <koubei_coupon_info>[{\&quot;couponAmt\&quot;:6,\&quot;couponId\&quot;:\&quot;2017120400073002651800Q2UVCD\&quot;,\&quot;couponName\&quot;:\&quot;秦月单品折扣券\&quot;,\&quot;couponType\&quot;:\&quot;ALIPAY_ITEM_VOUCHER\&quot;,\&quot;investDetails\&quot;:{\&quot;PLATFORM\&quot;:1,\&quot;merchantInvest\&quot;:5},\&quot;itemCodeList\&quot;:[\&quot;101292002\&quot;]},{\&quot;couponAmt\&quot;:15,\&quot;couponId\&quot;:\&quot;2017120500073002651800Q9WPIU\&quot;,\&quot;couponName\&quot;:\&quot;秦月减至券测试\&quot;,\&quot;couponType\&quot;:\&quot;ALIPAY_ITEM_VOUCHER\&quot;,\&quot;investDetails\&quot;:{\&quot;merchantInvest\&quot;:15},\&quot;itemCodeList\&quot;:[\&quot;103074008\&quot;]},{\&quot;couponAmt\&quot;:6,\&quot;couponId\&quot;:\&quot;2017120500073002651800Q9WPIV\&quot;,\&quot;couponName\&quot;:\&quot;秦月减至券0.05-1201\&quot;,\&quot;couponType\&quot;:\&quot;ALIPAY_ITEM_VOUCHER\&quot;,\&quot;investDetails\&quot;:{\&quot;PLATFORM\&quot;:1,\&quot;merchantInvest\&quot;:5},\&quot;itemCodeList\&quot;:[\&quot;101294003\&quot;]},{\&quot;couponAmt\&quot;:20,\&quot;couponId\&quot;:\&quot;2017120500073002651800Q9WPIW\&quot;,\&quot;couponName\&quot;:\&quot;秦月品类满减券\&quot;,\&quot;couponType\&quot;:\&quot;ALIPAY_ITEM_VOUCHER\&quot;,\&quot;investDetails\&quot;:{\&quot;PLATFORM\&quot;:1,\&quot;merchantInvest\&quot;:19},\&quot;itemCodeList\&quot;:[\&quot;103082007\&quot;]},{\&quot;couponAmt\&quot;:16,\&quot;couponId\&quot;:\&quot;2017120500073002651800Q9WPIX\&quot;,\&quot;couponName\&quot;:\&quot;秦月自出资单品折扣券\&quot;,\&quot;couponType\&quot;:\&quot;ALIPAY_ITEM_VOUCHER\&quot;,\&quot;investDetails\&quot;:{\&quot;merchantInvest\&quot;:16},\&quot;itemCodeList\&quot;:[\&quot;103138010\&quot;]}]</koubei_coupon_info>
                    </pay_channel>
                </pay_channels>
                <pay_time>2000-01-01 00:00:00</pay_time>
                <post_fee>1</post_fee>
                <store_id>1</store_id>
                <sub_orders>
                    <sub_order>
                        <biz_order_id>1</biz_order_id>
                        <promotion_discount_amt>1</promotion_discount_amt>
                        <item_code>1</item_code>
                        <original_amt>1</original_amt>
                        <parent_id>1</parent_id>
                        <price>1</price>
                        <promotion_info>1</promotion_info>
                        <quantity>1</quantity>
                        <store_id>1</store_id>
                        <trd_type>1</trd_type>
                        <member_discount_amt>1</member_discount_amt>
                        <share_discount_amt>1</share_discount_amt>
                        <sell_unit>kg</sell_unit>
                        <ns_quantity>1.1</ns_quantity>
                        <tb_biz_order_id>1234</tb_biz_order_id>
                        <pick_amount_stock>1.1</pick_amount_stock>
                        <buy_amount_stock>2.2</buy_amount_stock>
                        <member_point>5</member_point>
                        <order_type>COMMON</order_type>
                        <txd_pmt_amt>1</txd_pmt_amt>
                        <pick_amt>100</pick_amt>
                        <order_status>子订单的状态</order_status>
                        <status_change_time>{&quot;PACKAGED&quot;:&quot;2020-01-01 15:23:29&quot;,}</status_change_time>
                        <stock_unit>kg</stock_unit>
                        <sale_unit>g</sale_unit>
                        <trade_sub_attributes>{&quot;point&quot;:&quot;2&quot;}</trade_sub_attributes>
                        <sku_code>098771</sku_code>
                        <out_order_id>ele12324355</out_order_id>
                        <out_sku_code>123</out_sku_code>
                    </sub_order>
                </sub_orders>
                <trd_type>1</trd_type>
                <member_discount_amt>1</member_discount_amt>
                <member_card_num>1234</member_card_num>
                <operator_id>12</operator_id>
                <tb_biz_order_id>1234</tb_biz_order_id>
                <operator_name>a</operator_name>
                <merchant_code>TEST</merchant_code>
                <order_status>PAID</order_status>
                <member_point>1.5</member_point>
                <package_time>2000-01-01 00:00:00</package_time>
                <gift_coupon>1123424_1000</gift_coupon>
                <duty_code>一串字符串</duty_code>
                <trade_attributes>{&quot;point&quot;:&quot;2&quot;}</trade_attributes>
                <open_uid>123456</open_uid>
                <order_from>3</order_from>
                <shop_id>123</shop_id>
                <out_shop_id>1223</out_shop_id>
                <out_order_id>12324343</out_order_id>
                <order_client>app</order_client>
                <pay_amt>20</pay_amt>
            </order>
        </orders>
        <return_code>SUCCESS</return_code>
        <return_msg>success</return_msg>
        <total_number>10</total_number>
    </result>
</alibaba_wdk_order_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部