> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 编辑商品

> 按字段部分更新商品，未传字段保持不变。编辑生效中商品会生成新版本并返回新版本 ID；不支持修改状态（请使用变更商品状态接口）。features 为整表替换：传入时未包含的已有权益会被删除，并同步从该商品下所有定价移除；不传则权益不变。merchant_product_id 不可置空，修改后不会同步到已创建的定价。无法通过本接口清空全部权益；同一请求内权益 id 不可重复。

按字段部分更新商品，未传字段保持不变。编辑生效中商品会生成新版本并返回新版本 ID；不支持修改状态（请使用变更商品状态接口）。features 为整表替换：传入时未包含的已有权益会被删除，并同步从该商品下所有定价移除；不传则权益不变。merchant\_product\_id 不可置空，修改后不会同步到已创建的定价。无法通过本接口清空全部权益；同一请求内权益 id 不可重复。


## OpenAPI

````yaml openapi/v1-zh.yaml POST /api/v1/products/{product_id}
openapi: 3.0.3
info:
  title: Subotiz API
  description: Subotiz OpenAPI
  version: 1.0.0
servers:
  - url: https://{api}.subotiz.com
    variables:
      api:
        default: api
security:
  - sec0: []
tags:
  - name: 折扣
    description: 折扣
  - name: 发票
    description: 发票
  - name: 退款
    description: 退款
  - name: 商品管理
    description: 商品管理
  - name: 订阅
    description: 订阅
  - name: 商品定价
    description: 商品定价方案
  - name: 交易单
    description: 交易单
  - name: 支付流水
    description: 支付流水
  - name: 结账会话
    description: 结账会话
  - name: 顾客
    description: 顾客
  - name: 顾客门户
    description: 顾客门户
  - name: Webhook
    description: Webhook
  - name: 争议
    description: 争议订单
paths:
  /api/v1/products/{product_id}:
    post:
      tags:
        - 商品管理
      summary: 编辑商品
      description: >-
        按字段部分更新商品，未传字段保持不变。编辑生效中商品会生成新版本并返回新版本 ID；不支持修改状态（请使用变更商品状态接口）。features
        为整表替换：传入时未包含的已有权益会被删除，并同步从该商品下所有定价移除；不传则权益不变。merchant_product_id
        不可置空，修改后不会同步到已创建的定价。无法通过本接口清空全部权益；同一请求内权益 id 不可重复。
      operationId: v1-product-update-product
      parameters:
        - name: product_id
          in: path
          description: Subotiz 平台商品 ID
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/HeaderRequestID'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateProductRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateProductResponse'
components:
  parameters:
    HeaderRequestID:
      name: Request-Id
      in: header
      description: 请求的唯一标识符
      required: true
      schema:
        type: string
        default: 008e3967-a1b5-48bb-be14-d5bff5092e61
  schemas:
    UpdateProductRequest:
      required:
        - product_id
      type: object
      properties:
        product_id:
          type: string
          description: Subotiz 平台商品 ID
        product_name:
          type: string
          description: 商品名称，传入时不可为空
        category_id:
          type: string
          description: 商品分类 ID
        image_url:
          type: string
          description: 商品图片 URL，传入时不可为空
        merchant_product_id:
          type: string
          description: 商户侧商品 ID，同商户内唯一；不可传空串（不支持通过本接口清空）。修改后不会同步到已创建的定价
        description:
          type: string
          description: 商品描述
        features:
          type: array
          items:
            $ref: '#/components/schemas/UpdateProductFeature'
          description: |-
            商品权益列表，整表替换：
             - 传入时，未包含的已有权益会被删除，并同步从该商品下所有定价移除
             - 不传（或传空列表）时权益保持不变，因此无法通过本接口清空全部权益
             - 保留已有权益需带上其 id；不带 id 视为新增；同一请求内 id 不可重复
        quantity_unit:
          type: string
          description: 数量单位名称（商品级）；传空串重置为默认 unit
      description: 编辑商品请求（按字段部分更新：未传的字段保持不变）
    UpdateProductResponse:
      type: object
      properties:
        code:
          type: string
          description: error code
        message:
          type: string
          description: error message
        data:
          $ref: '#/components/schemas/UpdateProductResponse_Data'
      description: 编辑商品响应
    UpdateProductFeature:
      type: object
      properties:
        id:
          type: string
          description: 已有权益 ID；为空表示新增
        name:
          type: string
          description: 权益名称
        type:
          type: string
          description: 权益类型
      description: 编辑商品时的权益
    UpdateProductResponse_Data:
      type: object
      properties:
        product_id:
          type: string
          description: Subotiz 平台商品 ID
        product_version_id:
          type: string
          description: 编辑后的商品当前版本 ID（生效中商品编辑会生成新版本）
      description: 编辑商品响应
  securitySchemes:
    sec0:
      type: http
      description: 'Bearer API Key 鉴权。格式：Authorization: Bearer {your_api_key}'
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.