Giacenze per articolo: le giacenze lette con i filtri sugli articoli, anche per evento. Nel web service è il tipo PRODUCTSTOCK (valore 25 di DataType); gli oggetti sono della classe GiacenzeArticoli e viaggiano nella lista ObjectListGiacenzeArticoli della richiesta e della risposta.
Questo tipo è di sola lettura e restituisce oggetti GiacenzeArticoli, gli stessi di Giacenze: la differenza è che la lettura passa dagli articoli, quindi rispetta i filtri per evento di QueryParameter e un SQLFilter può usare anche le colonne della tabella articoli. Per scrivere le giacenze usa Giacenze.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | PRODUCTSTOCK = 25 |
| Classe | GiacenzeArticoli |
| Lista nella richiesta e nella risposta | ObjectListGiacenzeArticoli |
| Tabella letta da QUERY | GiacenzeArticoli — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3) |
| Campi chiave | Articolo + StringaVarianti + Deposito — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per le conferme di ricezione | Articolo|StringaVarianti|Deposito — come si usa |
| Controlli prima del salvataggio | Articolo: «Articolo non specificato»
Deposito: «Deposito non specificato» |
I campi di GiacenzeArticoli
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 |
|---|
Articolo | Testo | Chiave, sì | vuoto | codicearticolo | Codice dell'articolo. Codice dell'archivio Articoli. Se manca il server risponde «Articolo non specificato». |
StringaVarianti | Testo | Chiave | vuoto | stringavarianti | Valori della variante, separati come nel gestionale; vuoto per l'articolo senza variante. |
Deposito | Testo | Chiave, sì | vuoto | deposito | Codice del deposito. Codice dell'archivio Depositi. Se manca il server risponde «Deposito non specificato». |
Esistenza | Decimale | — | 0 | esistenza | Quantità fisicamente presente nel deposito. |
Disponibilita | Decimale | — | 0 | disponibilita | Quantità vendibile, al netto di quella impegnata. |
Esempi
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 25,
"GuidPC": "gestionale-01",
"SQLFilter": "GiacenzeArticoli.CodiceArticolo = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.