CliFor

Anagrafica clienti e fornitori

Riepilogo

Voce	Valore
Nome tecnico	CliFor
Area	Clienti e fornitori
Descrizione	Anagrafica clienti e fornitori
Campi chiave	customer_ID, ind_clifor, cod_clifor
Numero di campi	191

Operazioni

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

Chiavi e obbligatorietà

• Campi chiave: customer_ID, ind_clifor, cod_clifor. 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.

[
  {
    "ind_clifor": "<nchar(1)>",
    "cod_clifor": "<nvarchar(20)>",
    "flg_isdeleted": "<bit>"
  }
]

Risorse correlate

• MacroCategClifor
• CategClifor
• CondPagam
• StatiEsteri
• StoricoDocumentiT
• MCPClienti
• MCPFornitori

Esempio di lettura

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

curl

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

C#

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

JavaScript

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

Note

CliFor contiene sia clienti sia fornitori, distinti da ind_clifor (C = Cliente, F = Fornitore), che fa parte della chiave. Lo stesso cod_clifor può quindi esistere come cliente e come fornitore: usa sempre la coppia ind_clifor + cod_clifor.

Per leggere solo i clienti o solo i fornitori:

RecordSelection=ind_clifor='C'

In alternativa usa le viste MCPClienti e MCPFornitori, che riportano anche le descrizioni delle classificazioni.

Campi (191)

Campo	Tipo	Chiave	Nullable	Descrizione	Valori ammessi
customer_ID	int	🔑	No
ind_clifor	nchar(1)	🔑	No	Ind. CliFor	C=Cliente · F=Fornitore
cod_clifor	nvarchar(20)	🔑	No	Cod. CliFor
des_ragsoc	nvarchar(60)		Sì	Ragione Sociale
cod_cfisc	nvarchar(50)		Sì	Cod. Fisc.
cod_piva	nvarchar(50)		Sì	P.Iva
cod_lingua	nvarchar(10)		Sì	Cod. Lingua
des_lingua	nvarchar(50)		Sì
cod_valuta	nvarchar(10)		Sì	Cod. Valuta
des_valuta	nvarchar(50)		Sì
des_contatto	nvarchar(40)		Sì	Contatto
des_email1	nvarchar(255)		Sì	Email1
des_email2	nvarchar(255)		Sì	Email2
des_url	nvarchar(255)		Sì	Sito Web
flg_pers_fis	nvarchar(1)		Sì	Pers. Fisica?
des_cogn	nvarchar(30)		Sì	Cognome
des_nome	nvarchar(30)		Sì	Nome
ind_sesso	nchar(1)		Sì	Sesso	M=Maschio · F=Femmina
dat_nasc	datetime		Sì	Data Nascita
des_localita_nasc	nvarchar(100)		Sì	Località Nascita
sig_prov_nasc	nvarchar(3)		Sì	Prov. Nascita
cod_cap_nasc	nvarchar(10)		Sì	Cap Nascita
cod_naz_nasc	nvarchar(10)		Sì	Cod. Naz. Nascita
des_naz_nasc	nvarchar(50)		Sì
des_indir_res	nvarchar(255)		Sì	Indirizzo Residenza
sig_tel_res	nvarchar(18)		Sì	Telefono Res.
sig_tel1_res	nvarchar(18)		Sì	Telefono Res.1
cod_localita_res	nvarchar(4)		Sì	Cod. comune
des_localita_res	nvarchar(100)		Sì	Località Residenza
sig_tel2_res	nvarchar(18)		Sì	Telefono Res.2
sig_fax_res	nvarchar(18)		Sì	Fax. Res.
cod_cap_res	nvarchar(10)		Sì	Cap. Res.
sig_fax1_res	nvarchar(18)		Sì	Fax. Res. 1
sig_prov_res	nvarchar(3)		Sì	Prov. Res.
cod_naz_res	nvarchar(10)		Sì	Cod. Naz. Res.
des_naz_res	nvarchar(50)		Sì
des_indir_fis	nvarchar(255)		Sì	Indirizzo Fiscale
sig_tel_fis	nvarchar(18)		Sì	Telefono Fis.
sig_tel1_fis	nvarchar(18)		Sì	Telefono Fis. 1
sig_tel2_fis	nvarchar(18)		Sì	Telefono Fis. 2
sig_fax_fis	nvarchar(18)		Sì	Fax Fis.
sig_fax1_fis	nvarchar(18)		Sì	Fax Fis. 1
cod_localita_fis	nvarchar(4)		Sì	Cod. comune fis.
des_localita_fis	nvarchar(100)		Sì	Località Fiscale
cod_cap_fis	nvarchar(10)		Sì	Cap Fis.
sig_prov_fis	nvarchar(3)		Sì	Prov. Fis.
cod_naz_fis	nvarchar(10)		Sì	Cod. Naz. Fis.
des_naz_fis	nvarchar(50)		Sì
cod_regione	nvarchar(10)		Sì	Cod. Regione
des_regione	nvarchar(50)		Sì
des_note	nvarchar(-1)		Sì	Note
cod_iva	nvarchar(10)		Sì	Cod. Iva
des_iva	nvarchar(50)		Sì
ind_venacq	nchar(1)		Sì	Ind. Vend./Acq.	V=Vendita · A=Acquisto · G=Generico
cod_listino	nvarchar(10)		Sì	Cod. Listino
des_listino	nvarchar(50)		Sì
cod_macrocat	nvarchar(10)		Sì	Cod. Macrocateg.
des_macrocat	nvarchar(50)		Sì
cod_categ	nvarchar(10)		Sì	Cod. Categoria
des_categ	nvarchar(50)		Sì
cod_sottocateg	nvarchar(10)		Sì	Cod. Sotto Categ.
des_sottocateg	nvarchar(50)		Sì
cod_gruppocf1	nvarchar(10)		Sì	Cod. Ragg. CliFor
des_gruppocf1	nvarchar(50)		Sì
cod_gruppocf2	nvarchar(10)		Sì	Cod. Ragg. CliFor 2
des_gruppocf2	nvarchar(50)		Sì
cod_gruppocf3	nvarchar(10)		Sì	Cod. Ragg. CliFor 3
des_gruppocf3	nvarchar(50)		Sì
cod_pag	nvarchar(10)		Sì	Cod. Pagamento
des_pag	nvarchar(50)		Sì
num_mese_escl1	int		Sì	Primo mese escluso	1=Gennaio · 2=Febbraio · 3=Marzo · 4=Aprile · 5=Maggio · 6=Giugno · 7=Luglio · 8=Agosto · 9=Settembre · 10=Ottobre · 11=Novembre · 12=Dicembre
num_mese_escl2	int		Sì	Secondo mese escluso	1=Gennaio · 2=Febbraio · 3=Marzo · 4=Aprile · 5=Maggio · 6=Giugno · 7=Luglio · 8=Agosto · 9=Settembre · 10=Ottobre · 11=Novembre · 12=Dicembre
num_gio_mese_suc1	int		Sì	Giorno successivo al primo mese escluso	1=Lunedi · 2=Martedì · 3=Mercoledì · 4=Giovedì · 5=Venerdì · 6=Sabato · 7=Domenica
num_gio_mese_suc2	int		Sì	Giorno successivo al secondo mese escluso	1=Lunedi · 2=Martedì · 3=Mercoledì · 4=Giovedì · 5=Venerdì · 6=Sabato · 7=Domenica
num_gio_chiusura	int		Sì	Giono Chiusura	1=Lunedi · 2=Martedì · 3=Mercoledì · 4=Giovedì · 5=Venerdì · 6=Sabato · 7=Domenica
cod_macroarea	nvarchar(10)		Sì	Cod. Macro Area
des_macroarea	nvarchar(50)		Sì
cod_area	nvarchar(10)		Sì	Cod. Area
des_area	nvarchar(50)		Sì
cod_zona	nvarchar(10)		Sì	Cod. Zona
des_zona	nvarchar(50)		Sì
cod_banca1	nvarchar(10)		Sì	Cod. Banca
cod_agenzia1	nvarchar(10)		Sì	Cod. Agenza
sig_iban1	nvarchar(34)		Sì	Iban
sig_bban1	nvarchar(30)		Sì	Bban
sig_ccbanc1	nvarchar(20)		Sì	Conto Corrente
prc_sco1	decimal		Sì	% Sc. 1
prc_sco2	decimal		Sì	% Sc. 2
cod_agenzia_azi	nvarchar(20)		Sì	Cod. Banca Azienda
cod_asp_beni	nvarchar(10)		Sì	Cod. Asp. Beni
cod_mezzo_trasp	nvarchar(10)		Sì	Cod. Mezzo Trasp.
des_mezzo_trasp	nvarchar(50)		Sì
cod_porto	nvarchar(10)		Sì	Cod. Porto
des_porto	nvarchar(50)		Sì
cod_vettore	nvarchar(20)		Sì	Cod. Vettore
des_vettore	nvarchar(50)		Sì
cod_agente	nvarchar(20)		Sì	Cod. Agente
des_agente	nvarchar(50)		Sì
flg_addebito_bollo	nchar(1)		Sì	Addebito Bolli?
flg_addebito_spese	nchar(1)		Sì	Addebito Spese?
val_spese_inc	decimal		Sì	Valore spese di incasso
cod_iva_spese_inc	nvarchar(10)		Sì	Codice iva spese incasso
flg_stp_prz_bolla	nchar(1)		Sì	Stampa prezzo in bolla?
flg_scrp_fin_fat	nchar(1)		Sì	Scorpo Fine Fattura?
cod_testo	nvarchar(10)		Sì	Cod. Testo
ind_fido_impegni	nchar(1)		Sì	Ctrl Fido su Impegni?	0=no · 1=Si totale · 2=Con avviso
ind_bloccato	nchar(1)		Sì	Cliente Bloccato ?	0=No · 1=Si
ind_fido_doc_evas	nchar(1)		Sì	Ctrl Fido su Vendite?	0=no · 1=Si totale · 2=Con avviso
val_fido	decimal		Sì	Valore Fido
num_priorita_evas	int		Sì	Priorità Evasione
cod_gruppo_tipodoc	nvarchar(3)		Sì	Cod. Gruppo Doc.
des_gruppo_tipodoc	nvarchar(50)		Sì
cod_tipodoc	nvarchar(50)		Sì	Cod. Tipo Doc.
des_tipodoc	nvarchar(50)		Sì
ind_gest_omaggio	nchar(1)		Sì	Gest. Omaggi	0=Omaggi ammessi · 1=Omaggi non ammessi
cod_idest	nvarchar(36)		Sì	Id destinatario
dat_ini_b2b	datetime		Sì	Data inizio
ind_mod_invio_hub	nchar(1)		Sì	Modalità invio
des_email_pec_fe	nvarchar(255)		Sì	PEC e-mail
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ì
des_campo_libero13	nvarchar(255)		Sì
des_campo_libero14	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ì
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_esterno	nvarchar(128)		Sì	Codice esterno
cod_utente_cre_ERP	nvarchar(20)		Sì	Nome utente
dat_utente_cre_ERP	datetime		Sì	Data di creazione
cod_utente_mod_ERP	nvarchar(20)		Sì	Nome utente
dat_utente_mod_ERP	datetime		Sì	Data ultima modifica
cod_caurit	nvarchar(5)		Sì	Cod. causale rit.
dat_obsoleto	datetime		Sì	Data Obsoleto
flg_isdeleted	bit		No	Eliminato
dat_sync_tsec	datetime		Sì	Sync TsCloud
id_anaggen_tsec	int		Sì	Id anag. gen
id_clifor_tsec	int		Sì	Id clifor
dat_lastchange_tsec	datetime		Sì	LAstchange
cod_classif1	nvarchar(10)		Sì	Codice classificazione 1
cod_classif2	nvarchar(10)		Sì	Codice classificazione 2
cod_classif3	nvarchar(10)		Sì	Codice classificazione 3
cod_classif4	nvarchar(10)		Sì	Codice classificazione 4
cod_classif5	nvarchar(10)		Sì	Codice classificazione 5
cod_conto_cpart	varchar(10)		Sì	Conto contabile
cod_gruppo_cpart	decimal		Sì	Codice Pdc
cod_classifrs	varchar(10)		Sì	Cod. IFRS 15
des_classifrs	nvarchar(80)		Sì	Descr. IFRS 15
dat_creazione	datetime		Sì	Data Creazione
AgentiClienti	list		Sì	Elenco Agenti Clienti
cod_intermedio	nchar(10)		Sì
CIC_id	nvarchar(50)		Sì	Id Cassa in Cloud
ts_update	timestamp		No
dat_ultvar	datetime2		Sì
Id	int		No

Fonti

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