Eventi di merchandising: gli eventi con banchi, articoli e artisti per il merchandising. Nel web service è il tipo MERCHANDISINGEVENTO (valore 12 di DataType); gli oggetti sono della classe MerchandisingEvento e viaggiano nella lista ObjectListMerchandisingEvento della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | MERCHANDISINGEVENTO = 12 |
| Classe | MerchandisingEvento |
| Lista nella richiesta e nella risposta | ObjectListMerchandisingEvento |
| Tabella letta da QUERY | MercEventi — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | Anno + Numero — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | Anno|Numero |
| Chiave per le conferme di ricezione | Anno|Numero — come si usa |
I campi di MerchandisingEvento
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 |
|---|
Anno | Intero | Chiave | 0 | anno | Anno. |
Numero | Intero | Chiave | 0 | numero | Numero. |
Descrizione | Testo | — | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. |
Obsoleto | Vero/falso | — | false | obsoleto | Vero se il record non è più in uso: resta in archivio ma non viene proposto. |
Concluso | Vero/falso | — | false | concluso | Concluso. |
Artisti | Elenco di Testo | — | elenco vuoto | artista | Artisti. |
Tappe | Elenco di MerchandisingEventoTappa | — | elenco vuoto | — | Tappe: elenco di oggetti MerchandisingEventoTappa. |
Articoli | Elenco di MerchandisingEventoArticoli | — | elenco vuoto | — | Articoli: elenco di oggetti MerchandisingEventoArticoli. |
FileAllegati | Elenco di ImageTrasmission | — | elenco vuoto | — | File allegati. |
Classe annidata MerchandisingEventoTappa
Elemento usato dentro MerchandisingEvento. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
Data | Data e ora | — | nessuna data | Data. |
Citta | Testo | — | vuoto | Città. |
Luogo | Testo | — | vuoto | Luogo. |
NumeroBanchi | Intero | — | 0 | Numero banchi. |
Completata | Vero/falso | — | false | Completata. |
Classe annidata MerchandisingEventoArticoli
Elemento usato dentro MerchandisingEvento. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
Codice | Testo | — | vuoto | Codice univoco del record. È la chiave con cui il record viene creato o aggiornato. |
Descrizione | Testo | — | vuoto | Descrizione del record, mostrata nel gestionale e sul sito. |
GesVariante | Vero/falso | — | false | Ges variante. |
Variante | Testo | — | vuoto | Variante. |
Importo | Decimale | — | 0 | Importo. |
CategoriaMerceologica | Testo | — | vuoto | Categoria merceologica. Codice dell'archivio Categorie merceologiche. |
SottocategoriaMerceologica | Testo | — | vuoto | Sottocategoria merceologica. Codice dell'archivio Sottocategorie merceologiche. |
PercentualeProvvigione | Decimale | — | 0 | Percentuale provvigione. |
Raggruppamento | Testo | — | vuoto | Codice del raggruppamento. Codice dell'archivio Raggruppamenti dei file. |
ListaCodiciVarianti | Elenco di MerchandisingEventoArticoliCodiciVarianti | — | elenco vuoto | Codici varianti: elenco di oggetti MerchandisingEventoArticoliCodiciVarianti. |
Classe annidata MerchandisingEventoArticoliCodiciVarianti
Elemento usato dentro MerchandisingEventoArticoli. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
StringaVariante | Testo | — | vuoto | Valori della variante, separati come nel gestionale; vuoto per l'articolo senza variante. |
Codice | Testo | — | vuoto | Codice univoco del record. È la chiave con cui il record viene creato o aggiornato. |
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": 12,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListMerchandisingEvento": [
{
"Anno": 2026,
"Numero": 1,
"Descrizione": "Descrizione di esempio",
"Obsoleto": false,
"Concluso": false
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 12,
"GuidPC": "gestionale-01",
"SQLFilter": "MercEventi.Anno = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 12,
"GuidPC": "gestionale-01",
"ObjectListMerchandisingEvento": [
{
"Anno": 2026,
"Numero": 1
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.