Обновление товара#

Обновляет один товар синхронно. Идентифицируйте товар с помощью productId или sku вместе с shopId. Предоставьте ровно один идентификатор; запросы, содержащие оба или ни одного, возвращают 400 Bad Request.

http

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

Идентификатор отделен от объекта product. Это позволяет интеграции найти товар по его текущему SKU и изменить SKU в том же запросе.

Используйте productId в качестве идентификатора при изменении SKU. Это сохраняет однозначность повторных попыток, если первый запрос обновляет SKU, но его ответ потерян.

Тело запроса#

Поле	Тип	Обязательно	Описание
`shopId`	string	Да	Shop ID, предоставленный Ideal House.
`productId`	string	При условии	Идентификатор искомого товара. Обязателен, если `sku` не указан.
`sku`	string	При условии	Текущий SKU искомого товара. Обязателен, если `productId` не указан.
`product`	object	Да	Поля для обновления. Включите хотя бы одно поле.

Редактируемые поля товара#

Обновляются только поля, включенные в product.

Поле	Тип	Максимальная длина	Описание
`sku`	string	120	Новый SKU. Он должен оставаться уникальным в пределах магазина.
`externalProductId`	string	120	Внешний идентификатор товара.
`groupId`	string	120	Идентификатор группы товаров.
`collectionId`	string	120	Идентификатор коллекции товаров.
`name`	string	255	Название товара.
`title`	string	255	Заголовок товара, используемый для отображения.
`brand`	string	120	Бренд товара.
`productType`	string	120	Тип товара в вашей таксономии.
`normalizedProductType`	string	40	Нормализованный тип товара. Согласуйте поддерживаемые значения с Ideal House.
`category`	string	120	Категория товара.
`style`	string	120	Стиль товара.
`color`	string	120	Цвет товара.
`availability`	string	40	Значение доступности.
`imageUrl`	string	1,000	Публичный HTTP или HTTPS URL исходного изображения.
`previewImageUrl`	string	1,000	HTTP или HTTPS URL превью-изображения.
`productUrl`	string	1,000	URL страницы с подробной информацией о товаре по HTTP или HTTPS.
`attributes`	object	—	Атрибуты товара. При указании этот объект заменяет текущий объект атрибутов.
`status`	string	—	Статус товара. Конечная точка обновления принимает `active` или `inactive`.

Следующие поля только для чтения: id, shopId, productCode, createdAt и updatedAt. Используйте конечную точку удаления, чтобы установить товару статус invalid.

Обновление по 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"
    }
  }'

Обновление по идентификатору товара и изменение SKU#

json

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

Успешное обновление возвращает 200 OK и полный обновленный объект товара. Товар со статусом inactive сохраняется и остается доступным через конечную точку списка товаров.