Articoli

Anagrafica articoli

Riepilogo

Voce	Valore
Nome tecnico	Articoli
Area	Articoli e classificazioni
Descrizione	Anagrafica articoli
Campi chiave	customer_ID, cod_art, cod_variante
Numero di campi	130

Operazioni

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

Chiavi e obbligatorietà

• Campi chiave: customer_ID, cod_art, cod_variante. 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.

[
  {
    "cod_art": "<nvarchar(50)>",
    "cod_variante": "<nvarchar(50)>",
    "flg_isdeleted": "<bit>"
  }
]

Risorse correlate

• Famiglia
• Sottofamiglia
• MarcaArticoli
• AliquoteIva
• StoricoDocumentiR
• MCPArticoli

Esempio di lettura

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

curl

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

C#

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

JavaScript

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

Campi (130)

Campo	Tipo	Chiave	Nullable	Descrizione	Valori ammessi
customer_ID	int	🔑	No
cod_art	nvarchar(50)	🔑	No	Cod. Articolo
cod_variante	nvarchar(50)	🔑	No	Cod. Variante
ind_tiporiga	nchar(1)		Sì	Tipo Riga
des_articolo	nvarchar(500)		Sì	Des. Articolo
cod_interno	nvarchar(30)		Sì	Alias
cod_um	nvarchar(5)		Sì	Um
cod_um2	nvarchar(5)		Sì	Um2
cod_um_ven	nvarchar(5)		Sì	Um Ven.
cod_um_acq	nvarchar(5)		Sì	Um Acq.
des_articolo_ex	varchar(-1)		Sì	Des. Estesa
des_ubicazione	nvarchar(60)		Sì	Ubicazione
cod_tipoomag_ven	nvarchar(2)		Sì	Cod. Tipo Omag. Ven.
des_tipoomag_ven	nvarchar(50)		Sì
cod_tipoomag_acq	nvarchar(2)		Sì	Cod. Tipo Omag. Acq.
des_tipoomag_acq	nvarchar(50)		Sì
cod_iva_ven	nvarchar(10)		Sì	Cod. Iva Ven.
des_iva_ven	nvarchar(50)		Sì
cod_iva_acq	nvarchar(10)		Sì	Cod. Iva Acq.
des_iva_acq	nvarchar(50)		Sì
cod_linea	nvarchar(20)		Sì	Cod. Linea
cod_gruppostat1	nvarchar(10)		Sì	Cod. Gruppo 1 Stat.
des_gruppostat1	nvarchar(50)		Sì
cod_gruppostat2	nvarchar(10)		Sì	Cod. Gruppo 2 Stat.
des_gruppostat2	nvarchar(50)		Sì
cod_gruppostat3	nvarchar(10)		Sì	Cod. Gruppo 3 Stat.
des_gruppostat3	nvarchar(50)		Sì
cod_gruppostat4	nvarchar(10)		Sì	Cod. Gruppo 4 Stat.
des_gruppostat4	nvarchar(50)		Sì
cod_provenienza	nvarchar(10)		Sì	Cod. Provenienza
cod_marca	nvarchar(20)		Sì	Cod. Marca
cod_gruppofiscale	nvarchar(10)		Sì	Cod. Gruppo Fiscale
cod_tipoprodotto	nvarchar(10)		Sì	Cod. Tipo Prodotto
cod_famiglia	nvarchar(10)		Sì	Cod. Famiglia
des_famiglia	nvarchar(50)		Sì
cod_sfamiglia	nvarchar(10)		Sì	Cod. Sotto Fam.
des_sfamiglia	nvarchar(50)		Sì
cod_grumerc	nvarchar(10)		Sì	Cod. Gr. Mec.
des_grumerc	nvarchar(50)		Sì
cod_sgrumerc	nvarchar(10)		Sì	Cod. Sotto Gr. Mec.
des_sgrumerc	nvarchar(50)		Sì
flg_gest_lotti	nchar(1)		Sì	Gestione Lotti ?
flg_gest_matr	nchar(1)		Sì	Gestione Matricole ?
qta_pes_lordo_kg	decimal		Sì	Peso Lordo Kg
qta_pes_netto_kg	decimal		Sì	Peso Netto Kg
qta_min_ordin	decimal		Sì	Qtà Min. Ord.
qta_max_ordin	decimal		Sì	Qtà Max Ord.
qta_scorta_min	decimal		Sì	Qtà Scorta Min.
qta_scorta_max	decimal		Sì	Qtà Scorta Max
qta_lotto_riord	decimal		Sì	Qtà Lotto Riord.
dim_volume_colli	decimal		Sì	Volume Colli
cod_gencod_lotti	nvarchar(10)		Sì	Cod. Gen. Lotto
cod_gencod_matri	nvarchar(10)		Sì	Cod. Gen. Matricola
flg_gest_commesse	nvarchar(1)		Sì	Gestione Commesse ?
cod_abc_rimanenze	nvarchar(10)		Sì	Cod. ABC Rimanenze
cod_abc_vendite	nvarchar(10)		Sì	Cod. ABC Vendite
cod_abc_acquisti	nvarchar(10)		Sì	Cod. ABC Acquisti
cod_abc_produzione	nvarchar(10)		Sì	Cod. ABC Produzione
dat_inizio_lotti	datetime		Sì	Data inizio gestione lotti
dat_obsoleto	datetime		Sì	Obsoleto dal
flg_conf_var	nvarchar(1)		Sì	Confez. Variabile ?
flg_art_alt	nvarchar(1)		Sì	Prelievo Alternativo Possibile ?	N=Non definito · A=Articolo Base · C=Categoria omogenea · G=Gruppo Merc. · S=Sotto Gruppo Merc. · U=Unita Misura
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ì
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ì
flg_isdeleted	bit		No	Eliminato
cod_conto_acq	char(10)		Sì
cod_conto_ven	char(10)		Sì
dat_uca_acquis	datetime		Sì
dat_upv_vendit	datetime		Sì
val_uca_acquis	decimal		Sì
val_upv_vendit	decimal		Sì
MOD_priorita	int		Sì
dat_inizio_matricole	datetime		Sì	Data inizio gestione matricole
dat_sync_tsec	datetime		Sì	Sync TsCloud
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
flg_isarticolokit	bit		Sì	Articolo kit
des_nomcom_intra	varchar(8)		Sì	Nomenclatura INTRA
ind_um_intra	decimal		Sì	Ind. UM INTRA
val_massa_intra	decimal		Sì	Massa intra
cod_nazori_intra	nvarchar(10)		Sì	Nazione origine INTRA
ind_stato_art	nchar(2)		Sì	Ind. stato articolo
des_stato_art	nvarchar(40)		Sì	Des. stato articolo
des_note	nvarchar(-1)		Sì	Note articolo
CIC_id	varchar(50)		Sì	Id Teamsystem 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=Articoli
• Specifica OpenAPI ufficiale: api.e-cube.it/swagger/docs/v1