Calcoli quanto manca per la spedizione gratuita
Dica al cliente esattamente quanto gli manca per non pagare la spedizione: un carrello da 42,50 con una soglia di 60 richiede altri 17,50, e uno che la raggiunge già riceve zero. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Totale attuale
- 42,5
- Soglia per spedizione gratuita
- 60
- Importo necessario
- 17,5
Il calcolatore della soglia di spedizione gratuita trasforma due valori dell'ordine in una risposta concreta: l'importo che il cliente deve ancora aggiungere. Inserisca il totale corrente del carrello e la soglia del negozio per ottenere la differenza residua. Se il carrello ha già raggiunto o superato l'obiettivo, il risultato è zero e non un errore. Il calcolo può alimentare messaggi nel carrello, procedure di pagamento, assistenza, esperimenti e report.
Calcoli la spesa residua partendo da due totali
Per esempio, un carrello da 42.50 con soglia 60 richiede ancora 17.50. Entrambi gli input devono essere numeri finiti e non negativi, espressi nella stessa valuta e secondo lo stesso criterio contabile. La Sua applicazione deve stabilire in anticipo se sconti, imposte, buoni regalo o prodotti esclusi rientrano nel totale valido.
Non è richiesto un codice valuta perché la sottrazione è uguale per tutte le monete, ma spetta alla Sua interfaccia formattare il risultato con simbolo e decimali corretti. Nessuna consultazione del catalogo, conversione valutaria o regola di arrotondamento nascosta modifica i valori inviati.
Gestisca i carrelli che hanno già diritto al vantaggio
È un risultato corretto, non un errore. La Sua procedura può quindi mostrare un invito solo quando il valore è positivo e confermare la spedizione gratuita quando è zero. La regola copre una corrispondenza esatta, un ordine sopra l'obiettivo e una soglia pari a zero.
Campi mancanti, stringhe, valori nulli, negativi, infiniti o non numerici vengono rifiutati perché non rappresentano importi validi. La distinzione è essenziale: zero descrive un carrello valido che non richiede altra spesa; un errore di input indica un contratto dati errato. Poiché l'operazione è deterministica, gli stessi numeri producono sempre la medesima uscita nel negozio, sul server, nei test automatici, nei flussi di eventi e negli strumenti di assistenza.
Trasformi il risultato in un messaggio utile
Tratti il numero restituito come calcolo di base, quindi applichi le regole di presentazione e vendita della Sua attività. Una differenza positiva può diventare «Aggiunga altri 12.00 per la spedizione gratuita», nel formato monetario e locale corretto. Uno zero può attivare «Ha ottenuto la spedizione gratuita».
Alcuni negozi escludono articoli ingombranti, beni digitali, imposte, mance o costi di consegna; altri considerano il subtotale prima dei coupon. Tenere tali regole fuori dallo strumento evita di attribuirgli conoscenze di un catalogo mai ricevuto. Per le analisi, registri soglia e totale insieme alla differenza.
Casi d'uso
Messaggi di avanzamento nel carrello
Mostri al cliente l'esatta spesa valida ancora necessaria per sbloccare la spedizione gratuita.
Verifiche di idoneità al pagamento
Converta totale e soglia in una differenza coerente, sempre maggiore o uguale a zero.
Risposte del servizio clienti
Offra agli operatori un calcolo rapido e ripetibile quando un cliente chiede perché paga ancora la consegna.
Domande frequenti
Che cosa accade se il carrello ha già diritto al vantaggio?
Raggiungere o superare la soglia è un esito corretto, non un errore.
Il calcolo include imposte o sconti?
Applichi prima le regole del negozio su idoneità, imposte, sconti ed esclusioni.
Posso usare qualsiasi valuta?
Sì. Entrambi i valori devono usare la stessa valuta e lo stesso criterio contabile. Formatti il risultato monetario nella Sua applicazione.
Quali input vengono rifiutati?
Valori mancanti, stringhe, null, numeri negativi, infiniti e dati non numerici vengono rifiutati come input non validi.
Il calcolatore arrotonda l’importo mancante?
No. Sottrae il totale del carrello dalla soglia e restituisce la differenza esatta, quindi 60 meno 42,50 dà 17,50. Il simbolo della valuta e i decimali li aggiunge il suo carrello o la pagina di pagamento.
Quali valori vengono rifiutati?
Importi negativi, valori mancanti, testo e numeri non finiti, perché non possono rappresentare un totale reale. Lo zero invece è accettato, sia per il totale del carrello sia per la soglia.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"current_total":42.5,"free_shipping_threshold":60}'const res = await fetch("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"current_total": 42.5,
"free_shipping_threshold": 60
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"current_total": 42.5,
"free_shipping_threshold": 60
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"current_total":42.5,"free_shipping_threshold":60}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"current_total":42.5,"free_shipping_threshold":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"current_total": 42.5,
"free_shipping_threshold": 60
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.free_shipping_threshold_gap",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Calcoli la spesa residua partendo da due totali
Indichi il totale corrente degli articoli in current_total e il valore minimo richiesto in free_shipping_threshold. Il calcolatore sottrae il primo dalla soglia e restituisce la differenza come amount_needed.
Gestisca i carrelli che hanno già diritto al vantaggio
Quando il carrello raggiunge o supera la soglia, amount_needed vale zero.
Trasformi il risultato in un messaggio utile
Prima della chiamata, ricavi current_total esclusivamente dai prodotti ammessi alla promozione. Ogni richiesta API costa $0.002, mentre la versione browser esegue gratuitamente lo stesso calcolo puro, facile da verificare, collaudare e integrare.
Domande tecniche
Quanto costa un calcolo tramite API?
Ogni richiesta API costa $0.002. La versione browser esegue gratuitamente lo stesso calcolo deterministico.