SkillHub

ax-publish-goods

v1.0.2

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

Sourced from ClawHub, Authored by BigMountains

Installation

Please help me install the skill `ax-publish-goods` from SkillHub official store. npx skills add BigMountains/ax-publish-goods

翱象发品接口

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

快速开始

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

请求参数

参数 类型 必填 说明
cmd string 是 固定值: saas.sku.create.goods.batch
source string 是 AppKey
secret string 是 用于签名，不传参只用于签名计算
ticket string 是 随机生成的UUID格式字符串
timestamp string 是 10位时间戳
version string 是 固定值: 3
encrypt string 是 固定值: 空字符串 ""
body string 是 JSON格式的业务参数
sign string 是 MD5签名（大写）

Body 参数

参数 类型 必填 说明
merchant_code string 是 商家编码
erp_store_code string 是 门店编码
sku_list array 是 商品列表

SKU 参数

参数 类型 必填 说明
sku_name string 是 商品名称
inventory_unit string 是 库存单位（个/瓶/盒等）
sku_code string 是 商品编码（唯一）
barcodes array 是 条码列表
specification string 是 规格
sale_price string 是 售价（单位：分）

签名算法

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

  2. body, cmd, encrypt, secret, source, ticket, timestamp, version

  3. 拼接成字符串： key1=value1&key2=value2&...

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