Preis-API Sortiment (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, Topper und Bettwaren aus eigener Fertigung in Lemgo (Deutschland).
Endpunkte
Parameter der Preis-Route
produkt, kategorie, breite, laenge, hoehe, bezug, haerte, farbe, groesse, menge
produkt- Empfohlen: fixiert die Produktlinie. Ohne ihn wird die günstigste passende Option gewählt — ein Wechsel des Bezugs kann sonst still das Modell wechseln.
breite/laenge- Ganze Zentimeter. 25 von 26 Produkten nutzen diese beiden Achsen.
menge- „price" ist IMMER der Stückpreis; menge multipliziert ihn nicht.
preis_null- Ist „price" null, liegt zu dieser Kombination kein gepflegter Preis vor — dann gilt „reason", niemals 0 €.
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 sowie Topper mit einer Höhe über 6 cm, deren längste Seite 270 cm oder mehr misst).
- 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