注意:以下文档只适用于TOP接口,请谨慎使用!

alibaba.trade.buyerorderlist.get (订单列表查看(买家视角))

获取买家的订单列表,也就是用户的memberId必须等于订单里的买家memberId。该接口仅仅返回订单基本信息,不会返回订单的物流信息和发票信息;如果需要获取物流信息,请调用获取订单详情接口;如果需要获取发票信息,请调用获取发票信息的API。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_trade_get_order_list_param TradeGetOrderListParam 可选 请求入参
  • └ biz_types
  • String []
  • 可选
  • []
  • 业务类型,业务类型,支持: "cn"(普通订单类型), "ws"(大额批发订单类型), "yp"(普通拿样订单类型), "yf"(一分钱拿样订单类型), "fs"(倒批(限时折扣)订单类型), "cz"(加工定制订单类型), "ag"(协议采购订单类型), "hp"(伙拼订单类型), "gc"(国采订单类型), "supply"(供销订单类型), "nyg"(nyg订单类型), "factory"(淘工厂订单类型), "quick"(快订下单), "xiangpin"(享拼订单), "nest"(采购商城-鸟巢), "f2f"(当面付), "cyfw"(存样服务), "sp"(代销订单标记), "wg"(微供订单), "factorysamp"(淘工厂打样订单), "factorybig"(淘工厂大货订单)
  • └ buyer_rate_status
  • Number
  • 可选
  • 4
  • 买家评价状态 (4:已评价,5:未评价,6;不需要评价)
  • └ create_end_time
  • Date
  • 可选
  • 2016-12-12 12:12:12
  • 订单创建时间(结束时间)
  • └ create_start_time
  • Date
  • 可选
  • 2016-12-12 12:12:12
  • 订单创建时间(开始时间)
  • └ is_his
  • Boolean
  • 可选
  • false
  • 是否查询历史订单表,默认查询当前表
  • └ modify_end_time
  • Date
  • 可选
  • 2016-12-12 12:12:12
  • 订修改时间(查询开始值和结束值)
  • └ modify_start_time
  • Date
  • 可选
  • 2016-12-12 12:12:12
  • 订修改时间(查询开始值和结束值)
  • └ order_ids
  • Number []
  • 可选
  • []
  • 订单ID 不能突破20个
  • └ order_status
  • String
  • 可选
  • success
  • 订单状态,值有success,cancel(交易取消,违约金等交割完毕),waitbuyerpay(等待卖家付款),waitsellersend(等待卖家发货),waitbuyerreceive(等待买家收货 )
  • └ page
  • Number
  • 可选
  • 1
  • 页码
  • └ page_size
  • Number
  • 可选
  • 1
  • 每页条数
  • └ product_name
  • String
  • 可选
  • 名称
  • 产品名称
  • └ refund_status
  • String
  • 可选
  • waitselleragree1
  • 退款状态:waitselleragree(等待卖家同意),refundsuccess(退款成功),refundclose(退款关闭),waitbuyermodify(待买家修改),waitbuyersend(等待买家退货) * waitsellerreceive(等待卖家确认收货)
  • └ seller_member_id
  • String
  • 可选
  • b2b-12312314
  • 卖家memberId
  • └ seller_rate_status
  • Number
  • 可选
  • 4
  • 卖家评价状态 (4:已评价,5:未评价,6;不需要评价)
  • └ trade_type
  • String
  • 可选
  • UNIFY
  • 订单类型 UNIFY(普通,值为"6"),STEP(分阶段值,为"7")

响应参数

名称 类型 示例值 描述
result Result {} result
  • data
  • TradeOrderListVo
  • 1234
  • data
  • └ count
  • Number
  • 1
  • count
  • list
  • TradeInfo []
  • []
  • list
  • base_info
  • OrderBaseInfo
  • {}
  • baseInfo
  • └ all_delivered_time
  • Date
  • 2016-12-12 12:12:12
  • allDeliveredTime
  • └ business_type
  • String
  • cn
  • businessType
  • buyer_contact
  • TradeContact
  • {}
  • buyerContact
  • └ email
  • String
  • email
  • └ fax
  • String
  • fax
  • └ im_in_platform
  • String
  • imInPlatform
  • └ mobile
  • String
  • mobile
  • └ name
  • String
  • name
  • └ phone
  • String
  • phone
  • └ buyer_i_d
  • String
  • buyerID
  • └ buyer_memo
  • String
  • buyerMemo
  • └ buyer_remark_icon
  • String
  • buyerRemarkIcon
  • └ buyer_sub_i_d
  • Number
  • buyerSubID
  • └ complete_time
  • Date
  • 2016-12-12 12:12:12
  • completeTime
  • └ create_time
  • Date
  • 2016-12-12 12:12:12
  • createTime
  • └ currency
  • String
  • currency
  • └ discount
  • Number
  • discount
  • └ id
  • Number
  • id
  • └ modify_time
  • Date
  • 2016-12-12 12:12:12
  • modifyTime
  • └ pay_time
  • Date
  • 2016-12-12 12:12:12
  • payTime
  • └ receiving_time
  • Date
  • 2016-12-12 12:12:12
  • receivingTime
  • └ refund
  • String
  • refund
  • └ refund_payment
  • Number
  • refundPayment
  • └ refund_status
  • String
  • refundStatus
  • └ refund_status_for_as
  • String
  • refundStatusForAs
  • └ remark
  • String
  • remark
  • seller_contact
  • TradeContact
  • sellerContact
  • └ email
  • String
  • email
  • └ fax
  • String
  • fax
  • └ im_in_platform
  • String
  • imInPlatform
  • └ mobile
  • String
  • mobile
  • └ name
  • String
  • name
  • └ phone
  • String
  • phone
  • └ seller_i_d
  • String
  • sellerID
  • └ seller_sub_i_d
  • Number
  • sellerSubID
  • └ shipping_fee
  • String
  • shippingFee
  • └ status
  • String
  • status
  • └ total_amount
  • String
  • totalAmount
  • └ trade_type
  • String
  • tradeType
  • ext_attributes
  • KeyValuePair []
  • extAttributes
  • └ description
  • String
  • description
  • └ key
  • String
  • key
  • └ value
  • String
  • value
  • guarantees_terms
  • GuaranteeTermsInfo
  • {}
  • guaranteesTerms
  • └ assurance_info
  • String
  • assuranceInfo
  • └ assurance_type
  • String
  • assuranceType
  • └ quality_assurance_type
  • String
  • qualityAssuranceType
  • └ short_code
  • String
  • shortCode
  • international_logistics
  • InternationalLogisticsInfo
  • internationalLogistics
  • └ address
  • String
  • address
  • └ all_delivered_time
  • Date
  • allDeliveredTime
  • └ alternate_address
  • String
  • alternateAddress
  • └ carrier
  • String
  • carrier
  • └ city
  • String
  • city
  • └ city_code
  • String
  • cityCode
  • └ contact_person
  • String
  • contactPerson
  • └ country
  • String
  • country
  • └ country_code
  • String
  • countryCode
  • └ fax
  • String
  • fax
  • └ fax_area
  • String
  • faxArea
  • └ fax_country
  • String
  • faxCountry
  • └ insurance_fee
  • String
  • insuranceFee
  • └ logistics_code
  • String
  • logisticsCode
  • └ logistics_fee
  • String
  • logisticsFee
  • └ mobile
  • String
  • mobile
  • └ mobile_area
  • String
  • mobileArea
  • └ mobile_country
  • String
  • mobileCountry
  • └ port
  • String
  • port
  • └ port_code
  • String
  • portCode
  • └ province
  • String
  • province
  • └ province_code
  • String
  • provinceCode
  • └ shipment_absolute_date
  • Date
  • shipmentAbsoluteDate
  • └ shipment_absolute_zone
  • String
  • shipmentAbsoluteZone
  • └ shipment_date_type
  • String
  • shipmentDateType
  • └ shipment_method
  • String
  • shipmentMethod
  • └ shipment_relative_duration
  • String
  • shipmentRelativeDuration
  • └ shipment_relative_field
  • String
  • shipmentRelativeField
  • └ shipment_relative_start
  • String
  • shipmentRelativeStart
  • └ telephone
  • String
  • telephone
  • └ telephone_area
  • String
  • telephoneArea
  • └ telephone_countryv
  • String
  • telephoneCountryv
  • └ trade_term
  • String
  • tradeTerm
  • native_logistics
  • NativeLogisticsInfo
  • nativeLogistics
  • └ address
  • String
  • address
  • └ area
  • String
  • area
  • └ area_code
  • String
  • areaCode
  • └ city
  • String
  • city
  • └ contact_person
  • String
  • contactPerson
  • └ fax
  • String
  • fax
  • logistics_items
  • NativeLogisticsItemsInfo []
  • logisticsItems
  • └ delivered_time
  • Date
  • deliveredTime
  • └ logistics_code
  • String
  • logisticsCode
  • └ mobile
  • String
  • mobile
  • └ province
  • String
  • province
  • └ telephone
  • String
  • telephone
  • └ zip
  • String
  • zip
  • order_rate_info
  • OrderRateInfo
  • orderRateInfo
  • └ buyer_rate_status
  • Number
  • buyerRateStatus
  • └ seller_rate_status
  • Number
  • sellerRateStatus
  • product_items
  • ProductItemInfo []
  • productItems
  • └ cargo_number
  • String
  • cargoNumber
  • └ description
  • String
  • description
  • └ entry_discount
  • Number
  • entryDiscount
  • guarantees_terms
  • GuaranteeTermsInfo []
  • guaranteesTerms
  • └ assurance_info
  • String
  • assuranceInfo
  • └ assurance_type
  • String
  • assuranceType
  • └ quality_assurance_type
  • String
  • qualityAssuranceType
  • └ short_code
  • String
  • shortCode
  • └ item_amount
  • String
  • itemAmount
  • └ name
  • String
  • name
  • └ price
  • String
  • price
  • └ product_cargo_number
  • String
  • productCargoNumber
  • └ product_i_d
  • Number
  • productID
  • └ product_img_urls
  • String []
  • productImgUrl
  • └ product_snapshot_url
  • String
  • productSnapshotUrl
  • └ quantity
  • String
  • quantity
  • └ refund
  • String
  • refund
  • └ refund_actual_fee
  • Number
  • refundActualFee
  • └ refund_expect_fee
  • Number
  • refundExpectFee
  • └ refund_id
  • String
  • refundId
  • └ refund_id_for_as
  • String
  • refundIdForAs
  • └ sku_i_d
  • Number
  • skuID
  • sku_infos
  • SkuItemDesc []
  • skuInfos
  • └ name
  • String
  • name
  • └ value
  • String
  • value
  • └ sort
  • Number
  • sort
  • └ spec_id
  • String
  • specId
  • └ status
  • String
  • status
  • └ sub_item_i_d
  • Number
  • subItemID
  • └ type
  • String
  • type
  • └ unit
  • String
  • unit
  • └ weight
  • String
  • weight
  • └ weight_unit
  • String
  • weightUnit
  • trade_terms
  • TradeTermsInfo []
  • tradeTerms
  • └ pay_status
  • String
  • payStatus
  • └ pay_time
  • Date
  • payTime
  • └ pay_way
  • String
  • payWay
  • └ phas_amount
  • String
  • phasAmount
  • └ phase
  • Number
  • phase
  • └ phase_condition
  • String
  • phaseCondition
  • └ phase_date
  • String
  • phaseDate
  • └ total_count
  • Number
  • totalCount
  • └ error_code
  • String
  • "isv.invalid-parameter"
  • errorCode
  • └ error_info
  • String
  • errorInfo
  • └ success
  • Boolean
  • false
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTradeBuyerorderlistGetRequest req = new AlibabaTradeBuyerorderlistGetRequest();
AlibabaTradeBuyerorderlistGetRequest.TradeGetOrderListParam obj1 = new AlibabaTradeBuyerorderlistGetRequest.TradeGetOrderListParam();
obj1.setBizTypes("");
obj1.setBuyerRateStatus(4L);
obj1.setCreateEndTime(StringUtils.parseDateTime("2016-12-12 12:12:12"));
obj1.setCreateStartTime(StringUtils.parseDateTime("2016-12-12 12:12:12"));
obj1.setIsHis(false);
obj1.setModifyEndTime(StringUtils.parseDateTime("2016-12-12 12:12:12"));
obj1.setModifyStartTime(StringUtils.parseDateTime("2016-12-12 12:12:12"));
obj1.setOrderIds(new Long[] {  };
);
obj1.setOrderStatus("success");
obj1.setPage(1L);
obj1.setPageSize(1L);
obj1.setProductName("名称");
obj1.setRefundStatus("waitselleragree1");
obj1.setSellerMemberId("b2b-12312314");
obj1.setSellerRateStatus(4L);
obj1.setTradeType("UNIFY");
req.setParamTradeGetOrderListParam(obj1);
AlibabaTradeBuyerorderlistGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_trade_buyerorderlist_get_response>
    <result>
        <data>
            <count>1</count>
            <list>
                <trade_info>
                    <base_info>
                        <all_delivered_time>2016-12-12 12:12:12</all_delivered_time>
                        <business_type>cn</business_type>
                        <buyer_contact>
                            <email></email>
                            <fax></fax>
                            <im_in_platform></im_in_platform>
                            <mobile></mobile>
                            <name></name>
                            <phone></phone>
                        </buyer_contact>
                        <buyer_i_d></buyer_i_d>
                        <buyer_memo></buyer_memo>
                        <buyer_remark_icon></buyer_remark_icon>
                        <buyer_sub_i_d></buyer_sub_i_d>
                        <complete_time>2016-12-12 12:12:12</complete_time>
                        <create_time>2016-12-12 12:12:12</create_time>
                        <currency></currency>
                        <discount></discount>
                        <id></id>
                        <modify_time>2016-12-12 12:12:12</modify_time>
                        <pay_time>2016-12-12 12:12:12</pay_time>
                        <receiving_time>2016-12-12 12:12:12</receiving_time>
                        <refund></refund>
                        <refund_payment></refund_payment>
                        <refund_status></refund_status>
                        <refund_status_for_as></refund_status_for_as>
                        <remark></remark>
                        <seller_contact>
                            <email></email>
                            <fax></fax>
                            <im_in_platform></im_in_platform>
                            <mobile></mobile>
                            <name></name>
                            <phone></phone>
                        </seller_contact>
                        <seller_i_d></seller_i_d>
                        <seller_sub_i_d></seller_sub_i_d>
                        <shipping_fee></shipping_fee>
                        <status></status>
                        <total_amount></total_amount>
                        <trade_type></trade_type>
                    </base_info>
                    <ext_attributes>
                        <key_value_pair>
                            <description></description>
                            <key></key>
                            <value></value>
                        </key_value_pair>
                    </ext_attributes>
                    <guarantees_terms>
                        <assurance_info></assurance_info>
                        <assurance_type></assurance_type>
                        <quality_assurance_type></quality_assurance_type>
                        <short_code></short_code>
                    </guarantees_terms>
                    <international_logistics>
                        <address></address>
                        <all_delivered_time></all_delivered_time>
                        <alternate_address></alternate_address>
                        <carrier></carrier>
                        <city></city>
                        <city_code></city_code>
                        <contact_person></contact_person>
                        <country></country>
                        <country_code></country_code>
                        <fax></fax>
                        <fax_area></fax_area>
                        <fax_country></fax_country>
                        <insurance_fee></insurance_fee>
                        <logistics_code></logistics_code>
                        <logistics_fee></logistics_fee>
                        <mobile></mobile>
                        <mobile_area></mobile_area>
                        <mobile_country></mobile_country>
                        <port></port>
                        <port_code></port_code>
                        <province></province>
                        <province_code></province_code>
                        <shipment_absolute_date></shipment_absolute_date>
                        <shipment_absolute_zone></shipment_absolute_zone>
                        <shipment_date_type></shipment_date_type>
                        <shipment_method></shipment_method>
                        <shipment_relative_duration></shipment_relative_duration>
                        <shipment_relative_field></shipment_relative_field>
                        <shipment_relative_start></shipment_relative_start>
                        <telephone></telephone>
                        <telephone_area></telephone_area>
                        <telephone_countryv></telephone_countryv>
                        <trade_term></trade_term>
                    </international_logistics>
                    <native_logistics>
                        <address></address>
                        <area></area>
                        <area_code></area_code>
                        <city></city>
                        <contact_person></contact_person>
                        <fax></fax>
                        <logistics_items>
                            <native_logistics_items_info>
                                <delivered_time></delivered_time>
                                <logistics_code></logistics_code>
                            </native_logistics_items_info>
                        </logistics_items>
                        <mobile></mobile>
                        <province></province>
                        <telephone></telephone>
                        <zip></zip>
                    </native_logistics>
                    <order_rate_info>
                        <buyer_rate_status></buyer_rate_status>
                        <seller_rate_status></seller_rate_status>
                    </order_rate_info>
                    <product_items>
                        <product_item_info>
                            <cargo_number></cargo_number>
                            <description></description>
                            <entry_discount></entry_discount>
                            <guarantees_terms>
                                <guarantee_terms_info>
                                    <assurance_info></assurance_info>
                                    <assurance_type></assurance_type>
                                    <quality_assurance_type></quality_assurance_type>
                                    <short_code></short_code>
                                </guarantee_terms_info>
                            </guarantees_terms>
                            <item_amount></item_amount>
                            <name></name>
                            <price></price>
                            <product_cargo_number></product_cargo_number>
                            <product_i_d></product_i_d>
                            <product_img_urls>
                                <string></string>
                            </product_img_urls>
                            <product_snapshot_url></product_snapshot_url>
                            <quantity></quantity>
                            <refund></refund>
                            <refund_actual_fee></refund_actual_fee>
                            <refund_expect_fee></refund_expect_fee>
                            <refund_id></refund_id>
                            <refund_id_for_as></refund_id_for_as>
                            <sku_i_d></sku_i_d>
                            <sku_infos>
                                <sku_item_desc>
                                    <name></name>
                                    <value></value>
                                </sku_item_desc>
                            </sku_infos>
                            <sort></sort>
                            <spec_id></spec_id>
                            <status></status>
                            <sub_item_i_d></sub_item_i_d>
                            <type></type>
                            <unit></unit>
                            <weight></weight>
                            <weight_unit></weight_unit>
                        </product_item_info>
                    </product_items>
                    <trade_terms>
                        <trade_terms_info>
                            <pay_status></pay_status>
                            <pay_time></pay_time>
                            <pay_way></pay_way>
                            <phas_amount></phas_amount>
                            <phase></phase>
                            <phase_condition></phase_condition>
                            <phase_date></phase_date>
                        </trade_terms_info>
                    </trade_terms>
                </trade_info>
            </list>
            <total_count></total_count>
        </data>
        <error_code>&quot;isv.invalid-parameter&quot;</error_code>
        <error_info></error_info>
        <success>false</success>
    </result>
</alibaba_trade_buyerorderlist_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

FAQ

返回
顶部