# WooCommerce: come impostare l’ordine minimo e massimo (checkout classico e a blocchi)

<!-- Source: https://alessioangeloro.it/woocommerce-impostare-lordine-minimo-massimo-acquisto/ -->
<!-- Last modified: 2026-11-19T09:15:02+01:00 -->

In breve

Per impostare un **ordine minimo** (o massimo) in WooCommerce scrivi una funzione che controlla il subtotale del carrello e restituisce un errore. Con il **checkout classico** la agganci a woocommerce_check_cart_items, che blocca carrello e checkout; con il **checkout a blocchi**, predefinito dalla versione 8.3, serve l&#8217;azione woocommerce_store_api_cart_errors. Nel 2016 nascondevo il pulsante con il CSS: oggi il blocco deve avvenire sul server.

Può succedere che in WooCommerce serva un ordine minimo di acquisto: sotto una certa cifra al venditore non conviene spedire, oppure si vende all&#8217;ingrosso e servono quantità minime. Altre volte serve un massimo, per esempio per limitare il rischio sugli ordini di un nuovo cliente o rispettare un vincolo del metodo di pagamento.

## Come lo facevo nel 2016?

Una funzione agganciata a woocommerce_checkout_process e woocommerce_before_cart controllava WC()-&gt;cart-&gt;total: sotto i 60 euro mostrava un avviso e, con un CSS caricato apposta, nascondeva il pulsante &#8220;Concludi ordine&#8221;. Una seconda funzione faceva lo stesso per il massimo. Funzionava sul checkout di allora, ma aveva tre limiti: il totale comprendeva anche la spedizione, woocommerce_price() è stata sostituita da wc_price(), e soprattutto oggi molti negozi usano il **checkout a blocchi**, dove quei ganci non vengono eseguiti.

## Su quale importo conviene calcolare il minimo?

Di solito sul **subtotale dei prodotti**, senza spedizione: altrimenti un cliente lontano raggiunge il minimo pagando solo più spese di consegna. Decidi anche se contare gli sconti: con get_subtotal() hai il subtotale prima dei coupon, sottraendo get_discount_total() lo hai dopo. Qualunque scelta va bene, purché sia la stessa che scrivi nelle condizioni di vendita.

## Qual è il codice per il minimo e il massimo?

Una funzione sola calcola il problema; due agganci la usano nei due tipi di checkout. In un piccolo plugin, come spiego in [come creare un plugin](https://alessioangeloro.it/creare-un-plugin-wordpress/):

&lt;?php
// controllo minimo e massimo sul subtotale dei prodotti, scontato
function aa_limite_ordine( $cart ) {
    $minimo  = 60;
    $massimo = 900;
    $totale  = (float) $cart-&gt;get_subtotal() - (float) $cart-&gt;get_discount_total();

    if ( $totale &gt; 0 &amp;&amp; $totale &lt; $minimo ) {
        return sprintf( 'Ordine minimo di %s: aggiungi prodotti per altri %s.', wc_price( $minimo ), wc_price( $minimo - $totale ) );
    }
    if ( $totale &gt; $massimo ) {
        return sprintf( 'Ordine massimo di %s: il tuo carrello è di %s.', wc_price( $massimo ), wc_price( $totale ) );
    }
    return '';
}

// checkout classico: errore su carrello e checkout
function aa_limite_classico() {
    $errore = aa_limite_ordine( WC()-&gt;cart );
    if ( $errore ) {
        wc_add_notice( $errore, 'error' );
    }
}
add_action( 'woocommerce_check_cart_items', 'aa_limite_classico' );

// checkout a blocchi: errore tramite la Store API
function aa_limite_blocchi( $errors, $cart ) {
    $errore = aa_limite_ordine( $cart );
    if ( $errore ) {
        $errors-&gt;add( 'aa_limite_ordine', wp_strip_all_tags( $errore ) );
    }
}
add_action( 'woocommerce_store_api_cart_errors', 'aa_limite_blocchi', 10, 2 );

## Come funziona?

Nel checkout classico, un errore aggiunto con wc_add_notice() dentro woocommerce_check_cart_items compare nel carrello e impedisce di proseguire con l&#8217;ordine: non serve nascondere pulsanti. Nel checkout a blocchi l&#8217;azione woocommerce_store_api_cart_errors riceve un oggetto WP_Error: aggiungendoci un messaggio, il blocco mostra l&#8217;avviso e non permette di inviare l&#8217;ordine. Il messaggio del minimo dice anche **quanto manca**, che è il modo migliore per far aggiungere un prodotto invece di far abbandonare il carrello.

## Posso usare un plugin invece del codice?

Sì, esistono plugin gratuiti per il minimo d&#8217;ordine; scegline uno che dichiari esplicitamente il supporto al checkout a blocchi e alla Store API, altrimenti sul checkout moderno la regola non viene applicata. Se ti servono regole più complesse, come minimi diversi per categoria o per ruolo dell&#8217;utente, il codice su misura resta la strada più pulita.

## E se voglio solo incentivare, non bloccare?

Allora meglio una soglia di **spedizione gratuita** con un messaggio &#8220;ti mancano X euro&#8221;: WooCommerce la gestisce dal metodo di spedizione &#8220;Spedizione gratuita&#8221; con importo minimo, senza codice. Per mostrare al cliente quanto sta risparmiando con gli sconti, trovi un esempio in [la percentuale di sconto nel carrello](https://alessioangeloro.it/mostrare-la-percentuale-sconto-al-checkout-woocommerce/); per un campo al checkout che compare solo in certi casi, in [il campo al checkout per categoria](https://alessioangeloro.it/woocommerce-mostrare-nascondere-campi-personalizzati-solo-nel-carrelloo-ce-un-prodotto-determinata-categoria/).

## In sintesi

Una funzione che calcola il subtotale dei prodotti (con o senza sconti, senza spedizione) e restituisce un messaggio; agganciata a woocommerce_check_cart_items con wc_add_notice() per il checkout classico e a woocommerce_store_api_cart_errors con WP_Error per quello a blocchi. Il messaggio dice quanto manca. Niente pulsanti nascosti via CSS.

            [Il tuo negozio sembra lento quando ci clicchi sopra? Trovo gli script che bloccano le interazioni e li sistemo senza togliere quello che ti serve.
                       Analizziamo l&#039;INP](https://alessioangeloro.it/sito-wordpress-e-woocommerce-piu-veloce/)      

## Domande frequenti

### Come imposto un ordine minimo in WooCommerce?

Con una funzione che controlla il subtotale del carrello e aggiunge un errore: woocommerce_check_cart_items per il checkout classico, woocommerce_store_api_cart_errors per quello a blocchi.

### Perché il mio codice dell&#8217;ordine minimo non funziona più?

Probabilmente il negozio usa il checkout a blocchi, dove woocommerce_checkout_process non viene eseguito.

### Il minimo d&#8217;ordine deve includere la spedizione?

Di solito no: conviene calcolarlo sul subtotale dei prodotti, così la spedizione non aiuta a raggiungerlo.

### Basta nascondere il pulsante del checkout?

No, va bloccato l&#8217;ordine sul server: un pulsante nascosto si aggira facilmente.
