Der Artikel richtet sich an die Personen, die Ihr ERP-System mit Luminovo verbinden. Die Zugangsdaten für den Upload fordern Sie beim Luminovo-Support an (siehe „Wie lade ich die Dateien hoch?“).
Nutzen Sie für eine neue ERP-Integration die REST-API.
Luminovo unterstützt den dateibasierten CSV-Prozess nur noch aus Gründen der Abwärtskompatibilität und entwickelt dafür keine neuen Funktionen. Zur REST-API siehe den Artikel „Integrate your ERP data via our REST API“.
Was kann ich mit CSV-Dateien synchronisieren?
Sie können zwei Arten von Daten synchronisieren, jeweils in einer eigenen Datei:
Komponenten (interne Teilenummern, IPNs): IPN, Herstellerteilenummer (MPN), Hersteller, Beschreibung und Gehäuse.
Lagerbestand: IPN, verfügbarer Bestand, Gesamtbestand, Stückpreis und mehr. Die vollständige Liste der Spalten steht in den Tabellen unten.
Für den CSV-Import gelten diese Vorgaben:
Luminovo unterstützt einen Lagerbestand pro IPN, also eine Zeile pro IPN in der Bestandsdatei. Um Bestände aus mehreren Lagerorten hochzuladen, nutzen Sie die REST-API.
Die Bestandsdatei hat keine Kundenspalte, daher können Sie den Bestand per CSV nicht auf einen Kunden beschränken. Luminovo importiert jede Zeile als unbeschränkten Bestand mit dem Preistyp Standard price. Um Bestand auf einen Kunden zu beschränken, nutzen Sie das Feld customer des API-Endpunkts POST /offers/import, oder setzen Sie beim Anlegen eines Angebots auf der Seite Add offers das Häkchen bei Only valid for this customer.
Die Statusübersicht in Luminovo verfolgt nur CSV-Uploads, keine Uploads über die API.
Wann verarbeitet Luminovo die CSV-Dateien?
Sie können Dateien jederzeit hochladen. Luminovo verarbeitet die hochgeladenen Dateien nur einmal täglich, jede Nacht ab Mitternacht Mitteleuropäischer Zeit (MEZ). Laden Sie Ihre Dateien gegen 22 Uhr MEZ hoch, damit die Daten nach der Verarbeitung aktuell sind. Der Upload muss vor Mitternacht MEZ auf den Servern von Luminovo ankommen, damit er im Lauf dieser Nacht berücksichtigt wird.
Wie bereite ich die CSV-Dateien vor?
Welches Format brauchen die Dateien?
Befolgen Sie das CSV-Format nach RFC 4180.
Verwenden Sie ein Komma (,) oder ein Semikolon (;) als Trennzeichen.
Setzen Sie alle Werte in doppelte Anführungszeichen, damit Sonderzeichen das Format nicht beschädigen.
Verwenden Sie die UTF-8-Kodierung. Andere Kodierungen führen zu Fehlern, wenn die Datei Sonderzeichen enthält. Wählen Sie beim Export aus Ihrem ERP-System UTF-8.
Maskieren Sie ein doppeltes Anführungszeichen innerhalb eines Werts, indem Sie es verdoppeln. Der Wert Wire 3/8" erscheint in der Datei als "Wire 3/8""".
Verwenden Sie als Dezimaltrennzeichen nur ein Komma oder einen Punkt. Luminovo unterstützt kein Tausendertrennzeichen.
Wie benenne ich die Dateien?
Luminovo verarbeitet eine Datei nur, wenn ihr Name den Namen Ihres Tenants enthält. Ihr Tenant-Name ist der erste Teil der URL, mit der Sie sich anmelden.
Lautet die URL amazing-oem.luminovo.com, ersetzen Sie TENANTNAME durch amazing-oem. Die Dateinamen lauten:
luminovo_TENANTNAME_ipns.csv
luminovo_TENANTNAME_inventory.csv
Für den Beispiel-Tenant lauten die Namen luminovo_amazing-oem_ipns.csv und luminovo_amazing-oem_inventory.csv.
Welche Spalten hat die Komponentendatei?
Die Komponentendatei luminovo_TENANTNAME_ipns.csv hat diese Spalten. Benennen Sie die Spaltenüberschriften genau wie angegeben, einschließlich Groß- und Kleinschreibung, Leerzeichen und Klammern, und fügen Sie die Kopfzeile ein. Die Spaltennamen bleiben auch in der deutschen Oberfläche englisch.
Spalte | Pflicht | Beschreibung |
IPN | Ja | Die interne Teilenummer, mit der Sie einen Artikel in Ihrem ERP-System bezeichnen. Manche Unternehmen nennen sie Artikelnummer. |
MPN | Nein | Die Herstellerteilenummer. Luminovo ordnet Ihre IPN anhand dieses Werts und des Herstellers einem Teil zu. Je genauer der Wert, desto wahrscheinlicher findet Luminovo das Teil. |
Manufacturer | Nein | Der Hersteller des Teils. Tragen Sie nur den Namen des Herstellers ein, nicht den Namen eines Händlers. |
Description | Nein | Eine Beschreibung Ihres Teils. |
Package | Nein | Das Gehäuse des Teils, zum Beispiel SOT23. Bei SMT-Gehäusen wie 0603 geht Luminovo vom imperialen System aus (Tausendstel Zoll). Ist der Wert metrisch (in mm), geben Sie ihn als 0603 - metric an. |
Welche Spalten hat die Bestandsdatei?
Die Bestandsdatei luminovo_TENANTNAME_inventory.csv hat diese Spalten. Nur die IPN ist Pflicht.
Spalte | Standardwert | Beschreibung |
IPN | Keiner (Pflicht) | Die interne Teilenummer, mit der Sie einen Artikel in Ihrem ERP-System bezeichnen. |
Available stock | 0 | Der frei verfügbare Bestand, den Sie für neue Projekte nutzen können. Luminovo verwendet diesen Wert, um Lösungen zu erzeugen. Bruchteilige Bestände werden unterstützt. |
Total stock | Keiner | Der Gesamtbestand, einschließlich des Bestands, der anderen Projekten zugewiesen ist. Luminovo zeigt diesen Wert nur an und verwendet ihn nicht, um Lösungen zu erzeugen. Bruchteilige Bestände werden unterstützt. |
Unit price (Amount) | 0 | Der Preis pro Teil, mit dem Luminovo Lösungen berechnet. Sie entscheiden, welchen Wert Sie eintragen, zum Beispiel 0, den letzten Einkaufspreis oder den Durchschnittspreis. |
Unit price (Currency) | EUR | Der dreistellige Währungscode nach ISO 4217. |
Standard lead time (Days) | Keiner | Die Standardlieferzeit in Tagen, die ein Händler braucht, um das Teil nachzuliefern. Füllen Sie die Spalte nur aus, wenn Sie einen verlässlichen Wert kennen. |
Packaging | Keiner | Die Verpackung der Teile. Einer der Werte: AmmoPack, Bag, Bulk, Reel, ReReel, Tape, Tray, Tube, Carton. |
Unit of measurement (Quantity) | 1 | Die Menge pro Maßeinheit für die Werte in Available stock und Total stock. Füllen Sie die Spalte nur aus, wenn der Bestand in Vielfachen der Einheit gemessen wird. Beispiel: Eine IPN ist eine Kabelrolle mit 30 Metern. Tragen Sie hier 30 ein und als Einheit Meter. Ein verfügbarer Bestand von 10 bedeutet dann 300 Meter. |
Unit of measurement (Unit) | Piece | Die Maßeinheit. Einer der Werte: Kilogram, Meter, Liter, Piece. |
Die Werte in den Spalten Packaging und Unit of measurement (Unit) müssen englisch sein, zum Beispiel Reel oder Piece. Übersetzen Sie sie nicht, auch nicht „Rolle“ oder „Stück“.
Wie ordnet Luminovo IPNs Teilen zu?
Luminovo behandelt jeden Upload der Komponentendatei als aktuelle Liste der IPNs in Ihrem ERP-System.
Eine IPN mit mehreren Teilealternativen: Fügen Sie pro Alternative eine Zeile hinzu, mit derselben IPN und einem anderen Hersteller, einer anderen MPN oder einer anderen Beschreibung.
Hersteller und MPN angegeben: Luminovo ordnet nur Teile zu, die zu beiden Werten passen. Ein Teil mit der richtigen MPN, aber einem anderen Hersteller wird nicht zugeordnet. Geben Sie keinen Hersteller an, ordnet Luminovo alle Teile mit dieser MPN zu.
Nur Beschreibungen angegeben: Luminovo kann Teile in diesem Fall nicht automatisch zuordnen. Sie ordnen Teile und IPNs nach dem Upload manuell zu, und Luminovo merkt sich jede Zuordnung für spätere Stücklisten. Hat Ihr ERP keine Felder für Hersteller und MPN, tragen Sie alle relevanten Beschreibungen als eine lange Zeichenfolge in die Spalte Description ein. Haben Sie eine kurze und eine lange Beschreibung, fügen Sie zwei Zeilen mit derselben IPN hinzu.
Sie fügen eine Zeile mit einer neuen IPN hinzu: Luminovo legt die IPN an.
Sie entfernen eine IPN aus der Datei: Luminovo löscht die IPN. Wird die IPN noch von einem Bedarf oder einer Stückliste referenziert, behält Luminovo sie und markiert sie als entfernt. Fügt ein späterer Import die IPN erneut hinzu, hebt Luminovo die Markierung auf.
Sie ändern MPN, Hersteller oder Beschreibung einer IPN: Luminovo löscht alle automatischen und manuellen Zuordnungen der alten Spezifikation dieser IPN und startet die automatische Zuordnung neu.
Luminovo stoppt einen Import, der viele IPNs auf einmal entfernen würde, um Ihre Komponentenbibliothek vor einem unvollständigen Export zu schützen.
Wie lade ich die Dateien hoch?
Sie laden die Dateien über die Befehlszeile mit AzCopy hoch, dem Befehlszeilentool von Microsoft. AzCopy ist für Windows, macOS und Linux verfügbar.
Installieren Sie AzCopy. Folgen Sie der Installationsanleitung von Microsoft und fügen Sie AzCopy Ihrem Pfad hinzu.
Fordern Sie Zugangsdaten an. Öffnen Sie Ihr Luminovo-Konto und fordern Sie die Zugangsdaten über den Support-Chat an. Die Zugangsdaten bestehen aus vier Werten: appId, displayName, password und tenant. Halten Sie sie geheim und teilen Sie sie nicht in Tickets oder Chats.
Legen Sie die Umgebungsvariablen fest. Ersetzen Sie die Platzhalter in den Befehlen für Ihr System durch die Werte Ihrer Zugangsdaten: AZCOPY_SPA_APPLICATION_ID erhält Ihre appId, AZCOPY_SPA_CLIENT_SECRET Ihr password und AZCOPY_TENANT_ID Ihren tenant.
Laden Sie Ihre Dateien hoch. Ersetzen Sie tenantname durch Ihren Tenant-Namen, verwenden Sie die vollständigen Pfade zu Ihren Dateien und führen Sie die Upload-Befehle aus.
Befehle für macOS und Linux
Öffnen Sie das Terminal und führen Sie aus:
export "AZCOPY_AUTO_LOGIN_TYPE=SPN"
export "AZCOPY_SPA_CLIENT_SECRET=YOUR_PASSWORD"
export "AZCOPY_SPA_APPLICATION_ID=YOUR_APP_ID"
export "AZCOPY_TENANT_ID=YOUR_TENANT_ID"
Befehle für Windows (Eingabeaufforderung)
Öffnen Sie die Eingabeaufforderung (CMD) und führen Sie aus:
set "AZCOPY_AUTO_LOGIN_TYPE=SPN"
set "AZCOPY_SPA_CLIENT_SECRET=YOUR_PASSWORD"
set "AZCOPY_SPA_APPLICATION_ID=YOUR_APP_ID"
set "AZCOPY_TENANT_ID=YOUR_TENANT_ID"
Befehle für Windows PowerShell
$env:AZCOPY_AUTO_LOGIN_TYPE="SPN"
$env:AZCOPY_SPA_CLIENT_SECRET="YOUR_PASSWORD"
$env:AZCOPY_SPA_APPLICATION_ID="YOUR_APP_ID"
$env:AZCOPY_TENANT_ID="YOUR_TENANT_ID"
Upload-Befehle
Ersetzen Sie tenantname in den Dateinamen und am Ende jedes Befehls durch den ersten Teil Ihrer Anmelde-URL, in Kleinbuchstaben. Melden Sie sich unter https://amazing-ems.luminovo.com an, ersetzen Sie tenantname-erp durch amazing-ems-erp. Ersetzen Sie die Dateinamen durch die vollständigen Pfade zu Ihren Dateien.
azcopy copy luminovo_tenantname_ipns.csv "https://lumiquoteproderp.blob.core.windows.net/tenantname-erp"
azcopy copy luminovo_tenantname_inventory.csv "https://lumiquoteproderp.blob.core.windows.net/tenantname-erp"
AzCopy meldet, dass die Dateien übertragen wurden. Luminovo verarbeitet sie im nächsten nächtlichen Lauf.
Wie automatisiere ich den täglichen Upload?
Automatisieren Sie Export und Upload, sodass Ihre Daten jede Nacht vor Mitternacht MEZ bei Luminovo ankommen, also vor dem Start des nächtlichen Laufs. Fragen Sie Ihren ERP-Anbieter, ob Ihr ERP-System ein Skript planen kann. Andernfalls richten Sie selbst einen geplanten Job ein, zum Beispiel mit cron unter Linux und macOS oder mit der Aufgabenplanung für Windows.
Wie prüfe ich, ob der Upload angekommen ist und verarbeitet wurde?
Prüfen Sie den Status Ihrer Uploads auf der Seite CSV-Integrationen.
Klicken Sie oben rechts auf Ihren Avatar und dann auf Einstellungen.
Klicken Sie unter Integrationen auf CSV-Integrationen. Die Seite trägt den Titel Statusübersicht für CSV-Datei-Importe (azcopy).
Lesen Sie die Tabellen Komponenten und Lagerbestand. Jede Tabelle hat die Zeilen Zuletzt verarbeiteter Import und Anstehender Import mit Datum und Status.
Der Status zeigt einen dieser Werte:
Erfolgreich: Luminovo hat die Datei verarbeitet.
Fehler: Luminovo konnte die Datei nicht verarbeiten. Siehe „Warum schlägt mein Import fehl oder erscheinen meine Daten nicht?“.
In Bearbeitung: Der Import wartet auf den nächtlichen Lauf um Mitternacht MEZ.
Noch keine Datei hochgeladen: Luminovo hat für den anstehenden Import keine Datei erhalten.
Die Übersicht zeigt nur den Endstatus eines Uploads und hat kein Upload-Protokoll. Sie zeigt keine Uploads über die API.
Sie können das Ergebnis auch in der App prüfen:
Unter Teile > Komponenten zeigt die Zeile neben dem Titel Letzter Import und Suchindex aktualisiert, jeweils mit der vergangenen Zeit. Der Suchindex wird nur nach einem erfolgreichen Import aktualisiert, daher bedeutet eine lange Zeit seit dem letzten Import, dass Importe fehlschlagen. Die Komponentensuche läuft über diesen Index, der bei vielen Importen einige Stunden hinterherhinken kann.
Öffnen Sie eine IPN. Der Kopfbereich zeigt, wann die IPN Importiert und Geändert wurde. Der Bereich Lagerbestand zeigt Gesamter Lagerbestand und Verfügbarer Lagerbestand. Die beiden Werte entsprechen den Spalten Total stock und Available stock.
Die Aktualisierungsdaten von Komponenten und Lagerbestand sind nicht identisch. Um das Aktualisierungsdatum des Lagerbestands zu prüfen, suchen Sie eine IPN, deren Bestand sich kürzlich geändert hat, und öffnen Sie sie unter Teile > Komponenten.
Warum schlägt mein Import fehl oder erscheinen meine Daten nicht?
Gehen Sie die Prüfungen in dieser Reihenfolge durch.
Prüfen Sie, ob der Upload stattgefunden hat. Prüfen Sie auf Ihrer Seite, ob Ihr geplanter Job gelaufen ist. Können Sie das nicht feststellen, laden Sie die Daten erneut hoch und warten Sie bis zum nächsten Tag, ob die Daten aktualisiert werden.
Prüfen Sie den Status in der Statusübersicht. Lautet der Status Fehler, prüfen Sie das Dateiformat. Der Hinweis „Dateiformat prüfen“ kann bei jedem fehlgeschlagenen Import erscheinen, unabhängig von der Ursache.
Prüfen Sie die Datei auf die häufigen Probleme im nächsten Abschnitt. Sie können die Datei in einem Code-Editor öffnen, der Probleme hervorheben kann, oder sie in Excel importieren.
Prüfen Sie, ob der Export vollständig ist. Fehlen in der Datei im Vergleich zum letzten erfolgreichen Import viele IPNs, kann Luminovo den Import stoppen, um Ihre Komponentenbibliothek zu schützen. Prüfen Sie, ob sich Ihr ERP-Export geändert hat oder nur einen Teil der Teile umfasst.
Wenden Sie sich an Luminovo. Ist die Datei gültig und der Upload erfolgreich, die Daten erscheinen aber nicht, schreiben Sie an [email protected]. Nennen Sie Ihren Tenant, den Dateinamen, den Zeitpunkt des Uploads und den Status in der Statusübersicht.
Welche Probleme in der Datei treten am häufigsten auf?
Spaltenüberschriften: Die Kopfzeile fehlt oder ein Spaltenname ist falsch. Die Namen müssen genau den Vorlagen entsprechen, einschließlich Groß- und Kleinschreibung, Leerzeichen und Klammern, zum Beispiel Standard lead time (Days). Das gilt auch für die deutsche Oberfläche: Die Spaltennamen bleiben englisch.
Kodierung: Die Datei ist nicht UTF-8-kodiert. Wählen Sie beim Export UTF-8.
Anführungszeichen: Werte mit Komma oder Semikolon stehen nicht in doppelten Anführungszeichen, oder doppelte Anführungszeichen innerhalb eines Werts sind nicht verdoppelt. Beispiel: "Manufacturer, Inc." und "LCD 19"" monitor".
Ungültige Werte: Die Spalten Packaging und Unit of measurement (Unit) enthalten Werte, die nicht englisch sind; die Spalte Manufacturer enthält den Namen eines Händlers; die Spalte Unit of measurement (Quantity) ist gefüllt, obwohl der Bestand nicht in Vielfachen der Einheit gemessen wird; die Spalte Standard lead time (Days) ist ohne verlässlichen Wert gefüllt.
Häufig gestellte Fragen
Woran erkenne ich, ob der Upload funktioniert hat?
Prüfen Sie in der Statusübersicht unter Einstellungen > Integrationen > CSV-Integrationen den Status des zuletzt verarbeiteten Imports. Luminovo verarbeitet die Dateien nur einmal täglich, daher sehen Sie das Ergebnis am nächsten Tag.
Was ist, wenn ich die Daten hochgeladen habe, die Aktualisierung aber nicht sichtbar ist?
Gehen Sie die Prüfungen in „Warum schlägt mein Import fehl oder erscheinen meine Daten nicht?“ durch.
Welche Datumsangaben zeigen, wann die Aktualisierung stattfand?
Die Seite Komponenten zeigt Letzter Import und Suchindex aktualisiert. Die Seite einer IPN zeigt Importiert und Geändert. Die Daten für Komponenten und Lagerbestand unterscheiden sich.
Wie lade ich Bestände und Komponenten aus verschiedenen Lagerorten hoch?
Uploads aus verschiedenen Lagerorten sind nur über die Luminovo-API möglich. Siehe „Integrate your ERP data via our REST API“.
Ich finde einige meiner IPNs in Luminovo nicht. Was kann ich tun?
In den meisten Fällen waren die IPNs nicht im letzten Upload. Prüfen Sie, ob die IPNs in der Datei des letzten Uploads stehen, und prüfen Sie in der Statusübersicht, ob der Upload erfolgreich war. Steht die IPN in der Datei und war der Upload erfolgreich, schreiben Sie an [email protected].
Ich erhalte den Fehler 401 (unauthorized). Sind meine Zugangsdaten abgelaufen?
Die Zugangsdaten für den CSV-Upload laufen nicht ab. Prüfen Sie, ob die Zugangsdaten korrekt in den Umgebungsvariablen gespeichert sind, oder übergeben Sie sie bei der Anfrage ausdrücklich an AzCopy.
Kann ich IPNs oder Bestand mit den CSV-Dateien löschen?
Um eine IPN zu löschen, entfernen Sie sie aus der Komponentendatei. Luminovo löscht sie dann oder markiert sie als entfernt, wie in „Wie ordnet Luminovo IPNs Teilen zu?“ beschrieben.