ForHosting KIT · Finanzen und Geld

Versand-Treibstoffzuschlag

Machen Sie aus Grundfracht und aktuellem Treibstoffprozentsatz den Rechnungsbetrag: Eine Basis von 48,5 mit 12,5 % ergibt einen Zuschlag von 6,06 und eine Gesamtfracht von 54,56. Beide Werte geben Sie selbst ein, keine Tabelle wird abgefragt. 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
Grundtarif
48,5
Zuschlag (%)
12,5
Erhalten Sie
Zuschlagsbetrag
6,06
Fracht gesamt
54,56

Spediteure und Paketnetze veröffentlichen Treibstoffzuschläge als Prozentsatz der Basis-Transportgebühr, sodass der Betrag, den Sie einem Kunden in Rechnung stellen, nie nur der Listenpreis aus der Zonentabelle ist. Ops-Teams, Marketplace-Verkäufer und Frachtbroker brauchen einen einzigen deterministischen Schritt, der einen bekannten Basistarif und den aktuellen Treibstoffprozentsatz in den Zuschlagsbetrag und die All-in-Frachtgesamtsumme überführt.

Wie ein prozentualer Treibstoffzuschlag den Basistarif in die Gesamtfracht verwandelt

Ein Treibstoffzuschlag wird fast immer als Prozentsatz der Basis-Transport- oder Versandgebühr für ein gegebenes Servicelevel, eine Gewichtsklasse und eine Zielzone ausgedrückt. Zeigt das Carrier-Angebot oder Ihre Preisliste einen Basistarif von achtundvierzig Komma fünf Währungseinheiten und beträgt der veröffentlichte Treibstofffaktor zwölf Komma fünf Prozent, so ist der Zuschlagsbetrag Basis mal Prozent geteilt durch hundert, und die Gesamtfracht ist Basis plus dieser Zuschlag—beziehungsweise äquivalent Basis mal eins plus Prozent über hundert.

Die Rechnung von Hand ist für ein einzelnes Paket einfach und schmerzhaft, wenn Sie eine Wochenrechnung mit Hunderten von Zeilen abstimmen, jede mit anderer Basis und derselben wöchentlichen Treibstofftabelle. Diese Fähigkeit implementiert genau diese Zwei-Schritt-Identität ohne Carrier-Netzwerkabfrage und ohne datumsabhängige Tabelle: Sie liefern den Basistarif, den Sie bereits kennen, und den Zuschlagsprozentsatz für den Zeitraum, den Sie bepreisen.

Geldausgaben werden half-up auf zwei Nachkommastellen gerundet, sodass Gleitkomma-Zwischenwerte wie sechs Komma null sechs zwei fünf zu sechs Komma null sechs für den Zuschlag und vierundfünfzig Komma fünf sechs für die Summe werden und gängigen Buchhaltungs- und Rechnungszeilenkonventionen entsprechen.

Eingabevertrag, Antwortform und Validierungsverhalten

Der Basistarif ist auf eine Billion Währungseinheiten und der Zuschlagsprozentsatz auf tausend Prozent begrenzt, damit durchgegangene Automatisierung Anzeigepfade nicht überlaufen lässt. Eine Basis von hundert mit acht Prozent ergibt Zuschlag acht und Summe einhundertacht. Ungültige Anfragen werden nicht abgerechnet.

Kombinieren Sie diesen Endpunkt mit Ihrem eigenen Zonentarif- oder Volumengewichtsschritt, wenn Sie die Basis noch ableiten müssen; dieser Rechner wendet den Treibstoffprozentsatz erst an, wenn die Basis bekannt ist.

Wo sich der Treibstoffzuschlag-Rechner lohnt

E-Commerce-Plattformen nutzen einen Treibstoffzuschlag-Rechner, damit Checkout und Back-Office-Tools gelandete Fracht zeigen, die zu den wöchentlichen Carrier-Bulletins passt, ohne jeden Montag eine neue Konstante fest zu codieren. Drittanbieter-Logistikbetreiber und Frachtbroker brauchen ein deterministisches Orakel für Angebots-E-Mails, Preiskarten und Margenprüfungen, wenn dieselbe Basis unter unterschiedlichen Treibstofftabellen je Region oder Service erscheint. Halten Sie Basis und Prozent als einzige Eingaben, pinnen Sie gerundete Geldfelder in Tests und erhalten Sie reproduzierbare Frachtgesamtsummen für Marketplaces, WMS-Plugins und Edge-Worker, ohne eine eigene vollständige Rating-Engine aufzubauen.

Checkout und Anzeige der gelandeten Versandkosten

Zeigen Sie Käufern oder B2B-Kunden die All-in-Fracht, indem Sie den aktuellen Carrier-Treibstoffprozentsatz vor der Zahlung auf den angebotenen Basisversandtarif anwenden.

Rechnungszeilen und Carrier-Audit

Rekonstruieren Sie Zuschlag und Gesamtfracht je Basiszeile, wenn Sie wöchentliche Carrier-Rechnungen mit der veröffentlichten Treibstofftabelle für diesen Zeitraum abstimmen.

Angebots-E-Mails und Preiskarten

Erzeugen Sie Broker- oder 3PL-Angebote mit Basistarif, Treibstoffzuschlagsbetrag und Gesamtfracht aus einem einzigen Prozentsatz, der über viele SKUs geteilt wird.

Werden Live-Treibstofftabellen der Carrier abgefragt?

Nein. Sie liefern den Prozentsatz, der für den Zeitraum gilt, den Sie bepreisen.

Wie wird der Treibstoffzuschlag im Versand berechnet?

Multiplizieren Sie den Grundpreis mit dem Treibstoffprozentsatz und teilen Sie durch hundert; addieren Sie diesen Betrag dann zur Basis. Eine Basis von 100 mit 8 % ergibt einen Zuschlag von 8, der dann zur Basis hinzukommt.

Wie werden Zuschlag und Gesamtbetrag gerundet?

Beide werden kaufmännisch auf zwei Nachkommastellen gerundet, wie in üblichen Rechnungszeilen. Eine Basis von 48,5 mit 12,5 % zeigt daher einen Zuschlag von 6,06 und eine Gesamtfracht von 54,56.

Dürfen Grundpreis oder Prozentsatz null sein?

Ja. Ist einer der beiden Werte null, ist auch der Zuschlag null, und die Gesamtfracht entspricht der Basis. Negative Werte werden abgelehnt, und der Treibstoffprozentsatz darf tausend Prozent nicht überschreiten.

Gebe ich 12,5 oder einen Dezimalbruch für 12,5 % ein?

Geben Sie 12,5 ein. Der Treibstoffwert gilt als Prozentsatz des Grundpreises, so wie Frachtführer ihn in ihren Tabellen veröffentlichen, eine Umrechnung in eine Dezimalzahl ist nicht nötig.

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/fuel-surcharge

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/fuel-surcharge \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_rate":48.5,"surcharge_percent":12.5}'
{
  "base_rate": 48.5,
  "surcharge_percent": 12.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.fuel_surcharge",
  "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.

Dieser Versand-Treibstoffzuschlag-Rechner nimmt den Basisversandtarif und den Zuschlagsprozentsatz entgegen, multipliziert die Basis mit dem Prozentwert geteilt durch hundert für den Zuschlagsbetrag, addiert diesen zur Basis für die Gesamtfracht und rundet Geldbeträge half-up auf zwei Nachkommastellen, damit Rechnungen und API-Clients übereinstimmen. Basis null oder Prozent null sind erlaubt und ergeben null Zuschlag; negative Eingaben scheitern mit invalid_input und werden nicht abgerechnet.

Wie ein prozentualer Treibstoffzuschlag den Basistarif in die Gesamtfracht verwandelt

Die Antwort spiegelt die gesendeten Eingaben wider, liefert surcharge_amount und total_freight und enthält eine kurze formula-Zeichenkette, die Sie in der Oberfläche oder im Audit-Log neben den Zahlen anzeigen können.

Eingabevertrag, Antwortform und Validierungsverhalten

Senden Sie per POST einen JSON-Body mit zwei erforderlichen endlichen nichtnegativen Zahlen: base_rate, der Versand- oder Frachtbetrag vor Treibstoff (auch unter den Aliasen shipping_rate, rate, base_shipping_rate und freight_base akzeptiert); und surcharge_percent, der Treibstoffprozentsatz, zum Beispiel zwölf Komma fünf für zwölf Komma fünf Prozent (Aliase fuel_surcharge_percent, percent, fuel_percent und surcharge_pct). Jedes Feld kann als JSON-Zahl oder numerische Zeichenkette ankommen; leere Zeichenketten, fehlende Felder, nicht endliche Werte und Negative scheitern mit invalid_input und benennen das Feld. Bei Erfolg enthält der Body base_rate und surcharge_percent als normalisierte Zahlen, surcharge_amount und total_freight als half-up-Geld mit zwei Dezimalen sowie formula, das die Identität wiederholt. Beispiel: base_rate achtundvierzig Komma fünf und surcharge_percent zwölf Komma fünf ergeben surcharge_amount sechs Komma null sechs und total_freight vierundfünfzig Komma fünf sechs.

Wo eine API für Versand-Treibstoffzuschläge ihren Nutzen bringt

Tabellenersatz und Low-Code-Automatisierungen rufen die API auf, damit die Finanzabteilung historische Sendungen neu bepreisen kann, wenn eine strittige Rechnungszeile den Treibstofffaktor des Vormonats verwendete. Weil die Implementierung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz.

Wie berechne ich einen Versand-Treibstoffzuschlag?

Senden Sie nichtnegative base_rate und surcharge_percent. Die API liefert surcharge_amount = base_rate × surcharge_percent / 100 und total_freight = base_rate + surcharge_amount, Geld half-up auf zwei Dezimalen gerundet.

Welche Einheiten soll ich für base_rate verwenden?

Beliebige konsistente Geldeinheiten (USD, EUR usw.). Der Rechner ist einheitenagnostisch: er multipliziert und rundet; er wandelt keine Währungen um und schlägt keine Carrier-Tabellen nach.

Darf surcharge_percent null sein oder über 100 liegen?

Null ist erlaubt und ergibt null Zuschlag. Werte über 100 sind bis 1000 für extreme temporäre Tabellen zulässig; negativer Prozentwert wird mit invalid_input abgelehnt.

Was kostet der Versand-Treibstoffzuschlag-Rechner?

Das Browser-Tool ist kostenlos. API-Anfragen nutzen das prepaid KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingaben werden nicht abgerechnet.

Vollständige KIT-Dokumentation lesen →