翱象发品接口

对接翱象（淘宝闪购）零售开放平台，实现商品批量创建功能。

快速开始

Python 版本

from scripts.aoxiang_publish import AoxiangPublishClient

# 创建客户端
client = AoxiangPublishClient(
    app_key="???",
    secret="???"
)

# 构建商品列表
sku_list = [
    {
        "sku_name": "可口可乐 330ml",
        "inventory_unit": "瓶",
        "sku_code": "COLA330001",
        "barcodes": ["6901234567890"],
        "specification": "330ml",
        "sale_price": "350"  # 单位：分
    }
]

# 调用接口
result = client.create_goods(
    merchant_code="ERP_ACCESS_TEST",
    erp_store_code="ERP_NORMAL",
    sku_list=sku_list
)

# 处理结果
if result["body"]["errno"] == 0:
    print("发品成功!")
else:
    print(f"失败: {result['body']['error']}")

命令行使用

# 使用默认示例数据
python3 scripts/aoxiang_publish.py

# 自定义参数
python3 scripts/aoxiang_publish.py "MERCHANT_CODE" "STORE_CODE" '[{"sku_name":"商品","inventory_unit":"个","sku_code":"SKU001","barcodes":["123"],"specification":"规格","sale_price":"100"}]'

API 参数说明

请求参数

Body 参数

SKU 参数

签名算法

1. 构建签名参数（按 key 字母顺序排序）：

   • body, cmd, encrypt, secret, source, ticket, timestamp, version

2. 拼接成字符串：

   key1=value1&key2=value2&...
   

3. MD5 加密，转大写32位

响应格式

{
    "body": {
        "errno": 0,
        "data": null,
        "error": "success"
    },
    "cmd": "resp.saas.sku.create.goods.batch",
    "encrypt": "",
    "sign": "...",
    "source": "41389872",
    "ticket": "...",
    "timestamp": 1234567890,
    "traceid": "...",
    "version": "3"
}

• errno: 0 表示成功
• errno != 0 表示失败，错误信息在 error 字段

注意事项

1. 价格单位是"分"，不是元（3.5元 = 350分）
2. sku_code 必须唯一
3. ticket 是随机生成的UUID格式（带减号）
4. timestamp 是10位时间戳（秒级）
5. body 需要转为JSON字符串参与签名

文件列表

• scripts/aoxiang_publish.py - Python 客户端
• REFERENCE.md - Java 参考实现