Salta al contenuto principale
Versione: 2.x

Registrazione degli sconti

Per ridurre l'importo di una vendita, scegli uno dei tre metodi seguenti. Sconti del carrello è la pagina di riferimento per il cassiere per tutti e tre i metodi. Gli sviluppatori e chi consulta i report possono passare direttamente a Dove viene registrato ogni sconto.

Applicare sconti alla cassa​

La possibilità di combinarli nello stesso ordine dipende dalle regole del coupon. Aggiungi sconto non è cumulabile con un coupon contrassegnato come Utilizzo individuale.

Modificare il prezzo di un articolo​

  1. Tocca il prezzo di una riga. Si apre un tastierino.
  2. Premi un tasto percentuale (−5%, −10%, −15%) oppure digita il nuovo prezzo.
  3. Premi il segno di spunta (✓) per terminare, oppure Fine sul telefono. Il totale della riga diventa la quantità × il nuovo prezzo.
Il tastierino del prezzo aperto su una riga da $45.00 con −10% selezionato: il nuovo prezzo $40.50 con $45.00 −10% sopra, i tre tasti percentuali, i tasti numerici, il tasto per cancellare e il tasto per confermare
  1. Nuovo prezzo — quanto costerà l'articolo e come è stato calcolato a partire dal prezzo precedente.
  2. Tasti percentuali — ciascuno sottrae la propria percentuale dal prezzo di questa riga. Quello illuminato (qui −10%) è attivo; premilo di nuovo per ripristinare il prezzo precedente. Puoi scegliere i tasti in Sconti rapidi, nelle Impostazioni carrello.
  3. Cifre — in alternativa, digita un nuovo prezzo.
  4. Cancella — rimuove l'ultima cifra.
  5. ✓ — imposta il nuovo prezzo.

Se commetti un errore:

  • Tasto percentuale sbagliato — premine un altro prima di ✓; sostituisce il primo.
  • Vuoi ripristinare il prezzo precedente — prima di ✓, premi di nuovo il tasto illuminato. Dopo ✓, tocca di nuovo il prezzo e digita quello desiderato.
  • Chiusura del tastierino — toccando all'esterno mantieni il prezzo digitato. Escape sulla tastiera mantiene il prezzo precedente.

Altre soluzioni: Se qualcosa va storto. Per approfondire: Applicare uno sconto a un articolo.

Applicare uno sconto all'intero ordine​

  1. Premi + nella parte superiore del carrello e scegli Aggiungi sconto.
  2. In Sconto rapido, digita l'importo e scegli $ o %.
  3. Premi Aggiungi sconto.
La finestra Aggiungi sconto sulla scheda Sconto rapido, sopra un carrello contenente un Aim Analog Watch da $45.00: le schede Sconto rapido e Coupon, l'importo 10, il selettore tra dollari e percentuale impostato su percentuale e il pulsante Aggiungi sconto
  1. Sconto rapido — un importo o una percentuale da sottrarre all'intero ordine, non a una singola riga.
  2. Coupon — in alternativa, uno dei coupon del negozio. Vedi Applicare un coupon.
  3. Importo — toccalo e digita sul tastierino.
  4. $ o % — un importo fisso da sottrarre oppure una percentuale dell'ordine.
  5. Aggiungi sconto — applica lo sconto all'ordine.

Lo sconto compare insieme ai totali:

Il carrello dopo uno sconto del 10% su un orologio da $45.00: il totale della riga $45.00 barrato con $40.50 sotto, il subtotale $45.00, una riga Sconto (10%) che sottrae $4.50 con il relativo pulsante di rimozione e Cassa $40.50
  1. Totale riga — il prezzo prima dello sconto, barrato, e quanto paga ora il cliente.
  2. Subtotale — l'importo dell'ordine prima dello sconto.
  3. Sconto (10%) — lo sconto e l'importo sottratto. La sola dicitura Sconto indica un importo fisso. Premi ✕ per rimuoverlo.
  4. Cassa — il nuovo totale.

Per annullarlo, premi ✕ sulla sua riga. I totali delle righe tornano ai valori precedenti e i prezzi modificati sulle righe restano quelli impostati. Altre soluzioni: Se qualcosa va storto. Per approfondire: Applicare uno sconto all'intero ordine.

Applicare un coupon​

  1. Premi + nella parte superiore del carrello e scegli Aggiungi sconto (qui trovi anche i coupon).
  2. Passa a Coupon, premi Seleziona coupon e digita una parte del codice per trovarlo.
  3. Tocca il coupon e premi Applica.
La finestra Aggiungi sconto sulla scheda Coupon, con l'elenco dei coupon aperto: le schede Sconto rapido e Coupon, il campo Seleziona coupon, la casella di ricerca, un coupon con il relativo tipo e importo, il pulsante Nuovo coupon e il pulsante Applica
  1. Sconto rapido — un importo o una percentuale da sottrarre all'ordine, senza coupon. Vedi Applicare uno sconto all'intero ordine.
  2. Coupon — i coupon del negozio.
  3. Seleziona coupon — apre l'elenco. Dopo averne scelto uno, il suo codice compare qui.
  4. Cerca coupon — digita una parte qualsiasi del codice o della descrizione.
  5. Un coupon — il suo codice, la descrizione o il tipo e l'importo sottratto.
  6. Nuovo coupon (WCPOS Pro) — crea subito un coupon e applicalo a questa vendita.
  7. Applica — verifica che l'ordine rispetti le regole del coupon e lo applica.

Il coupon compare nei totali, oppure il POS indica perché non è possibile usarlo:

Il carrello con due coupon applicati: il menu di aggiunta, il subtotale, una riga per ciascun coupon con il codice, un pulsante di rimozione e l'importo sottratto, il totale dell'articolo con l'importo precedente barrato e il pulsante Cassa
  1. + — apri di nuovo Aggiungi sconto per aggiungere un altro coupon.
  2. Subtotale — l'importo dell'ordine prima dei coupon. Le righe dei coupon compaiono sotto.
  3. Un coupon — il suo codice, la ✕ per rimuoverlo e l'importo sottratto.
  4. Il coupon successivo — ogni coupon ha una propria riga, nell'ordine in cui li hai applicati.
  5. Cassa — incassa il pagamento dell'ordine. Vedi Cassa.

Hai scelto quello sbagliato? Premi ✕ sulla sua riga; l'importo sottratto viene riaggiunto. È stato rifiutato? Vedi Se il coupon viene rifiutato. Per approfondire: Applicare un coupon e Applicazione dei coupon.

Se qualcosa va storto​

  • Prezzo sbagliato su una riga — tocca di nuovo il prezzo e digita quello corretto. Prima di ✓, premi di nuovo il tasto percentuale illuminato per ripristinare il prezzo precedente.
  • Tastierino chiuso per errore — toccando all'esterno mantieni il prezzo digitato; Escape mantiene il prezzo precedente.
  • Sconto sbagliato sull'ordine — premi ✕ sulla sua riga sotto i totali. I totali delle righe tornano ai valori precedenti; i prezzi modificati sulle righe restano invariati.
  • Coupon sbagliato — premi ✕ sulla sua riga; l'importo sottratto viene riaggiunto.
  • Il coupon viene rifiutato — vedi Se il coupon viene rifiutato.

Se il coupon viene rifiutato​

La finestra rimane aperta e indica il motivo in rosso. Due cause dipendono dagli altri sconti presenti nell'ordine:

  • … non è cumulabile con altri coupon oppure … è già presente nell'ordine e non è cumulabile con altri coupon — un coupon contrassegnato come Utilizzo individuale deve essere applicato da solo. Rimuovi il coupon che impedisce l'applicazione oppure mantienilo e rinuncia a quello nuovo.
  • Escludi articoli in offerta — un articolo il cui prezzo è stato abbassato alla cassa viene considerato in offerta. Il coupon lo esclude e, finché l'articolo è nel carrello, non è possibile usare un coupon che sottrae un importo fisso dall'ordine. Rimuovi l'articolo oppure scegli un altro coupon. Per sapere perché, vedi cosa viene considerato in offerta.

Per tutti gli altri messaggi e le relative soluzioni: Quando la cassa rifiuta un coupon.

Dove viene registrato ogni sconto​

Per sviluppatori e report

Le informazioni seguenti non servono per lavorare alla cassa. Sono destinate agli sviluppatori e a chi consulta gli ordini WCPOS in un report, in un'esportazione o in un altro plugin.

Ogni metodo viene registrato in una posizione diversa nell'ordine:

  • Un prezzo modificato è il prezzo della riga: il metadato _woocommerce_pos_data e il subtotal della riga. Non è incluso in discount_total e non è soggetto ad alcuna regola dei coupon.
  • Aggiungi sconto crea una riga coupon con il codice pos-discount e il metadato _wcpos_quick_discount. È incluso in discount_total. Si applica a ogni riga prodotto, compresi gli articoli in offerta, ma non è cumulabile con un coupon contrassegnato come Utilizzo individuale.
  • Un coupon del negozio è una riga coupon con il codice del coupon. È incluso in discount_total ed è soggetto alle regole del coupon stesso.

Qui il prezzo di un orologio da $45.00 è stato impostato a $40.00 alla cassa, poi all'ordine è stato applicato uno sconto del 10% con Aggiungi sconto:

Il carrello con un Aim Analog Watch: il prezzo abbassato alla cassa da $45.00 a $40.00, il totale della riga $40.00 barrato con $36.00 sotto, il subtotale $40.00, una riga Sconto (10%) che sottrae $4.00 e Cassa $36.00
  1. Prezzo — un prezzo modificato alla cassa. Viene memorizzato per unità nel metadato _woocommerce_pos_data della riga; il subtotal della riga è questo prezzo × la quantità. Vedi Come vengono memorizzate le modifiche dei prezzi nel POS.
  2. Totale riga — il total della riga: il suo subtotal meno la quota di eventuali coupon o sconti applicati con Aggiungi sconto.
  3. Subtotale — la somma dei subtotali delle righe. Include già il prezzo impostato alla cassa, quindi l'ordine non ne conserva un valore separato.
  4. Sconto (10%) — una riga creata con Aggiungi sconto: una riga coupon con il codice pos-discount e il metadato _wcpos_quick_discount. Concorre al discount_total dell'ordine. Vedi Righe Aggiungi sconto.
  5. Cassa — il total dell'ordine.

In questa immagine i prezzi includono le imposte: le righe US e US AL sotto i totali mostrano le imposte comprese negli importi. Il carrello mostra gli importi con le imposte, mentre subtotal e total di ogni riga e discount_total dell'ordine li conservano al netto delle imposte. Il total dell'ordine è il totale complessivo, imposte incluse.

Come vengono memorizzate le modifiche dei prezzi nel POS​

Ogni riga prodotto creata dal POS contiene i prezzi unitari nel metadato di riga _woocommerce_pos_data:

{
"price": "40.00",
"regular_price": "45.00",
"tax_status": "taxable"
}
  • price è il prezzo di vendita della riga dopo eventuali modifiche alla cassa.
  • regular_price è il prezzo di listino del prodotto al momento dell'aggiunta. Modificare il prezzo alla cassa non lo cambia mai, quindi un prezzo aumentato alla cassa risulta superiore a questo valore.
  • Un prodotto generico contiene anche virtual, downloadable e categories, affinché le regole dei coupon possano verificarli.

Questo metadato è la fonte di riferimento per il prezzo unitario. Il subtotal della riga viene calcolato da price × quantità, scorporando le imposte e applicando l'arrotondamento, mentre total diventa inferiore quando si applica un coupon o Aggiungi sconto. Per ottenere valori unitari precisi, leggi price e regular_price dal metadato.

Il metadato è nascosto nella schermata dell'ordine di WooCommerce.

Leggere il metadato dal codice

Usa un decodificatore che accetti entrambi i formati. Le righe provenienti dalle app precedenti conservano il metadato come stringa JSON. L'app 2.0 lo scrive come oggetto, quindi WordPress memorizza un array serializzato e i valori possono essere numeri anziché stringhe. Una semplice chiamata a json_decode() non funziona sull'array.

I nuovi ordini POS contengono anche il metadato privato dell'ordine _woocommerce_pos_version: la versione del plugin WCPOS che ha salvato l'ordine. Le ricevute continuano a considerare autorevole il formato memorizzato delle righe, perché un ordine acquisito offline può arrivare a un plugin più recente dell'app che lo ha creato.

Totali delle righe e totale degli sconti​

WCPOS registra un prezzo impostato alla cassa come WooCommerce registra un prezzo in offerta:

  • line_item.subtotal = price × quantità, dove price è il prezzo impostato alla cassa.
  • line_item.total = subtotal − la quota della riga relativa ai coupon e ad Aggiungi sconto.
  • order.discount_total = solo coupon e righe Aggiungi sconto. Non include mai un prezzo impostato alla cassa.
Un esempio di calcolo: $45.00 → $40.00 alla cassa → $36.00

Senza imposte: un orologio con un prezzo di listino di $45.00, il cui prezzo viene impostato a $40.00 alla cassa, poi uno sconto del 10% con Aggiungi sconto. $40.00 − $4.00 = $36.00. L'ordine memorizza questi valori:

  • _woocommerce_pos_data.regular_price: 45.00
  • _woocommerce_pos_data.price: 40.00, il prezzo impostato alla cassa
  • line_items[0].subtotal: 40.00, 40.00 × 1
  • line_items[0].total: 36.00, al netto di Aggiungi sconto
  • discount_total: 4.00, solo Aggiungi sconto
  • total: 36.00

I $5.00 sottratti dal prezzo impostato alla cassa emergono solo confrontando regular_price con price. Le ricevute eseguono questo confronto automaticamente; vedi Dati della ricevuta.

Ordini precedenti alla v1.9.0

Prima della v1.9.0, l'app inviava subtotal = regular_price × quantità. WooCommerce calcolava poi discount_total = subtotal − total, quindi un prezzo impostato alla cassa veniva conteggiato come sconto. Questo rendeva errato il calcolo dei coupon: recalculate_coupons() si basa su subtotal, quindi i coupon venivano calcolati sul prezzo originale. Un filtro woocommerce_order_item_get_subtotal lato server aggirava il problema durante recalculate_coupons().

La v1.9.0 ha adottato il modello del prezzo in offerta descritto sopra e ha rimosso il filtro. Gli ordini salvati in precedenza mantengono i vecchi valori: per questo un report può mostrare un prezzo impostato alla cassa all'interno di discount_total per un vecchio ordine. Le ricevute ne tengono conto: vedi Dati della ricevuta.

Righe Aggiungi sconto​

Aggiungi sconto sottrae un importo o una percentuale dall'intero ordine. È una riga coupon, non un coupon del negozio:

  • Codice — pos-discount per il primo dell'ordine, poi pos-discount-2, pos-discount-3 e così via.
  • Metadato — _wcpos_quick_discount sulla riga coupon: { "discount_type": "percent", "amount": "10" }. discount_type è percent (fino a 100) oppure fixed_cart; amount è una stringa che rappresenta un numero decimale positivo.
  • Regole — si applica agli articoli in offerta, compresi quelli con prezzi abbassati alla cassa. Non è cumulabile con un coupon contrassegnato come Utilizzo individuale.
  • Ricalcola — WCPOS memorizza i dettagli del coupon sulla riga, quindi Ricalcola nella schermata dell'ordine di WooCommerce mantiene lo sconto.

Il coupon virtuale esiste solo mentre WCPOS salva un ordine POS: nel negozio online non è possibile utilizzare pos-discount. Se un coupon del negozio ha già un codice usato nella richiesta, il salvataggio viene rifiutato con il messaggio Il codice sconto rapido "…" appartiene a un coupon del negozio. Usa un altro codice.

L'app 2.0 non riduce più l'importo con una commissione negativa: richiede invece Aggiungi sconto. Il plugin accetta ancora righe con commissioni negative dalle app precedenti e da altri client.

Interazione con i coupon​

Applicare un coupon del negozio alla cassa è possibile con il plugin gratuito; per crearne uno alla cassa serve WCPOS Pro. Quando un coupon viene applicato a un ordine con un prezzo impostato alla cassa:

  1. Il coupon si basa sul prezzo impostato alla cassa (_woocommerce_pos_data.price), non su regular_price.
  2. Rimuovendo il coupon, la riga torna al prezzo impostato alla cassa.

L'app calcola i coupon sul dispositivo, quindi può applicarli offline; il plugin li ricalcola con gli stessi dati di contesto dei prodotti quando salva l'ordine.

Quando i prezzi includono le imposte e su una riga si applicano più coupon o sconti di Aggiungi sconto, l'app somma prima gli sconti della riga e scorpora le imposte una sola volta, come fa WooCommerce. I totali delle righe alla cassa corrispondono così a quelli dell'ordine salvato fino all'ultimo decimale.

Comportamento di exclude_sale_items​

Una riga il cui _woocommerce_pos_data.price è inferiore a regular_price viene considerata in offerta, come un prezzo in offerta di WooCommerce. Un prezzo impostato alla cassa uguale o superiore a regular_price non lo è. Quindi un coupon con Escludi articoli in offerta:

  • esclude una riga il cui prezzo impostato alla cassa è inferiore a regular_price;
  • non può essere usato finché una di queste righe è nel carrello, se è un coupon con sconto fisso sul carrello. Questa è una regola di WooCommerce per i coupon con sconto fisso sul carrello.

Per modificare ciò che viene considerato in offerta, usa il filtro wcpos_item_is_on_sale descritto di seguito.

Filtri disponibili​

wcpos_item_is_on_sale​

Modifica il criterio che determina se una riga con dati di prezzo POS viene considerata «in offerta» quando il plugin convalida i coupon. Prima di WCPOS 2.0 questo filtro si chiamava woocommerce_pos_item_is_on_sale; quel nome funziona ancora, ma è deprecato dalla 2.0 e verrà rimosso non prima della 2.2 (vedi Nomi degli hook).

Esempio e parametri
add_filter( 'wcpos_item_is_on_sale', function ( $is_on_sale, $product, $item, $pos_data ) {
// Let coupons with exclude_sale_items apply to lines lowered at the till.
return false;
}, 10, 4 );
  • $is_on_sale (bool) — indica se la riga viene considerata in offerta. Valore predefinito: price < regular_price.
  • $product (WC_Product) — l'oggetto prodotto.
  • $item (WC_Order_Item_Product) — la riga prodotto dell'ordine.
  • $pos_data (array) — il valore decodificato di _woocommerce_pos_data.

Il filtro viene eseguito sul server. Il controllo degli articoli in offerta dell'app, usato mentre il cassiere sta ancora componendo il carrello, è sempre price < regular_price; la risposta del server si applica al salvataggio dell'ordine.

Endpoint REST API​

Gli endpoint dei coupon fanno parte del plugin gratuito, quindi l'app non riceve mai un 404 quando richiede i coupon, anche senza WCPOS Pro.

L'app 2.0 sincronizza i coupon tramite GET /wp-json/wcpos/v2/coupons, che inoltra la richiesta a wc/v3/coupons di WooCommerce con il permesso di lettura POS. Un coupon creato alla cassa (Pro) viene salvato come un normale coupon WooCommerce e il cassiere deve avere il permesso di creare coupon.

L'endpoint v1, per le app precedenti alla 2.0

Le app precedenti alla 2.0 usano /wp-json/wcpos/v1/coupons. Il relativo controller estende WC_REST_Coupons_Controller e aggiunge UUID per la sincronizzazione offline, accesso in lettura per qualsiasi utente con la capacità access_woocommerce_pos e un percorso rapido che restituisce solo gli ID quando vengono richiesti posts_per_page=-1 e fields=id (oppure fields=id,date_modified_gmt).

Per sapere chi può accedere a ciascun endpoint, vedi Ruoli e accesso agli endpoint.

Dati esposti per le ricevute​

I template delle ricevute ottengono i risparmi senza leggere direttamente _woocommerce_pos_data: il risparmio di ogni riga, una riga per ogni coupon o Aggiungi sconto e i totali dell'ordine per entrambi.

I campi della ricevuta per sconti e risparmi
  • Ogni riga — regular_price, unit_savings e line_savings indicano il risparmio ottenuto con un prezzo impostato alla cassa o un prezzo in offerta. discounts è il subtotal della riga − total: la sua quota di coupon e Aggiungi sconto, mai un prezzo impostato alla cassa. Fanno eccezione gli ordini precedenti alla v1.9.0, in cui potrebbe già includere il risparmio: in quel caso savings_in_discounts è true.
  • discounts[] — una riga per ogni riga coupon, Aggiungi sconto incluso, con label, code, discount_type e total. Una riga Aggiungi sconto ha l'etichetta Sconto (10%), oppure Sconto per un importo fisso, con code pos-discount e discount_type percent o fixed_cart.
  • Totali — discount_total (coupon e Aggiungi sconto, da WC_Order::get_discount_total()), sale_savings_total (risparmio tra prezzo di listino e prezzo di vendita, compresi i prezzi impostati alla cassa) e total_saved per un valore complessivo. total_saved elimina il doppio conteggio negli ordini precedenti alla v1.9.0.
  • total_saved_complete — false quando una riga non contiene i dati di prezzo necessari per una somma affidabile; in quel caso i totali dei risparmi sono null.

Ognuno ha le varianti _incl e _excl. Receipt_Data_Builder::get_item_meta_pairs() esclude da lines[].meta tutte le chiavi dei metadati che iniziano con un trattino basso, compresa _woocommerce_pos_data.

Per esempi di template, vedi Visualizzare il prezzo di listino e il risparmio e Totali.