ForHosting KIT · Finanzen und Geld

Fehlbetrag für kostenlosen Versand berechnen

Zeigen Sie Kunden genau, wie viel bis zum versandkostenfreien Einkauf fehlt: Ein Warenkorb über 42,50 bei einer Schwelle von 60 braucht noch 17,50, ein Warenkorb über der Schwelle erhält null. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald
Wenn Sie eingeben
Aktueller Gesamtbetrag
42,5
Schwelle für kostenlosen Versand
60
Erhalten Sie
Benötigter Betrag
17,5

Der Rechner für die Versandfreigrenze macht aus zwei Bestellwerten eine direkt nutzbare Angabe: den Betrag, den ein Kunde noch hinzufügen muss. Geben Sie den aktuellen Warenkorbwert und die Schwelle des Shops ein; ausgegeben wird die verbleibende Differenz. Wurde das Ziel bereits erreicht oder überschritten, erhalten Sie null statt einer Fehlermeldung. Das Ergebnis eignet sich für Warenkorbhinweise, Checkout-Meldungen, Support, Tests und Berichte.

So entsteht der Fehlbetrag

Der Rechner zieht den aktuellen Warenkorbwert von der Schwelle ab, ab der Ihr Shop keine Versandkosten berechnet. Liegt der Warenkorb bei 42,50 und die Schwelle bei 60, fehlen 17,50. Erreicht oder übersteigt der Warenkorb die Schwelle, lautet das Ergebnis null statt eines negativen Werts. Beide Beträge müssen nichtnegative Zahlen in derselben Währung und auf derselben Grundlage sein, also nicht ein Warenkorb mit Steuern gegen eine Schwelle ohne Steuern. Es gibt keine versteckte Rundung und keine Währungsumrechnung, die Zahl bleibt genau so, wie sie sich aus Ihren Werten ergibt.

Wofür Sie ihn nutzen und worauf Sie achten sollten

Typisch sind Fortschrittshinweise im Warenkorb, Prüfungen an der Kasse und schnelle Antworten im Kundenservice, wenn jemand fragt, warum der Versand noch etwas kostet. Der häufigste Fehler liegt vor der Rechnung: Entscheiden Sie zuerst, ob Rabatte, Gutscheine, Steuern oder ausgeschlossene Artikel zum Warenkorbwert zählen, und geben Sie nur den berechtigten Betrag ein. Halten Sie für Auswertungen Schwelle und Warenkorbwert neben dem Ergebnis fest, damit spätere Berichte den Zusammenhang behalten.

Ermitteln Sie den Restbetrag aus zwei Werten

Bei einem Warenkorb von 42.50 und einer Schwelle von 60 fehlen beispielsweise 17.50. Beide Eingaben müssen endliche, nicht negative Zahlen in derselben Währung und auf derselben Abrechnungsbasis sein. Ihre Anwendung muss vorher festlegen, ob Rabatte, Steuern, Gutscheine oder ausgeschlossene Produkte zum berechtigten Wert zählen.

Ein Währungscode ist nicht nötig, da die Subtraktion für jede Währung gleich ist; Symbol und Dezimalstellen müssen Sie jedoch passend formatieren. Weder Katalogabfragen noch Währungsumrechnung oder verborgene Rundungsregeln verändern die übermittelten Werte.

Behandeln Sie bereits berechtigte Warenkörbe korrekt

So können Sie nur bei einem positiven Wert einen Kaufanreiz anzeigen und bei null den kostenlosen Versand bestätigen. Die Regel gilt bei exakter Übereinstimmung, bei höheren Bestellungen und bei einer Schwelle von null. Fehlende Felder, Zeichenketten, Nullwerte, negative, unendliche oder nicht numerische Werte werden abgelehnt, weil sie keine gültigen Beträge darstellen.

Diese Trennung ist wichtig: null beschreibt einen korrekten Warenkorb ohne zusätzlichen Bedarf; eine Eingabefehlermeldung weist auf einen verletzten Datenvertrag hin. Da die Operation deterministisch ist, liefern dieselben Zahlen im Shop, auf dem Server, in automatisierten Tests, Ereignisabläufen und Supportwerkzeugen stets dieselbe Ausgabe.

Machen Sie aus dem Ergebnis einen hilfreichen Hinweis

Verwenden Sie die ausgegebene Zahl als Berechnung und wenden Sie anschließend Ihre Darstellungs- und Verkaufsregeln an. Eine positive Differenz kann als „Fügen Sie noch 12.00 für kostenlosen Versand hinzu“ in der richtigen Währung und Sprache erscheinen. Bei null können Sie „Sie erhalten kostenlosen Versand“ anzeigen.

Manche Shops schließen Sperrgut, digitale Waren, Steuern, Trinkgeld oder Liefergebühren aus; andere bewerten die Zwischensumme vor Gutscheinen. Solche Regeln außerhalb dieses Werkzeugs zu halten verhindert Annahmen über einen unbekannten Katalog. Speichern Sie für Analysen Schwelle und Gesamtwert zusammen mit der Differenz.

Fortschrittshinweis im Warenkorb

Zeigen Sie den exakt noch fehlenden berechtigten Betrag bis zum kostenlosen Versand an.

Berechtigungsprüfung im Checkout

Wandeln Sie Warenkorbwert und Schwelle in eine verlässliche, nie negative Differenz um.

Antworten im Kundendienst

Geben Sie Mitarbeitenden eine schnelle, reproduzierbare Berechnung für Fragen zu Versandkosten.

Berücksichtigt der Rechner Steuern oder Rabatte?

Wenden Sie zuvor Ihre Regeln für Berechtigung, Steuern, Rabatte und Ausschlüsse an.

Kann ich jede Währung verwenden?

Ja. Beide Werte müssen dieselbe Währung und Abrechnungsbasis verwenden. Formatieren Sie das Geldresultat in Ihrer Anwendung.

Welche Eingaben werden abgelehnt?

Fehlende Werte, Zeichenketten, Nullwerte, negative, unendliche und nicht numerische Angaben gelten als ungültig.

Rundet der Rechner den Fehlbetrag?

Nein. Er zieht den Warenkorbwert von der Schwelle ab und liefert die genaue Differenz, also ergibt 60 minus 42,50 genau 17,50. Währungssymbol und Nachkommastellen ergänzt Ihr Warenkorb oder Ihre Kassenseite.

Was passiert, wenn der Warenkorb die Schwelle schon erreicht hat?

Dann ist das Ergebnis null, und das ist ein normales Ergebnis, kein Fehler. Dasselbe gilt, wenn der Warenkorb die Schwelle übersteigt. Ihr Shop kann dann statt eines Hinweises den erreichten Vorteil anzeigen.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

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

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

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}'
{
  "current_total": 42.5,
  "free_shipping_threshold": 60
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.free_shipping_threshold_gap",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Ermitteln Sie den Restbetrag aus zwei Werten

Tragen Sie den aktuellen Warenwert als current_total und den erforderlichen Mindestwert als free_shipping_threshold ein. Der Rechner zieht den Warenkorbwert von der Schwelle ab und gibt die Differenz als amount_needed zurück.

Behandeln Sie bereits berechtigte Warenkörbe korrekt

Erreicht oder überschreitet der Warenkorb die Schwelle, ist amount_needed gleich null. Das ist ein gültiges Ergebnis und kein Fehler.

Machen Sie aus dem Ergebnis einen hilfreichen Hinweis

Ermitteln Sie current_total vor dem Aufruf nur aus berechtigten Produkten. Eine API-Anfrage kostet $0.002; die Browserversion nutzt kostenlos dieselbe reine Berechnung und lässt sich daher leicht prüfen, testen und einbinden.

Was geschieht, wenn der Warenkorb bereits berechtigt ist?

Der Rechner gibt amount_needed mit null aus. Das Erreichen oder Überschreiten der Schwelle ist ein Erfolg und kein Fehler.

Was kostet eine Berechnung per API?

Jede API-Anfrage kostet $0.002. Die Browserversion führt dieselbe deterministische Berechnung kostenlos aus.

Vollständige KIT-Dokumentation lesen →