OpenSkillIndex← back to search
claude-codeopenclawautomation

Skills ax-publish-goods

翱象（淘宝闪购）发品接口，支持批量创建商品。Use when: (1) 需要调用翱象发品接口创建商品, (2) 需要生成翱象API签名, (3) 需要批量发布商品到淘宝闪购。

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bigmountains/ax-publish-goods" ~/.claude/skills/openclaw-skills-ax-publish-goods && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bigmountains/ax-publish-goods" ~/.openclaw/skills/openclaw-skills-ax-publish-goods && rm -rf "$T"
manifest: skills/bigmountains/ax-publish-goods/SKILL.md
tags
#taobao#api-integration#e-commerce#batch-processing#signature-generation#inventory-management
source content

翱象发品接口

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

快速开始

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 参数说明

请求参数

参数类型必填说明
cmdstring是固定值: 
saas.sku.create.goods.batch
sourcestring是AppKey
secretstring是用于签名，不传参只用于签名计算
ticketstring是随机生成的UUID格式字符串
timestampstring是10位时间戳
versionstring是固定值: 
3
encryptstring是固定值: 空字符串 
""
bodystring是JSON格式的业务参数
signstring是MD5签名（大写）

Body 参数

参数类型必填说明
merchant_codestring是商家编码
erp_store_codestring是门店编码
sku_listarray是商品列表

SKU 参数

参数类型必填说明
sku_namestring是商品名称
inventory_unitstring是库存单位（个/瓶/盒等）
sku_codestring是商品编码（唯一）
barcodesarray是条码列表
specificationstring是规格
sale_pricestring是售价（单位：分）

签名算法

  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 参考实现