API Reference

Aggiornamento stock e prezzi - PUT

Metodo HTTP

PUT

Endpoint

https://MIOSERVER/store360_api

Risorsa

Inserimento / aggiornamento stock e prezzi prodotti

PUT /stock-price

Esempio:

https://MIOSERVER/store360_api/stock-price

Questa risorsa consente l’inserimento o l’aggiornamento dello stock e del prezzo di uno o più prodotti tramite request body in formato JSON.

Request Body

Il corpo della richiesta deve essere inviato in formato JSON e contenere un array di prodotti da aggiornare.

Struttura del Body

{
  "Prodotti": [
    {
      "Sku": "0088381720984",
      "Prezzo": 200.30,
      "Qta": 10
    },
    {
      "Sku": "0088381806138",
      "Prezzo": 156.90,
      "Qta": 30
    }
  ]
}

Campi del Body

Prodotti

  • Tipo: array
  • Descrizione: Elenco dei prodotti da inserire o aggiornare

Ogni elemento dell’array rappresenta un singolo prodotto.

Campi dell’oggetto Prodotto

CampoTipoObbligatorioDescrizione
SkustringsìCodice SKU univoco del prodotto
PrezzonumbercondizionalePrezzo del prodotto
QtaintegercondizionaleQuantità disponibile a magazzino

Regole di Validazione

  • Il campo Sku è sempre obbligatorio
  • I campi Prezzo e Qta sono opzionali singolarmente
  • Almeno uno tra Prezzo e Qta deve essere valorizzato
  • È possibile:
    • aggiornare solo il prezzo
    • aggiornare solo la quantità
    • aggiornare prezzo e quantità insieme

Se entrambi i campi Prezzo e Qta non vengono forniti, il prodotto viene considerato non valido e scartato, con segnalazione nella response.

Esempi Validi

Aggiornamento solo prezzo:

{
  "Sku": "0088381720984",
  "Prezzo": 200.30
}

Aggiornamento solo quantità:

{
  "Sku": "0088381720984",
  "Qta": 10
}

Aggiornamento prezzo e quantità:

{
  "Sku": "0088381720984",
  "Prezzo": 200.30,
  "Qta": 10
}

Header Richiesti

Content-Type: application/json
Authorization: Bearer {access_token}

Comportamento

  • È possibile aggiornare uno o più prodotti con una singola richiesta
  • Ogni prodotto viene elaborato in modo indipendente
  • Eventuali errori su un prodotto non bloccano l’elaborazione degli altri
  • In caso di dati non validi, il prodotto viene scartato e segnalato nella response

Esempio di Richiesta

PUT /stock-price
Content-Type: application/json
Authorization: Bearer {token}

{
  "Prodotti": [
    {
      "Sku": "0088381720984",
      "Prezzo": 200.30,
      "Qta": 10
    },
    {
      "Sku": "0088381806138",
      "Prezzo": 156.90,
      "Qta": 30
    }
  ]
}

JSON di Risposta

Ad ogni chiamata PUT, il sistema Store360 restituisce una response in formato JSON con la seguente struttura.

Struttura della Response

{
  "ResponseTo": "Stock_Price",
  "Timestamp": "1765539057",
  "Ack": "OK",
  "MessaggioErrore": "",
  "CodiceErrore": "0",
  "Output": "File caricato correttamente\nFile elaborato correttamente\nAggiornati 2 prodotti"
}