Wareneingang: Etiketten so tief lesen, wie es der Artikel braucht

Im Wareneingang eines Teilehändlers kommen täglich Kisten mit zerlegten Teilen an. Für ein Bremsteil reicht die Teilenummer, für ein Steuergerät zählen Hardware- und Softwarestand. Wer jedes Etikett voll analysiert, erhält Angaben, die niemand braucht; wer nur abtippt, lagert Tippfehler ein.

Der Hub bietet drei Tiefen der Etikettlesung. Dieser Fall nutzt die beiden flachen: Zuerst wird geprüft, ob überhaupt eine Nummer lesbar ist und wo sie steht, dann werden nur die Nummern gelesen. Die vollständige Analyse bleibt den Teilen vorbehalten, bei denen Varianten- und Versionsangaben den Wert bestimmen.

Was dieser Fall voraussetzt

• Eine scharfe Aufnahme des Etiketts. Die Lesungen nehmen eine abrufbare Bildadresse; Unschärfe kostet mehr als eine zweite Aufnahme.
• Eine Regel, welche Teile die volle Analyse brauchen. Steuergeräte, Leuchten und Teile mit Varianten gehören dazu, Verschleißteile meist nicht.
• Den Hersteller, wo er bekannt ist. Die Normalisierung nimmt ihn als optionalen Herstellerkontext.
• Ein Lagersystem mit Gruppen. Der VDI-4081-Katalog liefert die Gruppen; die Zuordnung je Teil kommt aus den OE-Daten.
• Die Berechtigung zur Fahrzeugabfrage. Mit dem Aufruf bestätigen Sie, Halter, Eigentümer oder nachweislich bevollmächtigt beziehungsweise anderweitig rechtlich berechtigt zu sein und die Fahrgestellnummer ausschließlich für den angegebenen zulässigen Zweck zu verwenden.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Warum jede Stufe nötig ist

1. Prüfen, ob eine Nummer da ist. POST /scanner/label/basic antwortet mit hasPartNumber und where — ob die Nummer auf dem Etikett oder am Teil selbst steht. Ist keine lesbar, lohnt keine tiefere Lesung dieses Bildes; eine neue Aufnahme schon.
2. Nur die Nummern lesen. POST /scanner/label/extract-partnumbers gibt partNumbers zurück — die Teile- und Referenznummern, ohne Hersteller-, Versions- und Variantenangaben. Für den grössten Teil eines Wareneingangs ist das alles, was gebraucht wird.
3. Die Nummer prüfen. GET /parts/oe/normalize nimmt oeNumber und optional manufacturer und antwortet mit status, lookupKey und normalizedOeNumber. Eine abgelesene Zeichenfolge wird erst hier zu einer Nummer, mit der man arbeiten kann.
4. Das Teil bestimmen. POST /parts/identify wägt customerOeNumbers, labelReadings und descriptions gegeneinander ab und antwortet mit einem bestätigten Treffer, Kandidaten oder keinem Treffer. Das ist die Stufe, auf der eine Kundennummer und eine Ablesung, die nicht zusammenpassen, auffallen.
5. Die Lagergruppe nachschlagen. GET /vdi liefert den veröffentlichten VDI-4081-Katalog mit stand, mainGroups und entries — je Eintrag code, mainGroup, weight, qualityGroup und possibleInstallationLocations, seitenweise mit limit und offset. OE-Zuordnungen sind nicht Teil dieses Aufrufs; welche Gruppe zu einem Teil gehört, kommt aus den OE-Daten.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: wareneingang-kiste-17-teil-3' \
  -d '{"imageUrl":"https://example.com/etikett.jpg","quality":"enhanced"}' \
  'https://api.tapinomahub.com/scanner/label/extract-partnumbers'

Was am Ende vorliegt

Am Ende liegen die Teile mit geprüfter Nummer und einheitlicher Gruppe im Lager, und die aufwendige Analyse kam nur dort zum Einsatz, wo sie den Wert eines Teils bestimmt. Ein Etikett ohne lesbare Nummer fällt am Anfang auf, nicht beim Kunden.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-hub). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.