Cod.	Ultima revisione	Wiki	Note
343	2019/07/29 - PG	cartpad_custom

Il Cartpad Personalizzato consente di configurare e ordinare gli elementi visualizzati nel cartpad, sostituendo la versione standard con una sequenza e una selezione di campi su misura per le esigenze del cliente. Questa funzionalità permette di mostrare solo le informazioni rilevanti e di aggiungere nuovi elementi non previsti dal cartpad standard.

Caratteristica

Tramite l'apposito setting cartpad_custom è possibile definire quali elementi visualizzare nel cartpad e in quale ordine. La personalizzazione avviene specificando una sequenza di identificativi degli elementi, separati da virgola. Solo gli elementi elencati saranno visibili nel cartpad, nell'ordine indicato.
Esempio di configurazione:
cartpad_custom => "quantity,price,price_basic"
In questo caso, il cartpad mostrerà solo i campi Quantità, Vostro prezzo e Prezzo listino base.
Per richiedere una personalizzazione, è necessario comunicare all'assistenza la sequenza desiderata degli identificativi degli elementi.
I setting specifici degli elementi continuano a influenzare il comportamento dei singoli campi anche nel cartpad personalizzato.

Elementi disponibili per la personalizzazione

Di seguito la tabella degli elementi attivabili nel cartpad personalizzato, con etichetta, descrizione e identificativo da utilizzare nella configurazione:

Etichetta Elemento	Descrizione	Identificativo
Quantità	Quantità da inserire a carrello	quantity
Quantità omaggio	Quantità omaggio da inserire a carrello	freebie_quantity
Tipo omaggio	Tipologia dell'omaggio da inserire a carrello (guida)	freebie_quantity_type
Unità di Misura	Unità di misura di acquisto	um
Prezzi
Prezzo listino base	Prezzo derivante dal listino base cliente	price_basic
Codice Listino	Codice listino di provenienza (original_price)	pricelist_basic
Prezzo principale	Prezzo applicato in assenza di listino netto	main_price
Listino Cliente	Prezzo risultante dalle condizioni dell'algoritmo prima della modifica utente	original_price
Prezzo netto	Prezzo netto estratto come listino netto articolo (valore che verrà messo a carrello)	net_price
Vostro Prezzo	Prezzo modificabile da inserire a carrello (default: original_price)	price
Sconti
Sconto Principale	Sconto prevalente (in caso di listini netti mostra lo sconto che sarebbe applicato)	main_valid_discount
Sconto Originale	Sconto risultante dall'algoritmo prezzi e sconti prima delle modifiche utente	original_discount
Sconto	Modifica sconto da inserire a carrello (default: original_discount)	discount
Sconto Aggiuntivo	Inserimento sconto aggiuntivo per sconto composto (es. 10 + 5 + ...)	composite_discount
Prezzi calcolati risultanti
Costo Principale Cliente	Calcolo di main_price scontato di main_valid_discount	main_customer_cost
Costo Originale Cliente	Prezzo finale comprensivo del listino netto	original_customer_cost
Altri dati visualizzabili a carrello
Iva	Tassa attribuita alla riga	tax
Periodo Consegna	Gestione periodi di consegna di riga (non implementato)	delivery_period
Note	Nota di riga	row_note
Confezione Minima	Quantità multipla per l'articolo (Innerbox)	inner_box
Supplemento	Prezzo aggiuntivo non scontabile	extra_charge
Disponibilità	Visualizza disponibilità	availability
Disponibilità programmata	Visualizza disponibilità futura (data e quantità)	scheduled_availability
Decorrenza pagamento	Campo data decorrenza pagamento	effective_payment_date
Colore	Campo extra per opzione testuale	color
Numero Colli	Campo numerico per indicare i colli della consegna	number_of_packages
Massimo Sconto	Visualizza il massimo sconto previsto per l'articolo	max_discount
Descrizione breve	Visualizza la descrizione breve dell'articolo	short_description

Stringa che rispecchia il Cartpad standard:
quantity, freebie_quantity, um, price, discount, composite_discount, tax, delivery_date, row_note, number_of_packages, original_price,pricelist_code, extra_charge, availability, scheduled_availability
Stringa completa per i setting:
quantity, freebie_quantity, um, price, discount, composite_discount, tax, delivery_date, row_note, number_of_packages, original_price, price_basic,pricelist_code, extra_charge, availability, scheduled_availability, pricelist_basic, original_discount, original_customer_cost, net_price, effective_payment_date, color, inner_box, max_discount
Nota: La funzionalità è disponibile su IOS dalla versione 2017-10-20 - 2.3.093.

Esempi di valorizzazione prezzi e sconti

Casistica 1:
Cliente: C201
Listino cliente: L001
Articolo: A027
Prezzo su L001: 62.00 €
Prezzo personalizzato Cliente/Articolo: 52.00 €
Sconto Cliente: 10%
Sconto personalizzato Cliente/Articolo: 15%
Listino netto: 30.00 €

Visualizzazione:
Prezzo listino base: 62.00 €
Prezzo principale: 52.00 €
Prezzo netto: 30.00 €
Prezzo risultante: 30.00 €
Vostro Prezzo: 30.00 € (modificabile)
Sconto Principale: 15%
Sconto Originale: -
Sconti Articolo: -
Costo Principale Cliente: 44.20 €
Costo Originale Cliente: 30.00 €

Casistica 2:
Cliente: C201
Listino cliente: L001
Articolo: A027
Prezzo su L001: 62.00 €
Prezzo personalizzato Cliente/Articolo: 52.00 €
Sconto Cliente: 10%
Sconto personalizzato Cliente/Articolo: 15%

Visualizzazione:
Prezzo listino base: 62.00 €
Prezzo principale: 52.00 €
Prezzo netto: -
Prezzo risultante: 52.00 €
Vostro Prezzo: 52.00 € (modificabile)
Sconto Principale: 15%
Sconto Originale: 15%
Sconti Articolo: 15%
Costo Principale Cliente: 44.20 €
Costo Originale Cliente: 44.20 €

Settings disponibili

Setting	Descrizione	Rif.
Abilita Personalizzazione Elementi in Cartpad	Permette di definire gli elementi presenti nel cartpad e la loro sequenza. Per i comportamenti di ciascun elemento, fare riferimento ai setting specifici.	cartpad_custom

Recepimento Settings nel Cartpad Personalizzato

Questa sezione descrive come i principali setting di comportamento, già previsti per il cartpad standard, vengano recepiti e applicati anche agli elementi del cartpad personalizzato. Per ogni campo sono riportati dettagli, riferimenti e stato di implementazione nei diversi ambienti.

Quantità

(id = quantity) Il campo Quantità nel cartpad personalizzato recepisce i setting di gestione previsti per il cartpad standard, garantendo coerenza di comportamento tra le due modalità.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Quantità Omaggio

(id = freebie_quantity) Gestione della quantità omaggio associata all’articolo, con recepimento dei setting standard.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Tipo Omaggio

(id = freebie_quantity_type) Permette di specificare la tipologia di omaggio associata alla quantità omaggio.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Unità di Misura

(id = um) Gestione dell’unità di misura dell’articolo, con recepimento dei setting standard.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Vostro Prezzo

(id = price) Il campo Vostro Prezzo nel cartpad personalizzato recepisce i setting descritti nella guida Vostro Prezzo. Disponibile su IOS dalla versione 8E: 2018-07-24 - 2.5.26.

Settings disponibili

Setting	Descrizione	Codice riferimento
Disabilita aggiornamento prezzo	Blocca la modifica del campo "Vostro Prezzo".	settings_vendita_acquisti/cart/disable_price_update
Abilita scelta prezzi da lista listini disponibili	Permette la selezione da una lista di prezzi disponibili.	settings_vendita_acquisti/cart/enable_price_list
Abilita modifica prezzo se mancante o zero	Permette la modifica solo se il prezzo originale è 0 (usato se "disable_price_update" è attivo).	settings_vendita_acquisti/cart/enable_empty_price_update

Interazione tra i settings: Ci sono tre flag che possono alterare il comportamento del campo "Vostro prezzo": - settings_vendita_acquisti/cart/disable_price_update - settings_vendita_acquisti/cart/enable_price_list - settings_vendita_acquisti/cart/enable_empty_price_update if "disable_price_update" == true prezzo obbligatorio = false prezzo modificabile = false if "enable_empty_price_update" == true and prezzo originale == 0 prezzo obbligatorio = true prezzo modificabile = true presenta "Vostro prezzo" else if "disable_price_update" == false "enable_empty_price_update" non viene considerato if "enable_price_list" == true presenta la lista dei prezzi con la possibilità di aggiungerne di nuovi else presenta "Vostro prezzo" modificabile e non obbligatorio

Stato implementativo

Client	Issue Implementativa	Stato
IOS App8E	75493	Completata
Web

---

Prezzo Listino Base

(id = price_basic) Il campo Prezzo Listino Base mostra il prezzo estratto per l’articolo e l’anagrafica, secondo le seguenti priorità:

• Listino anagrafica condizionato (vedi dettaglio)
• Prezzo di listino base (vedi dettaglio)

Le altre casistiche (es. listini personalizzati) non vengono considerate. Viene associato a price_basic il primo valore trovato e stampato.
Esempio:
L001;Listino 001;AZ293-a;;;;D>=20231011 AND D<20231031;270.00;0.0000

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019 Commit 38d04682 02/Oct/2023	Completata
Buy

---

Listino Cliente

(id = original_price) Corrisponde al prezzo di acquisto proposto dall'app in base alle casistiche di prezzo (vedi algoritmo prezzi). Non tiene conto di eventuali sconti.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit 38d04682 02/Oct/2023	Completata
Buy

---

Codice Listino

(id = pricelist_basic) Visualizza il codice del listino base applicato all’articolo.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 24/Feb/2020	Completata
Buy

---

Sconto

(id = discount) Il campo Sconto recepisce i setting di gestione previsti per il cartpad standard.

Settings disponibili

Setting	Descrizione	Codice riferimento
Disabilita aggiornamento sconto	Rende il campo sconto non modificabile.	settings_vendita_acquisti/cart/custom_cartpad_discount_readonly
Abilita sconti composti vincolati	Gestione sconti composti secondo regole vincolate.	settings_vendita_acquisti/cart/enable_composite_discounts
Abilita scelta sconto da lista sconti disponibili	Permette la selezione da una lista di sconti disponibili.	settings_vendita_acquisti/cart/enable_discount_list
Abilita nuovo sconto in lista	Consente l’inserimento di un nuovo valore di sconto.	settings_vendita_acquisti/cart/enable_discount_list_new_value
Abilita bypass disabilitazione sconti in lista sconti	Permette la visualizzazione completa della lista sconti anche se alcuni sono disabilitati.	settings_vendita_acquisti/cart/enable_full_discount_list
Abilita modifica sconto con prezzi a zero	Permette la modifica dello sconto se il prezzo è 0 o mancante, anche se di default è disabilitata.	settings_vendita_acquisti/cart/disable_discounts_index_on_zero_price

---

Sconto Aggiuntivo

(id = composite_discount) Gestione dello sconto aggiuntivo (composto) secondo i setting standard.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

IVA

(id = tax) Gestione dell’aliquota IVA associata all’articolo.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Data Consegna

(id = delivery_date) Gestione della data di consegna prevista per la riga d’ordine. Il campo è soggetto ai setting descritti nelle seguenti guide:

• disable_delivery_date_insert (Solo Sell)
• delivery_date_min_delta_day
• enable_future_delivery_date_check_on_zero_availability

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Gestione Setting - Commit: db6bd412 03/Mar/2020 Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Note

(id = row_note) Campo per l’inserimento di note aggiuntive sulla riga d’ordine.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Confezione Minima

(id = inner_box) Indica la quantità minima di lotto (innerbox) che verrà inserita a carrello. Per dettagli, vedi questa guida.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Supplemento

(id = extra_charge) Gestione di eventuali supplementi associati alla riga d’ordine.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Disponibilità

(id = availability) Visualizza la disponibilità attuale dell’articolo.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 24/Feb/2020	Completata
Buy

---

Disponibilità Programmata

(id = scheduled_availability) Visualizza la disponibilità programmata dell’articolo.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 24/Feb/2020	Completata
Buy

---

Numero Colli

(id = number_of_packages) Gestione del numero di colli previsti per la riga d’ordine.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Massimo Sconto

(id = max_discount) Visualizza il massimo sconto applicabile alla riga d’ordine.

Stato Implementativo

Client	Versione Rilascio / Issue	Stato
IOS App8E		Completata
Sell	Commit: d27a9d77 21/Oct/2019	Completata
Buy

---

Descrizione Breve

(id = short_description) Visualizza la descrizione breve dell’articolo.

Stato Implementativo

Client	Issue Implementativa	Stato
IOS App8E	9E: 2019-09-16 3.0.1.70	Completata
Sell	381

Argomenti correlati

• Traduzione elementi Cartpad personalizzato -
• Cartpad Standard -
• Vostro Prezzo -
• Sconti in Cartpad -