Unsere öffentlichen Schnittstellen für Händler, Partner, Entwickler und KI-Agenten: Versandkosten berechnen, Lagerbestand abfragen, Produktdaten laden, Warenkörbe vorbereiten und Konfigurationen aus dem 3D-Konfigurator auswerten. Alle hier beschriebenen Schnittstellen sind kostenlos, lesend und ohne Anmeldung nutzbar.
ℹ️ Allgemeines
Format: JSON (UTF-8), Beträge als Zeichenkette mit Punkt, z. B. "18.14", in EUR (sofern nicht anders angegeben).
Anmeldung: nicht nötig. Alle beschriebenen Endpunkte sind öffentlich und nur lesend.
Fehler 403? Unsere Server stehen hinter Cloudflare. curl, Python requests und JavaScript fetch funktionieren ohne weitere Angaben; einzelne Bibliotheken (z. B. Python urllib) werden abgewiesen. Senden Sie dann einen eigenen User-Agent, z. B. MeineFirma-Integration/1.0 (kontakt@example.com).
Aufruf aus dem Browser (CORS): Die Lagerbestand-API und die Produkt-Feeds erlauben Aufrufe von jeder Website. Die Versandkosten-API ist für Aufrufe von Servern gedacht – rufen Sie sie aus Ihrem Backend auf.
Grenzen: Versandkosten für Konfigurationen: 60 Anfragen pro Minute und IP-Adresse (danach 429). Bitte fragen Sie Daten nicht häufiger als nötig ab und speichern Sie Ergebnisse kurz zwischen (z. B. Lagerbestand 5–10 Minuten).
Fehler: HTTP-Statuscodes (400 ungültige Eingabe, 404 nicht gefunden, 422 Parameter fehlen oder ungültig, 429 zu viele Anfragen). Der Text steht im Feld detail bzw. error.
Für KI-Agenten: Eine kompakte Übersicht für Sprachmodelle finden Sie unter /llms.txt und /agents.md.
🚚 Versandkosten-API
Basis-URL:https://modula24.com
Berechnet die Versandkosten genau wie unser Warenkorb und unsere Kasse – für einen Warenkorb, für Gewichte oder für eine Konfiguration aus dem 3D-Konfigurator. Ware aus unserem Lager in Hamburg geht per DHL (Pakete bis 31,5 kg), Ware, die nur in unserem Lager in China vorrätig ist, per Seefracht oder Luftfracht. Liegt nur ein Teil in Hamburg, gibt es eine Teilsendung. Welche Artikel wo liegen, ermittelt die API aus dem aktuellen Lagerbestand.
Versandarten (id): dhl (ab Hamburg: DHL Paket International Premium, Zustellung an die Haustür; in Deutschland DHL Paket), dhl_eco (ab Hamburg: DHL Paket International Economy, Zustellung an Packstation/Filiale – nur außerhalb der EU und nicht in allen Ländern), sea / air (nur China-Ware), split_sea / split_air (Teilsendung: Hamburg per DHL Premium, Rest aus China), air_door (nur außerhalb der EU, wenn auch Hamburg-Ware dabei ist: ganze Bestellung ab Lager China per Luftfracht bis zur Haustür, verzollt, 7–10 Werktage), pallet (Palette per Spedition ab Hamburg, nur Deutschland/EU/Schweiz/Norwegen/Island, bis 750 kg je Palette, ab 100 kg, nach Preis einsortiert), fourpx (4PX: ganze Bestellung ab Lager China, mit Sendungsverfolgung, Zoll übernimmt der Shop; auch in der EU, nicht in allen Ländern), sea_door (nur außerhalb der EU: ganze Bestellung ab Lager China per Seefracht bis zur Haustür, verzollt, 9–11 Wochen – steht immer am Ende). Welcher Tarif gilt, steht zusätzlich in legs[].product. Jede Option enthält cost, die Lieferzeit days mit unit (days = Werktage, weeks = Wochen) und die einzelnen Sendungsteile legs. Die günstigste Option steht zuerst (außer air_door, fourpx und sea_door, die immer am Ende stehen).
GET/api/checkout/config
Lieferländer – Liste der Lieferländer (ISO-3166-Codes) und Währungen. Nur diese Länder werden beliefert.
curl https://modula24.com/api/checkout/config
const res = await fetch('https://modula24.com/api/checkout/config');
const { countries } = await res.json();
console.log(countries); // ["AT", "AU", "BE", ...]
import requests
r = requests.get("https://modula24.com/api/checkout/config", timeout=10)
print(r.json()["countries"])
Versandkosten für eine Konfiguration – Für eine gespeicherte Konfiguration aus dem 3D-Konfigurator: Die Stückliste wird wie beim Knopf „In den Warenkorb“ in Shop-Artikel umgesetzt. Ohne country kommen die Optionen für alle Lieferländer (countries). Teile ohne lieferbaren Shop-Artikel stehen in missing – ihr Gewicht ist nicht enthalten, dann ist complete = false. Auch als POST mit {"config": "…"} oder einer Stückliste {"bom": […]}. Höchstens 60 Anfragen pro Minute.
Parameter
Name
Ort
Typ
Beschreibung
configPflicht
Query
string
Konfigurations-ID (z. B. LFKDD5KLP9MG)
countryoptional
Query
string
Lieferland; leer = alle Länder
currencyoptional
Query
string
EUR oder USD
missingoptional
Query
integer
1 = zusätzlich missing_shipping: geschätzter Versand der nicht lieferbaren Teile ab Lager China (Gewicht aus dem Katalog bzw. geschätzt nach Fläche/Länge, +10 % Verpackung; Optionen wie See-/Luftfracht, 4PX, fourpx_split = Aufteilung in 30-kg-Pakete). Richtwert ohne Zoll/Einfuhrumsatzsteuer; diese Teile sind im Shop nicht bestellbar. POST: "missing": true
curl "https://modula24.com/api/checkout/shipping?config=LFKDD5KLP9MG&country=AT"
# mit Versand-Schätzung für nicht lieferbare Teile (ab China)
curl "https://modula24.com/api/checkout/shipping?config=8JUKX9TJ2WSK&country=DE&missing=1"
const url = new URL('https://modula24.com/api/checkout/shipping');
url.searchParams.set('config', 'LFKDD5KLP9MG');
url.searchParams.set('country', 'AT');
const data = await (await fetch(url)).json();
if (!data.complete) console.warn('Nicht enthalten:', data.missing);
console.log(data.shipping_options, data.cart_url);
import requests
r = requests.get("https://modula24.com/api/checkout/shipping",
params={"config": "LFKDD5KLP9MG", "country": "AT"}, timeout=10)
d = r.json()
print(d["complete"], d["weight_kg"], d["shipping_options"], d["cart_url"])
Aktueller Bestand unseres Lagers in Hamburg (hamburg) je Lager-SKU. Ideal für Händler, Preisvergleiche und Warenwirtschaften. Die Daten werden laufend aktualisiert (Verkäufe über alle Kanäle werden alle 10 Minuten verbucht); das Feld data_updated_at zeigt die letzte Änderung. Aufruf auch direkt aus dem Browser möglich (CORS).
Felder je Artikel:sku, warehouse, title, price + currency (Preis wie im Shop; null, wenn der Artikel nicht im Shop ist), available (verfügbare Menge), ean, url (Produktseite auf modula24.com, deutsch), urls (Produktseite je Sprache: de, en, fr, it), updated_at. Wird ein Artikel auf modula24.com nicht angeboten, sind url und urlsnull.
GET/stock
Bestand abfragen – Alle Artikel oder gefiltert. Filter lassen sich kombinieren.
Parameter
Name
Ort
Typ
Beschreibung
warehouseoptional
Query
string
Lager-ID (siehe /warehouses), derzeit hamburg; leer = alle
const res = await fetch('https://api.modula24.com/stock?warehouse=hamburg&in_stock=true');
const { items, data_updated_at } = await res.json();
for (const i of items) console.log(i.sku, i.available);
import requests
r = requests.get("https://api.modula24.com/stock",
params={"warehouse": "hamburg", "skus": "kugel,rohr_350"}, timeout=10)
for item in r.json()["items"]:
print(item["sku"], item["available"])
Alle bestellbaren Artikel mit Preis, Verfügbarkeit, Bildern, Gewicht, Kategorie, Farbe/Größe und Versandkosten je Lieferland (1 Stück, günstigste Versandart) – je Sprache als JSON und im Format des Google Merchant Centers. Die Feeds werden bei jeder Änderung im Shop neu erzeugt. Die variant_id brauchen Sie für die Versandkosten-API und den Warenkorb-Link.
GET/products.json
Produkte (Shopify-kompatibel) – Alle Produkte mit Varianten im bekannten Shopify-Format – vorhandene Shopify-Werkzeuge funktionieren damit weiter. Einzelnes Produkt: /products/{handle}.json, Produkte einer Kategorie: /collections/{handle}/products.json. Andere Sprachen mit Präfix, z. B. /en/products.json. Die Varianten-id ist die variant_id für Versandkosten-API und Warenkorb-Link.
Parameter
Name
Ort
Typ
Beschreibung
handleoptional
Pfad
string
URL-Name des Produkts bzw. der Kategorie (aus dem Link)
const { product } = await (await fetch('https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json')).json();
for (const v of product.variants) console.log(v.id, v.title, v.price, v.available);
import requests
r = requests.get("https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json", timeout=10)
for v in r.json()["product"]["variants"]:
print(v["id"], v["title"], v["price"], v["available"])
Google-Merchant-Feed (XML) – RSS 2.0 mit Google-Namensraum für Merchant Center, Preisportale und Marktplätze. {lang} = de, en, fr, it, ja oder us (USD). Außerdem: /sitemap.xml.
Parameter
Name
Ort
Typ
Beschreibung
langPflicht
Pfad
string
Sprache bzw. us
curl https://modula24.com/feeds/google.de.xml
const xml = await (await fetch('https://modula24.com/feeds/google.de.xml')).text();
const doc = new DOMParser().parseFromString(xml, 'application/xml');
console.log(doc.querySelectorAll('item').length);
import requests, xml.etree.ElementTree as ET
xml = requests.get("https://modula24.com/feeds/google.de.xml", timeout=20).content
G = "{http://base.google.com/ns/1.0}"
for item in ET.fromstring(xml).iter("item"):
print(item.find(G + "id").text, item.find("title").text, item.find(G + "price").text)
Antwort (gekürzt)
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"><channel>
<item>
<g:id>M24-58436517069064</g:id>
<title>Konnektor Connector Verbindung - 100% kompatibel mit USM Haller</title>
<g:price>0.95 EUR</g:price>
<g:availability>in_stock</g:availability>
…
</item>
🛒 Warenkorb-Link
Basis-URL:https://modula24.com
Ein Link, der Artikel direkt in den Warenkorb eines Besuchers legt – z. B. aus einer Stückliste, einem Angebot, einem Planungs-Tool oder einem KI-Assistenten. Der Besucher sieht „N Artikel wurden in den Warenkorb gelegt“ und bestellt selbst in der Kasse. Nur bekannte, lieferbare Varianten werden übernommen; bereits vorhandene Artikel bleiben im Warenkorb, gleiche Varianten werden addiert. Höchstens 60 Positionen je Link.
LINK/cart?add={variant_id}:{qty},…
Artikel in den Warenkorb legen – Sprachen: /cart (Deutsch), /en/cart, /fr/cart, /it/cart, /ja/cart. Mit &cfg=ID wird die Konfigurations-ID mit angezeigt.
items = [("58436497375496", 8), ("58546503745800", 8)]
url = "https://modula24.com/cart?add=" + ",".join(f"{vid}:{qty}" for vid, qty in items)
print(url)
🧩 Konfigurator-API
Basis-URL:https://konfigurator.modula24.com
Jede im 3D-Konfigurator gespeicherte Konfiguration hat eine ID aus 12 Zeichen (z. B. LFKDD5KLP9MG). Mit dieser ID können Sie die Konfiguration öffnen, Preis, Gewicht und Außenmaße abrufen, sie in Shop-Artikel umsetzen (für den Warenkorb-Link) und die Versandkosten berechnen (siehe Versandkosten-API). Konfigurator öffnen: https://konfigurator.modula24.com/?load=ID.
GET/checkout-api.php?action=summary&id={id}
Zusammenfassung – Preis laut Konfigurator, Gewicht, Außenmaße (mm) und Stückliste.
Als Shop-Artikel – Setzt die Stückliste in bestellbare Shop-Artikel um (lines) und liefert den fertigen Warenkorb-Link (url). Nicht im Shop erhältliche oder nicht lieferbare Teile stehen in missing.
Galerie-Bilder – Fotorealistische KI-Bilder echter Konfigurationen mit Farbe, Außenmaßen (mm), Fächern und Konfigurations-ID. Bild-URL: https://konfigurator.modula24.com/images/ai/{file}.
import requests
r = requests.get("https://konfigurator.modula24.com/galerie.php",
params={"format": "json"}, timeout=20)
for im in r.json()["images"][:3]:
print(im["cfg"], im["code"], im["dims"])