Actualizar un producto#

Actualiza un producto de forma síncrona. Identifique el producto con ya sea productId o sku, junto con shopId. Proporcione exactamente un identificador; las solicitudes que contengan ambos o ninguno devuelven 400 Bad Request.

http

PATCH https://sdkapi.ideal.house/product-import/products

El identificador es separado del objeto product. Esto permite que una integración localice un producto por su SKU actual y cambie el SKU en la misma solicitud.

Utilice productId como identificador cuando cambie un SKU. Esto mantiene los reintentos sin ambigüedad si la primera solicitud actualiza el SKU pero su respuesta se pierde.

Cuerpo de la solicitud#

Campo	Tipo	Obligatorio	Descripción
`shopId`	string	Sí	Shop ID proporcionado por Ideal House.
`productId`	string	Condicional	ID del producto a localizar. Requerido cuando `sku` se omite.
`sku`	string	Condicional	SKU actual para localizar. Requerido cuando `productId` se omite.
`product`	object	Sí	Campos a actualizar. Incluya al menos un campo.

Campos editables del producto#

Solo se actualizan los campos incluidos en product.

Campo	Tipo	Longitud máxima	Descripción
`sku`	string	120	Nuevo SKU. Debe permanecer único dentro de la tienda.
`externalProductId`	string	120	Identificador externo del producto.
`groupId`	string	120	Identificador del grupo de productos.
`collectionId`	string	120	Identificador de la colección de productos.
`name`	string	255	Nombre del producto.
`title`	string	255	Título de visualización del producto.
`brand`	string	120	Marca del producto.
`productType`	string	120	Tipo de producto en su taxonomía.
`normalizedProductType`	string	40	Tipo de producto normalizado. Coordine los valores compatibles con Ideal House.
`category`	string	120	Categoría del producto.
`style`	string	120	Estilo del producto.
`color`	string	120	Color del producto.
`availability`	string	40	Valor de disponibilidad.
`imageUrl`	string	1,000	URL HTTP o HTTPS pública de la imagen de origen.
`previewImageUrl`	string	1,000	URL HTTP o HTTPS de la imagen de vista previa.
`productUrl`	string	1,000	URL HTTP o HTTPS de la página de detalles del producto.
`attributes`	object	—	Atributos del producto. Cuando se proporciona, este objeto reemplaza al objeto de atributos actual.
`status`	string	—	Estado del producto. El endpoint de actualización acepta `active` o `inactive`.

Los siguientes campos son de solo lectura: id, shopId, productCode, createdAt y updatedAt. Utilice el endpoint de eliminación para establecer un producto en invalid.

Actualizar por SKU#

json

{
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "product": {
    "name": "Large Gold Wall Mirror",
    "color": "Antique Gold",
    "status": "active"
  }
}

bash

curl --request PATCH \
  'https://sdkapi.ideal.house/product-import/products' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>' \
  --data-raw '{
    "shopId": "shop_123",
    "sku": "SKU-10001",
    "product": {
      "name": "Large Gold Wall Mirror",
      "color": "Antique Gold",
      "status": "active"
    }
  }'

Actualizar por ID de producto y cambiar el SKU#

json

{
  "shopId": "shop_123",
  "productId": "product_123",
  "product": {
    "sku": "SKU-10001-NEW",
    "name": "Large Gold Wall Mirror",
    "status": "inactive"
  }
}

Una actualización exitosa devuelve 200 OK y el objeto de producto actualizado completo. Un producto inactive se retiene y permanece disponible a través del endpoint Listar productos.