中文版
产品文档1688 APITaobao / Tmall APIPoizon API
产品文档1688 APITaobao / Tmall APIPoizon API
English
  1. 1688 订单管理
  • 1688 开发人员参考
  • 1688 商品搜索
    • 上传图片获取imageId
      POST
    • 图片搜索
      GET
    • 关键词搜索
      GET
    • 商品详情搜索
      GET
    • 店铺搜索
      GET
    • 商品运费查询
      POST
    • 类目查询
      GET
    • 商品详情搜索-支持短链
      GET
  • 1688 订单管理
    • 预览订单
      POST
    • 创建订单
      POST
    • 取消订单
      POST
    • 确认收货
      POST
    • 查询订单详情
      POST
    • 查询订单列表
      POST
  • 1688 订单支付
    • 批量获取订单的支付链接
      GET
    • 发起免密支付
      POST
  • 1688 其他接口
    • 多语言搜索导航
      GET
  • 1688 消息说明
    • 1688 交易消息
    • 1688消息-签名验证
  1. 1688 订单管理

查询订单列表

POST
/alibaba/trade/getBuyerOrderList
获取买家的订单列表

请求参数

Body 参数application/json

示例
{
    "appKey": "",
    "appSecret": "",
    "createStartTime": "20250702211113000+0800",
    "createEndTime": "20250902211113000+0800",
    "orderStatus": "success",
    "outOrderId": "",
    "productName": "",
    "page": 1,
    "pageSize": 1
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.dajisaas.com/alibaba/trade/getBuyerOrderList' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "createStartTime": "20250702211113000+0800",
    "createEndTime": "20250902211113000+0800",
    "orderStatus": "success",
    "outOrderId": "",
    "productName": "",
    "page": 1,
    "pageSize": 1
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 200,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "guaranteesTerms": null,
                "internationalLogistics": null,
                "nativeLogistics": {
                    "address": "广东省 广州市 白云区",
                    "area": "白云区",
                    "areaCode": "440111",
                    "city": "广州市",
                    "contactPerson": "XXX",
                    "fax": null,
                    "mobile": null,
                    "province": "广东省",
                    "telephone": null,
                    "zip": "510000",
                    "logisticsItems": null,
                    "townCode": null,
                    "town": null,
                    "caid": null,
                    "realLogisticsCompanyNo": null
                },
                "productItems": [
                    {
                        "cargoNumber": null,
                        "description": null,
                        "itemAmount": 42.8,
                        "name": "现货打孔机成人耳环项链手链饰品挂卡打孔器首饰收纳卡片打孔机",
                        "price": 23.9,
                        "productID": 800609753716,
                        "productImgUrl": [
                            "http://cbu01.alicdn.com/img/ibank/O1CN01kK7V1m1MjlflseKog_!!6000000001471-0-cib.80x80.jpg",
                            "http://cbu01.alicdn.com/img/ibank/O1CN01kK7V1m1MjlflseKog_!!6000000001471-0-cib.jpg"
                        ],
                        "productSnapshotUrl": "https://trade.1688.com/order/offer_snapshot.htm?order_entry_id=2908059205527363456",
                        "quantity": 2,
                        "refund": 0,
                        "skuID": null,
                        "sort": null,
                        "status": "success",
                        "subItemID": 290803333337363456,
                        "type": "common",
                        "unit": "个",
                        "weight": null,
                        "weightUnit": null,
                        "guaranteesTerms": [
                            {
                                "assuranceInfo": "“满足相应条件时,用户在退货寄出后,享受极速退款到账。",
                                "assuranceType": "lsjst_s",
                                "qualityAssuranceType": "极速退款"
                            },
                            {
                                "assuranceInfo": "卖家在承诺买家保障服务的基础上,向买家提供“48小时发货延必赔”的服务。在买家通过支付宝担保交易完成付款或通过货到付款下单成功后,卖家承诺在买家支付成功起48小时内发货。如卖家未履行前述承诺,买家可在指定期限内发起维权,并申请赔付。",
                                "assuranceType": "ssbxsfh",
                                "qualityAssuranceType": "48小时发货"
                            },
                            {
                                "assuranceInfo": null,
                                "assuranceType": null,
                                "qualityAssuranceType": null
                            },
                            {
                                "assuranceInfo": null,
                                "assuranceType": null,
                                "qualityAssuranceType": null
                            }
                        ],
                        "productCargoNumber": "LP-10C-058",
                        "skuInfos": null,
                        "entryDiscount": 0,
                        "specId": null,
                        "quantityFactor": 1,
                        "statusStr": "交易成功",
                        "refundStatus": null,
                        "closeReason": null,
                        "logisticsStatus": null,
                        "gmtCreate": null,
                        "gmtModified": null,
                        "gmtCompleted": null,
                        "gmtPayExpireTime": null,
                        "refundId": null,
                        "subItemIDString": null,
                        "refundIdForAs": null,
                        "erpMaterialCode": null,
                        "itemDiscountFee": null,
                        "cantSendReason": null,
                        "canSendGoods": null,
                        "barCode": null,
                        "permitLogisticsCpCode": null,
                        "deliverGoodsOverdueRisk": null,
                        "relatedCode": null,
                        "freeEntryServiceInfo": null,
                        "payEntryServiceInfo": null,
                        "extAttributes": null
                    }
                ],
                "tradeTerms": [
                    {
                        "payStatus": "6",
                        "payTime": "2025-09-02T09:58:02.000+00:00",
                        "payWay": "13",
                        "phasAmount": 47.3,
                        "phase": 610423338363456,
                        "phaseCondition": null,
                        "phaseDate": null,
                        "cardPay": false,
                        "expressPay": false,
                        "payWayDesc": "支付平台"
                    }
                ],
                "extAttributes": null,
                "orderRateInfo": {
                    "buyerRateStatus": 5,
                    "sellerRateStatus": 5,
                    "buyerRateList": null,
                    "sellerRateList": null
                },
                "orderInvoiceInfo": null,
                "customs": null,
                "overseasExtraAddress": null,
                "baseInfo": {
                    "allDeliveredTime": "2025-09-03T09:21:17.000+00:00",
                    "businessType": "cn",
                    "buyerID": "b2b-2217533334e9c00",
                    "buyerMemo": null,
                    "completeTime": "2025-09-13T09:21:25.000+00:00",
                    "createTime": "2025-09-02T09:56:37.000+00:00",
                    "currency": null,
                    "id": 29080593337363456,
                    "modifyTime": "2025-09-13T09:21:24.000+00:00",
                    "payTime": "2025-09-02T09:58:02.000+00:00",
                    "receivingTime": "2025-09-13T09:21:23.826+00:00",
                    "refund": 0,
                    "remark": null,
                    "sellerID": "b2b-292931333434e",
                    "sellerMemo": null,
                    "shippingFee": 4.5,
                    "status": "success",
                    "totalAmount": 47.3,
                    "buyerRemarkIcon": null,
                    "sellerRemarkIcon": null,
                    "discount": 0,
                    "buyerContact": {
                        "phone": "",
                        "fax": null,
                        "email": null,
                        "imInPlatform": "tb643316",
                        "name": null,
                        "mobile": null,
                        "companyName": null
                    },
                    "tradeType": "50060",
                    "refundStatus": null,
                    "refundStatusForAs": null,
                    "refundPayment": 0,
                    "idOfStr": "290805923333456",
                    "alipayTradeId": "11170600025033391079365634",
                    "receiverInfo": {
                        "toFullName": "XXX",
                        "toDivisionCode": "440111",
                        "toMobile": null,
                        "toPhone": null,
                        "toPost": "510000",
                        "toTownCode": null,
                        "toArea": "广东省 广州市 白云区"
                    },
                    "buyerLoginId": "tb640552016",
                    "sellerLoginId": "kyocraft",
                    "buyerUserId": 221753365634,
                    "sellerUserId": 292333315908,
                    "buyerAlipayId": "2088743338265",
                    "sellerAlipayId": "2083332969006510",
                    "confirmedTime": null,
                    "closeReason": null,
                    "sumProductPayment": 47.8,
                    "stepOrderList": null,
                    "stepAgreementPath": null,
                    "stepPayAll": false,
                    "buyerFeedback": null,
                    "overSeaOrder": false,
                    "subBuyerLoginId": null,
                    "sellerOrder": null,
                    "preOrderId": null,
                    "refundId": null,
                    "flowTemplateCode": null,
                    "buyerLevel": null,
                    "sellerCreditLevel": null,
                    "sellerContact": {
                        "phone": "86-",
                        "fax": null,
                        "email": null,
                        "imInPlatform": "kyocraft",
                        "name": "王静波",
                        "mobile": "1363322222",
                        "companyName": "宁波市海曙奇奥文具有限公司",
                        "wgSenderName": null,
                        "wgSenderPhone": null
                    },
                    "newStepOrderList": null,
                    "closeRemark": null,
                    "closeOperateType": null,
                    "couponFee": null,
                    "tradeTypeDesc": null,
                    "payChannelList": null,
                    "tradeTypeCode": null,
                    "payTimeout": null,
                    "payTimeoutType": null,
                    "payChannelCodeList": null,
                    "ccid": null,
                    "relatedCode": null,
                    "buyerOpenUid": null,
                    "buyerSubOpenUid": null,
                    "inventoryMode": null,
                    "outOrderId": null
                },
                "orderBizInfo": {
                    "odsCyd": false,
                    "accountPeriodTime": null,
                    "creditOrder": false,
                    "creditOrderDetail": null,
                    "preOrderInfo": null,
                    "lstOrderInfo": null,
                    "erpBuyerUserId": null,
                    "erpOrderId": null,
                    "erpBuyerOrgId": null,
                    "isCz": null,
                    "isDz": null,
                    "dz": null,
                    "dropshipping": false,
                    "shippingInsurance": "givenByAnXinGou",
                    "hyperLinkCangFaOrder": null,
                    "hyperLinkOrder": null,
                    "hyperLinkSecondStepOrder": null,
                    "hyperLinkShipType": null,
                    "lightningWarehouse": null
                },
                "quoteList": null,
                "fromEncryptOrder": null,
                "encryptOutOrderInfo": null,
                "outChannel": null,
                "sendGoodsOverdueRisk": null,
                "officialLogisticOrder": null
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "totalRecord": 8713
    },
    "timestamp": 175813323480,
    "traceId": "c805230410e",
    "cost": 0
}
修改于 2025-09-18 04:05:41
上一页
查询订单详情
下一页
批量获取订单的支付链接
Built with