1. 1688 订单管理
大吉开放平台 API
  • 大吉开放平台API
    • 产品文档
      • 平台概述
      • 成为开发者
      • Access Key和Access 密钥
      • 接口签名规则(sign)
      • 1688 API 说明
      • Taobao API 说明
      • 常见问题
    • 1688-API
      • 1688 商机
        • 查询榜单列表
        • 查询商品每日销售趋势
      • 1688 订单管理
        • 预览订单
          POST
        • 创建订单
          POST
        • 取消订单
          POST
        • 确认收货
          POST
        • 查询订单详情
          POST
        • 查询订单列表
          POST
      • 1688 其他接口
        • 多语言搜索导航
      • 1688 订单支付
        • 批量获取订单的支付链接
        • 发起免密支付
      • 1688 商品搜索
        • 上传图片获取imageId
        • 图片搜索
        • 关键词搜索
        • 商品详情搜索
        • 店铺搜索
        • 商品运费查询
        • 类目查询
        • 商品详情搜索-支持短链
      • 1688-API调试
        • 1688 签名&枚举
        • 上传图片获取imageId
        • 图片搜索
        • 关键词搜索
        • 商品详情搜索
        • 店铺搜索
        • 商品运费查询
        • 类目查询
        • 商品详情搜索-支持短链
        • 查询榜单列表
        • 查询商品每日销售趋势
        • 预览订单
        • 创建订单
        • 取消订单
        • 确认收货
        • 查询订单详情
        • 查询订单列表
        • 批量获取订单的支付链接
        • 发起免密支付
        • 多语言搜索导航
        • 1688 交易消息
        • 1688消息-签名验证
        • 1688 API
    • Taobao-API
      • Taobao-Tmall-API
        • Taobao/Tmall 签名&枚举
        • 上传图片
        • 图片搜索V1.0
        • 图片搜索V2.0
        • 关键词搜索
        • 店铺搜索
        • 商品详情搜索
        • 榜单类型搜索
        • 榜单商品搜索
        • 商品运费查询
        • 商品详情搜索-支持短链
        • 批量商品运费查询
        • 商品详情搜索V2
        • 商品运费查询 V2
        • 批量商品运费查询 V2
        • 撞库接口
        • 预览商品
        • 创建订单
        • 取消订单
        • 查询订单
        • 支付订单
        • 订单消息
        • 订单消息-签名验证
        • Taobao / Tmall API
      • Taobao API调试
        • Tmall 订单管理
          • 撞库接口
          • 预览商品
          • 创建订单
          • 取消订单
          • 查询订单
        • Tmall 订单支付
          • 支付订单
        • Tmall 商品搜索
          • 上传图片
          • 图片搜索V1.0
          • 图片搜索V2.0
          • 关键词搜索
          • 店铺搜索
          • 商品详情搜索V2
          • 榜单类型搜索
          • 榜单商品搜索
          • 商品运费查询 V2
          • 商品详情搜索-支持短链
          • 批量商品运费查询 V2
    • Poizon-API
      • Poizon 关键词搜索
      • Poizon 商品详情
      • Poizon API调试
        • 得物商品搜索
          • Poizon 关键词搜索
          • Poizon 商品详情
  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 '/alibaba/trade/getBuyerOrderList' \
--header 'Content-Type: application/json' \
--data '{
    "appKey": "",
    "appSecret": "",
    "createStartTime": "20250702211113000+0800",
    "createEndTime": "20250902211113000+0800",
    "orderStatus": "success",
    "outOrderId": "",
    "productName": "",
    "page": 1,
    "pageSize": 1
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "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": 290803333337363460,
                        "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
}
修改于 2026-07-31 07:36:47
上一页
查询订单详情
下一页
多语言搜索导航
Built with