Ein Produkt aktualisieren#

Aktualisiert ein Produkt synchron. Identifizieren Sie es mit productId oder sku zusammen mit shopId. Geben Sie genau einen Identifikator an; Anfragen mit beiden oder keinem davon liefern 400 Bad Request.

http

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

Die Kennung wird getrennt vom product-Objekt angegeben. Dadurch kann eine Integration ein Produkt anhand seiner aktuellen SKU finden und die SKU in derselben Anfrage ändern.

Verwenden Sie beim Ändern einer SKU productId als Kennung. So bleiben Wiederholungsversuche eindeutig, wenn die erste Anfrage die SKU aktualisiert, ihre Antwort aber verloren geht.

Anforderungstext#

Feld	Typ	Erforderlich	Beschreibung
`shopId`	string	Ja	Von Ideal House bereitgestellte Shop ID.
`productId`	string	Bedingt	ID des gesuchten Produkts. Erforderlich, wenn `sku` nicht angegeben wird.
`sku`	string	Bedingt	Aktuelle SKU des gesuchten Produkts. Erforderlich, wenn `productId` nicht angegeben wird.
`product`	object	Ja	Zu aktualisierende Felder. Fügen Sie mindestens ein Feld ein.

Bearbeitbare Produktfelder#

Nur die in product enthaltenen Felder werden aktualisiert.

Feld	Typ	Maximale Länge	Beschreibung
`sku`	string	120	Neue SKU. Sie muss innerhalb des Shops eindeutig bleiben.
`externalProductId`	string	120	Externe Produktkennung.
`groupId`	string	120	Produktgruppenkennung.
`collectionId`	string	120	Kennung der Produktsammlung.
`name`	string	255	Produktname.
`title`	string	255	Titel der Produktanzeige.
`brand`	string	120	Produktmarke.
`productType`	string	120	Produkttyp in Ihrer Taxonomie.
`normalizedProductType`	string	40	Normalisierter Produkttyp. Stimmen Sie die unterstützten Werte mit Ideal House ab.
`category`	string	120	Produktkategorie.
`style`	string	120	Produktstil.
`color`	string	120	Produktfarbe.
`availability`	string	40	Produktverfügbarkeitswert.
`imageUrl`	string	1,000	Öffentliche HTTP- oder HTTPS-Quellbild-URL.
`previewImageUrl`	string	1,000	HTTP- oder HTTPS-Vorschaubild-URL.
`productUrl`	string	1,000	HTTP- oder HTTPS-Produktdetail-URL.
`attributes`	object	—	Produktattribute. Wenn dieses Objekt bereitgestellt wird, ersetzt es das aktuelle Attributobjekt.
`status`	string	—	Produktstatus. Der Bearbeitungsendpunkt akzeptiert `active` oder `inactive`.

Die folgenden Felder sind schreibgeschützt: id, shopId, productCode, createdAt und updatedAt. Verwenden Sie den Löschendpunkt, um den Status eines Produkts auf invalid zu setzen.

Anhand der SKU aktualisieren#

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"
    }
  }'

Anhand der Produkt-ID aktualisieren und die SKU ändern#

json

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

Eine erfolgreiche Aktualisierung liefert 200 OK und das vollständige aktualisierte Produktobjekt. Ein Produkt mit dem Status inactive bleibt gespeichert und ist weiterhin über den Endpunkt zum Auflisten der Produkte verfügbar.