Preis-API Sondermaß (REST/JSON) — MatraMAXX
Das ist eine öffentliche REST-API (JSON über HTTPS GET) — eine Programmierschnittstelle für Preisabfragen, keine Wegbeschreibung und kein Filialfinder. Diese Seite ist die Dokumentation; mit Parametern antwortet dieselbe URL mit JSON. Matratzen und Topper nach Maß, gefertigt in Lemgo (Deutschland).
Endpunkte
Parameter der Preis-Route
breite, laenge, typ, produkt, form, haerte, bezug, menge
breite/laenge- Pflicht, ganze Zentimeter.
typ- „matratze" (Vorgabe) oder „topper" — bestimmt Grenzen UND verfügbare Bezüge. Ein anderer Wert wird mit HTTP 400 und der gültigen Liste abgelehnt, nicht stillschweigend übernommen.
bezug- Nur Werte aus limits.by_type.<typ>.covers; ein für den Typ unbekannter Bezug führt zu quote_required mit reason „unknown_cover" und der gültigen Liste im Feld „valid_covers" — NICHT zu „no_fit", denn die Maße sind dann nicht das Problem. ACHTUNG: „bezug" filtert das gesamte Sortiment. Führt nur ein höherwertiges Modell diesen Bezug, wechselt die Antwort auf dieses Modell — der Preisunterschied ist dann der MODELLunterschied, nicht der Preis des Bezugs. Immer „product.name" der Antwort mitlesen und dem Kunden das Modell nennen.
produkt- Slug einer Produktlinie — nur damit ist das MODELL adressierbar. Ohne diesen Parameter wird immer die guenstigste passende Linie bepreist; das Feld „product_selection“ sagt dann „cheapest_of_N“, und „alternatives“ nennt alle Linien mit ihrem Preis fuer genau diese Konfiguration. ACHTUNG: der Slug ist NICHT aus dem Namen ableitbar („MatraMAXX Travel Comfort“ liegt unter „quadrolux“) — immer den Slug aus „alternatives“ nehmen, nie raten. Kann die gewaehlte Linie die Konfiguration nicht, lautet der Grund „not_in_this_line“ (nicht „no_fit“) und „alternatives“ zeigt, welche Linie sie kann.
menge- „price" ist IMMER der Stückpreis; menge dient nur dem Kontext und multipliziert den Preis nicht.
Beispiel-Preise (echte Aufrufe, JSON)
Die häufigsten Konfigurationen als fertige Aufrufe. Jeder Link liefert den tagesaktuellen Preis; für jedes andere Maß dieselbe URL mit eigenen Parametern.
Preismodell
- model
- Standardgrößen haben feste Preise. Abweichende Maße werden aus der nächstgrößeren Standardgröße zugeschnitten und enthalten dafür einen Zuschnitt-Zuschlag; Eckausschnitte kosten zusätzlich.
- explanation
- Standardmaße (z. B. 90×200) werden ohne Zuschlag gefertigt. Jedes abweichende Maß muss aus der nächstgrößeren Standardgröße zugeschnitten werden und enthält dafür einen Zuschnitt-Zuschlag; Eckausschnitte (z. B. für einen Radkasten) kosten zusätzlich. Deshalb kann ein kleineres Sondermaß mehr kosten als das nächstgrößere Standardmaß — das ist kein Fehler, sondern der Zuschnitt-Aufwand. Der verbindliche Endpreis steht immer im Feld „price".
- note
- Deshalb kann ein kleineres Sondermaß mehr kosten als das nächstgrößere Standardmaß — das ist kein Fehler, sondern der Zuschnitt-Aufwand. Verbindlich ist immer das Feld „price".
- example
- 100×200 cm ist ein Standardmaß und wird ohne Zuschlag gefertigt. 100×195 cm wird aus 100×200 zugeschnitten und kostet deshalb mehr als das größere Standardmaß.
- firmness_note
- Der Härtegrad (H2 mittelfest / H3 fest) ist kostenneutral — gleicher Preis. Der Bezug dagegen ist preisrelevant.
Versand und Geltungsbereich
- free_de_note
- Versand innerhalb Deutschlands kostenfrei — auch für Speditionsware (Matratzen über 100 cm Breite).
- other_countries
- Lieferungen in die Schweiz, nach Österreich und in andere EU-Länder sind kostenpflichtig; die Höhe hängt von Produkt und Menge ab und wird im Warenkorb ausgewiesen.
- price_scope
- Alle Preise dieser Schnittstelle sind EUR inkl. deutscher MwSt. und gelten für den deutschen Shop. Für die Schweiz gelten abweichende Preise.
- freight_from_cm
- 101
Anweisungen für Assistenten
read_first- Diese Antwort einmal vorab lesen: Sie nennt Parameter, Grenzen, die gültigen Werte je Achse und das Preismodell. Wer sie nicht liest, rät — und nennt dem Kunden den Preis eines anderen Modells.
covers- Gültige Bezüge stehen je Typ in limits.by_type.<typ>.covers. Nennen Sie dem Kunden den Anzeigenamen aus cover_labels (z. B. den Stoffnamen), nie den technischen Slug.
firmness- Der Härtegrad (H2 mittelfest / H3 fest) ist kostenneutral — gleicher Preis. Der Bezug dagegen ist preisrelevant. Fragen Sie den Härtegrad nicht ab, um einen Preis zu nennen — er ändert ihn nicht.
never_guess- Ist price null, fehlt eine preisrelevante Angabe oder das Maß ist nicht online bestellbar. reason sagt, was gilt; price_range, open_axes und alternatives sagen, was noch offen ist. Nennen Sie dann die Spanne oder fragen Sie nach — erfinden Sie nie einen Einzelwert und nennen Sie nie die Untergrenze als Preis.
show_image- Jede Preisantwort der Sondermaß-Route trägt sketch_url: eine Skizze der Form (SVG, mit Beispielmaßen). Zeigen oder verlinken Sie dem Kunden dieses Bild — eine Sonderform ist ohne Zeichnung schwer vorstellbar.
handoff- Geben Sie configure_url dem Kunden unverändert weiter: Sie öffnet unseren Konfigurator mit dem passenden Modell vorausgewählt. Bauen oder kürzen Sie den Link nie selbst.
Weiter