Aggiornamento stato ordini - PUT

Aggiornamento Stato Ordini

Metodo HTTP

PUT

---

Endpoint

https://MIOSERVER/store360_api

---

Risorsa

Aggiornamento stato di uno o più ordini

PUT /orders

Esempio:

https://MIOSERVER/store360_api/orders

Questa risorsa consente l’aggiornamento dello stato di uno o più ordini tramite request body in formato JSON.

---

Request Body

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

---

Struttura del Body

JSON

{
  "Ordini": [
    {
      "OrdineId": "123456",
      "Stato": "PAGATOESPEDITO",
      "Data": "2025-12-11T19:12:27.000Z",
      "TrackingNumber": "G4660635509",
      "CarrierUsed": "GLS",
      "ShippingMethod": "National Express"
    },
    {
      "OrdineId": "45667789",
      "Stato": "PAGATOESPEDITO",
      "Data": "2025-12-11T19:15:30.000Z",
      "TrackingNumber": "G4660635510",
      "CarrierUsed": "GLS",
      "ShippingMethod": "National Express"
    }
  ]
}

---

Campi del Body

Ordini

• Tipo: array
• Descrizione: Elenco degli ordini da aggiornare

Ogni elemento dell’array rappresenta un singolo ordine.

---

Campi dell’oggetto Ordine

Campo	Tipo	Obbligatorio	Descrizione
OrdineId	string	sì	Identificativo dell’ordine nel sistema Store360
Stato	string	sì	Nuovo stato dell’ordine
Data	string	sì	Data e ora dell’aggiornamento in formato ISO 8601
TrackingNumber	string	no	Codice di tracciamento della spedizione
CarrierUsed	string	no	Corriere utilizzato
ShippingMethod	string	no	Metodo di spedizione

---

Stati Ordine Ammessi

Valore	Descrizione
NUOVO	Ordine creato
PAGATO	Ordine pagato
SPEDITO	Ordine spedito ma non ancora pagato
PAGATOESPEDITO	Ordine pagato ed evaso

---

Header Richiesti

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

---

Comportamento

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

---

Esempio di Richiesta

HTTP

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

JSON

{
  "Ordini": [
    {
      "OrdineId": "43460",
      "Stato": "PAGATOESPEDITO",
      "Data": "2025-12-11T19:15:30.000Z",
      "TrackingNumber": "G4660635510",
      "CarrierUsed": "GLS",
      "ShippingMethod": "National Express",
      "StoreId": "2"
    }
  ]
}