Schnittstellenbeschreibung für Lieferanten
Artikeldaten v1 · Stand 24.09.2026
Vollständige Beschreibung herunterladen (.md) CSV-Beispiel herunterladen
Aktuell nutzbar: Excel und CSV
CSV in UTF-8 oder XLSX, maximal 5 MB und 500 Artikel je Upload. Bei Excel wird das erste Arbeitsblatt gelesen; Artikelnummern als Text und Formeln als Werte speichern. Ein berechtigter Benutzer prüft die Vorschau und bestätigt die Übernahme.
| Spalte | Inhalt |
|---|---|
| Number | Artikelnummer, erforderlich, bis 100 Zeichen |
| Name | Bezeichnung, erforderlich, bis 160 Zeichen |
| Unit | Erforderlich: Piece, Gram, Kilogram, Metre, SquareMetre oder CubicMetre |
| GramsPerUnit | Optional: Gramm je Basiseinheit, bis 6 Nachkommastellen |
| RollLengthMetres | Optional: Meter je Rolle, nur bei Metre, bis 3 Nachkommastellen |
| ProductUrl | Optionale HTTPS-Produktadresse |
| DocumentUrl | Optionaler HTTPS-Link zu Datenblatt oder Zertifikat |
Alle sieben Spalten müssen vorhanden sein. Die vollständige Beschreibung enthält Zahlenbereiche, Trennzeichen, Beispiele und Fehlerrückmeldungen.
Alte Artikel bleiben erhalten
Fehlende Artikel in einer neuen Datei werden nicht gelöscht. Änderungen erhalten eine neue Version; frühere Versionen bleiben unverändert einsehbar. Identische Daten erzeugen keine neue Version. Leere optionale Werte leeren das Feld nur im neuen Stand.
Nicht mehr angebotene Artikel können ausdrücklich archiviert werden. Ein Upload reaktiviert sie nicht. Historie, vorhandene Materialien und Packdokumentationen bleiben erhalten. Neue Materialübernahmen verweisen auf die übernommene Katalogversion.
Historische URL-Texte werden gespeichert; verlinkte Dokumentdateien werden nicht automatisch archiviert. Erforderliche Nachweise bitte zusätzlich am Material hochladen.
Automatische Schnittstellen abstimmen
REST API, SOAP, EDI, SFTP und OCI/Punchout können bereits beim Lieferanten dokumentiert werden. Eine externe Maschinen-API für den Artikelimport ist noch nicht freigegeben. Die internen Formularrouten sind keine Integrations-API.
Für einen Adapter brauchen wir technische Dokumentation, Beispieldaten, stabile Artikelnummern, Einheiten, Authentifizierungsverfahren und Regeln für Änderungen und Abkündigungen. Zugangsdaten gehören nicht in Artikellisten oder Freitextfelder.