StoricoDocumentiT

Testate documento del gestionale

Riepilogo

Voce	Valore
Nome tecnico	StoricoDocumentiT
Area	Documenti
Descrizione	Testate documento del gestionale
Campi chiave	customer_ID, key_documento
Numero di campi	138

Operazioni

Operazione	Descrizione
GET /api/resources/StoricoDocumentiT	Elenco paginato, filtrabile con RecordSelection
GET /api/sync/StoricoDocumentiT?LastUtcRun=…	Record variati dopo la data indicata
POST /api/sync/StoricoDocumentiT	Invio di un array di record

Chiavi e obbligatorietà

• Campi chiave: customer_ID, key_documento. customer_ID identifica il tenant.
• Obbligatori oltre alle chiavi: flg_isdeleted.
• Id, ts_update e dat_ultvar sono gestiti dalla piattaforma.

Struttura minima di un record

Campi chiave e obbligatori, con il tipo indicato dalla guida al posto del valore.

[
  {
    "key_documento": "<nvarchar(500)>",
    "flg_isdeleted": "<bit>"
  }
]

Risorse correlate

• StoricoDocumentiR
• CodiciDocumento
• GruppiDocumento
• CliFor
• CondPagam
• MCPDocumentiT

Esempio di lettura

Il filtro su key_documento è un esempio: sostituisci i segnaposto <…>.

curl

curl -G "<BASE_URL>/api/resources/StoricoDocumentiT" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  --data-urlencode "PageSize=100" --data-urlencode "PageNumber=1" \
  --data-urlencode "RecordSelection=key_documento='<VALORE>'"

C#

await foreach (var row in ecube.ReadAllAsync("StoricoDocumentiT", "key_documento='<VALORE>'"))
    Console.WriteLine(row);
// ecube: EcubeClient, vedi Esempi > C# / .NET

JavaScript

for await (const row of readAll("StoricoDocumentiT", "key_documento='<VALORE>'")) console.log(row);
// readAll: vedi Esempi > JavaScript

Note

Testata e righe in un'unica chiamata

Le righe viaggiano nell'array StoricoDocumentiR di ogni testata e ripetono la key_documento della testata. Un invio con POST /api/sync/StoricoDocumentiT pubblica quindi documento e righe insieme.

Chiave del documento

key_documento è la chiave assegnata dal sistema che invia il documento: deve essere univoca nel tenant e collega la testata alle sue righe.

Controparte

ind_clifor_c e cod_clifor_c identificano il cliente o il fornitore del documento, con la stessa chiave di CliFor.

Campi (138)

Campo	Tipo	Chiave	Nullable	Descrizione	Valori ammessi
customer_ID	int	🔑	No
key_documento	nvarchar(500)	🔑	No	Chiave
cod_gruppo_tipodoc	nvarchar(10)		Sì	Gruppo doc.
cod_tipodoc	nvarchar(15)		Sì	Codice doc.
num_anno	int		Sì	Anno
cod_stato_doc	nvarchar(10)		Sì	Stato doc.
cod_flusso_stato	nvarchar(10)		Sì
sig_serie_doc	nvarchar(4)		Sì	Sezione
des_num_doc	nvarchar(15)		Sì	Numero
num_prot	decimal		Sì	Protocollo
des_numvsdoc	nvarchar(20)		Sì	Numero esterno
dat_vsdoc	datetime		Sì	Data doc esterno
des_notevsdoc	nvarchar(240)		Sì	Note doc esterno
ind_doc_bis	nvarchar(1)		Sì	Bis
dat_doc	datetime		Sì	Data doc
dat_movimento	datetime		Sì	Data mov
ind_clifor_c	nvarchar(1)		Sì	C/F
cod_clifor_c	nvarchar(20)		Sì	Codice cli/for
cod_banca	nvarchar(20)		Sì	Banca appoggio
cod_agenzia	nvarchar(20)		Sì	Agenzia appoggio
cod_agenzia_azi	nvarchar(20)		Sì	Canalizzazione
cod_iva	nvarchar(20)		Sì	Codice IVA
cod_pag	nvarchar(20)		Sì	Cod. pagam.
cod_caumag	nvarchar(10)		Sì	Causale mag.
cod_dep_mov	nvarchar(10)		Sì	Deposito
cod_dep_c	nvarchar(10)		Sì	Deposito collegato
cod_valuta	nvarchar(10)		Sì	Valuta
cod_agente	nvarchar(20)		Sì	Agente
cod_listino	nvarchar(4)		Sì	Listino
val_spese_tra	decimal		Sì
val_spese_tra_val	decimal		Sì
val_spese_acc	decimal		Sì
val_spese_acc_val	decimal		Sì
val_spese_inc	decimal		Sì
val_spese_inc_val	decimal		Sì
prc_sco1	decimal		Sì
prc_sco2	decimal		Sì
prc_sco3	decimal		Sì
prc_scopag	decimal		Sì
val_scmerce	decimal		Sì	Sconto merce valore
des_note	nvarchar(255)		Sì
cod_sede	nvarchar(10)		Sì
cod_mezzo_trasp	nvarchar(10)		Sì
cod_porto	nvarchar(10)		Sì
ind_stato_evas	nchar(1)		Sì	Stato evasione documento	E=Evaso totalmente · P=Parzialmente evaso · I=Da evadere
dat_evasione	datetime		Sì
des_campo_libero1	nvarchar(255)		Sì
des_campo_libero2	nvarchar(255)		Sì
des_campo_libero3	nvarchar(255)		Sì
des_campo_libero4	nvarchar(255)		Sì
des_campo_libero5	nvarchar(255)		Sì
des_campo_libero6	nvarchar(255)		Sì
des_campo_libero7	nvarchar(255)		Sì
des_campo_libero8	nvarchar(255)		Sì
des_campo_libero9	nvarchar(255)		Sì
des_campo_libero10	nvarchar(255)		Sì
des_campo_libero11	nvarchar(255)		Sì
des_campo_libero12	nvarchar(255)		Sì
val_campo_libero1	decimal		Sì
val_campo_libero2	decimal		Sì
val_campo_libero3	decimal		Sì
val_campo_libero4	decimal		Sì
val_campo_libero5	decimal		Sì
val_campo_libero6	decimal		Sì
val_campo_libero7	decimal		Sì
val_campo_libero8	decimal		Sì
val_campo_libero9	decimal		Sì
val_campo_libero10	decimal		Sì
val_campo_libero11	decimal		Sì
val_campo_libero12	decimal		Sì
dat_campo_libero1	datetime		Sì
dat_campo_libero2	datetime		Sì
dat_campo_libero3	datetime		Sì
dat_campo_libero4	datetime		Sì
dat_campo_libero5	datetime		Sì
dat_campo_libero6	datetime		Sì
dat_campo_libero7	datetime		Sì
dat_campo_libero8	datetime		Sì
dat_campo_libero9	datetime		Sì
dat_campo_libero10	datetime		Sì
ind_campo_libero1	nchar(1)		Sì
ind_campo_libero2	nchar(1)		Sì
ind_campo_libero3	nchar(1)		Sì
ind_campo_libero4	nchar(1)		Sì
ind_campo_libero5	nchar(1)		Sì
ind_campo_libero6	nchar(1)		Sì
ind_campo_libero7	nchar(1)		Sì
ind_campo_libero8	nchar(1)		Sì
ind_campo_libero9	nchar(1)		Sì
ind_campo_libero10	nchar(1)		Sì
cod_sottogruppo_tipodoc	nvarchar(3)		Sì	Sottogruppo doc.
val_cambio	decimal		Sì	Cambio valuta
val_tot_doc	decimal		Sì	Totale Documento
val_tot_doc_val	decimal		Sì	Totale Documento in valuta documento
val_tot_imp	decimal		Sì	Totale Imponibile
val_tot_imp_val	decimal		Sì	Totale Imponibile in valuta documento
val_tot_iva	decimal		Sì	Totale Imposta
val_tot_iva_val	decimal		Sì	Totale Imposta in valuta documento
val_tot_a_pagare	decimal		Sì	Totale a pagare
val_tot_a_pagare_val	decimal		Sì	Totale a pagare in valuta documento
val_tot_bolli	decimal		Sì	Totale spese bolli
val_tot_bolli_val	decimal		Sì	Totale spese bolli in valuta
val_lordo_merce	decimal		Sì
val_lordo_merce_val	decimal		Sì
val_netto_merce	decimal		Sì
val_netto_merce_val	decimal		Sì
des_rifesterno	nvarchar(500)		Sì	Riferimento esterno
ind_priorita	int		Sì	Priorità
des_notensdoc	nvarchar(240)		Sì	Note doc interno
des_rifnsdoc	nvarchar(72)		Sì	Descrizione documento interno
num_tot_colli	int		Sì	Numero totale colli
qta_peso_netto_kg	decimal		Sì	Tot. Peso Netto
qta_peso_lordo_kg	decimal		Sì	Tot. Peso Lordo
cod_vettore_1	nvarchar(20)		Sì	Cod. vettore 1
cod_cau_trasp	nvarchar(10)		Sì	Cod. causale di trasporto
cod_asp_beni	nvarchar(10)		Sì	Cod. aspetto dei beni
dat_obsoleto	datetime		Sì
flg_isdeleted	bit		No	Eliminato
StoricoDocumentiR	list		Sì
StoricoDocumentiIVA	list		Sì	IVA
dat_sync_tsec	datetime		Sì	Sync TsCloud
dat_lastchange_tsec	datetime		Sì	LAstchange
cod_utente_cre	nvarchar(50)		Sì	Utente Creaz.
dat_utente_cre	datetime		Sì	Data Utente Creaz.
cod_utente_mod	nvarchar(50)		Sì	Utente Mod.
dat_utente_mod	datetime		Sì	Data Utente Mod.
val_imppagfix	decimal		Sì	Pagamento fisso
cod_commessa	nvarchar(50)		Sì	Cod. Commessa
cod_scommessa	nvarchar(10)		Sì	Cod. Sottocommessa
cod_commessadoc	nvarchar(50)		Sì	Cod. Commessa Doc
cod_scommessadoc	nvarchar(50)		Sì	Cod. Sottocommessa Doc
cod_operatore	nvarchar(10)		Sì	Codice operatore
dat_cons_richiesta	datetime		Sì	Dt cons richiesta
dat_cons_confermata	datetime		Sì	Dt cons confermata
cod_chiave_bancheclifor	nvarchar(50)		Sì	Chiave banca cliente/fornitore
ts_update	timestamp		No
dat_ultvar	datetime2		Sì
Id	int		No

Fonti

• Guida campi: https://api.e-cube.it/Guide/Details?res=StoricoDocumentiT
• Specifica OpenAPI ufficiale: api.e-cube.it/swagger/docs/v1