电商中台数据整合：淘宝商品 API 对接 ERP 系统的字段映射与同步逻辑

本文链接：https://blog.youkuaiyun.com/API_technology/article/details/147276931

一、引言

在电商业务不断发展的今天，企业往往需要将淘宝等电商平台的商品数据与企业内部的 ERP 系统进行整合，以实现业务流程的自动化和数据的统一管理。电商中台作为连接电商平台和 ERP 系统的桥梁，承担着数据整合的重要任务。本文将详细介绍如何通过淘宝商品 API 对接 ERP 系统，包括字段映射和同步逻辑，并提供相应的代码示例。

二、需求背景

企业在运营过程中，淘宝店铺的商品数据（如商品名称、价格、库存等）需要实时同步到 ERP 系统中，以便进行库存管理、销售统计等操作。同时，ERP 系统中的商品数据更新也需要同步到淘宝店铺，确保数据的一致性。

三、淘宝商品 API 与 ERP 系统字段映射

1. 字段分析

淘宝商品 API 返回的数据包含多个字段，如 title（商品标题）、price（商品价格）、num（商品库存数量）等。而 ERP 系统中的商品数据也有对应的字段，如 product_name、product_price、product_stock 等。需要建立两者之间的映射关系。

2. 字段映射表

淘宝商品 API 字段	ERP 系统字段
`title`	`product_name`
`price`	`product_price`
`num`	`product_stock`

四、同步逻辑设计

1. 从淘宝到 ERP 的同步

定期调用淘宝商品 API 获取商品数据。
根据字段映射表将淘宝商品数据转换为 ERP 系统可以接受的格式。
将转换后的数据插入或更新到 ERP 系统中。

2. 从 ERP 到淘宝的同步

监听 ERP 系统中商品数据的更新事件。
根据字段映射表将 ERP 系统中的商品数据转换为淘宝 API 可以接受的格式。
调用淘宝 API 更新商品信息。

五、代码实现

以下是一个使用 Python 实现的简单示例，假设使用 MySQL 作为 ERP 系统的数据库：

import hashlib
import requests
import time
import mysql.connector

# 淘宝 API 相关信息
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"
API_URL = "http://gw.api.taobao.com/router/rest"

# ERP 系统数据库信息
ERP_DB_CONFIG = {
    'user': 'your_db_user',
    'password': 'your_db_password',
    'host': 'your_db_host',
    'database': 'your_db_name'
}

# 生成签名
def generate_sign(params, secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = secret
    for key, value in sorted_params:
        sign_str += f"{key}{value}"
    sign_str += secret
    md5 = hashlib.md5()
    md5.update(sign_str.encode('utf-8'))
    return md5.hexdigest().upper()

# 调用淘宝 API
def call_taobao_api(method, params):
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
    api_params = {
        "method": method,
        "app_key": APP_KEY,
        "timestamp": timestamp,
        "format": "json",
        "v": "2.0",
        "sign_method": "md5"
    }
    api_params.update(params)
    sign = generate_sign(api_params, APP_SECRET)
    api_params["sign"] = sign
    response = requests.get(API_URL, params=api_params)
    return response.json()

# 从淘宝同步数据到 ERP
def sync_taobao_to_erp():
    method = "taobao.item.get"
    params = {
        "fields": "num_iid,title,price,num",
        "num_iid": "your_product_id"  # 替换为实际的商品 ID
    }
    result = call_taobao_api(method, params)
    item = result.get('item_get_response', {}).get('item', {})
    if item:
        # 字段映射
        erp_data = {
            'product_id': item.get('num_iid'),
            'product_name': item.get('title'),
            'product_price': item.get('price'),
            'product_stock': item.get('num')
        }
        # 插入或更新到 ERP 数据库
        conn = mysql.connector.connect(**ERP_DB_CONFIG)
        cursor = conn.cursor()
        query = """
        INSERT INTO products (product_id, product_name, product_price, product_stock)
        VALUES (%(product_id)s, %(product_name)s, %(product_price)s, %(product_stock)s)
        ON DUPLICATE KEY UPDATE
        product_name = VALUES(product_name),
        product_price = VALUES(product_price),
        product_stock = VALUES(product_stock)
        """
        cursor.execute(query, erp_data)
        conn.commit()
        cursor.close()
        conn.close()

# 从 ERP 同步数据到淘宝（简单示例，实际需调用淘宝更新 API）
def sync_erp_to_taobao():
    conn = mysql.connector.connect(**ERP_DB_CONFIG)
    cursor = conn.cursor()
    query = "SELECT product_id, product_name, product_price, product_stock FROM products WHERE id = your_product_id"  # 替换为实际的查询条件
    cursor.execute(query)
    row = cursor.fetchone()
    if row:
        product_id, product_name, product_price, product_stock = row
        # 字段映射
        taobao_data = {
            "num_iid": product_id,
            "title": product_name,
            "price": product_price,
            "num": product_stock
        }
        # 调用淘宝更新 API
        # 这里需要根据淘宝 API 文档实现具体的更新逻辑
        print("模拟调用淘宝更新 API:", taobao_data)
    cursor.close()
    conn.close()

if __name__ == "__main__":
    # 从淘宝同步数据到 ERP
    sync_taobao_to_erp()
    # 从 ERP 同步数据到淘宝
    sync_erp_to_taobao()