Universal Web Platform · Destinazioni diverse

DestinazioniDiverse: gli indirizzi di consegna di clienti e fornitori

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

VoceValore
Tipo di datoDESTINAZIONIDIVERSE = 44
ClasseDestinazioniDiverse
Lista nella richiesta e nella rispostaObjectListDestinazioniDiverse
Tabella letta da QUERYDestinazionidiv — è il nome da usare davanti alle colonne in SQLFilter
Operazioni ammesseQUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2)
Campi chiaveCodiceClienteFornitore + TipoClienteFornitore + Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea
Chiave per cancellare con DeletingClassCodiceClienteFornitore|TipoClienteFornitore|Codice
Chiave per le conferme di ricezioneCodiceClienteFornitore|TipoClienteFornitore|Codice — come si usa
Controlli prima del salvataggioCodiceClienteFornitore: «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.

CampoTipoObbligatorioPredefinitoColonnaA cosa serve
CodiceClienteFornitoreTestoChiave, sìvuotocodcliforCodice del cliente o del fornitore. Se manca il server risponde «Codice cliente o fornitore non specificato».
TipoClienteFornitoreTestoChiave, sìvuototipocliforC per cliente, F per fornitore. Se manca il server risponde «Tipo cliente o fornitore non specificato».
CodiceTestoChiave, sìvuotocodiceCodice della destinazione, univoco per il cliente o fornitore. Se manca il server risponde «Codice non specificato».
DescrizioneTesto—vuotodescrizioneDescrizione del record, mostrata nel gestionale e sul sito.
DescrizionePersonalizzataTesto—vuotodescrpersDescrizione personalizzata.
IndirizzoTesto—vuotoindirizzoIndirizzo (via e numero civico).
CapTesto—vuotocapCodice di avviamento postale.
CittaTesto—vuotocittaCittà.
ProvinciaTesto—vuotoprovSigla della provincia.
RegioneTesto—vuotoregioneRegione.
NazioneTesto—vuotonazioneCodice della nazione.
IndirizzoGPSlngDecimale—0indirizzogpslngIndirizzo GP slng.
IndirizzoGPSlatDecimale—0indirizzogpslatIndirizzo GP slat.
ReferentiTesto—vuotoreferentiNomi dei referenti.
Telefono1Testo—vuototelefono1Primo numero di telefono.
Telefono2Testo—vuototelefono2Secondo numero di telefono.
CellulareTesto—vuotocellulareNumero di cellulare.
FaxTesto—vuotofaxNumero di fax.
OrariUfficioTesto—vuotoorariuffOrari di ufficio.
NoteTesto—vuotonoteNote libere.
AssistenzaDistanzaKMDecimale—0assdistkmAssistenza distanza km.
AssistenzaOreViaggioDecimale—0assoreviaggioAssistenza ore viaggio.
NoteSpedizioneTesto—vuotonotespedNote per la spedizione.
Email1Testo—vuotoemail1Primo indirizzo email.
Email2Testo—vuotoemail2Secondo indirizzo email.
WhatsappTesto—vuotowhatsappNumero WhatsApp.
PecTesto—vuotopecIndirizzo di posta elettronica certificata.
CodiceCorrispondenzaTesto—vuotocodicecorrCodice corrispondenza.
CodiceEsportazioneTesto—vuotocodiceesportazioneCodice da usare nei tracciati di esportazione.
ObsoletoVero/falso—falseobsoletoVero se il record non è più in uso: resta in archivio ma non viene proposto.
ObsoletoDalData e ora—nessuna dataobsoletodalData 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.