Response Recupero Prodotti
La response del servizio di recupero prodotti è restituita in formato JSON e include informazioni di paginazione e l’elenco dei prodotti.
Struttura della Response
{
"ResponseTo": "Products",
"Timestamp": "1765637484",
"Ack": "OK",
"MessaggioErrore": "",
"CodiceErrore": "",
"Output": {
"TotaleProdotti": "12",
"TotalePagine": "1",
"PaginaCorrente": "1",
"ProdottiPerPagina": "100",
"Prodotti": [ ... ]
}
}
Metadati di Paginazione
| Campo | Tipo | Descrizione |
|---|---|---|
| TotaleProdotti | integer | Numero totale di prodotti disponibili |
| TotalePagine | integer | Numero totale di pagine |
| PaginaCorrente | integer | Pagina corrente |
| ProdottiPerPagina | integer | Numero di prodotti per pagina |
Lista Prodotti
Il campo Prodotti contiene un array di prodotti.
Ogni elemento rappresenta una variante di prodotto.
Campi dell’oggetto Prodotto
| Campo | Tipo | Descrizione |
|---|---|---|
| codice | string | Codice univoco del prodotto (SKU variante) |
| products_id | integer | Identificativo interno del prodotto |
| codice_padre | string | Codice del prodotto padre |
| products_name | string | Nome del prodotto |
| products_description | string | Descrizione del prodotto |
| products_barcode | string | Codice a barre (EAN) |
| MPN | string | Manufacturer Part Number |
| codice_categoria | string | Codici categoria separati da # |
| price_gross | number | Prezzo lordo del prodotto |
| products_image | string (URL) | URL dell’immagine principale |
| products_quantity | integer | Quantità disponibile |
| manufacturers_name | string | Nome del produttore |
| products_status | integer | Stato del prodotto (1 = attivo) |
| varianti | object | Attributi di variante del prodotto |
Oggetto varianti
variantiL’oggetto varianti contiene le caratteristiche della variante prodotto.
| Campo | Tipo | Descrizione |
|---|---|---|
| Colore | string | Colore della variante |
| Taglia | string | Taglia della variante |
Esempio:
"varianti": {
"Colore": "NERO",
"Taglia": "39/40"
}
Note Importanti
- Ogni combinazione di prodotto padre + varianti viene restituita come prodotto distinto
- Il campo
codice_padreconsente di ricondurre le varianti allo stesso prodotto principale - I campi numerici possono essere restituiti come stringhe
- Il campo
products_statusindica lo stato di visibilità del prodotto
Esempio di Prodotto
{
"codice": "711-7511",
"products_id": "1679",
"codice_padre": "PR_711",
"varianti": {
"Colore": "NERO",
"Taglia": "39/40"
},
"products_name": "Ciabatta donna Mare Guess GU111A1U2",
"products_description": "",
"products_barcode": "7618391082685",
"MPN": "",
"codice_categoria": "beachwear donna#accessori mare donna",
"price_gross": "0.00",
"products_image": "https://example.store360.it/prodotti/immagini/5563.jpg",
"products_quantity": "1",
"manufacturers_name": "Guess",
"products_status": "1"
}
