Recupero ordini

Metodo HTTP

GET

Endpoint

https://MIOSERVER/store360_api

Risorse

Recupero lista ordini

GET /orders

Esempio:

https://MIOSERVER/store360_api/orders

Questa risorsa consente il recupero di più ordini e supporta parametri di filtro tramite query string.

Recupero singolo ordine

GET /orders/{id_ordine_store360}

Esempio:

https://MIOSERVER/store360_api/orders/115

In questo caso, l’identificativo dell’ordine (id_ordine_store360) è un Path Parameter e identifica in modo univoco l’ordine da recuperare.

Path Parameters

Utilizzati esclusivamente per il recupero del singolo ordine.

`id_ordine_store360`

Tipo: integer
Descrizione: Identificativo univoco dell’ordine nel sistema Store360

Query Parameters

Utilizzati solo nel recupero di più ordini (GET /orders) e passati tramite query string.
Tutti i parametri sono opzionali.

`Dal`

Tipo: string
Formato: YYYY-MM-DD (ISO)
Esempio: Dal=2022-03-10

Data a partire dalla quale (compresa) vengono recuperati gli ordini.

Se non valorizzato e non viene specificato un id_ordine_store360, vengono restituiti gli ordini a partire da 1 giorno precedente rispetto alla data del server.

`Al`

Tipo: string
Formato: YYYY-MM-DD (ISO)
Esempio: Al=2022-03-20

Data fino alla quale (compresa) vengono recuperati gli ordini.

Se valorizzato, deve contenere una data successiva o uguale a quella indicata in Dal
Se non valorizzato, viene considerata la data corrente del server

`Stato`

Tipo: string
Esempio: Stato=PAGATO

Filtro opzionale sullo stato dell’ordine, applicato in combinazione con Dal e Al.

Valori ammessi:

Valore	Descrizione
ALL	Tutti gli stati (valore di default)
NUOVO	Ordini nuovi
PAGATO	Ordini pagati
SPEDITO	Ordini spediti ma non ancora pagati (es. contrassegno)
PAGATOESPEDITO	Ordini pagati ed evasi

Comportamento di Default

Se non viene specificato alcun Query Parameter, l’API restituisce gli ordini delle ultime 24 ore
Se viene specificato un Path Parameter (id_ordine_store360), tutti i Query Parameters vengono ignorati

Esempi di Richiesta

Recupero ordini con filtri (Query Parameters)

GET /orders?Dal=2022-03-10&Al=2022-03-20&Stato=PAGATO

Recupero ordini senza filtri (ultime 24 ore)

GET /orders

Recupero singolo ordine (Path Parameter)

GET /orders/115

Esempio di risposta JSON ordine

{
  "ResponseTo": "Orders",
  "Timestamp": "1765636861",
  "Ack": "OK",
  "MessaggioErrore": "",
  "CodiceErrore": "",
  "Output": {
    "Ordine": {
      "OrdineId": "58239",
      "DataOrdine": "2025-12-09 18:20:19",
      "Provenienza": "WEB",
      "external_orderid": "43460",
      "Stato": "PAGATOESPEDITO",
      "Totale": "275",
      "MetodoSpedizione": "Spedizione gratuita",
      "CostoSpedizione": "0.00",
      "DataSpedizione": "2025-12-11 19:15:30",
      "CostoAssicurazione": "0.00",
      "MetodoPagamento": "PayPal",
      "CostoPagamento": "0.00",
      "ClienteId": "47048",
      "Cliente": "NOME COGNOME",
      "Azienda": "AZIENDA_O_CF",
      "PartitaIva": "",
      "CodiceFiscale": "RSSMRA00A00A000A",
      "Indirizzo": "Via Esempio 1",
      "Citta": "CittaEsempio",
      "Cap": "00000",
      "Provincia": "XX",
      "Nazione": "IT",
      "Nazione_ISO2": "IT",
      "Telefono": "0000000000",
      "Email": "[email protected]",
      "ClienteSpedizione": "NOME COGNOME",
      "AziendaSpedizione": "AZIENDA_O_CF",
      "IndirizzoSpedizione": "Via Esempio 1",
      "CittaSpedizione": "CittaEsempio",
      "CapSpedizione": "00000",
      "ProvinciaSpedizione": "XX",
      "NazioneSpedizione": "IT",
      "NazioneSpedizione_ISO2": "IT",
      "Note": "Ordine Woocommerce: 43460 Cambio stato: 2<br>",
      "Prodotti": {
        "Prodotto": {
          "Codice": "8012667403270",
          "Nome": "Beta 961N - Videoscopio elettronico con sonda flessibile ed orientabile - 009610030",
          "Qta": "1",
          "Prezzo": "225.41",
          "External_sku": "8012667403270",
          "Iva": "22.00"
        }
      },
      "IvaPagamento": "22.00",
      "IvaSpedizione": "22.00"
    }
  }
}