Universal Web Platform · Dipendenti

Dipendenti: dipendenti, commessi e agenti, con i loro dati

Dipendenti: dipendenti, commessi e agenti, con i loro dati. Nel web service è il tipo DIPENDENTI (valore 30 di DataType); gli oggetti sono della classe Dipendenti e viaggiano nella lista ObjectListDipendenti della richiesta e della risposta.

Scheda tecnica

VoceValore
Tipo di datoDIPENDENTI = 30
ClasseDipendenti
Lista nella richiesta e nella rispostaObjectListDipendenti
Tabella letta da QUERYDipendenti — è il nome da usare davanti alle colonne in SQLFilter
Operazioni ammesseQUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2)
Campi chiaveCodice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea
Chiave per cancellare con DeletingClassCodice
Chiave per le conferme di ricezioneCodice — come si usa
Controlli prima del salvataggioCodice: «Codice non specificato»
Nome: «Nome non specificato»
Cognome: «Cognome non specificato»

I campi di Dipendenti

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
CodiceTestoChiave, sìvuotocodiceCodice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato».
NomeTestoSìvuotonomeNome. Se manca il server risponde «Nome non specificato».
CognomeTestoSìvuotocognomeCognome. Se manca il server risponde «Cognome non specificato».
DataAssunzioneData e ora—nessuna datadataassData assunzione.
DataFineRapportoData e ora—nessuna datadatafineData fine rapporto.
Telefono1Testo—vuototelefono1Primo numero di telefono.
Telefono2Testo—vuototelefono1Secondo numero di telefono.
CellulareTesto—vuotocellNumero di cellulare.
FaxTesto—vuotofaxNumero di fax.
Email1Testo—vuotoemail1Primo indirizzo email.
Email2Testo—vuotoemail2Secondo indirizzo email.
CLSIDTesto—vuotoclsidCLSID.
ResponsabileVero/falso—falseresponsabileResponsabile.
DepositoDefaultTesto—vuotodepositodefDeposito predefinito.
CodiceBarreTesto—vuotocodabarreCodice barre.
RuoloAgenteVero/falso—falseruoloagenteRuolo agente.
RuoloCommessoVero/falso—falseruolocommessoRuolo commesso.
RuoloAmministrativoVero/falso—falseruoloamministrativoRuolo amministrativo.
RuoloCapoareaVero/falso—falseruolocapoareaRuolo capoarea.
RuoloTecnicoVero/falso—falseruolotecnicoRuolo tecnico.
RuoloFunzionarioVero/falso—falseruolofunzionarioRuolo funzionario.
PECTesto—vuotopecIndirizzo di posta elettronica certificata.
PIvaTesto—vuotopivaP IVA.
UsernameTesto—vuotousernameNome utente.
PasswordTesto—vuotopasswordPassword.
SerieWEBTesto—vuotoseriewebSerie web.
SoloVisualizzazioneVero/falso—falsewebsolovisualizzazioneSolo visualizzazione.
IndirizzoTesto—vuotoindirizzoIndirizzo (via e numero civico).
IndirizzoLatitudineDecimale—0indirizzolatIndirizzo latitudine.
IndirizzoLongitudineDecimale—0indirizzolongIndirizzo longitudine.
RegioneTesto—vuotoregioneRegione.
CAPTesto—vuotocapCodice di avviamento postale.
CittaTesto—vuotocittaCittà.
ProvinciaTesto—vuotoprovSigla della provincia.
FotoImageTrasmission—oggetto vuoto—Fotografia, come file in Base64.
DomicilioIndirizzoTesto—vuotoindirizzodomDomicilio indirizzo.
DomicilioIndirizzoLatitudineDecimale—0indirizzolatdomDomicilio indirizzo latitudine.
DomicilioIndirizzoLongitudineDecimale—0indirizzolongdomDomicilio indirizzo longitudine.
DomicilioRegioneTesto—vuotoregionedomDomicilio regione.
DomicilioCAPTesto—vuotocapdomDomicilio CAP.
DomicilioCittaTesto—vuotocittadomDomicilio città.
DomicilioProvinciaTesto—vuotoprovdomDomicilio provincia.
IBANTesto—vuotoibanIBAN.
CapNascitaTesto—vuotocapnascCAP nascita.
CittaNascitaTesto—vuotocittanascCittà nascita.
ProvinciaNascitaTesto—vuotoprovnascProvincia nascita.
DataDiNascitaData e ora—nessuna datadatanascData di nascita.
SessoTesto—vuotosessoSesso.
CodiceFiscaleTesto—vuotocodicefiscaleCodice fiscale.
TitoloTesto—vuototitoloTitolo.
RepartoTesto—vuotorepartoReparto. Codice dell'archivio Reparti.
CostoOraDecimale—0costooraCosto ora.
IDSigilloTesto—vuotoidsigilloID sigillo.
IDNumeroSigilloTesto—vuotoidnumsigilloID numero sigillo.
CategoriaTesto—vuotocategoriaCodice della categoria a cui appartiene il record.
AccountTesto—vuotoaccountAccount.
ExportPalmareVero/falso—falseexportpalmareExport palmare.
ListDipendentiCondizioniEconomicheDipendentiCondizioniEconomiche—oggetto vuoto—Elenco dipendenti condizioni economiche.
ListDipendentiCondizioniEconomicheCategorieProvvigionaliElenco di DipendentiCondizioniEconomicheCategorieProvvigionali—elenco vuoto—Dipendenti condizioni economiche categorie provvigionali: elenco di oggetti DipendentiCondizioniEconomicheCategorieProvvigionali.
ListDipendentiCondizioniEconomicheScaglioniElenco di DipendentiCondizioniEconomicheScaglioni—elenco vuoto—Dipendenti condizioni economiche scaglioni: elenco di oggetti DipendentiCondizioniEconomicheScaglioni.
ListDipendentiImportOrdiniElenco di DipendentiImportOrdini—elenco vuoto—Dipendenti import ordini: elenco di oggetti DipendentiImportOrdini.
ListDipendentiListiniAssociatiElenco di Testo—elenco vuotocodlistinoElenco dipendenti listini associati.
ListDipendentiAttestatiElenco di Testo—elenco vuotocodattestatiElenco dipendenti attestati.
ListDipendentiContrattiElenco di DipendentiContratti—elenco vuoto—Dipendenti contratti: elenco di oggetti DipendentiContratti.
ListDipendentiFerieElenco di DipendentiFerie—elenco vuoto—Dipendenti ferie: elenco di oggetti DipendentiFerie.
ListDipendentiComunicazioniElenco di DipendentiComunicazioni—elenco vuoto—Dipendenti comunicazioni: elenco di oggetti DipendentiComunicazioni.

Classe annidata DipendentiCondizioniEconomiche

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
TipoCalcoloTesto—vuotoModalità di calcolo.
TipoMaturazioneTesto—vuotoTipo maturazione.
BonusAcquisizioneClientiVero/falso—falseBonus acquisizione clienti.
BonusAcquisizioneClientiNumeroClientiIntero—0Bonus acquisizione clienti numero clienti.
BonusAcquisizioneClientiImportoNumeroClientiDecimale—0Bonus acquisizione clienti importo numero clienti.

Classe annidata DipendentiCondizioniEconomicheCategorieProvvigionali

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
CategoriaProvvigionaleTesto—vuotoCategoria provvigionale. Codice dell'archivio Categorie provvigionali.
PercentualeDecimale—0Percentuale.
DaPercentualeScontoDecimale—0Da percentuale sconto.
APercentualeScontoDecimale—0A percentuale sconto.

Classe annidata DipendentiCondizioniEconomicheScaglioni

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
DaImportoDecimale—0Da importo.
AImportoDecimale—0A importo.
PercentualeDecimale—0Percentuale.

Classe annidata DipendentiImportOrdini

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
TipoTesto—vuotoTipo.
DepositoTesto—vuotoCodice del deposito. Codice dell'archivio Depositi.

Classe annidata DipendentiContratti

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
DataContrattoData e ora—nessuna dataData contratto.
DataInizioData e ora—nessuna dataData di inizio.
DataFineData e ora—nessuna dataData di fine.
DataAvvisoData e ora—nessuna dataData avviso.
NonAvvisareVero/falso—falseNon avvisare.
RiferimentoNumeroTesto—vuotoRiferimento numero.
TipologiaContrattoTesto—vuotoTipologia contratto.
DescrizioneTesto—vuotoDescrizione del record, mostrata nel gestionale e sul sito.
ListaFileAllegatiElenco di ImageTrasmission—elenco vuotoFile allegati.

Classe annidata DipendentiFerie

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
TipoTesto—"f"Tipo.
DaDataData e ora—nessuna dataDa data.
ADataData e ora—nessuna dataA data.
DaOraData e ora—nessuna dataOra di inizio.
AOraData e ora—nessuna dataOra di fine.
MotivoTesto—vuotoMotivo.
MotivoDescrizioneTesto—vuotoDescrizione di Motivo, riportata per comodità di chi legge.
DescrizioneTesto—vuotoDescrizione del record, mostrata nel gestionale e sul sito.
ListaFileAllegatiElenco di ImageTrasmission—elenco vuotoFile allegati.

Classe annidata DipendentiComunicazioni

Elemento usato dentro Dipendenti. I suoi campi si inviano e si ricevono insieme al record principale.

CampoTipoObbligatorioPredefinitoA cosa serve
DataData e ora—nessuna dataData.
TitoloTesto—vuotoTitolo.
CorpoTesto—vuotoCorpo.
ListaFileAllegatiElenco di ImageTrasmission—elenco vuotoFile allegati.

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": 30,
  "GuidPC": "gestionale-01",
  "AllInsert": false,
  "ObjectListDipendenti": [
    {
      "Codice": "COD001",
      "Nome": "Esempio",
      "Cognome": "ESEMPIO",
      "DataAssunzione": "2026-03-15T00:00:00",
      "DataFineRapporto": "2026-03-15T00:00:00",
      "Telefono1": "ESEMPIO"
    }
  ]
}

Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.

JSON · QUERY
{
  "DataOperation": 3,
  "TypeObject": 30,
  "GuidPC": "gestionale-01",
  "SQLFilter": "Dipendenti.codice = 'COD001'",
  "QueryParameter": {
    "IgnoreImportRecord": true,
    "StartingRecord": 1,
    "LimitRecord": 100
  }
}

Cancellazione: bastano i campi chiave.

JSON · DELETE
{
  "DataOperation": 1,
  "TypeObject": 30,
  "GuidPC": "gestionale-01",
  "ObjectListDipendenti": [
    {
      "Codice": "COD001"
    }
  ]
}

Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.

PrecedenteSpedizionieriSuccessivaClienti e fornitori