Lieferpreis berechnen.

Technische Schnittstellen zum automatischen Preisabruf

Für den automatischen Preisabruf genügt ein GET-Aufruf der JSON-Schnittstelle. Die ebenfalls unterstützte POST-Variante ist ein alternativer Zugangsweg zur selben Berechnung und wird vom Preisrechner der Website genutzt.

JSON per GET abrufen

GET /lieferpreis.php?plz=50667 liefert den berechneten Lieferpreis als JSON. Die Liefer-PLZ wird direkt in der URL übergeben; ein JSON-Anfragetext ist dafür nicht erforderlich.

Alternative: JSON per POST abrufen

Die bestehende Website nutzt POST /lieferpreis.php mit Content-Type: application/json und einem freigegebenen Website-Origin. Das folgende JSON ist ein Beispiel für den Anfragetext bei POST, nicht für die Preisantwort:

{"plz":"50667","land":"DE"}

plz ist eine fünfstellige Zeichenkette; führende Nullen bleiben erhalten. Nur Deutschland wird unterstützt. GET und POST liefern dieselben Ergebnisfelder.

Die Liefer-PLZ genügt

Die Preisberechnung richtet sich ausschließlich nach der Liefer-PLZ. Eine Ortsauswahl oder zusätzliche Ortskennung ist nicht erforderlich. Der zurückgegebene Ortsname dient als Adressvorschlag und beeinflusst den Preis nicht. Im Anfrageformular kann er für die tatsächliche Lieferadresse angepasst werden.

Alternative im Browser: ohne JavaScript

GET /?plz=50667 zeigt dieselbe Berechnung als HTML im vorhandenen Preisbereich der Startseite. Das Formular funktioniert ohne JavaScript.

Felder einer erfolgreichen Berechnung

postcode, city, country

Bestätigte Liefer-PLZ, zugehöriger Ortsname als Adressvorschlag und Ländercode DE. Der Ortsname ist keine zusätzliche Preisbedingung.

unit, unit_kg, total

Nettopreis pro 20-kg-Ballen, pro Kilogramm und für die zugrunde gelegte volle LKW-Ladung einschließlich Lieferung. Geldbeträge sind Dezimalzeichenketten mit Punkt und zwei Nachkommastellen. Der Kilopreis wird aus dem angezeigten Ballenpreis kaufmännisch auf Cent gerundet. Der Gesamtpreis wird vor der Rundung auf einen einzelnen Ballen berechnet und kann deshalb vom gerundeten Ballenpreis mal 1.026 abweichen.

pallets, bales_per_pallet, bales, weight_kg, quantity_basis

38 Paletten, 27 Ballen je Palette, 1.026 Ballen, 20 kg je Ballen und eine Beschreibung des Mengenbezugs.

currency, tax_status, vat_percent, vat_included

EUR, net, 7 und false. Die Umsatzsteuer ist in den genannten Preisen nicht enthalten.

delivery_included, included_services, pallet_deposit

Enthaltene Lieferung (true), Liste der enthaltenen Leistungen und Hinweis auf das zusätzliche Pfand von 15,00 € zzgl. MwSt. je nicht getauschter EUR-Palette mit Gutschrift bei Rückgabe.

calculated_at, created_at, expires_at

Berechnungszeitpunkt als ISO-8601-Zeitstempel (UTC), zusätzlich lesbar in Europe/Berlin, sowie Ablaufzeitpunkt als ISO-8601-Zeitstempel. Eine Berechnung gilt höchstens 60 Minuten; geänderte Preisstände können eine Neuberechnung erfordern.

quote_id

Zufällige Referenz für die anschließende Angebotsanfrage. Diese Referenz vertraulich behandeln. Browserpreise werden beim Absenden nicht übernommen; der Server prüft den gespeicherten Preis, Preisstand, Menge, Lieferziel, Ablauf und Verwendungsstatus.

Ab-Preis abrufen

GET /preisstand.php liefert die aktuelle Untergrenze mit price_type: starting_from und postcode_dependent: true. Dieser Ab-Preis ersetzt keine Berechnung für eine Liefer-PLZ und erzeugt keine Anfragefreigabe.

HTTP-Status und Grenzen

200: berechneter Preis. 422: ungültige oder unbekannte PLZ. 429: zu viele Berechnungen; erneut nach der in Retry-After genannten Wartezeit versuchen. 503: Berechnung derzeit nicht verfügbar. GET und POST teilen sich ein Limit von 15 Berechnungen je IP-Adresse innerhalb von zehn Minuten, einschließlich des HTML-Formulars. Antworten werden nicht zwischengespeichert.

Fehler enthalten ausschließlich message. Beim JSON-POST gelten zusätzlich 400 für ungültiges JSON, 403 für fehlende oder nicht freigegebene Origins, 413 für zu große Eingaben und 415 für einen unpassenden Content-Type. Andere HTTP-Methoden erhalten 405. Es wird kein Ersatzpreis ausgegeben.

Die Schnittstelle veröffentlicht ausschließlich die oben dokumentierten Felder. Ein API-Schlüssel ist für die öffentliche Preisberechnung nicht erforderlich. Eine Berechnung löst keine Anfrage oder Bestellung aus.