ForHosting KIT · Strumenti per sviluppatori

Calcoli quanto manca per la spedizione gratuita

Il calcolatore della soglia di spedizione gratuita trasforma due valori dell'ordine in una risposta concreta: l'importo che il cliente deve ancora aggiungere.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

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

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. 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

Quando il carrello raggiunge o supera la soglia, amount_needed vale zero. È 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». Prima della chiamata, ricavi current_total esclusivamente dai prodotti ammessi alla promozione. 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. Ogni richiesta API costa $0.002, mentre la versione browser esegue gratuitamente lo stesso calcolo puro, facile da verificare, collaudare e integrare.

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?

Il calcolatore restituisce amount_needed pari a zero. Raggiungere o superare la soglia è un esito corretto, non un errore.

Il calcolo include imposte o sconti?

Usa current_total esattamente come Lei lo fornisce. 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.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. La versione browser esegue gratuitamente lo stesso calcolo deterministico.

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

POSThttps://api.kit.forhosting.com/ecom/free-shipping-threshold-gap

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

per richiesta$0.002

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.

Leggi la documentazione completa del KIT →