小于电商开放平台-获取订单列表

简要描述

• 获取订单列表

请求URL

• {Host}/lt-third/api/order/list，见【基础参数说明】

请求方式

• GET 方式发送参数
• POST 方式发送参数。当使用 POST 时，请求的主体必须是 JSON 格式，而且 HTTP header 的 Content-Type 需要设置为 application/json

请求参数说明

参数名	必选	类型	说明
appId	是	string	应用AppId
appSecret	是	string	应用AppSecret
platformShopIds	否	string	【API-店铺ID】集合 可逗号隔开
platformGoodsIds	否	string	【API-商品ID】集合 可逗号隔开
platformOrderIds	否	string	【API-订单ID】集合 可逗号隔开
createStartTime	否	string	查询下单开始时间，格式： yyyy-MM-dd HH:mm:ss
createEndTime	否	string	查询下单结束时间，格式： yyyy-MM-dd HH:mm:ss
updateStartTime	否	string	数据更新开始时间，格式： yyyy-MM-dd HH:mm:ss
updateEndTime	否	string	数据更新结束时间，格式： yyyy-MM-dd HH:mm:ss
pageIndex	否	int	页码，默认值为1
pageSize	否	int	每页记录数，默认值为20 取值范围：1~50
keywords	否	string	关键词

请求示例

POST {Host}/lt-third/api/order/list
Content-Type: application/json

{
  "appId": "RlYajTa4hd74xh4FuGrVkDPx",
  "appSecret": "uy8wHbPohwT8cB1HncTJaZaBSmVwaV",
  "platformShopIds": "doudian_77844856",
  "startTime": "2023-04-14 14:28:00",
  "endTime": "2023-04-14 14:29:00",
  "pageIndex": 1,
  "pageSize": 10
}

返回参数说明

参数名	类型	说明
code	int	状态码
msg	string	描述
data	object
total	int	总行数
rows	Order[]	订单列表

Order 实体：

参数名	类型	说明
platformShopId	string	店铺ID，唯一值
platformOrderId	string	订单ID，唯一值
thirdPlatform	string	对接平台，见【字典数据】
platformShopNo	string	平台店铺ID
orderNo	string	订单编号
orderCreateTime	string	下单时间，格式： yyyy-MM-dd HH:mm:ss
orderCount	int	下单数量
payAmount	number	支付金额，最多保留4位小数
orderStatus	string	订单状态，如：已关闭，见【字典数据】
orderStatusValue	string	订单状态值，如：4，见【字典数据】
receiver	string	收货人
receiverTel	string	收货人电话
receiverAddr	string	收货人地址
buyerRemark	string	买家备注
otherInfo	string	其他信息JSON字符串，每个平台定制字段，见【字典数据】
skuList	Sku[]	商品列表，订单的商品信息，包括一个订单多个商品
logisticsList	Logistics[]	物流信息列表
updateTime	string	数据更新时间，格式： yyyy-MM-dd HH:mm:ss

Sku 实体：

参数名	类型	说明
platformGoodsId	string	商品ID，唯一值
itemOrderNo	string	子订单编号
platformGoodsNo	string	平台商品ID
productName	string	商品标题
skuId	string	平台规格ID
skuImg	string	规格图片
skuSpecName	string	规格名称
skuSn	string	规格编码
skuPrice	number	规格价格，最多保留4位小数
skuQuantity	int	下单规格数量
skuTotalAmount	number	规格总金额，最多保留4位小数
totalAmount	number	规格实收金额，最多保留4位小数
orderStatus	string	订单状态，如：已关闭，见【字典数据】
orderStatusValue	string	订单状态值，如：4，见【字典数据】
afterSaleId	string	售后订单编号
afterSaleStatus	string	售后状态，如：退款成功，见【字典数据】
afterSaleStatusValue	string	售后状态值，如：4，见【字典数据】
otherInfo	string	其他信息JSON字符串，每个平台定制字段，见【字典数据】

Logistics 实体：

参数名	类型	说明
logisticsName	string	物流公司
logisticsCode	string	物流单号

返回示例

{
  "msg": "查询成功",
  "code": 200,
  "data": {
    "total": 1,
    "rows": [
      {
        "platformShopId": "doudian_77844856",
        "platformOrderId": "doudian_77844856_5056692825384258657",
        "thirdPlatform": "doudian",
        "platformShopNo": "77844856",
        "orderNo": "5056692825384258657",
        "orderCreateTime": "2023-04-14 14:28:03",
        "orderCount": 4,
        "payAmount": 552.8300,
        "orderStatus": "已关闭",
        "orderStatusValue": "4",
        "receiver": "毛**",
        "receiverTel": "1********21",
        "receiverAddr": "广东省深圳市龙岗区龙城街道回龙路***号*************栋****",
        "buyerRemark": "我希望成为羽毛球高手",
        "otherInfo": "{\"mainStatusValue\":\"4\"}",
        "skuList": [
          {
            "platformGoodsId": "doudian_3587199297139143582",
            "itemOrderNo": "5056692825383996513",
            "platformGoodsNo": "3587199297139143582",
            "productName": "巧发力羽毛球训练器 练习器辅助发力阻力拍套器 羽毛球挥拍训练器",
            "skuId": "1322222144112",
            "skuImg": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/EOdaZBIk_m_7216a7d59beb4e96025d52e505bb853f_sx_58687_www800-800",
            "skuSpecName": "3050 黄色",
            "skuSn": "HUANG001",
            "skuPrice": 190.9100,
            "skuQuantity": 2,
            "skuTotalAmount": 381.8200,
            "totalAmount": 381.8200,
            "orderStatus": "已取消",
            "orderStatusValue": "4",
            "afterSaleId": "7270922374579552548",
            "afterSaleStatus": "退款成功",
            "afterSaleStatusValue": "12",
            "otherInfo": "{\"mainStatusValue\":\"4\"}"
          },
          {
            "platformGoodsId": "doudian_3587199297139143582",
            "itemOrderNo": "5056692825384127585",
            "platformGoodsNo": "3587199297139143582",
            "productName": "巧发力羽毛球训练器 练习器辅助发力阻力拍套器 羽毛球挥拍训练器",
            "skuId": "1381380565656",
            "skuImg": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/EOdaZBIk_m_7216a7d59beb4e96025d52e505bb853f_sx_58687_www800-800",
            "skuSpecName": "3050 蓝色\t",
            "skuSn": "LAN001",
            "skuPrice": 0.1100,
            "skuQuantity": 1,
            "skuTotalAmount": 381.8200,
            "totalAmount": 0.1100,
            "orderStatus": "已取消",
            "orderStatusValue": "4",
            "afterSaleId": "7270924461149438271",
            "afterSaleStatus": "退款成功",
            "afterSaleStatusValue": "12",
            "otherInfo": "{\"mainStatusValue\":\"4\"}"
          }
        ],
        "logisticsList": [
          {
            "logisticsName": "韵达快递",
            "logisticsCode": "433004982581839"
          }
        ],
        "updateTime": "2023-02-13 17:16:47"
      }
    ]
  }
}

联系我们

小于电商开放平台
手机：13267238092