Schnittstelle

Wir helfen Effizienz zu schaffen

Verbinden Sie Ihr ERP oder Ihr Lagersystem direkt mit unserem Katalog. Preise, Verfügbarkeit, Versandtermin und Bestellung — ohne dass jemand etwas abtippt.

Die Schnittstelle spricht Ihre Nummern

In Ihrem Artikelstamm stehen HASCO- und Meusburger-Nummern — teils seit zwanzig Jahren. Eine Schnittstelle, die unsere Artikelnummern verlangt, bedeutet: erst den kompletten Stamm umschlüsseln, dann bestellen. Genau deshalb bleiben Lieferanten-APIs ungenutzt.

Unsere nimmt Z40/6x160 und antwortet mit dem passenden Artikel, dem Preis und dem Versandtag. Keine Umschlüsselung, keine Mapping-Tabelle auf Ihrer Seite.

Anfrage

curl https://api.normalien.example/v1/lookup?q=Z40/6x160 \
     -H "X-API-Key: nk_live_..."

Antwort

{
  "query": "Z40/6x160",
  "status": "matched",
  "sku": "KX-EJP-060-1600",
  "name": "Auswerferstift DIN 1530 A Ø6 x 160",
  "price_eur": 8.40,
  "available": 120,
  "compatibility": "Compatible with HASCO Z40/6x160"
}

Endpunkte

GET	/v1/lookup?q=…	Eine Nummer auflösen — Ihre oder unsere.
POST	/v1/lookup	Bis zu 500 Nummern auf einmal. Ihr ganzer Artikelstamm in einem Aufruf.
GET	/v1/availability	Bestand, Versandtag und Cut-off. Der Aufruf, den eine Mindestbestandsregel macht.
POST	/v1/quote	Preise inkl. Staffeln, USt und Liefertermin. Reserviert nichts.
POST	/v1/orders	Bestellung mit Ihrer Bestellnummer und Kostenstelle je Position.
GET	/v1/orders/{ref}	Auftragsstatus.

Vollständige OpenAPI-Beschreibung unter /docs — Ihr Client lässt sich daraus generieren.

Wofür Kunden sie nutzen

Automatische Nachbestellung. Ihr System prüft den Mindestbestand und bestellt selbst — mit Ihrer Bestellnummer und Kostenstelle je Position.
Preise und Termine im eigenen System. Ihre Kalkulation zieht den aktuellen Preis, statt in einer PDF-Preisliste zu suchen.
Stücklisten prüfen. 500 Positionen in einem Aufruf, bevor das Werkzeug in Arbeit geht.

Was wir nicht raten

Eine Nummer wie Z181/25x64 enthält die Lastklasse nicht — die steckt in der Farbe. Wir liefern in so einem Fall alle vier Kandidaten zurück, nie einen geratenen.

Genauso bei Bestellungen: lässt sich eine Position nicht eindeutig auflösen, scheitert die ganze Bestellung. Eine stillschweigend gekürzte Lieferung merkt man erst, wenn das Werkzeug zerlegt auf der Bank liegt.

Zugang

Kostenlos für Kunden. Ein Schlüssel je System, Rechte getrennt nach Lesen und Bestellen — Ihre Kalkulation braucht keinen Bestellzugriff.

API-Schlüssel anfragen →

Wir schicken Ihnen den Schlüssel und ein Beispiel für Ihr System. Bei den gängigen ERPs helfen wir beim Anbinden.