淘宝官方商品、交易、订单、物流、插旗接口接入说明

以下是关于淘宝店铺订单列表接口、订单详情接口、订单物流接口的相关信息：

订单列表接口

• 功能：获取淘宝店铺的订单列表，能展示订单的基本信息，如订单号、创建时间、支付状态等。

• 使用场景：可用于展示店铺的订单概览，方便商家快速了解订单状态，进行初步的管理和统计，比如查看当天、本周或本月的订单总量、不同支付状态（如已支付、未支付、退款中）的订单数量分布等。

• 常见接口：taobao.trades.sold.get，可获取三个月内已卖出的在线订单，适用于初始化时使用，但不建议用于获取增量订单；taobao.topats.trades.sold.get，异步获取三个月内已卖出的在线订单，具有简单、高效、准确的特点，且支持超大卖家，强烈建议在初始化时使用，替代taobao.trades.sold.get以提升效率、降低开发成本。

• 调用示例（以taobao.trades.sold.get为例） ：

  请求方式：GET 或 POST

  请求参数：

  api：接口名称，如taobao.trades.sold.get。

  其他参数（参考淘宝开放平台接口文档）：可能包括交易类型type、订单创建时间范围等。

  响应示例：返回的结果中包含订单列表的相关信息，如订单号、买家昵称、商品信息、交易金额、创建时间、支付状态等。

订单详情接口

• 功能：获取单笔订单的详细信息，涵盖买家信息（如买家昵称、联系方式）、收货地址、购买的商品详情（如商品名称、规格、数量）、金额（如商品总价、运费、优惠金额等）、支付和物流信息等。

• 使用场景：主要用于订单详细查看，帮助商家进行发货前的准备工作，如核对商品和收货信息，也可用于售后服务，比如处理买家的退换货申请时，查看订单的具体情况。

• 常见接口：taobao.trade.fullinfo.get，用于获取单笔订单的详细信息；taobao.topats.trades.fullinfo.get，可批量获取最多 100 笔订单详情。

• 调用示例（以taobao.trade.fullinfo.get为例） ：

  请求方式：GET 或 POST

  请求参数：

  api：接口名称，如taobao.trade.fullinfo.get。

  tid：订单号，必填参数，指定要获取详情的订单编号。

  其他参数（参考淘宝开放平台接口文档）：可能包括是否需要获取子订单信息等。

  响应示例：返回的结果中包含指定订单的详细信息，如买家信息、收货地址、商品详情、交易金额、支付方式、物流信息等。

订单物流接口

• 功能：获取订单的物流信息，包括物流公司、物流单号、物流流转信息（如发货时间、运输中的各个节点及时间等）。

• 使用场景：用于订单的物流跟踪，商家和买家都可以通过该接口了解商品的配送状态，商家可以据此掌握物流进度，及时处理可能出现的问题，如物流延迟等；买家可以随时查看自己购买商品的运输情况，预估到货时间。

• 常见接口：通常在获取订单详情时，其中的物流信息部分会包含相关数据。此外，一些物流相关的特定接口，如taobao.logistics.online.confirm（仅在使用taobao.logistics.online.send发货时且未输入运单号的情况下，用于确认发货）等也可能会涉及到物流信息的处理。

• 调用示例（结合订单详情接口获取物流信息） ：在调用订单详情接口（如taobao.trade.fullinfo.get）的响应结果中，会有物流信息的字段，如logistics_company（物流公司名称）、out_sid（物流单号）等。如果需要进一步跟踪物流流转信息，可能需要根据物流公司和单号，调用相应物流公司的开放接口或使用第三方物流查询平台的接口进行查询。

使用这些接口的一般步骤：

1. 注册开发者账号：在淘宝开放平台注册开发者账号。

2. 创建应用：在淘宝开放平台创建应用，如添加 Taobaoapi2014 地球号以获取 API 调用权限。

3. 获取 API 密钥：在应用中获取appkey和appsecret，这两个密钥将用于 API 的调用认证。

4. 调用 API 接口：使用 HTTP 请求调用 API 接口，并传入必要的参数，如订单号、API 密钥等。

5. 体验 API 接口：u6v.cn/5W41Dx

注意事项：

1. 遵守淘宝开放平台的使用协议和规定，不要滥用 API 或进行任何违法违规的操作。

2. 注意 API 调用的频率限制，避免超出调用配额。

3. 淘宝开放平台的 API 可能会随时更新，需要经常查阅官方文档以获取最新信息。