Le API di commercioVirtuoso.it ti permettono di aggiornare i dettagli dei prodotti esistenti nel tuo negozio in modo programmatico. In questa guida, ti mostreremo come utilizzare l’Endpoint /api/v2/products/{productId}.json
per aggiornare un prodotto esistente.
Documentazione API e Sandbox
Puoi visualizzare la lista completa degli Endpoint API e una Sandbox per simulare le chiamate e le risposte direttamente accedendo a: https://api.commerciovirtuoso.it
Aggiornare un Prodotto
Per aggiornare un prodotto, dovrai effettuare una richiesta PUT all’endpoint /api/v2/products/{productId}.json
con i dettagli aggiornati del prodotto nel corpo della richiesta. Di seguito sono riportati i passaggi dettagliati su come farlo.
Endpoint
PUT /api/v2/products/{productId}.json
Parametri della Richiesta
La richiesta deve contenere un oggetto JSON con tutti i dettagli del prodotto che si vuole aggiornare. Ecco un esempio di corpo della richiesta:
Corpo della Richiesta
{
"product_name": "Test Product",
"product_type": "product type",
"product_description": "product description",
"images": [
{
"image_url": "https://example.com/example.png",
"image_alt": "test-image",
"position": "0",
"image_attachment": "string"
}
]
}
Nota Importante
Quando si modificano i dettagli di un prodotto, questo entrerà in riapprovazione, ad eccezione della modifica dei seguenti campi:
- SKU
- Prezzo di vendita
- Prezzo di confronto
- Quantità
- Barcode
Eliminare di un Prodotto
commercioVirtuoso.it non permette l’eliminazione dei prodotti via API per policy interna.
Se desideri delistare dalla vendita un prodotto, devi effettuare una chiamata di aggiornamento prodotto modificando il campo “active”: 0. Impostare la quantità di ciascuna variante a 0 è una pratica suggerita.