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