ForHosting KIT · Entwickler-Tools

Fehlbetrag für kostenlosen Versand berechnen

Der Rechner für die Versandfreigrenze macht aus zwei Bestellwerten eine direkt nutzbare Angabe: den Betrag, den ein Kunde noch hinzufügen muss.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

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.

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

Erreicht oder überschreitet der Warenkorb die Schwelle, ist amount_needed gleich null. Das ist ein gültiges Ergebnis und kein Fehler. 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. Ermitteln Sie current_total vor dem Aufruf nur aus berechtigten Produkten. 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. Eine API-Anfrage kostet $0.002; die Browserversion nutzt kostenlos dieselbe reine Berechnung und lässt sich daher leicht prüfen, testen und einbinden.

Anwendungsfälle

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.

Häufige Fragen

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.

Berücksichtigt der Rechner Steuern oder Rabatte?

Er verwendet current_total genau wie von Ihnen übermittelt. 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.

Was kostet eine Berechnung per API?

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

Für Entwickler — API-Zugang

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.

Endpunkt

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.

Aufruf aus Ihrem 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)

Beispiel-Anfrage

{
  "current_total": 42.5,
  "free_shipping_threshold": 60
}

Beispiel-Antwort

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

Preis

pro Anfrage$0.002

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

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →