MCPDocumentiR

Vista delle righe documento con articolo, famiglia, marca, quantità, prezzi, sconti e IVA

Riepilogo

Voce	Valore
Nome tecnico	MCPDocumentiR
Area	Viste MCP
Descrizione	Vista delle righe documento con articolo, famiglia, marca, quantità, prezzi, sconti e IVA
Campi chiave	customer_ID, key_documento, prg_riga
Numero di campi	74

Operazioni

Operazione	Descrizione
GET /api/resources/MCPDocumentiR	Elenco paginato, filtrabile con RecordSelection

Chiavi e obbligatorietà

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

Risorse correlate

• StoricoDocumentiR
• MCPDocumentiT
• MCPResources

Esempio di lettura

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

curl

curl -G "<BASE_URL>/api/resources/MCPDocumentiR" \
  -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("MCPDocumentiR", "key_documento='<VALORE>'"))
    Console.WriteLine(row);
// ecube: EcubeClient, vedi Esempi > C# / .NET

JavaScript

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

Note

• Ogni riga ripete i dati principali della testata (num_anno, dat_doc, cod_tipodoc, controparte e agente), così si può filtrare senza unire tabelle.
• Famiglia, sottofamiglia, gruppi e marca dell'articolo sono già sulla riga.
• La vista non contiene campi di costo o di margine, né i riferimenti al documento evaso (rifevas_*), presenti invece in StoricoDocumentiR.

È la vista più voluminosa: filtra sempre, per esempio per tipo documento, anno o famiglia.

RecordSelection=cod_tipodoc='<COD_TIPODOC>' and num_anno=<ANNO> and cod_famiglia='<COD_FAMIGLIA>'

Campi (74)

Campo	Tipo	Chiave	Nullable	Descrizione	Valori ammessi
customer_ID	int	🔑	No
key_documento	nvarchar(500)	🔑	No	Key Documento
prg_riga	int	🔑	No	Progressivo di riga fisica
num_riga	int		No	Numero riga logica per ordinamento in stampa
ind_tiporiga	nchar(1)		Sì	Indicatore tipo riga
des_tiporiga	varchar(50)		Sì	Descrizione tipo riga
cod_dep_mov	nvarchar(10)		Sì	Codice deposito movimento
des_dep_mov	nvarchar(50)		Sì	Descrizione deposito movimentato
cod_art	nvarchar(50)		Sì	Codice articolo
cod_variante	nvarchar(50)		Sì	Variante
des_articolo_riga	varchar(5000)		Sì	Descrizione articolo modificabile
cod_um_doc	nvarchar(5)		Sì	Unità misura del documento
des_um_doc	nvarchar(30)		Sì	Descrizione Unità misura del documento
qta_merce	decimal		Sì	Quantità merce
prz_merce	decimal		Sì	Prezzo unitario
prc_magg1	decimal		Sì	Maggiorazione %1
prc_magg2	decimal		Sì	Maggiorazione %2
prc_sconto1	decimal		Sì	Sconto1 %
prc_sconto2	decimal		Sì	Sconto2 %
prc_sconto3	decimal		Sì	Sconto3 %
prc_sconto4	decimal		Sì	Sconto4 %
prc_sconto5	decimal		Sì	Sconto5 %
prc_sconto6	decimal		Sì	Sconto6 %
val_merce	decimal		Sì	Valore merce
cod_tipoomag	nvarchar(10)		Sì	Codice tipo omaggio
des_tipoomag	nvarchar(50)		Sì	Descrizione tipo omaggio
prc_provvi	decimal		Sì	%Provv
prc_provvi_ca	decimal		Sì	%Provv capo area
cod_iva	nvarchar(10)		Sì	Codice Iva
des_iva	nvarchar(50)		Sì	Descrizione Iva
prc_iva	decimal		Sì	% Iva
flg_prezzo_con_iva	nvarchar(1)		Sì	Flag prezzi con IVA
num_colli	int		Sì	Numero colli
cod_cp_merce	nvarchar(10)		Sì	Codice contropartita merce
des_cp_merce	nvarchar(50)		Sì	Descrizione contropartita merce
cod_commessa	nvarchar(50)		Sì	Codice commessa
des_commessa	nvarchar(100)		Sì	Descrizione commessa
cod_famiglia	nvarchar(10)		Sì	Codice famiglia articolo
des_famiglia	nvarchar(50)		Sì	Descrizione famiglia articolo
cod_sfamiglia	nvarchar(10)		Sì	Codice sottofamiglia articolo
des_sfamiglia	nvarchar(50)		Sì	Descrizione sottofamiglia articolo
cod_grumerc	nvarchar(10)		Sì	Codice gruppo merceologico articolo
des_grumerc	nvarchar(50)		Sì	Descrizione gruppo merceologico articolo
cod_sgrumerc	nvarchar(10)		Sì	Codice sottogruppo merceologico articolo
des_sgrumerc	nvarchar(50)		Sì	Descrizione sottogruppo
cod_gruppostat1	nvarchar(10)		Sì	Codice gruppo statistico 1 articolo
des_gruppostat1	nvarchar(50)		Sì	Descrizione gruppo statistico 1 articolo
cod_gruppostat2	nvarchar(10)		Sì	Codice gruppo statistico 2 articolo
des_gruppostat2	nvarchar(50)		Sì	Descrizione gruppo statistico 2 articolo
cod_gruppostat3	nvarchar(10)		Sì	Codice gruppo statistico 3 articolo
des_gruppostat3	nvarchar(50)		Sì	Descrizione gruppo statistico 3 articolo
cod_gruppostat4	nvarchar(10)		Sì	Codice gruppo statistico 4 articolo
des_gruppostat4	nvarchar(50)		Sì	Descrizione gruppo statistico 4 articolo
cod_marca	nvarchar(10)		Sì	Codice Marca
des_marca	nvarchar(50)		Sì	Descrizione Marca
dat_cons_richiesta	datetime		Sì	Data consegna richiesta
dat_cons_confermata	datetime		Sì	Data consegna confermata
ind_stato_riga	nchar(1)		Sì	Stato evasione riga
qta_evasa	decimal		Sì	Quantità evasa
num_anno	int		No	Anno
dat_doc	datetime		No	Data Documento
cod_clifor_c	nvarchar(20)		Sì	Cod. CliFor Controparte
ind_clifor_c	nvarchar(1)		Sì	Ind. CliFor Controparte
des_ragsoc	nvarchar		Sì	Ragione Sociale Clifor Controparte
cod_gruppo_tipodoc	nvarchar(10)		Sì	Codice gruppo documento
des_gruppo_tipodoc	nvarchar(50)		Sì	Descrizione gruppo documento
cod_tipodoc	nvarchar(15)		No	Codice tipo documento
des_tipodoc	nvarchar(100)		Sì	Descrizione tipo documento
cod_agente	nvarchar(20)		Sì	Cod. Agente
des_agente	nvarchar(50)		Sì	Descrizione Agente
ts_update	timestamp		No
flg_isdeleted	bit		No
dat_ultvar	datetime2		Sì
Id	int		No

Fonti

• Guida campi: https://api.e-cube.it/Guide/Details?res=MCPDocumentiR