Sottocategorie merceologiche: il secondo livello del catalogo, legato alla sua categoria. Nel web service è il tipo SOTTOCATEGORIEMERCEOLOGICHE (valore 3 di DataType); gli oggetti sono della classe SottoCategoriaMerceologica e viaggiano nella lista ObjectListSottoCategoriaMerceologica della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | SOTTOCATEGORIEMERCEOLOGICHE = 3 |
| Classe | SottoCategoriaMerceologica |
| Lista nella richiesta e nella risposta | ObjectListSottoCategoriaMerceologica |
| Tabella letta da QUERY | SottoCategorieMerceologiche — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | CodiceCategoria + Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | CodiceCategoria|Codice |
| Chiave per le conferme di ricezione | CodiceCategoria|Codice — come si usa |
| Controlli prima del salvataggio | CodiceCategoria: «Codice categoria non specificato»
Codice: «Codice non specificato»
Descrizione: «Descrizione non specificato» |
I campi di SottoCategoriaMerceologica
La colonna Obbligatorio riporta i campi chiave e quelli controllati dal server prima di salvare; Predefinito è il valore che il campo assume se non lo invii; Colonna è il nome del campo nel database, da usare nei filtri di lettura.
| Campo | Tipo | Obbligatorio | Predefinito | Colonna | A cosa serve |
|---|
CodiceCategoria | Testo | Chiave, sì | vuoto | codicecategoria | Codice della categoria merceologica a cui appartiene. Codice dell'archivio Categorie merceologiche. Se manca il server risponde «Codice categoria non specificato». |
DescrizioneCategoria | Testo | — | vuoto | — | Descrizione categoria. |
Codice | Testo | Chiave, sì | vuoto | codice | Codice della sottocategoria, univoco all'interno della categoria. Se manca il server risponde «Codice non specificato». |
Descrizione | Testo | Sì | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. Se manca il server risponde «Descrizione non specificato». |
CategoriaGoogleMarket | Testo | — | vuoto | googlecod | Categoria corrispondente nella tassonomia di Google Merchant. |
CategoriaGoogleMarketDescrizione | Testo | — | vuoto | googledes | Descrizione di CategoriaGoogleMarket, riportata per comodità di chi legge. |
CategoriaFacebookMarket | Testo | — | vuoto | facebookcod | Categoria corrispondente nel catalogo di Meta. |
CategoriaFacebookMarketDescrizione | Testo | — | vuoto | facebookdes | Descrizione di CategoriaFacebookMarket, riportata per comodità di chi legge. |
Logo | ImageTrasmission | — | oggetto vuoto | — | Logo, come file in Base64. |
LogoMiniatura | ImageTrasmission | — | oggetto vuoto | — | Logo in miniatura, come file in Base64. |
Ordinamento | Intero | — | 0 | ordinamento | Posizione nell'ordinamento: i valori più bassi vengono prima. |
DescrizioneDettagliata | Testo | — | vuoto | descrizionedett | Descrizione estesa, anche in HTML. |
Attivo | Vero/falso | — | false | attivo | Vero se il record è attivo. |
Esempi
Inserimento o aggiornamento di un record (valori di esempio). Ricorda che INSERTORMODIFY riscrive tutti i campi: quelli che non invii tornano al valore predefinito, quindi per modificare un record esistente invia il record completo.
JSON · INSERTORMODIFY{
"DataOperation": 0,
"TypeObject": 3,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListSottoCategoriaMerceologica": [
{
"CodiceCategoria": "COD001",
"DescrizioneCategoria": "Descrizione di esempio",
"Codice": "COD002",
"Descrizione": "Descrizione di esempio",
"CategoriaGoogleMarket": "ESEMPIO",
"CategoriaFacebookMarket": "ESEMPIO"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 3,
"GuidPC": "gestionale-01",
"SQLFilter": "SottoCategorieMerceologiche.CodiceCategoria = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 3,
"GuidPC": "gestionale-01",
"ObjectListSottoCategoriaMerceologica": [
{
"CodiceCategoria": "COD001",
"Codice": "COD002"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.