Destinazioni diverse: gli indirizzi di consegna di clienti e fornitori. Nel web service è il tipo DESTINAZIONIDIVERSE (valore 44 di DataType); gli oggetti sono della classe DestinazioniDiverse e viaggiano nella lista ObjectListDestinazioniDiverse della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | DESTINAZIONIDIVERSE = 44 |
| Classe | DestinazioniDiverse |
| Lista nella richiesta e nella risposta | ObjectListDestinazioniDiverse |
| Tabella letta da QUERY | Destinazionidiv — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | CodiceClienteFornitore + TipoClienteFornitore + Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | CodiceClienteFornitore|TipoClienteFornitore|Codice |
| Chiave per le conferme di ricezione | CodiceClienteFornitore|TipoClienteFornitore|Codice — come si usa |
| Controlli prima del salvataggio | CodiceClienteFornitore: «Codice cliente o fornitore non specificato»
TipoClienteFornitore: «Tipo cliente o fornitore non specificato»
Codice: «Codice non specificato» |
I campi di DestinazioniDiverse
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 |
|---|
CodiceClienteFornitore | Testo | Chiave, sì | vuoto | codclifor | Codice del cliente o del fornitore. Se manca il server risponde «Codice cliente o fornitore non specificato». |
TipoClienteFornitore | Testo | Chiave, sì | vuoto | tipoclifor | C per cliente, F per fornitore. Se manca il server risponde «Tipo cliente o fornitore non specificato». |
Codice | Testo | Chiave, sì | vuoto | codice | Codice della destinazione, univoco per il cliente o fornitore. Se manca il server risponde «Codice non specificato». |
Descrizione | Testo | — | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. |
DescrizionePersonalizzata | Testo | — | vuoto | descrpers | Descrizione personalizzata. |
Indirizzo | Testo | — | vuoto | indirizzo | Indirizzo (via e numero civico). |
Cap | Testo | — | vuoto | cap | Codice di avviamento postale. |
Citta | Testo | — | vuoto | citta | Città. |
Provincia | Testo | — | vuoto | prov | Sigla della provincia. |
Regione | Testo | — | vuoto | regione | Regione. |
Nazione | Testo | — | vuoto | nazione | Codice della nazione. |
IndirizzoGPSlng | Decimale | — | 0 | indirizzogpslng | Indirizzo GP slng. |
IndirizzoGPSlat | Decimale | — | 0 | indirizzogpslat | Indirizzo GP slat. |
Referenti | Testo | — | vuoto | referenti | Nomi dei referenti. |
Telefono1 | Testo | — | vuoto | telefono1 | Primo numero di telefono. |
Telefono2 | Testo | — | vuoto | telefono2 | Secondo numero di telefono. |
Cellulare | Testo | — | vuoto | cellulare | Numero di cellulare. |
Fax | Testo | — | vuoto | fax | Numero di fax. |
OrariUfficio | Testo | — | vuoto | orariuff | Orari di ufficio. |
Note | Testo | — | vuoto | note | Note libere. |
AssistenzaDistanzaKM | Decimale | — | 0 | assdistkm | Assistenza distanza km. |
AssistenzaOreViaggio | Decimale | — | 0 | assoreviaggio | Assistenza ore viaggio. |
NoteSpedizione | Testo | — | vuoto | notesped | Note per la spedizione. |
Email1 | Testo | — | vuoto | email1 | Primo indirizzo email. |
Email2 | Testo | — | vuoto | email2 | Secondo indirizzo email. |
Whatsapp | Testo | — | vuoto | whatsapp | Numero WhatsApp. |
Pec | Testo | — | vuoto | pec | Indirizzo di posta elettronica certificata. |
CodiceCorrispondenza | Testo | — | vuoto | codicecorr | Codice corrispondenza. |
CodiceEsportazione | Testo | — | vuoto | codiceesportazione | Codice da usare nei tracciati di esportazione. |
Obsoleto | Vero/falso | — | false | obsoleto | Vero se il record non è più in uso: resta in archivio ma non viene proposto. |
ObsoletoDal | Data e ora | — | nessuna data | obsoletodal | Data da cui il record è obsoleto. |
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": 44,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListDestinazioniDiverse": [
{
"CodiceClienteFornitore": "COD001",
"TipoClienteFornitore": "C",
"Codice": "COD002",
"Descrizione": "Descrizione di esempio",
"DescrizionePersonalizzata": "Descrizione di esempio",
"Indirizzo": "ESEMPIO",
"Cap": "ESEMPIO"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 44,
"GuidPC": "gestionale-01",
"SQLFilter": "Destinazionidiv.Codclifor = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 44,
"GuidPC": "gestionale-01",
"ObjectListDestinazioniDiverse": [
{
"CodiceClienteFornitore": "COD001",
"TipoClienteFornitore": "C",
"Codice": "COD003"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.