作者:鲨鱼 | 时间:2025年7月24日
原创文章,首发于优快云,如需转载,请注明出处。
目录
一、引言
在电商运营日益复杂的今天,如何快速、准确地获取并处理订单数据,已成为电商从业者必须掌握的核心技能之一。手动导出和整理订单不仅效率低下,还容易出错。
而通过拼多多开放平台的订单接口,我们可以实现订单数据的自动化同步,打通订单、商品、物流等多个环节,提升运营效率,优化数据决策。
本文将手把手教你如何接入拼多多API,获取订单数据,并进行解析、统计和入库,最终生成一份完整的销售报表,助力你的电商运营之路。
二、拼多多开放平台概览
什么是拼多多开放平台?
拼多多开放平台是拼多多为开发者、服务商、商家提供的一套开放接口系统,支持订单、商品、物流、售后等多维度的数据调用和管理。
核心功能
- 订单管理:查询订单状态、获取订单列表、同步物流信息等。
- 商品管理:上传、下架、修改商品信息。
- 物流服务:电子面单、物流跟踪、退货管理等。
- 用户管理:获取用户信息、管理售后反馈等。
为什么选择拼多多API?
- 数据实时性强:实时获取最新订单数据。
- 接口文档完善:官方提供详细的API文档和调用示例。
- 支持多平台接入:适用于Web、App、ERP系统等多种场景。
三、接入拼多多API
步骤1:注册并创建应用
- 登录 拼多多开放平台官网。
- 创建一个“自用型”或“服务商型”应用。
- 获取
Client ID
和Client Secret
,这是调用API的凭证。
步骤2:获取Access Token
使用授权码或账号密码方式获取 access_token
,用于后续API调用。
import requests
def get_access_token(client_id, client_secret):
url = "https://gw-api.pinduoduo.com/api/router"
payload = {
'type': 'pdd.pop.auth.token.create',
'client_id': client_id,
'client_secret': client_secret,
'grant_type': 'client_credential'
}
response = requests.post(url, data=payload)
return response.json()
# 示例调用
client_id = 'your_client_id'
client_secret = 'your_client_secret'
token_info = get_access_token(client_id, client_secret)
print(token_info)
四、实战:同步拼多多订单数据
使用接口:pdd.pop.order.list.get
该接口用于批量获取订单列表,支持按时间范围、订单状态等条件筛选。
import time
import requests
def get_order_list(access_token, start_created, end_created, page=1, page_size=50):
url = "https://gw-api.pinduoduo.com/api/router"
params = {
'type': 'pdd.pop.order.list.get',
'access_token': access_token,
'start_created': start_created,
'end_created': end_created,
'page': page,
'page_size': page_size,
'fields': 'order_sn,status,pay_time,receiver_name,receiver_mobile,receiver_address,total_amount,payment,goods_details'
}
response = requests.post(url, data=params)
return response.json()
# 示例调用
access_token = 'your_access_token'
start_created = '2025-07-01 00:00:00'
end_created = '2025-07-31 23:59:59'
orders = get_order_list(access_token, start_created, end_created)
print(orders)
五、解析与处理订单数据
解析订单结构,提取关键字段
def parse_order(order):
return {
'order_sn': order.get('order_sn'),
'status': order.get('status'),
'pay_time': order.get('pay_time'),
'receiver_name': order.get('receiver_name'),
'receiver_mobile': order.get('receiver_mobile'),
'receiver_address': order.get('receiver_address'),
'total_amount': float(order.get('total_amount', 0)),
'payment': float(order.get('payment', 0)),
'items': [
{
'goods_id': item.get('goods_id'),
'goods_name': item.get('goods_name'),
'price': float(item.get('price', 0)),
'quantity': int(item.get('quantity', 0))
}
for item in order.get('goods_details', [])
]
}
# 解析并打印
parsed_orders = [parse_order(order) for order in orders.get('order_list_get_response', {}).get('order_list', [])]
for parsed in parsed_orders:
print(parsed)
六、生成销售报表
聚合数据并统计关键指标
def generate_sales_report(orders):
total_sales = sum(order['payment'] for order in orders)
order_count = len(orders)
average_order_value = total_sales / order_count if order_count > 0 else 0
# 商品销售统计
sales_by_item = {}
for order in orders:
for item in order['items']:
key = (item['goods_id'], item['goods_name'])
if key not in sales_by_item:
sales_by_item[key] = {
'quantity': 0,
'revenue': 0
}
sales_by_item[key]['quantity'] += item['quantity']
sales_by_item[key]['revenue'] += item['price'] * item['quantity']
return {
'total_sales': total_sales,
'order_count': order_count,
'average_order_value': average_order_value,
'sales_by_item': sales_by_item
}
# 生成报表
sales_report = generate_sales_report(parsed_orders)
print(sales_report)
输出报表为CSV
import csv
def export_to_csv(report, filename='sales_report.csv'):
with open(filename, mode='w', newline='', encoding='utf-8') as file:
writer = csv.writer(file)
# 写入表头
writer.writerow(['Total Sales', 'Order Count', 'Average Order Value'])
writer.writerow([report['total_sales'], report['order_count'], report['average_order_value']])
# 写入商品销售统计
writer.writerow([])
writer.writerow(['Goods ID', 'Goods Name', 'Quantity Sold', 'Revenue'])
for (goods_id, goods_name), stats in report['sales_by_item'].items():
writer.writerow([goods_id, goods_name, stats['quantity'], stats['revenue']])
# 导出报表
export_to_csv(sales_report)
七、将数据写入数据库(可选)
创建MySQL表结构
CREATE TABLE sales_reports (
id INT AUTO_INCREMENT PRIMARY KEY,
total_sales DECIMAL(10, 2),
order_count INT,
average_order_value DECIMAL(10, 2),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE sales_by_items (
id INT AUTO_INCREMENT PRIMARY KEY,
report_id INT,
goods_id BIGINT,
goods_name VARCHAR(255),
quantity_sold INT,
revenue DECIMAL(10, 2),
FOREIGN KEY (report_id) REFERENCES sales_reports(id)
);
插入数据到数据库
import mysql.connector
def insert_into_db(report):
conn = mysql.connector.connect(
host="localhost",
user="root",
password="password",
database="sales_db"
)
cursor = conn.cursor()
# 插入总销售数据
insert_report_query = """
INSERT INTO sales_reports (total_sales, order_count, average_order_value)
VALUES (%s, %s, %s)
"""
cursor.execute(insert_report_query, (
report['total_sales'],
report['order_count'],
report['average_order_value']
))
report_id = cursor.lastrowid
# 插入商品销售统计
insert_item_query = """
INSERT INTO sales_by_items (report_id, goods_id, goods_name, quantity_sold, revenue)
VALUES (%s, %s, %s, %s, %s)
"""
for (goods_id, goods_name), stats in report['sales_by_item'].items():
cursor.execute(insert_item_query, (
report_id,
goods_id,
goods_name,
stats['quantity'],
stats['revenue']
))
conn.commit()
cursor.close()
conn.close()
# 插入报表数据
insert_into_db(sales_report)
八、总结
通过本文的讲解,你已经掌握了以下技能:
- 如何接入拼多多开放平台并获取API权限;
- 如何调用订单接口同步订单数据;
- 如何解析订单结构并提取关键字段;
- 如何生成销售报表并导出为CSV文件;
- 如何将报表数据写入数据库以便后续分析。
这些技能不仅能帮助你提升电商运营效率,还能为后续的BI分析、数据看板、自动化系统开发打下坚实基础。
九、结束语
电商数据的自动化处理,正在成为电商从业者必备的核心能力之一。掌握拼多多订单接口,意味着你已经迈出了自动化运营的第一步。
希望本文能为你提供实用的技术指导和清晰的开发思路。无论你是电商创业者、运营人员,还是开发者,都可以通过本文的示例代码快速上手,打造属于自己的订单管理系统。
十、作者简介
鲨鱼,全栈开发者,电商系统架构师,优快云博客专家,专注于电商API对接、数据自动化处理、ERP系统开发等领域。拥有多年电商平台对接经验,擅长使用Python、Java等语言实现电商数据的采集、分析与可视化展示。