Pagamenti: le condizioni di pagamento con scadenze, spese e metodi abilitati sul sito. Nel web service è il tipo PAGAMENTI (valore 31 di DataType); gli oggetti sono della classe Pagamenti e viaggiano nella lista ObjectListPagamenti della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | PAGAMENTI = 31 |
| Classe | Pagamenti |
| Lista nella richiesta e nella risposta | ObjectListPagamenti |
| Tabella letta da QUERY | Pagamenti — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | Codice |
| Chiave per le conferme di ricezione | Codice — come si usa |
| Controlli prima del salvataggio | Codice: «Codice non specificato»
Descrizione: «Descrizione non specificato» |
I campi di Pagamenti
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 |
|---|
Codice | Testo | Chiave, sì | vuoto | codice | Codice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato». |
Descrizione | Testo | Sì | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. Se manca il server risponde «Descrizione non specificato». |
CalcoloSpese | Vero/falso | — | false | calcolospese | Calcolo spese. |
TipoCalcolo | Testo | — | vuoto | tipocalc | Modalità di calcolo. |
ValoreCalcolo | Decimale | — | 0 | valcalc | Valore calcolo. |
VoceSpesa | Intero | — | 0 | vocespesa | Voce spesa. |
TipoRimesse | Testo | — | vuoto | tiporimesse | Tipo rimesse. |
Sconto | Decimale | — | 0 | sconto | Sconto. |
RichiediContoAziendale | Vero/falso | — | false | ricconto | Richiedi conto aziendale. |
ControllaFido | Vero/falso | — | false | controllafido | Controlla fido. |
AbilitaVenditaWEB | Vero/falso | — | false | abilitavendweb | Abilita vendita web. |
AbilitaVenditaBanco | Vero/falso | — | false | abilitavendbanc | Abilita vendita banco. |
CalcoloGiorni | Testo | — | vuoto | calcologiorni | Calcolo giorni. |
MesiEsclusi | Testo | — | vuoto | mesiescl | Mesi esclusi. |
GiornoMeseSuccessivo | Intero | — | 0 | giornomesesucc | Giorno mese successivo. |
GiornoMeseSuccessivoEsclusi | Intero | — | 0 | giornomesesuccnoescl | Giorno mese successivo esclusi. |
AggiungiGiornoAScadenza | Intero | — | 0 | giornoaddscad | Aggiungi giorno a scadenza. |
AbilitaBancaClienteFornitori | Vero/falso | — | false | abilitabancaclifor | Abilita banca cliente fornitori. |
AbilitaPaypal | Vero/falso | — | false | abilitapaypal | Abilita PayPal. |
AbilitaGooglePay | Vero/falso | — | false | abilitagooglepay | Abilita Google pay. |
AbilitaKlarna | Vero/falso | — | false | abilitaklarna | Abilita Klarna. |
AbilitaNexi | Vero/falso | — | false | abilitanexi | Abilita Nexi. |
AbilitaCarta | Vero/falso | — | false | abilitacarta | Abilita carta. |
Tipocarta | Testo | — | vuoto | tipocarta | Tipocarta. |
UsernameCarta | Testo | — | vuoto | usernamecarta | Username carta. |
PasswordCarta | Testo | — | vuoto | passwordcarta | Password carta. |
Note | Testo | — | vuoto | note | Note libere. |
ValoreScontrino | Testo | — | vuoto | valorescontrino | Valore scontrino. |
AbilitaClienteGestitoDirettamente | Vero/falso | — | false | abilitaclientegestito | Abilita cliente gestito direttamente. |
ListaCorpo | Elenco di PagamentiCorpo | — | elenco vuoto | — | Corpo: elenco di oggetti PagamentiCorpo. |
Classe annidata PagamentiCorpo
Elemento usato dentro Pagamenti. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
Tipologia | Testo | — | vuoto | Tipologia. |
InizioRimessa | Testo | — | vuoto | Inizio rimessa. |
NumeroGiorni | Intero | — | 0 | Numero giorni. |
ValoreRata | Decimale | — | 0 | Valore rata. |
ArrotondamentoData | Testo | — | vuoto | Arrotondamento data. |
GeneraIncassoContestuale | Vero/falso | — | false | Genera incasso contestuale. |
SottocontoIncasso | Testo | — | vuoto | Sottoconto incasso. |
SezioneContabileIncasso | Testo | — | vuoto | Sezione contabile incasso. |
Classificazione | Testo | — | vuoto | Codice della classificazione. |
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": 31,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListPagamenti": [
{
"Codice": "COD001",
"Descrizione": "Descrizione di esempio",
"CalcoloSpese": false,
"TipoCalcolo": "ESEMPIO",
"ValoreCalcolo": 1,
"VoceSpesa": 1
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 31,
"GuidPC": "gestionale-01",
"SQLFilter": "Pagamenti.codice = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 31,
"GuidPC": "gestionale-01",
"ObjectListPagamenti": [
{
"Codice": "COD001"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.