Modifica un prodotto#

Aggiorna un prodotto in modo sincrono. Identificarlo tramite productId oppure sku, insieme a shopId. Fornire esattamente un identificatore: le richieste con entrambi o nessuno dei due restituiscono 400 Bad Request.

http

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

L'identificatore è separato dall’oggetto product. Ciò consente a un'integrazione di individuare un prodotto in base al suo SKU corrente e di modificare lo SKU nella stessa richiesta.

Utilizzare productId come identificatore quando si modifica uno SKU. Ciò mantiene i tentativi non ambigui se la prima richiesta aggiorna lo SKU ma la risposta viene persa.

Corpo della richiesta#

Campo	Tipo	Obbligatorio	Descrizione
`shopId`	string	Sì	ID negozio fornito da Ideal House. (Shop ID)
`productId`	string	Condizionale	ID del prodotto da individuare. Obbligatorio se `sku` è omesso.
`sku`	string	Condizionale	SKU attuale del prodotto da individuare. Obbligatorio se `productId` è omesso.
`product`	object	Sì	Campi da aggiornare. Includere almeno un campo.

Campi prodotto modificabili#

Solo i campi inclusi in product sono aggiornati.

Campo	Tipo	Lunghezza massima	Descrizione
`sku`	string	120	Nuovo codice. Deve rimanere unico all'interno del negozio. (SKU)
`externalProductId`	string	120	Identificatore del prodotto esterno.
`groupId`	string	120	Identificatore del gruppo di prodotti.
`collectionId`	string	120	Identificatore della raccolta prodotti.
`name`	string	255	Nome del prodotto.
`title`	string	255	Titolo visualizzato del prodotto.
`brand`	string	120	Marchio del prodotto.
`productType`	string	120	Tipo di prodotto nella tassonomia.
`normalizedProductType`	string	40	Tipo di prodotto normalizzato. Concordare i valori supportati con Ideal House.
`category`	string	120	Categoria di prodotto.
`style`	string	120	Stile del prodotto.
`color`	string	120	Colore del prodotto.
`availability`	string	40	Valore disponibilità prodotto.
`imageUrl`	string	1,000	URL pubblico dell'immagine di origine HTTP o HTTPS.
`previewImageUrl`	string	1,000	URL dell'immagine di anteprima HTTP o HTTPS.
`productUrl`	string	1,000	URL dei dettagli del prodotto HTTP o HTTPS.
`attributes`	object	—	Attributi del prodotto. Quando fornito, questo oggetto sostituisce l'oggetto attributi corrente.
`status`	string	—	Stato del prodotto. L'endpoint di modifica accetta `active` o `inactive`.

I seguenti campi sono di sola lettura: id, shopId, productCode, createdAt e updatedAt. Usare l’endpoint di eliminazione per impostare lo stato di un prodotto su invalid.

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

Modifica per ID prodotto e modifica SKU#

json

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

Un aggiornamento riuscito restituisce 200 OK e l’oggetto prodotto completo aggiornato. Un prodotto inactive viene conservato e resta disponibile tramite l’endpoint che elenca i prodotti.