Linkfox Temu Manage Product Global

Temu 全球站商品管理 API（Manage Product）

本 skill（linkfox-temu-manage-product-global）覆盖 全球区（`site=global`，非美国/欧洲） 的 Product > Manage Product 下 24 个 bg.local.* / temu.local.* 接口（type 与 US/EU 对齐）。美国站请用 `linkfox-temu-manage-product-us`；欧洲站请用 `linkfox-temu-manage-product-eu`。

网关（本 skill 内置）：

发品请用 `linkfox-temu-add-product-us`（JSON 中 `site=global`）。电商合规（资质/GPSR/实拍图/责任人）用 `linkfox-temu-compliance-global`；价格/供货价（含 SKU 列表价）用 `linkfox-temu-price-global`；促销用 `linkfox-temu-promotion-global`；广告用 `linkfox-temu-ads-global`；订单用 `linkfox-temu-order-global` / `linkfox-temu-order-eu`；履约用 `linkfox-temu-fulfillment-global` / `linkfox-temu-fulfillment-eu`；取消用 `linkfox-temu-cancel-order-us` / `linkfox-temu-cancel-order-eu`（均需 `site=global` 时显式传入）。

API Usage

入参/出参、Partner 官方文档 URL 已内联至 references/：

常用单接口文档示例：

• 部分编辑：apis/bg-local-goods-partial-update.md
• 商品列表：apis/bg-local-goods-list-query.md
• 库存编辑：apis/bg-local-goods-stock-edit.md

默认参数

鉴权

1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token 2. Temu：accessToken 或 storeKey

Scripts（按 type）

示例

export LINKFOXAGENT_API_KEY="<key>"

# 商品列表
python scripts/global_manage_list_query.py '{"accessToken":"TOKEN","site":"global","tokenPurpose":"product-inventory","request":{"pageNo":1,"pageSize":20,"goodsSearchType":1,"goodsStatusFilterType":0}}'

# 详情
python scripts/global_manage_detail_query.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"versionQueryType":2}}'

# 部分编辑标题（官方字段为 goodsBasic.goodsName，非 productName）
python scripts/global_manage_partial_update.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"goodsBasic":{"goodsName":"New Title"}}}'

# 库存增量
python scripts/global_manage_stock_edit.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"skuStockChangeList":[{"skuId":999,"stockDiff":10}]}}'

Feedback： skillName：linkfox-temu-manage-product-global

网关与授权脚本

授权说明：references/access-token.md

<!-- LF_LARGE_RESPONSE_BLOCK -->

Handling Large Responses

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:

python scripts/response_io.py run --script scripts/check_linkfox_token.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick --out-dir outside any git working tree (e.g. /tmp/... on Unix, %TEMP%/... on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

This skill exposes multiple entry scripts: check_linkfox_token.py, get_temu_access_token.py, global_manage_category_check.py, global_manage_compliance_edit.py, global_manage_compliance_list_query.py, global_manage_detail_query.py, global_manage_goods_delete.py, global_manage_goods_list_retrieve.py, global_manage_goods_update.py, global_manage_list_query.py, global_manage_out_sn_set.py, global_manage_partial_update.py, global_manage_pre_sale_status_edit.py, global_manage_property_get.py, global_manage_property_relations.py, global_manage_property_relations_level_template.py, global_manage_property_relations_template.py, global_manage_publish_status_get.py, global_manage_sale_status_set.py, global_manage_sku_list_query.py, global_manage_sku_list_retrieve.py, global_manage_sku_out_sn_set.py, global_manage_sku_stock_query.py, global_manage_spec_info_get.py, global_manage_stock_edit.py, global_manage_videocoverimage_get.py, list_temu_access_tokens.py, save_temu_access_token.py, temu_file_download.py, temu_global_file_download.py, temu_global_proxy.py, temu_proxy.py, temu_token_guide.py. Pass --script scripts/<name>.py to choose the one you need.

run writes the full response to a file and emits only a schema preview + file path. read projects specific fields, with --limit/--offset for slicing and --format json|jsonl|csv|table for output.

When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:

• High field count per record, or fields you don't need
• Batch/paginated results (multiple items per call)
• Long-text fields (descriptions, reviews, HTML, time series)
• Output reused across later steps rather than consumed immediately

For small, single-use responses, calling the main script directly is fine.

⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via read. <!-- /LF_LARGE_RESPONSE_BLOCK -->

Temu accessToken 授权与获取

Temu 没有 LinkFox 侧自动 OAuth；accessToken 须在 Temu 卖家后台「服务市场 → 授权管理」手动复制。与 LINKFOXAGENT_API_KEY（LinkFox 用户鉴权）是两套令牌。

两种鉴权（勿混淆）

export LINKFOXAGENT_API_KEY="<your-key>"
python scripts/check_linkfox_token.py

tokenPurpose 与场景

1. 半托管 — 商品/库存 Token

1. 登录 seller.kuajingmaihuo.com 或 agentseller.temu.com 2. 系统管理 → 服务市场 → 授权管理 3. 获取授权 → 选择 「酷鸟卖家助手」 4. 全选常规和特殊授权 → 确认 → 复制 access_token 5. 调用 API：site=cn 或 partner，managementType=semi-managed

2. 半托管 — 订单/发货 Token

1. 登录 Temu 卖家后台 2. 右上角 Seller Central → 切换到目标区域（美区 / 欧区 / 全球） 3. 服务市场 → 授权管理 4. 获取授权 → 选择 「Cyber-ERP酷鸟助手」 5. 全选授权 → 确认 → 复制 token 6. 调用 API：site=global / global / eu，managementType=semi-managed

3. 全托管店铺

1. 登录 Temu 平台 2. 系统管理 → 服务市场 → 授权管理 3. 获取授权 → 「酷鸟卖家助手」 → 全选 → 复制 token 4. 调用 API：managementType=full-managed，site 通常 cn 或 partner

4. 本土店铺（美区、欧区主体）

1. 登录 Temu 2. Apps And Services → Manage Your Apps 3. Authorize a new app → 搜索 「Cyber-ERP」 4. 一般权限与敏感权限全选 → 确认 → 复制 token

站点与 OpenAPI 网关

本地保存 Token（推荐）

默认存储：~/.linkfox/temu-access-tokens.json（可用 TEMU_TOKEN_STORE_PATH 覆盖）。

# 查看授权步骤
python scripts/temu_token_guide.py '{"shopType":"semi-managed","tokenPurpose":"product-inventory","site":"cn"}'

# 保存 token
python scripts/save_temu_access_token.py '{
  "storeKey": "my-shop",
  "label": "中国半托管",
  "site": "cn",
  "managementType": "semi-managed",
  "tokenPurpose": "product-inventory",
  "accessToken": "PASTE_TOKEN"
}'

# 列出已保存（脱敏）
python scripts/list_temu_access_tokens.py

# 用 storeKey 调 API（无需每次粘贴 token）
python scripts/temu_proxy.py '{
  "storeKey": "my-shop",
  "site": "cn",
  "managementType": "semi-managed",
  "tokenPurpose": "product-inventory",
  "type": "bg.goods.category.mapping",
  "params": {"goodsName": "测试", "goodsNameEn": "Test"}
}'

注意事项

1. 子账号：可能无法进入服务市场，需主账号授权。 2. 多站点：全球站、英国站等需分别登录对应后台获取 Token。 3. 有效期：Token 会过期，过期后重新在后台复制并 save_temu_access_token.py。 4. IP 白名单：需联系紫鸟开放平台配置调用 IP。 5. 参数小写：site、managementType 必须小写。

脚本一览

linkfox-temu-manage-product-global — API 参考

Temu 全球站商品管理（Partner Global Product > Manage Product），经本 skill temu_global_proxy（POST /temu/proxy） 转发。Temu 的 type 写在 Body，不是 URL 路径。

网关与鉴权：本 skill scripts/（LINKFOXAGENT_API_KEY、accessToken / storeKey）。授权见 references/access-token.md。

---

调用规范

网关请求 Body（/temu/proxy）

网关响应

解析顺序：网关 `code` → JSON.parse(body) → success / errorCode / errorMsg / result。

脚本调用

export LINKFOXAGENT_API_KEY="<key>"
python scripts/global_manage_list_query.py '{"accessToken":"TOKEN","request":{"pageNo":1,"pageSize":20,"goodsSearchType":1,"goodsStatusFilterType":0}}'

业务字段可放在顶层或嵌套 params。

---

接口一览（24）

完整 sub_menu_code 与 Partner 文档 URL 见 partner-global-catalog.md。

每个接口单独一份文档： apis/README.md（24 个 apis/<type-slug>.md）。

---

典型管理流程

1. bg.local.goods.list.query 或 temu.local.goods.list.retrieve  → 找 goodsId
2. bg.local.goods.detail.query                                 → 拉全量详情
3. bg.local.goods.partial.update / bg.local.goods.update       → 改标题/图/属性
4. bg.local.goods.stock.edit                                     → 改库存
5. bg.local.goods.sale.status.set                                → 上下架

发品（V2 add）请用 `linkfox-temu-add-product-us`。价格/供货价请用 `linkfox-temu-price-us`。订单请用 `linkfox-temu-order-us`。履约/发货请用 `linkfox-temu-fulfillment-us`。买家取消请用 `linkfox-temu-cancel-order-us`。卖家取消请用 `linkfox-temu-cancel-order-us`。

---

网关错误码

---

Feedback API

• POST https://skill-api.linkfox.com/api/v1/public/feedback
• skillName: `linkfox-temu-manage-product-global`

合规商品列表 — bg.local.compliance.goods.list.query

Description: Product management attribute list query（合规待办/属性管理商品列表查询）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── pageNo / pageSize
    ├── searchText
    ├── statusList
    └── optionalConditionList[]
        ├── complianceType
        ├── templateId
        ├── repType
        ├── actualPhotoCheckType
        └── certType

request 内字段

statusList / 各块 status 枚举

optionalConditionList[]

筛选侧 complianceType 除 1/2 外，通过条件字段可推断 `3` 实拍、**4** 资质等类型（以 Partner 与实网为准）。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 25,
    "statusList": [4, 7],
    "searchText": "keyword"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 25,
    "optionalConditionList": [
      {
        "complianceType": 2,
        "repType": 2
      }
    ]
  }
}

勿使用旧字段 goodsIdList、complianceStatus；官方为 `statusList` + `optionalConditionList`。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── total
    └── goodsList[]
        ├── goodsId / goodsName / thumbUrl / outGoodsSn / crtTime
        ├── extraTemplateInfoList[]
        ├── gpsrInfoList[]
        ├── repInfoList[]
        ├── actualPhotoList[]
        └── certificateInfoList[]

result.goodsList[]

extraTemplateInfoList[]

gpsrInfoList[]

repInfoList[]

actualPhotoList[]

certificateInfoList[]

---

示例

python scripts/global_manage_compliance_list_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 25,
    "statusList": [4, 7]
  }
}'

python scripts/global_manage_compliance_list_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 25,
    "searchText": "123456789",
    "optionalConditionList": [
      {
        "complianceType": 2,
        "repType": 3
      }
    ]
  }
}'

类目预检 — bg.local.goods.category.check

Description: precheck category misplacement（类目错放预检）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── catId
    ├── hdThumbUrl
    ├── carouselImageList
    ├── language
    └── goodsName

request 内字段

官方表中五项均为选填；实际预检时通常需传入 `catId` 及能描述商品的字段（如 `goodsName`、`hdThumbUrl` / `carouselImageList`），以提高准确度。以 Partner 文档与实网校验为准。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "goodsName": "Product Title",
    "language": "en"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "goodsName": "Product Title",
    "hdThumbUrl": "https://example.com/thumb.jpg",
    "carouselImageList": [
      "https://example.com/1.jpg",
      "https://example.com/2.jpg"
    ]
  }
}

勿使用旧文档中的 goodsId、productPropertyReqs；官方入参为 `catId` + 图片/标题/语言组合。

---

Response（Temu body 解析后）

官方 Response 表中 `result` 未在提供的片段中展开，预检结论、建议类目等字段名以 Partner 后台为准。

---

示例

python scripts/global_manage_category_check.py '{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "goodsName": "Wireless Earbuds",
    "carouselImageList": ["https://example.com/main.jpg"],
    "language": "en"
  }
}'

合规编辑 — bg.local.goods.compliance.edit

Description: Edit product qualification information（编辑商品合规/资质信息：资质文件、实拍图、责任人、治理属性等）。

---

调用方式说明

经 LinkFox 网关 调用时，使用 accessToken + request 等业务字段即可，无需在 params 中自行拼装 app_key、sign、timestamp 等（由网关代签转发）。直连 Temu OpenAPI 时需携带下列通用参数。

Temu OpenAPI 通用参数（直连上游）

---

Request 结构（业务 params）

params
└── request (OBJECT, 选填)
    ├── language
    ├── goodsId                    ← 必填
    ├── certificateInfo            ← 资质文件
    │   └── certificateDetailList[]
    │       ├── certType
    │       ├── skip
    │       ├── authCode
    │       ├── authCodes[]
    │       │   └── authCode
    │       ├── certFiles[]        ← 最多 6
    │       │   ├── fileName
    │       │   ├── fileUrl
    │       │   └── language
    │       └── inspectReportFiles[]  ← 最多 6
    │           ├── fileName
    │           ├── fileUrl
    │           └── language
    ├── actualPhoto                ← 实拍图
    │   ├── skip
    │   └── actualPhotoInfoList[]
    │       ├── sameSku
    │       ├── position
    │       └── skuPhotoInfoList[]
    │           ├── specIdList[]
    │           └── imageList[]
    │               └── imageUrl
    ├── repInfo                    ← 责任人
    │   └── repDetailList[]
    │       ├── complianceRepType
    │       └── repIdList[]
    └── extraTemplate              ← 治理属性
        └── extraTemplateDetailList[]
            ├── templateId
            ├── properties         ← MAP: propertyId → value id[]
            ├── inputText          ← MAP: propertyId → 输入对象
            └── compliancePropertyList[]  ← SKU 维度合规
                ├── specIdList[]
                └── inputTextList[]
                    ├── properties
                    └── inputText

request 顶层字段

---

certificateInfo — 资质文件

certificateDetailList[]

authCodes[]

certFiles[] / inspectReportFiles[]（结构相同）

---

actualPhoto — 实拍图

actualPhotoInfoList[]

skuPhotoInfoList[]

imageList[]

---

repInfo — 责任人信息

repDetailList[]

---

extraTemplate — 治理属性

extraTemplateDetailList[]

properties（MAP 键值）

inputText（MAP 键值）

inputText.$value

####### multiLineInputs[]

compliancePropertyList[]

inputTextList[]

---

网关 params 写法（示例）

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "language": "en",
    "certificateInfo": {
      "certificateDetailList": [
        {
          "certType": 1,
          "authCode": "CERT-001",
          "certFiles": [
            {
              "fileName": "certificate.pdf",
              "fileUrl": "https://example.com/cert.pdf",
              "language": "en"
            }
          ]
        }
      ]
    },
    "actualPhoto": {
      "actualPhotoInfoList": [
        {
          "sameSku": true,
          "position": 1,
          "skuPhotoInfoList": [
            {
              "specIdList": [10001],
              "imageList": [
                { "imageUrl": "https://example.com/photo1.jpg" }
              ]
            }
          ]
        }
      ]
    },
    "repInfo": {
      "repDetailList": [
        {
          "complianceRepType": 4,
          "repIdList": [90001]
        }
      ]
    },
    "extraTemplate": {
      "extraTemplateDetailList": [
        {
          "templateId": 100,
          "properties": {
            "12345": [67890]
          },
          "inputText": {
            "23456": {
              "name": "custom text"
            }
          }
        }
      ]
    }
  }
}

官方字段名为 `certificateInfo`（非 certificationInfo）。各合规块是否必填取决于类目与待办类型，可先通过 bg.local.compliance.goods.list.query 查询待补项。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result (OBJECT，可能为空)

解析顺序见 ../api.md：先校验网关 code，再解析 body 内 success / errorCode / errorMsg。

---

相关接口

---

示例

python scripts/global_manage_compliance_edit.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "certificateInfo": {
      "certificateDetailList": [
        {
          "certType": 1,
          "skip": false,
          "authCode": "AUTH-2024-001",
          "certFiles": [
            {
              "fileName": "ce-cert.pdf",
              "fileUrl": "https://cdn.example.com/ce-cert.pdf"
            }
          ]
        }
      ]
    }
  }
}'

商品详情 — bg.local.goods.detail.query

Description: Query local goods detail.

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── language
    ├── goodsId              ← 必填
    └── versionQueryType     ← 查哪一版商品信息

request 内字段

versionQueryType 枚举

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "versionQueryType": 2
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "language": "en",
    "goodsId": 123456,
    "versionQueryType": 1
  }
}

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── goodsId
    ├── catId
    ├── subStatus
    ├── goodsName
    ├── goodsDesc
    ├── bulletPoints
    ├── customized
    ├── productType
    ├── sourceSiteInfo
    ├── targetSiteInfo[]
    ├── goodsGallery
    ├── importDesignation
    ├── outGoodsSn
    ├── goodsServicePromise
    ├── goodsProperties[]
    ├── goodsTrademark
    ├── goodsSizeChartList
    ├── goodsSizeImage
    ├── goodsOriginInfo
    ├── secondHand
    ├── itemTaxCode
    ├── skuList[]
    └── saveModeStatus

result 顶层字段（官方）

注意：详情 Response 的 result 为扁平结构（字段直接在 result 下），与 update 请求 中包在 request.goodsBasic 内的层级不同。改商品时请按 partial.update / update 的 Request 结构组装。

goodsGallery（Response 常见子字段）

与编辑请求一致，见 partial.update §goodsGallery：detailVideo、goodsCarouselImage、detailImage、carouselVideo。

---

示例

# 查线上在售版本（默认 versionQueryType=2）
python scripts/global_manage_detail_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456
  }
}'

# 查审核中最新版本
python scripts/global_manage_detail_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "versionQueryType": 1
  }
}'

商品列表 — bg.local.goods.list.query

Description: 分页查询商品列表（页码分页，与 temu.local.goods.list.retrieve 的游标分页不同）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── pageNo / pageSize              ← 均必填
    ├── orderField / orderType
    ├── goodsSearchType                ← 必填（INTEGER 枚举）
    ├── goodsStatusFilterType          ← 必填（新版）
    ├── goodsSubStatusFilterType       ← 选填（新版）
    ├── searchText / statusFilterType
    ├── crtFrom / crtTo
    ├── goodsIdList / catIdList
    ├── goodsStatusChangeTimeFrom / goodsStatusChangeTimeTo
    └── goodsSearchTags

request 内字段

goodsSearchType 枚举

官方同时标记 `goodsSearchType` 与 `goodsStatusFilterType` 为必填；调用时需同时传入（goodsStatusFilterType 取值以 Partner「Goods status description」为准）。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 20,
    "goodsSearchType": 1,
    "goodsStatusFilterType": 0,
    "searchText": "keyword"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 50,
    "goodsSearchType": 1,
    "goodsStatusFilterType": 0,
    "goodsIdList": [123456789],
    "catIdList": [1001, 1002],
    "orderField": "createTime",
    "orderType": 0,
    "crtFrom": 1704067200000,
    "crtTo": 1735689600000
  }
}

勿使用旧字段名 createTimeFrom/createTimeTo（官方为 `crtFrom`/`crtTo`）；勿用单值 catId（官方为 `catIdList`）。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── pageNo
    ├── total
    └── goodsList[]
        ├── goodsId / goodsName / specName / thumbUrl
        ├── outGoodsSn / status4VO / subStatus4VO
        ├── currency / marketPrice / listPrice / price / retailPrice
        ├── outSkuSnList / skuIdList / skuInfoList
        ├── quantity / crtTime / goodsStatusChangeTime
        ├── catId / brandId / trademarkId
        ├── costTemplateId / shipmentLimitSecond
        ├── goodsShowSubStatus / lowTrafficTag / restrictedTrafficTag
        └── ...

result.goodsList[]

响应中状态字段为 `status4VO` / `subStatus4VO`，勿写成 status / subStatus。listPrice、retailPrice、skuInfoList 在 Partner 文档中为可展开对象，子字段以官方为准。

---

与 temu.local.goods.list.retrieve 对比

---

示例

python scripts/global_manage_list_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 20,
    "goodsSearchType": 1,
    "goodsStatusFilterType": 0
  }
}'

商品外部编码（Contribution SKU）— bg.local.goods.out.sn.set

Description: Set contribution ID for goods（批量设置商品 Contribution SKU / 外部商品编码 outGoodsSn）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── modifyList[]          ← 最多 50 条
    │   ├── outGoodsSn
    │   └── goodsId
    └── language

request 内字段

modifyList[]

批量修改时，modifyList 中每项通常需同时提供 `goodsId` 与目标 `outGoodsSn`。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      {
        "goodsId": 123456789,
        "outGoodsSn": "MY-GOODS-001"
      }
    ],
    "language": "en"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      { "goodsId": 111, "outGoodsSn": "SKU-A" },
      { "goodsId": 222, "outGoodsSn": "SKU-B" }
    ]
  }
}

勿将 goodsId、outGoodsSn 仅放在 params 顶层（须放在 `request.modifyList[]` 内，除非网关另有兼容）。

---

Response（Temu body 解析后）

response
├── result
│   └── resultList[]
│       ├── outGoodsSn
│       ├── goodsId
│       ├── modifySuccess
│       └── duplicateGoodsId
├── success
├── errorCode
└── errorMsg

result.resultList[]

批量调用时以 `result.resultList[]` 中每条 `modifySuccess` 为准判断是否成功；duplicateGoodsId 有值时表示 outGoodsSn 已被其他商品占用。

---

与 SKU 外部编码接口区分

---

示例

python scripts/global_manage_out_sn_set.py '{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      {
        "goodsId": 123456789,
        "outGoodsSn": "CONTRIBUTION-GOODS-001"
      }
    ]
  }
}'

部分字段编辑 — bg.local.goods.partial.update

Description: Edit a subset of the product properties (e.g. description, brand, images, attributes).

仅传需要修改的字段。官方请求体为 `request` 对象；goodsServicePromise、goodsProperty、skuList 等与 `goodsBasic` 同级，均在 request 下，不要把这些字段塞进 goodsBasic。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── language
    ├── goodsId                    ← 必填
    ├── goodsBasic                 ← 仅基础信息（名称/图库/进口标识）
    ├── goodsServicePromise        ← 与 goodsBasic 同级
    ├── goodsProperty
    ├── goodsOriginInfo
    ├── bulletPoints
    ├── goodsDesc
    ├── guideFileInfo
    ├── goodsSizeChartList
    ├── goodsSizeImage
    ├── skuList
    ├── goodsTrademark
    ├── goodsVehiclePropertyRelation
    ├── secondHand
    ├── modifyId
    └── saveMode

request 内字段一览

网关 params 写法

推荐与官方一致，整体放入 `request`：

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "goodsBasic": { "goodsName": "New Title" }
  }
}

若网关/Temu 要求展平，可将 request 内字段提到 params 顶层（goodsId、goodsBasic、skuList 等保持同级关系，仍不要把 skuList 放进 goodsBasic）。

---

goodsBasic

仅包含 goods basic 相关字段（Partner 文档中 goodsBasic 子树）：

goodsBasic.goodsGallery

---

request.goodsServicePromise

---

request.goodsProperty

`goodsProperties[]`

---

request.goodsOriginInfo

---

request.guideFileInfo

---

request.goodsSizeChartList

数组元素： classId、meta、groups[]（id、name、elements[]、records[]、values[]）、bodyMeta、bodyRecords[]。

---

request.skuList[]

---

request.goodsTrademark

---

request.goodsVehiclePropertyRelation

---

request.secondHand

---

Response

---

示例

只改标题

python scripts/global_manage_partial_update.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "goodsBasic": {
      "goodsName": "Updated Title"
    }
  }
}'

改轮播图 + 提交状态

python scripts/global_manage_partial_update.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "language": "en",
    "goodsBasic": {
      "goodsGallery": {
        "goodsCarouselImage": ["https://..."]
      }
    },
    "saveMode": 1
  }
}'

修改已有 SKU（skuList 与 goodsBasic 同级）

python scripts/global_manage_partial_update.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "skuList": [{
      "skuId": 58224724203874,
      "weight": "500",
      "weightUnit": "g",
      "length": "10",
      "width": "10",
      "height": "10",
      "volumeUnit": "cm",
      "images": ["https://..."]
    }]
  }
}'

商品属性获取 — bg.local.goods.property.get

Description: Get Temu goods attributes（按商品信息/类目等获取属性，与发品侧「类目属性模板」接口不同，见文末说明）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── goodsName                 ← 必填
    ├── catId
    ├── language / goodsDesc
    ├── thirdPartyErpType / thirdPartyMall / thirdPartyCatName
    └── goodsPropList[]
        ├── propName
        └── values

request 内字段

goodsPropList[]

goodsPropList 为英文属性名 + 英文属性值的简单结构，不是 bg.local.goods.partial.update 中 goodsProperty.goodsProperties[] 的 vid / templatePid / refPid 模型。用于传入第三方或已知属性片段，辅助平台匹配/推荐 Temu 属性。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsName": "Wireless Bluetooth Earbuds",
    "catId": 12345,
    "language": "en"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "goodsName": "Wireless Bluetooth Earbuds",
    "catId": 12345,
    "goodsDesc": "Noise cancelling in-ear headphones",
    "thirdPartyMall": "amazon",
    "thirdPartyCatName": "Electronics > Headphones",
    "goodsPropList": [
      {
        "propName": "Material",
        "values": ["Plastic", "Metal"]
      },
      {
        "propName": "Color",
        "values": ["Black"]
      }
    ]
  }
}

勿仅传 catId 而不传 `goodsName`（官方必填）。勿与仅传 catId 的类目模板接口 temu.local.product.attributes.get / bg.goods.attrs.get（发品 skill）混用。

---

Response（Temu body 解析后）

官方 Response 表中 `result` 未在提供的片段中展开；返回的属性列表/推荐字段以 Partner 后台为准。

---

与发品「类目属性模板」接口区分

---

示例

python scripts/global_manage_property_get.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsName": "Stainless Steel Water Bottle 32oz",
    "catId": 67890,
    "language": "en",
    "goodsPropList": [
      { "propName": "Capacity", "values": ["32 oz"] },
      { "propName": "Material", "values": ["Stainless Steel"] }
    ]
  }
}'

车型库层级模板 — bg.local.goods.property.relations.level.template

Description: Obtaining the hierarchical attribute value and hierarchical id of vehicle type library data（获取车型库的层级属性值与层级 ID）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── catId              ← 必填，叶子类目
    └── relationType       ← 必填，车型库传 1

request 内字段

relationType（已知）

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationType": 1
  }
}

勿使用旧文档中的 pid、levelId；官方入参仅为 `catId` + `relationType`。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    └── levelPropertyDependencyList[]
        ├── relationId
        ├── propertyDependencyId
        ├── parentPropertyDependencyId
        ├── propertyName
        └── level

result.levelPropertyDependencyList[]

描述在给定 relationId（兼容车型库）下共有多少层级、每层属性值分类名（propertyName）、层级序号（level）以及层级之间的父子关系。不同 relationId 下，同一 level 可能对应不同的 `propertyDependencyId`。

字段关系示意

relationId（车型库）
  └── level=1  propertyName=Brand      propertyDependencyId=A, parent=0
        └── level=2  propertyName=Model propertyDependencyId=B, parent=A
              └── level=3  ...

下一步 relations.template 使用 `relationId` + `propertyRelationQueryDTOList` 拉取各层可选 propertyValue；不传查询列表时返回 level 1 全部值。后续 property.relations 按 goodsId 读取商品已选数据。

---

与同族接口协作

1. bg.local.goods.property.relations.level.template（本接口）
   入参：catId + relationType=1
   出参：result.levelPropertyDependencyList[]（relationId、propertyDependencyId、level、propertyName 等）

2. bg.local.goods.property.relations.template
   入参：catId + relationId + relationType=1 + propertyRelationQueryDTOList（可选）
   出参：result.parentPropValDepMapDTOList[] → propValDepDTOList[]（propertyValueId、propertyValue、isLeafProperty 等）

3. bg.local.goods.property.relations
   入参：goodsId + relationId + relationType=1 + queryLastVersion
   出参：商品已保存的兼容车型关联

4. partial.update / update
   → goodsVehiclePropertyRelation 写回

---

示例

python scripts/global_manage_property_relations_level_template.py '{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationType": 1
  }
}'

关系属性值查询 — bg.local.goods.property.relations.template

Description: Query the full quantum attribute by the dependency id of the parent attribute value and the hierarchical id（按父级属性值依赖 ID 查询下级全量可选属性值，用于兼容车型库级联选择）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── catId                         ← 必填
    ├── relationId                    ← 必填
    ├── relationType                  ← 必填，车型库传 1
    └── propertyRelationQueryDTOList[]  ← 选填
        ├── propertyDependencyId
        └── parentPropertyValueDependencyId

request 内字段

relationType（已知）

propertyRelationQueryDTOList[]

请求侧为 `parentPropertyValueDependencyId`（值级父 ID）；与 level.template 层级定义中的 `parentPropertyDependencyId`（层级结构父 ID）名称不同，勿混用。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationId": 10001,
    "relationType": 1
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationId": 10001,
    "relationType": 1,
    "propertyRelationQueryDTOList": [
      {
        "propertyDependencyId": 200,
        "parentPropertyValueDependencyId": 0
      }
    ]
  }
}

勿使用旧文档中的 pid、parentVid、levelId。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    └── parentPropValDepMapDTOList[]
        ├── parentPropertyValueDependencyId
        └── propValDepDTOList[]
            ├── propertyDependencyId
            ├── propertyValueDependencyId
            ├── parentPropertyValueDependencyId
            ├── propertyValueId
            ├── propertyValue
            └── isLeafProperty

result.parentPropValDepMapDTOList[]

propValDepDTOList[]

级联查询示意

1. level.template → 得到 relationId、各层 propertyDependencyId / level / propertyName
2. relations.template（本接口）
   - 首次：propertyRelationQueryDTOList 为空 → 返回 level 1 全部 propertyValueId
   - 用户选中某值后：带上 parentPropertyValueDependencyId + propertyDependencyId 再查下一层
   - isLeafProperty=true 的项可作为叶子，写入 goodsVehiclePropertyRelation.leafPropertyValueDependencyIdList
3. property.relations → 按 goodsId 读取商品已保存关联

---

与同族接口协作

---

示例

# 拉取 level 1 全部可选值（不传 propertyRelationQueryDTOList）
python scripts/global_manage_property_relations_template.py '{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationId": 10001,
    "relationType": 1
  }
}'

# 按父级属性值继续查下一层
python scripts/global_manage_property_relations_template.py '{
  "accessToken": "TOKEN",
  "request": {
    "catId": 12345,
    "relationId": 10001,
    "relationType": 1,
    "propertyRelationQueryDTOList": [
      {
        "propertyDependencyId": 200,
        "parentPropertyValueDependencyId": 987654321
      }
    ]
  }
}'

商品属性关联数据查询 — bg.local.goods.property.relations

Description: 查询商品已关联的关系型属性数据（如兼容车型库 / compatible vehicle models）。不是按 catId 拉车型库层级/选项的接口（见 level.template、relations.template）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── goodsId              ← 必填
    ├── relationId           ← 必填
    ├── relationType         ← 必填（车型库填 1）
    └── queryLastVersion     ← 必填

request 内字段

queryLastVersion

relationType（已知）

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "relationId": 10001,
    "relationType": 1,
    "queryLastVersion": true
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "relationId": 10001,
    "relationType": 1,
    "queryLastVersion": false
  }
}

勿使用旧文档中的 catId、pid、pageNo、keyword 等字段；本接口为按商品 + 关系库 ID 读取已绑定数据。

---

Response（Temu body 解析后）

官方 Response 表中 `result` 未在提供的片段中展开。返回体通常包含该商品在指定 relationId 关系库下已选的兼容车型/级联属性值等，具体字段名以 Partner 后台为准。

与编辑接口的对应关系（写入侧参考）

发品/编辑时写入车型关联的块为 request.goodsVehiclePropertyRelation（见 partial.update）：

本接口 `property.relations` 为读取；result 内字段命名可能与上表一致或嵌套包装，以实网返回为准。

---

与同族接口协作（车型库）

1. bg.local.goods.property.relations.level.template
   → 按 **catId + relationType=1** 拉 `result.levelPropertyDependencyList[]`（含 `relationId`、`propertyDependencyId`、`level`、`propertyName`）

2. bg.local.goods.property.relations.template
   → 按 relationId + propertyRelationQueryDTOList 拉各层 propertyValue（见该接口文档）

3. bg.local.goods.property.relations（本接口）
   → 按 goodsId + relationId + relationType=1 + queryLastVersion
     读取商品上已保存的兼容车型关联数据

4. bg.local.goods.partial.update / update
   → goodsVehiclePropertyRelation 写回 ktype / leafPropertyValueDependencyIdList 等

---

示例

python scripts/global_manage_property_relations.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "relationId": 10001,
    "relationType": 1,
    "queryLastVersion": true
  }
}'

批量查发布状态 — bg.local.goods.publish.status.get

Description: Batch Query Product Publication Status.

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    └── goodsIdList[]    ← 必填

request 内字段

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsIdList": [123456, 123457]
  }
}

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    └── goodsPublishStatusList[]
        ├── goodsId
        ├── status
        └── subStatus

result.goodsPublishStatusList[]

勿使用旧字段名 publishStatusList、publishStatus、rejectReason、siteStatusList（官方为 goodsPublishStatusList + status / subStatus）。

---

示例

python scripts/global_manage_publish_status_get.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsIdList": [123456, 789012]
  }
}'

商品上下架 — bg.local.goods.sale.status.set

Description: 设置商品或 SKU 的上架/下架状态。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── goodsId              ← 必填
    ├── onsale               ← 必填（注意小写）
    ├── skuIdList            ← 选填；传入则仅对 SKU 上下架
    └── operationType        ← 选填

request 内字段

onsale

operationType

官方字段名为 `onsale`（全小写），勿写成 onSale。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "onsale": 1,
    "operationType": 1
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "onsale": 0,
    "skuIdList": [111, 222],
    "operationType": 2
  }
}

勿使用旧字段 onSale、bindSiteId（除非 Partner 另有说明）；上下架以官方 `request` 内字段为准。

---

Response（Temu body 解析后）

response
├── success          ← 请求级
├── errorCode
├── errorMsg
└── result
    └── success      ← 业务修改是否成功

需同时关注 `response.success`（网关/接口调用）与 `result.success`（上下架操作结果）。errorCode / errorMsg 非 0 时以错误信息为准。

---

示例

# 整品上架
python scripts/global_manage_sale_status_set.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "onsale": 1,
    "operationType": 1
  }
}'

# 指定 SKU 下架
python scripts/global_manage_sale_status_set.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "onsale": 0,
    "skuIdList": [58224724203874, 58224724203875],
    "operationType": 2
  }
}'

SKU 列表 / Variants — bg.local.goods.sku.list.query

Description: Get sku list, as well as get Variants（分页 SKU 列表查询，不是按单个 goodsId 查全量 SKU）。

勿与 bg.local.goods.detail.query 的 result.skuList（单商品详情内 SKU）混淆；本接口为列表检索接口。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── pageNo / pageSize
    ├── orderField / orderType
    ├── skuSearchType          ← 必填
    ├── skuStatusFilterType    ← 必填（新版）
    ├── searchText
    ├── statusFilterType
    ├── crtFrom / crtTo
    ├── skuIdList / catIdList
    ├── skuSubStatusFilterType
    ├── skuStatusChangeTimeFrom / skuStatusChangeTimeTo
    └── goodsSearchTags

request 内字段

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 20,
    "skuSearchType": 2,
    "skuStatusFilterType": 0,
    "searchText": "keyword"
  }
}

勿使用旧文档仅传 goodsId 的方式；官方入参为分页 + 筛选模型，无单独必填 goodsId（可用 searchText 或 skuIdList 定位）。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── pageNo
    ├── total
    └── skuList[]
        ├── goodsName / specName / thumbUrl
        ├── goodsId / skuId / skuSn
        ├── stock / price / retailPrice
        ├── crtTime / status4VO / subStatus4VO
        ├── goodsIsOnSale / currency
        ├── skuStatusChangeTime
        ├── volumeInfo / weightInfo
        ├── skuShowSubStatus4VO
        ├── specList[]
        ├── lowTrafficTag / restrictedTrafficTag
        └── ...

result.skuList[]

---

示例

python scripts/global_manage_sku_list_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 20,
    "skuSearchType": 2,
    "skuStatusFilterType": 0,
    "orderField": "createTime",
    "orderType": 0
  }
}'

# 按 SKU ID 列表筛选
python scripts/global_manage_sku_list_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageNo": 1,
    "pageSize": 50,
    "skuSearchType": 2,
    "skuStatusFilterType": 0,
    "skuIdList": [58224724203874, 58224724203875]
  }
}'

SKU 外部编码（Contribution SKU）— bg.local.goods.sku.out.sn.set

Description: Set contribution ID for SKU（批量设置 SKU 的 Contribution SKU / 外部 SKU 编码 outSkuSn）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── modifyList[]          ← Contribution SKU 修改列表
    │   ├── goodsId
    │   ├── outSkuSn
    │   └── skuId
    └── language

request 内字段

modifyList[]

批量修改时，modifyList 中每项通常需同时提供 `goodsId`、`skuId` 与目标 `outSkuSn`，以唯一定位要修改的 SKU。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      {
        "goodsId": 123456789,
        "skuId": 58224724203874,
        "outSkuSn": "MY-SKU-001"
      }
    ],
    "language": "en"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      { "goodsId": 111, "skuId": 1001, "outSkuSn": "SKU-A" },
      { "goodsId": 111, "skuId": 1002, "outSkuSn": "SKU-B" }
    ]
  }
}

勿将 goodsId、skuId、outSkuSn 仅放在 params 顶层（须放在 `request.modifyList[]` 内，除非网关另有兼容）。

---

Response（Temu body 解析后）

response
├── result
│   └── resultList[]
│       ├── goodsId
│       ├── outSkuSn
│       ├── modifySuccess
│       ├── duplicateSkuId
│       ├── duplicateGoodsId
│       └── skuId
├── success
├── errorCode
└── errorMsg

response 顶层字段

result

result.resultList[]

批量调用时以 `result.resultList[]` 中每条 `modifySuccess` 为准判断是否成功；duplicateSkuId / duplicateGoodsId 有值时表示 outSkuSn 已被其他 SKU 或商品占用（含义以 Partner 实网返回为准）。

---

与商品外部编码接口区分

---

示例

python scripts/global_manage_sku_out_sn_set.py '{
  "accessToken": "TOKEN",
  "request": {
    "modifyList": [
      {
        "goodsId": 123456789,
        "skuId": 58224724203874,
        "outSkuSn": "CONTRIBUTION-SKU-001"
      }
    ]
  }
}'

库存编辑 — bg.local.goods.stock.edit

Description: Edit product stock with full-update and diff-update.

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── goodsId                      ← 必填
    ├── stockType                    ← 库存类型，默认 0
    ├── skuStockChangeList[]         ← 增量：stock += stockDiff
    ├── skuStockTargetList[]         ← 全量：覆盖到 stockTarget
    └── requestUniqueKey             ← 幂等键

两种改库存方式二选一（或按 Partner 文档组合规则）：

request 内字段

skuStockChangeList[]（增量）

skuStockTargetList[]（全量）

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "stockType": 0,
    "skuStockChangeList": [
      { "skuId": 58224724203874, "stockDiff": 10 }
    ]
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "stockType": 0,
    "skuStockTargetList": [
      { "skuId": 58224724203874, "stockTarget": 100 }
    ],
    "requestUniqueKey": "uuid-once-001"
  }
}

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── goodsId
    ├── skuStockEditStatusInfoList[]
    │   ├── skuId
    │   ├── stockEditStatus
    │   ├── errorCode
    │   └── errorMsg
    ├── operateResult          ← 在 result 下，与列表同级
    └── msg                    ← 在 result 下，与列表同级

result.skuStockEditStatusInfoList[]

---

示例

增量改库存

python scripts/global_manage_stock_edit.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "skuStockChangeList": [
      { "skuId": 58224724203874, "stockDiff": 5 }
    ]
  }
}'

全量设为目标库存

python scripts/global_manage_stock_edit.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "stockType": 1,
    "skuStockTargetList": [
      { "skuId": 58224724203874, "stockTarget": 50 }
    ]
  }
}'

全量编辑 — bg.local.goods.update

Description: Edit all properties (e.g. description, brand, images, attributes) of a product.

与 partial.update 共用同一 `request` 顶层结构（goodsBasic 与 skuList 等同级）。全量更新须提交完整商品数据，且 `skuList` 必填；建议先 bg.local.goods.detail.query 拉详情再改。

goodsBasic、goodsProperty、skuList[] 等嵌套字段定义见 partial.update 对应章节（结构一致）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── language
    ├── goodsId                    ← 必填
    ├── goodsBasic
    ├── goodsServicePromise
    ├── goodsProperty
    ├── goodsOriginInfo
    ├── bulletPoints
    ├── goodsDesc
    ├── guideFileInfo
    ├── goodsSizeChartList
    ├── goodsSizeImage
    ├── skuList                    ← 必填（全量）
    ├── goodsTrademark
    ├── goodsVehiclePropertyRelation
    ├── secondHand
    └── modifyId

与 partial.update 的差异：

request 内字段一览

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "goodsBasic": { "goodsName": "Full Title", "goodsGallery": { "goodsCarouselImage": ["https://..."] } },
    "goodsProperty": { "goodsProperties": [{ "vid": 100, "value": "Cotton" }] },
    "skuList": [{ "skuId": 999, "weight": "500", "weightUnit": "g", "length": "10", "width": "10", "height": "10", "volumeUnit": "cm", "images": ["https://..."] }]
  }
}

勿使用发品接口字段名（productName、carouselImageUrls、productPropertyReqs 等）。skuList 放在 request 下，不要放进 goodsBasic。

---

Response（Temu body 解析后）

`result.skuInfoList[]`

---

示例

# 先查详情，再组完整 request
python scripts/global_manage_detail_query.py '{"accessToken":"TOKEN","goodsId":123456}'

python scripts/global_manage_goods_update.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "language": "en",
    "goodsBasic": {
      "goodsName": "Updated Full Product",
      "goodsGallery": {
        "goodsCarouselImage": ["https://..."],
        "detailImage": ["https://..."]
      }
    },
    "goodsDesc": "Updated description",
    "skuList": [{
      "skuId": 58224724203874,
      "weight": "500",
      "weightUnit": "g",
      "length": "10",
      "width": "10",
      "height": "10",
      "volumeUnit": "cm",
      "images": ["https://..."]
    }]
  }
}'

视频封面 — bg.local.goods.videocoverimage.get

Description: Obtain cover image of video frame（按视频 vid 批量获取视频封面图）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    └── vidList[]              ← 视频 vid 列表

request 内字段

实际调用时通常传入至少一个 vid；vid 来自商品详情或视频上传接口返回，勿与规格属性值 vid 混淆（以 Partner 上下文为准）。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "vidList": ["video-vid-001", "video-vid-002"]
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "vidList": ["58224724203874"]
  }
}

勿使用旧字段 videoUrl；官方入参为 `request.vidList`。

---

Response（Temu body 解析后）

response
├── result
│   └── videoInfoMap          ← MAP: vid → 视频详情
│       └── [vid]
│           └── coverImage
├── success
├── errorCode
└── errorMsg

response 顶层字段

result

result.videoInfoMap（MAP 键值）

videoInfoMap.$value

批量查询时遍历 `result.videoInfoMap`，以 key（vid） 与入参对照；某 vid 无 key 或 coverImage 为空时，表示该视频暂无封面或查询失败（以实网返回为准）。

响应示例（结构示意）

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "result": {
    "videoInfoMap": {
      "video-vid-001": {
        "coverImage": "https://cdn.example.com/cover1.jpg"
      },
      "video-vid-002": {
        "coverImage": "https://cdn.example.com/cover2.jpg"
      }
    }
  }
}

---

示例

python scripts/global_manage_videocoverimage_get.py '{
  "accessToken": "TOKEN",
  "request": {
    "vidList": ["video-vid-001"]
  }
}'

Manage Product — 接口文档索引

每个 type 单独一份文档，经 POST /temu/proxy 调用。网关与鉴权见 ../api.md；目录与 sub_menu_code 见 ../partner-global-catalog.md。

查询（7）

编辑 / 删除（3）

库存 / 上下架（4）

属性 / 合规 / 辅助（10）

删除商品 — temu.local.goods.delete

Description: Product deletion.

---

Request（params）

与同族接口一致，业务字段建议放在 `request` 下（goodsId 为必填，以 Partner 入参页为准）：

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456
  }
}

---

Response（Temu body 解析后）

response
├── success              ← 整单请求是否成功
├── errorCode
├── errorMsg
└── result               ← Specific information
    ├── success          ← delete result（删除操作结果）
    └── errorMsg         ← error message（删除失败时的说明）

注意区分两层 success：顶层表示 API 调用是否成功；`result.success` 表示商品删除操作本身是否成功。result 下无 errorCode 字段（以官方文档为准）。

---

示例

python scripts/global_manage_goods_delete.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456
  }
}'

商品列表搜索（Retrieve）— temu.local.goods.list.retrieve

Description: local goods list search（游标分页检索，与 bg.local.goods.list.query 的页码分页模型不同）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── pageSize / pageToken          ← 游标分页（无 pageNo）
    ├── orderField / orderType
    ├── goodsSearchType               ← 必填（STRING 枚举）
    ├── goodsIdList / outGoodsSnList
    ├── skuIdList / outSkuSnList
    ├── catIdList
    ├── goodsName
    ├── goodsCreateTimeFrom / goodsCreateTimeTo
    ├── goodsStatusChangeTimeFrom / goodsStatusChangeTimeTo
    └── goodsSearchTags

request 内字段

goodsSearchType 枚举（STRING）

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "pageSize": 25,
    "goodsSearchType": "ACTIVE"
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "pageSize": 50,
    "pageToken": "NEXT_PAGE_TOKEN_FROM_PREVIOUS_RESPONSE",
    "goodsSearchType": "ALL",
    "goodsIdList": ["123456789"],
    "orderField": "create_time",
    "orderType": 0
  }
}

勿使用旧字段 page、keyword、goodsStatus、goodsIds、sortField/sortOrder；官方为 `pageToken` + `goodsSearchType`（STRING）+ `request` 包装。

---

Response（Temu body 解析后）

官方 Response 表中 `result` 未在提供的片段中展开。游标分页列表接口通常会在 result 内返回 商品列表 与 下一页 `pageToken`，具体字段名以 Partner 后台为准。

列表项字段可能与 bg.local.goods.list.query 的 result.goodsList[] 相近，但不可假定完全一致（尤其 ID 类型多为 STRING、状态字段命名可能不同），以实网返回为准。

---

与 bg.local.goods.list.query 对比

与 temu.local.sku.list.retrieve 对比

---

示例

python scripts/global_manage_goods_list_retrieve.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageSize": 25,
    "goodsSearchType": "ACTIVE",
    "goodsName": "keyword"
  }
}'

# 翻页
python scripts/global_manage_goods_list_retrieve.py '{
  "accessToken": "TOKEN",
  "request": {
    "pageSize": 25,
    "pageToken": "TOKEN_FROM_LAST_PAGE",
    "goodsSearchType": "ALL"
  }
}'

预售状态编辑 — temu.local.goods.pre.sale.status.edit

Description: 编辑商品 SKU 的预售状态（开启/关闭预售及预售库存、结束时间等）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── goodsId
    ├── targetPreSaleStatus
    └── skuInfoList[]              ← 必填，最多 100 条
        ├── skuId                  ← 必填
        ├── targetPreSaleStock
        └── preSaleEndTime

request 内字段

targetPreSaleStatus

skuInfoList[]

商品级 `targetPreSaleStatus` 与 SKU 列表 `skuInfoList` 同时必填；关闭预售（2）时 targetPreSaleStock / preSaleEndTime 多为选填。

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "targetPreSaleStatus": 1,
    "skuInfoList": [
      {
        "skuId": 58224724203874,
        "targetPreSaleStock": 100,
        "preSaleEndTime": 1735689600000
      }
    ]
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "targetPreSaleStatus": 2,
    "skuInfoList": [
      { "skuId": 58224724203874 },
      { "skuId": 58224724203875 }
    ]
  }
}

勿使用旧字段 skuPreSaleList、productSkuId、preSaleStatus、preSaleDeliveryDays。

---

Response（Temu body 解析后）

response
├── success
├── errorCode
├── errorMsg
└── result
    ├── goodsId
    ├── code / msg              ← 商品级结果
    └── skuOperateResultInfoList[]
        ├── skuId
        ├── code
        └── msg

result 内字段

result.skuOperateResultInfoList[]

批量编辑时需检查 `result.code`（整体）及每条 `skuOperateResultInfoList[].code`（单 SKU）。顶层 `success` 为 false 时以 errorCode / errorMsg 为准。

---

示例

python scripts/global_manage_pre_sale_status_edit.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "targetPreSaleStatus": 1,
    "skuInfoList": [
      {
        "skuId": 58224724203874,
        "targetPreSaleStock": 50,
        "preSaleEndTime": 1735689600000
      }
    ]
  }
}'

# 关闭多个 SKU 预售
python scripts/global_manage_pre_sale_status_edit.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456789,
    "targetPreSaleStatus": 2,
    "skuInfoList": [
      { "skuId": 58224724203874 },
      { "skuId": 58224724203875 }
    ]
  }
}'

规格信息查询 — temu.local.goods.spec.info.get

Description: 按规格 ID 列表查询规格信息（可配合 language 取多语言展示）。

---

Request 结构（官方顶层）

params
└── request (OBJECT, 选填)
    ├── language
    └── specIdList          ← 必填

request 内字段

网关 params 写法

{
  "accessToken": "TOKEN",
  "request": {
    "specIdList": [1001, 1002]
  }
}

{
  "accessToken": "TOKEN",
  "request": {
    "language": "en",
    "specIdList": [1001]
  }
}

勿使用旧文档中的 parentSpecId、languages（单数/复数混用）；官方入参仅为 `language` + `specIdList`（LONG[]，必填）。

---

Response（Temu body 解析后）

官方 Response 表中 `result` 未在提供的片段中展开，具体规格信息字段名与结构以 Partner 后台为准。

---

示例

python scripts/global_manage_spec_info_get.py '{
  "accessToken": "TOKEN",
  "request": {
    "specIdList": [1001, 1002],
    "language": "en"
  }
}'

商品编辑 / 删除 API（已拆分）

• 索引：apis/README.md → 编辑 / 删除（3）
• bg.local.goods.partial.update：apis/bg-local-goods-partial-update.md

商品查询 API（已拆分）

各接口参数已迁至 `apis/` 目录，每个 type 一个文件：

• 索引：apis/README.md → 查询（7）

旧合并文档不再维护，请直接打开对应 apis/<type-slug>.md。

属性 / 合规 / 辅助 API（已拆分）

• 索引：apis/README.md → 属性 / 合规 / 辅助（10）

库存 / 价格 / 上下架 API（已拆分）

• 索引：apis/README.md → 库存 / 价格 / 上下架（5）