全部
常见问题
产品动态
精选推荐

淘宝店铺订单相关 API 接口详解

管理 管理 编辑 删除

在电商业务的开发中,与淘宝店铺订单数据交互至关重要。通过一系列 API 接口,开发者能够获取订单列表、订单详情以及订单物流信息,为电商系统的完善和用户体验的提升提供有力支持。本文将详细介绍淘宝店铺订单列表、订单详情、订单物流这三个关键 API 接口。供稿者:Taobaoapi2014

一、订单列表 API 接口

(一)接口功能

该接口用于获取淘宝店铺的订单列表信息,支持多种筛选条件,方便开发者根据业务需求精准获取所需订单数据。

(二)请求方式

通常采用 HTTP GET 或 POST 请求,具体取决于淘宝开放平台的规定。一般建议使用 POST 请求,以便传递较为复杂的参数。

(三)请求参数

  1. 店铺 ID:必填参数,用于指定获取哪个淘宝店铺的订单列表。
  2. 时间范围:可选择传入开始时间和结束时间,以筛选出该时间段内的订单。例如,start_time=2025-01-01 00:00:00&end_time=2025-01-31 23:59:59。
  3. 订单状态:可选参数,如 “待付款”“已付款”“已发货”“已完成” 等,用于筛选特定状态的订单。例如,status = 已发货。
  4. 页码与每页数量:page=1&page_size=20,表示获取第一页,每页显示 20 条订单数据。

(四)响应数据

  1. 订单列表:包含多个订单对象,每个订单对象包含订单编号、买家信息、商品信息、订单金额、订单状态等详细字段。
封装好的第三方数据商平台接口,复制链接获取测试。 
demo url=http://c0b.cc/R4rbK2  wechat id:Taobaoapi2014
{
    "orders": [
        {
            "order_id": "1234567890",
            "buyer_name": "张三",
            "product_list": [
                {
                    "product_name": "商品A",
                    "quantity": 2,
                    "price": 100.00
                }
            ],
            "total_amount": 200.00,
            "status": "已发货"
        },
        {
            "order_id": "0987654321",
            "buyer_name": "李四",
            "product_list": [
                {
                    "product_name": "商品B",
                    "quantity": 1,
                    "price": 150.00
                }
            ],
            "total_amount": 150.00,
            "status": "待付款"
        }
    ]
}
  1. 总记录数:方便开发者进行分页计算,total_count=100,表示订单总数为 100 条。

二、订单详情 API 接口

(一)接口功能

根据订单编号获取该订单的详细信息,包括买家详细信息、商品详细清单、订单支付信息、收货地址等。

(二)请求方式

同样支持 HTTP GET 或 POST 请求,POST 请求用于传递复杂参数时更为可靠。

(三)请求参数

  1. 订单编号:必填参数,唯一标识一个订单,例如 order_id=1234567890。

(四)响应数据

  1. 订单基本信息:订单编号、店铺 ID、买家 ID、订单创建时间等。
  2. 买家信息:买家姓名、联系电话、收货地址等。
  3. 商品清单:详细列出每个商品的名称、规格、数量、单价、总价等。
  4. 支付信息:支付方式(如支付宝、微信支付)、支付金额、支付时间等。
  5. 订单备注:买家或卖家添加的订单备注信息。
封装好的第三方数据商平台接口,复制链接获取测试。 
demo url=http://c0b.cc/R4rbK2  wechat id:Taobaoapi2014
{
    "order_id": "1234567890",
    "store_id": "54321",
    "buyer_id": "98765",
    "create_time": "2025-01-15 10:20:30",
    "buyer_info": {
        "name": "张三",
        "phone": "13800138000",
        "address": "XX省XX市XX区XX街道"
    },
    "product_list": [
        {
            "product_name": "商品A",
            "specification": "XX规格",
            "quantity": 2,
            "unit_price": 100.00,
            "total_price": 200.00
        }
    ],
    "payment_info": {
        "payment_method": "支付宝",
        "payment_amount": 200.00,
        "payment_time": "2025-01-15 10:30:00"
    },
    "order_note": "买家留言:请尽快发货"
}

三、订单物流 API 接口

(一)接口功能

通过订单编号获取该订单的物流轨迹信息,方便买家和卖家实时跟踪订单的配送状态。

(二)请求方式

HTTP GET 或 POST 请求,根据实际情况选择合适的请求方式。

(三)请求参数

  1. 订单编号:必填,用于定位要查询物流信息的订单,如 order_id=1234567890。

(四)响应数据

  1. 物流公司名称:如 “顺丰速运”“中通快递” 等。
  2. 物流单号:用于在物流公司官网查询物流轨迹的单号。
  3. 物流轨迹列表:包含多个物流轨迹节点,每个节点包含时间、地点、物流状态描述等信息。
封装好的第三方数据商平台接口,复制链接获取测试。 
demo url=http://c0b.cc/R4rbK2  wechat id:Taobaoapi2014
{
    "logistics_company": "顺丰速运",
    "tracking_number": "SF123456789",
    "logistics_trace": [
        {
            "time": "2025-01-16 08:00:00",
            "location": "XX市XX区集散中心",
            "status": "已收件"
        },
        {
            "time": "2025-01-16 12:00:00",
            "location": "XX市XX区转运中心",
            "status": "快件在途,已发车"
        }
    ]
}

四、注意事项

  1. 接口权限:在使用淘宝店铺订单相关 API 接口前,需确保已在淘宝开放平台完成开发者认证,并申请到相应接口的调用权限。
  2. 数据安全:妥善处理请求和响应数据,防止数据泄露,尤其是涉及买家敏感信息(如姓名、电话、地址等)的数据。
  3. 接口调用频率:遵循淘宝开放平台规定的接口调用频率限制,避免因频繁调用导致接口被封禁。

通过以上对淘宝店铺订单列表、订单详情、订单物流 API 接口的详细介绍,开发者能够快速了解这些接口的功能、使用方法以及注意事项,从而在电商系统开发中高效地集成和利用这些接口,实现与淘宝店铺订单数据的无缝交互。

请登录后查看

用户19970108018 最后编辑于2025-03-02 11:23:18

快捷回复
回复
回复
回复({{post_count}}) {{!is_user ? '我的回复' :'全部回复'}}
排序 默认正序 回复倒序 点赞倒序

{{item.user_info.nickname ? item.user_info.nickname : item.user_name}} LV.{{ item.user_info.bbs_level }}

作者 管理员 企业

{{item.floor}}# 同步到gitee 已同步到gitee {{item.is_suggest == 1? '取消推荐': '推荐'}}
{{item.is_suggest == 1? '取消推荐': '推荐'}}
沙发 板凳 地板 {{item.floor}}#
{{item.user_info.title || '暂无简介'}}
附件

{{itemf.name}}

{{item.created_at}}  {{item.ip_address}}
{{item.like_count}}
{{item.showReply ? '取消回复' : '回复'}}
删除
回复
回复

{{itemc.user_info.nickname}}

{{itemc.user_name}}

回复 {{itemc.comment_user_info.nickname}}

附件

{{itemf.name}}

{{itemc.created_at}}
{{itemc.like_count}}
{{itemc.showReply ? '取消回复' : '回复'}}
删除
回复
回复
查看更多
144
{{like_count}}
{{collect_count}}
添加回复 ({{post_count}})

相关推荐

快速安全登录

使用微信扫码登录
{{item.label}} 加精
{{item.label}} {{item.label}} 板块推荐 常见问题 产品动态 精选推荐 首页头条 首页动态 首页推荐
取 消 确 定
回复
回复
问题:
问题自动获取的帖子内容,不准确时需要手动修改. [获取答案]
答案:
提交
bug 需求 取 消 确 定

微信登录/注册

切换手机号登录

{{ bind_phone ? '绑定手机' : '手机登录'}}

{{codeText}}
切换微信登录/注册
暂不绑定
CRMEB客服

CRMEB咨询热线 咨询热线

400-8888-794

微信扫码咨询

CRMEB开源商城下载 源码下载 CRMEB帮助文档 帮助文档
返回顶部 返回顶部
CRMEB客服