Scadenze dei documenti: le rate di pagamento generate dai documenti. Nel web service è il tipo DOCUMENTISCADENZE (valore 53 di DataType); gli oggetti sono della classe DocumentScadenze e viaggiano nella lista ObjectListDocumentScadenze della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | DOCUMENTISCADENZE = 53 |
| Classe | DocumentScadenze |
| Lista nella richiesta e nella risposta | ObjectListDocumentScadenze |
| Tabella letta da QUERY | DocumentiScadenze — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | DocTipo + DocEsercizio + DocSerie + DocRegistro + DocNumero + DocTipoControparte + DocControparte + DocProgressivo — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | DocTipo|DocEsercizio|DocSerie|DocRegistro|DocNumero|DocTipoControparte|DocControparte|DocProgressivo |
| Chiave per le conferme di ricezione | DocTipo|DocEsercizio|DocSerie|DocRegistro|DocNumero|DocControparte|DocTipoControparte|DocProgressivo — come si usa |
| Controlli prima del salvataggio | DocTipo: «Tipo documento non specificato»
DocEsercizio: «Esercizio documento non specificato»
DocNumero: «Numero documento non specificato»
DocTipoControparte: «Tipo controparte non specificato»
DocControparte: «Controparte non specificato»
Data: «Data non specificata» |
I campi di DocumentScadenze
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 |
|---|
DocTipo | Testo | Chiave, sì | vuoto | tipo | Doc tipo. Se manca il server risponde «Tipo documento non specificato». |
DocEsercizio | Testo | Chiave, sì | vuoto | esercizio | Doc esercizio. Se manca il server risponde «Esercizio documento non specificato». |
DocSerie | Testo | Chiave | vuoto | serie | Doc serie. |
DocRegistro | Testo | Chiave | vuoto | reg | Doc registro. |
DocNumero | Decimale | Chiave, sì | 0 | numero | Doc numero. Se manca il server risponde «Numero documento non specificato». |
DocTipoControparte | Testo | Chiave, sì | vuoto | tipoclifor | Doc tipo controparte. Se manca il server risponde «Tipo controparte non specificato». |
DocControparte | Testo | Chiave, sì | vuoto | controparte | Doc controparte. Se manca il server risponde «Controparte non specificato». |
DocProgressivo | Intero lungo | Chiave | 0 | progressivo | Doc progressivo. |
TipoScadenza | Testo | — | vuoto | tiposcadenza | Tipo scadenza. |
TipoScadenzaPA | Testo | — | "MP05" | tiposcadenzapa | Tipo scadenza PA. |
Data | Data e ora | Sì | nessuna data | data | Data. Se manca il server risponde «Data non specificata». |
Importo | Decimale | — | 0 | importo | Importo. |
GeneraIncasso | Vero/falso | — | false | generaincasso | Genera incasso. |
ContropartitaIncasso | Testo | — | vuoto | controincasso | Contropartita incasso. |
SezioneContabileIncasso | Testo | — | vuoto | sezcontincasso | Sezione contabile incasso. |
Trasmesse | Vero/falso | — | false | esportate | Trasmesse. |
DataTrasmissione | Data e ora | — | nessuna data | dataesport | Data trasmissione. |
Classificazione | Testo | — | vuoto | classificazione | Codice della classificazione. |
NonAvvisareAlert | Vero/falso | — | false | nonavvisarealert | Non avvisare alert. |
SoloStampa | Vero/falso | — | false | solostampa | Solo stampa. |
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": 53,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListDocumentScadenze": [
{
"DocTipo": "COD001",
"DocEsercizio": "COD002",
"DocSerie": "COD003",
"DocRegistro": "COD004",
"DocNumero": 1,
"DocTipoControparte": "COD005",
"DocControparte": "COD006",
"DocProgressivo": 1,
"TipoScadenza": "ESEMPIO",
"Data": "2026-03-15T00:00:00"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 53,
"GuidPC": "gestionale-01",
"SQLFilter": "DocumentiScadenze.Tipo = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 53,
"GuidPC": "gestionale-01",
"ObjectListDocumentScadenze": [
{
"DocTipo": "COD001",
"DocEsercizio": "COD002",
"DocSerie": "COD003",
"DocRegistro": "COD004",
"DocNumero": 1,
"DocTipoControparte": "COD006",
"DocControparte": "COD007",
"DocProgressivo": 1
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.