Betriebsmittel massenhaft importieren: Mein API-Hack

Stell dir vor, es ist Dienstagmorgen. Auf dem Hof deiner Firma fährt der LKW vor und lädt eine Palette ab. Darauf: 200 nagelneue Rundschlingen und 50 Kettenzüge. Ein Traum für die Jungs auf der Baustelle, die endlich wieder ordentliches Material haben.

Aber im Büro sitzt jetzt jemand, dem der kalte Schweiß ausbricht. Denn diese 250 Teile müssen alle ins System. Jedes einzelne braucht eine Seriennummer, einen Standort, einen Verantwortlichen und das hinterlegte Werkszeugnis. Wenn du das händisch eintippst, bist du nicht am Dienstag fertig, sondern irgendwann nach Weihnachten.

Ganz ehrlich: Genau an solchen Scheißprozessen stirbt die Digitalisierung in der Praxis. Die physische Lieferung ist am nächsten Tag da, aber der digitale Zwilling steckt im Excel-Trauma fest. Wir haben uns das bei Lizard eine Weile angeschaut und uns dann gefragt: Was wäre, wenn nicht der Kunde tippen muss, sondern der Händler die Daten gleich mitliefert?

So ist unser neuestes Baby entstanden: Der ExpressImport. Kein fettes neues Software-Modul, sondern ein extrem schlanker API-Hack, der gerade die Beziehung zwischen Händlern und Betreibern komplett auf links dreht. Komm, ich zeig dir mal, wie wir das am Whiteboard gelöst haben.

200 Rundschlingen und ein Excel-Trauma: Wenn Betriebsmittel digital erfassen nervt

Der Klassiker sieht so aus: Du kaufst Software zur Betriebsmittelverwaltung, um endlich dein Zettel-Chaos in den Griff zu bekommen. Die Software ist super. Aber sie ist leer. Um Wert daraus zu ziehen, musst du sie füttern.

Bisher hieß das für unsere Kunden: Entweder den Praktikanten wochenlang abbestellen oder unseren KI-Import nutzen. Letzterer ist schon geil, aber bei hunderten identischen Artikeln aus einer Neubeschaffung immer noch ein Nadelöhr.

Wir dachten uns: Der Händler, der dir die 200 Schlingen verkauft, hat die Daten doch alle in seinem ERP-System (wie SAP). Warum gibt er dir nicht einfach direkt den fertigen Datensatz? Noch besser: Warum legt er die Dinger nicht direkt in deinem Namen in deinem System an?

Das Problem: Du willst dem Händler ja keinen Vollzugriff als Admin in deiner Firmen-IT geben. Und der Händler hat keine Lust, sich in 50 verschiedene Kunden-Systeme einzuloggen. Es musste also eine Brücke her.

Die API-first Architektur: Warum wir den ExpressImport ausgelagert haben

Hier hat es sich massiv ausgezahlt, dass wir Lizard von Tag eins an als offenes Ökosystem gebaut haben. Wir haben nicht versucht, den Express-Importer tief in den Kern unseres Systems zu schweißen. Stattdessen haben wir ein eigenständiges Tool gebaut, das unsere eigene Software einfach nur fernbedient.

Der Händler öffnet eine simple Weboberfläche. Der Betreiber gibt ihm vorab einen speziellen API-Token (einen digitalen Schlüssel mit begrenzten Rechten). Der Händler lädt seine Liste hoch, drückt auf Start, und das Tool feuert die Daten über unsere Schnittstellen direkt in das Lizard-System des Kunden.

Das ist das Schöne an einer echten API-first Architektur: Du baust das Backend einmal sauber auf, und danach kannst du lauter kleine, smarte Werkzeuge drumherum iterieren, ohne das Mutterschiff anfassen zu müssen.

Kein Datenbank-Klotz am Bein: Security und CSV Import auf Baustellen-Art

Als ich die Idee für das Tool gepitcht habe, war die erste Frage: "Okay, und wo hosten wir die neue Datenbank für die Händler?" Meine Antwort: Gar nicht.

Wir haben das Ding komplett ohne eigene Datenbank gebaut. Alles passiert im Browser des Händlers. Warum? Weil wir null Bock auf DSGVO-Alpträume hatten und sensible Kundendaten (wie API-Keys von Konzernen wie thyssenkrupp) nicht bei uns zwischenspeichern wollen.

Das klingt simpel, hat uns aber vor ein paar knackige technische Hürden gestellt. Hier sind 3 Dinge, die wir beim massenhaften CSV-Import auf die harte Tour gelernt haben:

• Der PDF-Speicher-Trick: Kleine Metadaten kann man super im localStorage des Browsers ablegen. Aber wenn der Händler 200 Werksbescheinigungen als PDF mitliefert, sprengt das sofort das 5-MB-Limit. Die Lösung? Wir schieben die fetten Inspektionsdateien temporär in die IndexedDB des Browsers. Sobald der Import durch ist, wird alles sauber gelöscht.
• Token-Verschlüsselung mit Paranoia-Level: Wir speichern keine API-Keys im Klartext. Der Token wird direkt im Browser via AES-256-GCM verschlüsselt. Unser FastAPI-Backend fungiert nur als dummer Proxy. Der Klartext-Token existiert nur für den Bruchteil einer Sekunde während des API-Requests und wird danach sofort gegrillt. Das ist Industrie-Standard.
• Das Spalten-Mapping-Chaos: Frag drei Händler nach einer CSV-Datei, und du bekommst fünf verschiedene Formate. Statt den Händlern unser Format aufzuzwingen, haben wir einen automatischen Delimiter-Check gebaut. Das System erkennt die Spaltennamen selbst und mappt sie (z.B. "sapnummer" auf unsere "Betriebsmittelnummer"). Das Original-CSV bleibt als Template erhalten.

Und um zu verhindern, dass ein Händler mit 1.000 Items auf einen Schlag unsere Server in die Knie zwingt, haben wir ein ressourcenschonendes Rate-Limiting eingebaut: Exakt 200 Millisekunden Pause zwischen jedem Request. Der Batch tröpfelt sauber ins System, während sich der Händler einen Kaffee holt.

Das Win-Win-Prinzip: Wenn der Händler die Betriebsmittelverwaltung übernimmt

Was mich an diesem Projekt am meisten fasziniert, ist gar nicht der Code. Es ist der geschäftliche Hebel. Wir haben hier ein Werkzeug gebaut, das den Vertrieb von Industriegütern verändert.

Stell dir vor, du bist Verkäufer. Dein Kunde jammert über den Dokumentationsaufwand. Du sagst: "Pass auf, gib mir deinen Lizard-Key. Ich pflege dir die 200 Schlingen direkt ein. Wenn die Palette morgen bei dir auf den Hof rollt, sind die Dinge alle schon im System."

Wir gehen sogar noch einen Schritt weiter: Der Import verknüpft die Datensätze direkt mit unseren Dyntags. Der Händler klebt den QR-Code vor dem Versand auf die Schlinge. Die Lieferung kommt auf der Baustelle an, der Polier scannt das Ding mit dem Handy, die Ampel springt auf Grün und die Werksbescheinigung ist sofort auf dem Schirm. Boom.

Das ist das "Mach Dass Es Geht" (MDEG)-Prinzip in Reinkultur. Der Kunde zahlt für diesen Service vielleicht ein paar Euro mehr, ist aber mega glücklich, weil er sich nicht kümmern muss. Und der Händler? Der hat eine extrem starke Kundenbindung geschaffen.

Fazit: Echte Digitalisierung verbindet

Ein Tool wie der ExpressImport zeigt, wo die Reise im B2B-Sektor hingeht. Wir müssen aufhören, Software als isolierte Inseln für einzelne Firmen zu begreifen. Echte Wertschöpfung entsteht dort, wo die Datenketten unternehmensübergreifend fließen – vom Händler-ERP über die API direkt auf das Smartphone des Handwerkers auf der Baustelle.

Wenn Händler und Betreiber plötzlich über die gleiche Infrastruktur arbeiten und sich gegenseitig die nervigen Aufgaben abnehmen, dann haben wir das nächste Level erreicht.

Wenn du als Händler oder Betreiber aktuell auch vor Bergen von nicht-gepflegten Betriebsmitteln stehst und denkst "Das muss doch schlauer gehen" – dann lass uns schnacken. Die Schnittstellen sind offen, wir müssen sie nur nutzen.