Le nostre interfacce pubbliche per rivenditori, partner, sviluppatori e agenti IA: calcolare le spese di spedizione, consultare le giacenze, caricare i dati dei prodotti, preparare carrelli e analizzare le configurazioni del configuratore 3D. Tutte le interfacce descritte qui sono gratuite, di sola lettura e senza registrazione.
ℹ️ Informazioni generali
Formato: JSON (UTF-8); importi come stringa con il punto, ad es. "18.14", in EUR (salvo diversa indicazione).
Autenticazione: nessuna. Tutti gli endpoint descritti qui sono pubblici e di sola lettura.
Errore 403? I nostri server sono dietro Cloudflare. curl, Python requests e JavaScript fetch funzionano senza altre impostazioni; alcune librerie (ad es. Python urllib) vengono rifiutate. In tal caso invia un tuo User-Agent, ad es. MeineFirma-Integration/1.0 (kontakt@example.com).
Chiamate dal browser (CORS): l’API delle giacenze e i feed prodotti possono essere chiamati da qualsiasi sito. L’API delle spese di spedizione è pensata per chiamate da server a server – chiamala dal tuo backend.
Limiti: spese di spedizione per configurazioni: 60 richieste al minuto per indirizzo IP (poi 429). Non richiedere i dati più spesso del necessario e memorizza brevemente i risultati (ad es. giacenze 5–10 minuti).
Errori: codici di stato HTTP (400 input non valido, 404 non trovato, 422 parametri mancanti o non validi, 429 troppe richieste). Il messaggio è nel campo detail o error.
Per agenti IA: una panoramica compatta per modelli linguistici è disponibile su /llms.txt e /agents.md.
🚚 API spese di spedizione
URL di base:https://modula24.com
Calcola le spese di spedizione esattamente come il nostro carrello e la cassa – per un carrello, per dei pesi o per una configurazione del configuratore 3D. La merce del nostro magazzino di Amburgo viene spedita con DHL (pacchi fino a 31,5 kg); la merce disponibile solo nel magazzino in Cina viene spedita via mare o via aerea. Se solo una parte è ad Amburgo, viene offerta una spedizione parziale. L’API determina dove si trovano gli articoli in base alle giacenze attuali.
Metodi di spedizione (id): dhl (da Amburgo: DHL Paket International Premium, consegna a domicilio; in Germania pacco DHL), dhl_eco (da Amburgo: DHL Paket International Economy, consegna a locker/ufficio postale – solo fuori dall’UE e non in tutti i paesi), sea / air (merce solo in Cina), split_sea / split_air (spedizione parziale: Amburgo con DHL Premium, il resto dalla Cina), air_door (solo fuori dall’UE, se l’ordine contiene articoli di Amburgo: intero ordine dal magazzino in Cina via aerea fino a casa, sdoganato, 7–10 giorni lavorativi), pallet (pallet tramite corriere da Amburgo, solo Germania/UE/Svizzera/Norvegia/Islanda, fino a 750 kg per pallet, a partire da 100 kg, ordinato per prezzo), fourpx (4PX: intero ordine dal magazzino in Cina, con tracciamento, dazi a carico del negozio; anche nell’UE, non in tutti i paesi), sea_door (solo fuori dall’UE: intero ordine dal magazzino in Cina via mare fino a casa, sdoganato, 9–11 settimane – sempre per ultimo). Il tariffario è indicato anche in legs[].product. Ogni opzione contiene cost, i tempi di consegna days con unit (days = giorni lavorativi, weeks = settimane) e le singole parti della spedizione legs. L’opzione più economica è la prima (tranne air_door, fourpx e sea_door, sempre per ultimi).
GET/api/checkout/config
Paesi di consegna – Elenco dei paesi di consegna (codici ISO 3166) e delle valute. Consegniamo solo in questi paesi.
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"])
Spese di spedizione per una configurazione – Per una configurazione salvata del configuratore 3D: la distinta viene convertita in articoli del negozio come con il pulsante “Aggiungi al carrello”. Senza country si ottengono le opzioni per tutti i paesi di consegna (countries). Le parti senza articolo disponibile sono in missing – il loro peso non è incluso e complete è false. Disponibile anche come POST con {"config": "…"} o una distinta {"bom": […]}. Max. 60 richieste al minuto.
Parametri
Nome
Posizione
Tipo
Descrizione
configobbligatorio
query
string
ID della configurazione (ad es. LFKDD5KLP9MG)
countryfacoltativo
query
string
Paese di consegna; vuoto = tutti i paesi
currencyfacoltativo
query
string
EUR o USD
missingfacoltativo
query
integer
1 = restituisce anche missing_shipping: spedizione stimata delle parti non disponibili dal nostro magazzino in Cina (peso dal catalogo o stimato per superficie/lunghezza, +10 % imballo; opzioni come nave/aereo, 4PX, fourpx_split = suddivisione in colli da 30 kg). Valore indicativo senza dazi/IVA all’importazione; queste parti non sono ordinabili nel negozio. 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"])
Giacenze attuali del nostro magazzino di Amburgo (hamburg) per SKU. Ideale per rivenditori, comparatori di prezzi e gestionali. I dati vengono aggiornati continuamente (le vendite di tutti i canali vengono registrate ogni 10 minuti); il campo data_updated_at indica l’ultima modifica. Chiamabile anche direttamente dal browser (CORS).
Campi per articolo:sku, warehouse, title, price + currency (stesso prezzo del negozio; null se l’articolo non è in vendita nel negozio), available (quantità disponibile), ean, url (pagina prodotto su modula24.com, in tedesco), urls (pagina prodotto per lingua: de, en, fr, it), updated_at. Se un articolo non è offerto su modula24.com, url e urls sono null.
GET/stock
Consultare le giacenze – Tutti gli articoli o filtrati. I filtri sono combinabili.
Parametri
Nome
Posizione
Tipo
Descrizione
warehousefacoltativo
query
string
ID del magazzino (vedi /warehouses), attualmente hamburg; vuoto = tutti
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"])
Tutti gli articoli ordinabili con prezzo, disponibilità, immagini, peso, categoria, colore/misura e spese di spedizione per paese di destinazione (1 pezzo, opzione più economica) – per lingua in JSON e nel formato Google Merchant Center. I feed vengono rigenerati a ogni modifica del negozio. La variant_id serve per l’API delle spese di spedizione e per il link al carrello.
GET/products.json
Prodotti (compatibile con Shopify) – Tutti i prodotti con varianti nel noto formato Shopify – gli strumenti Shopify esistenti continuano a funzionare. Singolo prodotto: /products/{handle}.json, prodotti di una categoria: /collections/{handle}/products.json. Altre lingue con prefisso, ad es. /it/products.json. L’id della variante è la variant_id per l’API delle spese di spedizione e il link al carrello.
Parametri
Nome
Posizione
Tipo
Descrizione
handlefacoltativo
percorso
string
Nome URL del prodotto o della categoria (dal 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"])
Feed Google Merchant (XML) – RSS 2.0 con namespace Google per Merchant Center, comparatori di prezzi e marketplace. {lang} = de, en, fr, it, ja o us (USD). Inoltre: /sitemap.xml.
Parametri
Nome
Posizione
Tipo
Descrizione
langobbligatorio
percorso
string
Lingua o 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)
Risposta (abbreviata)
<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>
🛒 Link al carrello
URL di base:https://modula24.com
Un link che inserisce gli articoli direttamente nel carrello di un visitatore – ad es. da una distinta, un preventivo, uno strumento di progettazione o un assistente IA. Il visitatore vede “N articoli aggiunti al carrello” e ordina lui stesso alla cassa. Vengono accettate solo varianti note e disponibili; gli articoli già presenti restano, le varianti uguali vengono sommate. Max. 60 righe per link.
LINK/cart?add={variant_id}:{qty},…
Aggiungere articoli al carrello – Lingue: /cart (tedesco), /en/cart, /fr/cart, /it/cart, /ja/cart. Con &cfg=ID viene mostrato anche l’ID della configurazione.
items = [("58436497375496", 8), ("58546503745800", 8)]
url = "https://modula24.com/cart?add=" + ",".join(f"{vid}:{qty}" for vid, qty in items)
print(url)
🧩 API del configuratore
URL di base:https://konfigurator.modula24.com
Ogni configurazione salvata nel configuratore 3D ha un ID di 12 caratteri (ad es. LFKDD5KLP9MG). Con questo ID puoi aprire la configurazione, ottenere prezzo, peso e dimensioni esterne, convertirla in articoli del negozio (per il link al carrello) e calcolare le spese di spedizione (vedi API spese di spedizione). Aprire il configuratore: https://konfigurator.modula24.com/?load=ID.
GET/checkout-api.php?action=summary&id={id}
Riepilogo – Prezzo secondo il configuratore, peso, dimensioni esterne (mm) e distinta.
Come articoli del negozio – Converte la distinta in articoli ordinabili (lines) e restituisce il link al carrello pronto (url). Le parti non disponibili sono in missing.
Immagini della galleria – Immagini IA fotorealistiche di configurazioni reali con colore, dimensioni esterne (mm), vani e ID della configurazione. URL immagine: 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"])