Zum Hauptinhalt springen
Alle KollektionenIntegrationen
Integrieren Sie Ihre ERP Daten mithilfe von .csv or .json Dateien
Integrieren Sie Ihre ERP Daten mithilfe von .csv or .json Dateien
Timon Ruban avatar
Verfasst von Timon Ruban
Vor über 4 Monaten aktualisiert

Einleitung

Dieser Artikel beschreibt, wie die Integration Ihrer ERP-Daten über .csv- oder .json-Dateien funktioniert.

Wir unterstützen derzeit die Integration Ihrer internen Teilenummern (IPNs), Lagerbestandsdaten und Standardteile aus Ihrem ERP.

Bislang unterstützt die Integration nur eine Richtung: Daten, die aus Ihrem ERP in Luminovo fließen. Für die andere Richtung (das Abrufen von Daten) können Sie unsere REST-API und Webhooks verwenden (und Sie können einige ausgewählte Dinge im Tool direkt über .xlsx-Dateien exportieren, z. B. eine kalkulierte Stückliste).

💡 Wenn Sie Ihr ERP-System zum ersten Mal an Luminovo anbinden, empfehlen wir Ihnen, dafür die REST-API zu verwenden. Der Prozess ist hier im Detail dokumentiert. In Zukunft wird der dateibasierte Prozess nur noch unterstützt, um zu gewährleisten, dass bereits bestehende Integrationen weiterhin problemlos funktionieren. Bei dieser Variante werden keine neuen Funktionen, wie die Verarbeitung von Kundenteilenummern (=CPNs), unterstützt.

Exportieren Sie Ihre Daten in .csv oder .json Dateien und laden Sie sie auf unsere Server.

Sie können Ihre Daten mit Luminovo synchronisieren, indem Sie diese Daten in .csv- oder .json-Dateien exportieren und sie dann auf unseren Server hochladen.

Guidelines für die .csv-Vorlage - Interne Teilenummern (=IPNs)

Dateiname

Bitte benennen Sie Ihre .csv als luminovo_tenantname_ipns.csv, wobei der tenantname der erste Teil der URL ist (als Beispiel wird hier “ems” verwendet), den Sie für den Zugriff auf Luminovo verwenden. Wenn Sie also unter https://ems.luminovo.ai auf Luminovo zugreifen, nennen Sie Ihre Datei bitte luminovo_ems_ipns.csv.

.csv Format

Bitte verwenden Sie entweder , oder ; als Trennzeichen für die csv-Datei und setzen Sie alle Werte in Anführungszeichen. Die Datei sollte die Kodierung UTF-8 verwenden.

"IPN";"Manufacturer";"MPN";"Description";... 
"0-1234#";"Texas Instruments";"LM358";"A description\\nwith line break";...

Wir folgen dem CSV-Format nach RFC 4180. Insbesondere sollten Anführungszeichen in dem Wert selber als doppelte Anführungszeichen escaped werden. Zum Beispiel sollte der Wert Wire 3/8" in der Datei als ...,"Wire 3/8""",... vorkommen.

Spalten

  • IPN: Die interne Teilenummer, mit der Sie einen Artikel in Ihrem ERP referenzieren. => Erforderlich.

  • Manufacturer: Der Hersteller des Bauteils. => Optional.

  • MPN: Die Herstellerteilenummer des Bauteils. Diese wird zusammen mit dem Hersteller verwendet, um Ihre IPN mit einem Teil abzugleichen. Je genauer diese Informationen sind, desto höher ist die Wahrscheinlichkeit, dass wir das Teil zuordnen können. => Optional.

  • Description: Eine Beschreibung Ihres Teils (z.B. die technischen Beschreibungen eines herstellerfreien Bauteils). => Optional.

  • Package: Das Gehäuse des Teils (z. B. SOT23). Bei SMT-Gehäusen wie 0603 gehen wir davon aus, dass es im imperialen System angegeben ist (gemessen in Tausend/Inch). Fügen Sie es als 0603 - metric hinzu, wenn es im metrischen System (gemessen in mm) angegeben ist. => Optional.

Was ist, wenn eine IPN mehrere alternative Teile hat?

Oft wird eine IPN mit mehreren genehmigten Teilen (mit unterschiedlichen Herstellern und MPNs) verknüpft. In diesem Fall fügen Sie einfach eine Zeile (mit derselben IPN, aber möglicherweise unterschiedlichen Herstellern (Manufacturer), MPN oder Beschreibungen (Description)) für jede Teilealternative in die .csv-Datei ein.

Wenn sowohl eine MPN als auch ein Hersteller angegeben sind, werden wir nur Teile zuordnen, die beiden entsprechen. Das heißt, wir werden kein Teil mit einer IPN abgleichen, wenn wir ein Teil mit der richtigen MPN finden, aber der Hersteller ein anderer ist. Wenn kein Hersteller angegeben ist, werden wir alle Teile mit der entsprechenden MPN abgleichen.

In Zukunft planen wir auch, generische Teile (wie herstellerfreie Widerstände oder Kondensatoren) automatisch mit den Beschreibungen Ihrer IPNs abzugleichen. Wenn Ihre IPN also ein herstellerfreies Teil darstellt, geben Sie bei Hersteller (Manufacturer) "Frei" an, geben Sie die technischen Parameter in der Beschreibungsspalte (Description) und das Gehäuse in der Gehäusespalte (Package) an.

Was ist, wenn in meinem ERP-System der Hersteller und die MPN nicht in einem eigenen Feld verfügbar sind?

Bei vielen unserer Kunden stehen diese Informationen in ihrem ERP nicht zur Verfügung, sondern es gibt nur ein langes Textfeld, das einen oder mehrere Hersteller und MPNs enthalten kann. In diesem Fall fügen Sie einfach alle relevanten Beschreibungen in eine lange Zeichenkette ein, die Sie in die Beschreibungsspalte (Description) eintragen. Wenn Sie eine "kurze" und eine "lange" Beschreibung Ihrer IPN haben, können Sie zwei Zeilen mit der gleichen IPN hinzufügen und die kurze Beschreibung in die erste Zeile und die lange Beschreibung in die zweite Zeile einfügen.

Wenn Sie nur Beschreibungen und keine Hersteller und MPNs angeben, können wir die Teile nicht automatisch zuordnen. Luminovo bietet jedoch eine Funktion zum manuellen Abgleich von Teilen und IPNs nach dem Hochladen. Sie können die von Ihnen bereitgestellten Beschreibungen durchsuchen, so wie Sie heute wahrscheinlich in Ihrem ERP-System nach Ihren IPNs suchen können. Das Gute daran: Sobald Sie die Teile und IPNs in Luminovo einmal abgeglichen haben, merken wir uns den Abgleich und verwenden ihn für Ihre nächste Stückliste.

Was passiert, wenn ich eine IPN lösche oder einen Teil einer bestehenden IPN entferne oder hinzufüge?

Wir gehen davon aus, dass die .csv-Datei, die Sie hochladen, die aktuelle Liste der IPNs aus Ihrem ERP widerspiegelt. Das heißt, wenn Sie in einem neuen Upload eine neue Zeile mit einer neuen MPN hinzufügen, werden wir diese IPN hinzufügen. Wenn Sie eine IPN aus der .csv-Datei entfernen, löschen wir die IPN in Luminovo. Wenn Sie die für eine IPN angegebene MPN, den Hersteller oder die Beschreibung ändern (z. B. weil Sie ein genehmigtes Teil hinzugefügt oder entfernt haben), löschen wir alle automatischen und manuellen Zuordnungen, die anhand der alten Teilespezifikation für diese IPN vorgenommen wurden, und starten die automatische Zuordnung von Teilen zu IPNs neu.

Guidelines für die .csv- Vorlage - Lagerbestand

Dateiname

Bitte benennen Sie Ihre .csv-Datei als luminovo_tenantname_inventory.csv, wobei tenantname der erste Teil der URL ist, die Sie für den Zugriff auf unser Tool verwenden. Wenn Sie also unter https://ems.luminovo.ai auf unser Tool zugreifen, nennen Sie Ihre Datei bitte luminovo_ems_inventory.csv.

.csv format

Bitte verwenden Sie entweder , oder ; als Trennzeichen für die csv-Datei und setzen Sie alle Werte in Anführungszeichen. Die Datei sollte die Kodierung UTF-8 verwenden.

"IPN";"Available stock";"Total stock";"Unit price (Amount)"... 
"0-1234#";"25";"2000";"2.32";...
"0-3456#";"50";"1000";"1.23";...

Wir folgen dem CSV-Format nach RFC 4180. Insbesondere sollten Anführungszeichen in dem Wert selber als doppelte Anführungszeichen escaped werden. Zum Beispiel sollte der Wert Wire 3/8" in der Datei als ...,"Wire 3/8""",... vorkommen.

Spalten

  • IPN: Die interne Teilenummer, mit der Sie einen Artikel in Ihrem ERP referenzieren. => Erforderlich.

  • Available stock: Der frei verfügbare Bestand in Ihrem Lager, der für neue Projekte verwendet werden kann. Dieser Bestand wird für die Erstellung von Lösungen inm Tool verwendet. Bruchteilige Bestandswerte werden unterstützt. Optional (Standardwert: 0).

  • Total stock: Der Gesamtbestand in Ihrem Inventar (einschließlich des Bestands, der bereits einem anderen Projekt zugewiesen wurde). Dieser Wert wird nicht zur Erstellung von Lösungen verwendet, sondern nur als zusätzliche Information im Tool angezeigt. Ein Szenario, in dem dies nützlich sein könnte: Sie haben ein neues Prototyp-Projekt, für das Sie nur 10 Teile benötigen. Sie haben keinen verfügbaren Bestand, aber 100.000 auf Lager, die einem anderen Projekt zugeordnet sind. Mit dieser Information wissen Sie, dass Sie die 10 Teile vielleicht noch aus Ihrem eigenen Bestand beschaffen können. Bruchteilige Bestandswerte werden unterstützt. => Optional.

  • Unit price (Amount): Der Preis pro Teil, den Sie für die Berechnung von Lösungen verwenden möchten. Es liegt an Ihnen zu entscheiden, was Sie hier eintragen wollen. Manche behandeln ihren Bestand als "frei". Andere wiederum verwenden den letzten Einkaufspreis und so weiter. => Optional (Standardwert ist 0).

  • Unit price (Currency): Währungscode mit 3 Buchstaben gemäß ISO-4217. => Optional (Standardwert ist EUR).

  • Standard lead time (Days): Falls bekannt, können Sie eine Standardvorlaufzeit (in Tagen) angeben, die auf Lieferantenseite benötigt wird, um neue Teile auf Lager zu haben. => Optional.

  • Packaging: Die Verpackung der Teile. Muss eine von sein: AmmoPack, Bag, Bulk, Reel, ReReel, Tape, Tray, Tube, Carton. => Optional.

  • Unit of measurement (Quantity): Die Maßeinheit für die in Verfügbarer Bestand (Available stock) und Gesamtbestand (Total stock) angegebenen Mengen. Wenn Sie nichts angeben, ist dies standardmäßig 1 Piece. Wenn das Teil in Ihrem Bestand jedoch besser in einer anderen Einheit gemessen wird, können Sie die Maßeinheit hier festlegen. Wenn sich Ihre IPN zum Beispiel auf eine Kabelrolle bezieht, bei der jede Rolle 30 Meter Kabel hat, können Sie 30 und Meter als Maßeinheit angeben. Wenn Sie den verfügbaren Bestand (Available stock) mit 10 angeben, wissen wir, dass Sie 300 Meter Kabel zur Verfügung haben. => Optional (Standardwert ist 1).

  • Unit of measurement (Unit): Muss eine der folgenden sein: Kilogram, Meter, Liter, Piece. Bitte beachten Sie, dass nur die englischen Werte unterstützt werden, und nicht die entsprechenden deutschen Namen. => Optional (Standardwert ist "Piece").

Was ist das richtige Zahlenformat?

Achten Sie darauf, dass Sie nur , oder . als Dezimaltrennzeichen verwenden. Ein Tausendertrennzeichen wird nicht unterstützt. Dies ist besonders wichtig für Spalten wie (Unit price (Amount)). Nachfolgend finden Sie ein Beispiel:

✅ Unterstütztes Zahlenformat

1234,56
1234.56

❌ Nicht unterstütztes Zahlenformat:

1.234,56
1,234.56

Was ist, wenn ich mehrere Bestände/Lager habe?

Wir unterstützen derzeit nur ein Inventar (d. h. Sie können nur eine Zeile pro IPN in der csv-Datei haben). Sie können entweder Ihre verschiedenen Bestände im verfügbaren Bestand und im Gesamtbestand zusammenfassen oder den wichtigsten Bestand auswählen, den Sie im Tool integrieren möchten.

Guidelines für die .json-Vorlage - Standardteile

Dateiname

Benennen Sie Ihre .json als luminovo_tenantname_parts.json wobei tenantname der erste Teil der URL ist, den Sie für den Zugriff auf Luminovo verwenden.

Sollten Sie also mit https://ems.luminovo.ai auf Luminovo zugreifen, nennen Sie Ihre Datei bitte luminovo_ems_parts.json.

.json format

Die Datei muss die Kodierung UTF-8 verwenden.

Insbesondere Anführungszeichen innerhalb des Wertes selbst sollten durch einen Backslash ersetzt werden. Zum Beispiel sollte der Wert Wire 3/8"in der Datei als "Wire 3/8\\"" erscheinen.

Falls Sie keinen Wert für ein optionales Feld haben, lassen Sie das Schlüssel/Wert-Paar einfach ganz weg, anstatt es als "key": null anzugeben.

Sofern nicht ausdrücklich als erforderlich gekennzeichnet, sind alle Werte optional.

Sofern nicht ausdrücklich anders gekennzeichnet, sollten alle Werte als Strings angegeben werden.

Es wird erwartet, dass die Datei ein Array von Teilobjekten mit der folgenden Struktur enthält:

Bauteilobjektstruktur

  • "mpn": Die Teilenummer des Herstellers. Erforderlich.

  • "manufacturer": Der Hersteller des Bauteils. Erforderlich. Die Kombination aus mpn and manufacturer darf in der gesamten Datei nur einmalig vorhanden sein.

  • "alias": Aliasnamen für die MPN. Eine Liste von Strings.

  • "description": Eine Beschreibung des Bauteils.

  • "part_type": Bauteiltyp

  • "se_id": Wenn Ihre Bauteildaten von Silicon Expert stammen, können Sie hier deren Teile-ID angeben.

  • "crosses": Alternativen für das Bauteil. Nicht beachtet: Ein Array von Objekten mit folgender Struktur

    • "CrossPartNumber": die MPN für das Alternativbauteil

    • "CrossManufacturer": der Hersteller des alternativen Bauteils

    • "CrossType":

    • "Comment": Kommentar zur Alternative

  • "package": Gehäuse des Bauteils. Ein Objekt mit der folgenden Struktur:

    • "name": Der Name des Gehäuses (z.B. "0402"). Für SMT Gehäuse wie "0603" nehmen wir an, dass diese im imperialen System angegeben sind (gemessen in Tausend/Zoll). Fügen Sie diese als "0603mm" ein, falls es sich um metrische Werte handelt (gemessen in mm).

    • "mounting": Bestückung (z.B. "SMT").

    • "pin_pitch": Pinabstand (Pin Pitch).

    • "length_in_mm": Die Länge des Gehäuses in mm. Ignoriert

    • "width_in_mm": Die Breite des Gehäuses in mm. Ignoriert

    • "height_in_mm": Die Höhe des Gehäuses in mm. Ignoriert

    • "thread_size": Die Größe des Gewindes. Ignoriert

    • "number_of_pins": Die Anzahl der Pins. Kann ein String oder eine Zahl sein.

  • "compliance": Compliance Informationen für das Bauteil**.** Ein Objekt mit folgender Struktur

    • "eu_rohs": RoHS-Informationen für das Teil. Wenn angegeben, muss es sich um einen Wert aus dem RoHS-Compliance-Status **(siehe unten) handeln.

    • "aec_qualified": Noch nicht geparst.

    • "contains_svhc": Falls angegeben, muss dies entweder "yes" oder "no" sein. Siehe REACH-Compliance Status für weitere Informationen.

    • "svhc_exceed_threshold_limit": Falls angegeben, muss dies entweder "yes" oder "no" sein. Siehe REACH-Compliance Status für weitere Informationen.

  • "lifecycle": Noch nicht geparst.

    • "status": Status.

    • "estimated_eol_date": Jahr des voraussichtlichen Endes des Lebenszyklus.

    • "last_time_buy_date": Das Datum, an dem das Bauteil das letzte Mal gekauft werden kann.

  • "datasheet_url": Eine URL für das Datenblatt des Bauteils.

  • "technical_properties": Die technischen Eigenschaften des Bauteils. Ein Objekt der folgenden Struktur

    • "resistance_value": Wir erkennen Werte in der Form von "x mΩ" oder "x m" für Milliohm, "x Ω" oder "x" für Ohm, "x kΩ" oder "x k" for Kiloohm, "x MΩ" oder "x M" für Megaohm und "x GΩ" oder "x G" für Gigaohm. Gebrochene Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

    • "resistance_range": Ignoriert

    • "inductance": Ignoriert

    • "capacitance_value": Wir erkennen Werte in der Form "x pF" für Picofarad, "x nF" für Nanofarad, "x uF" oder "x µF" für Mikrofarad, "x mF" für Mikrofarad und "x F" für Farad. Funktionale Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

    • "dielectric_type": Zurzeit werden nur Keramikkondensatoren unterstützt. Wir erkennen die folgenden Typen an:

    "X8R" "C0G" "NP0" "X7R" "X5R" "X8L" "Y5V" "X6S" "Z5U" "X7S" "Y5U" "C0H" "Y5R" "Y5P" "Y5T" "U2J" "Z5V" "Z5P" "K4000" "X6T" "X7T" "Z5F"
    • "power_rating": Wir erkennen Werte in der Form von "x mW" für Milliwatt, "x W" für Watt, "x kW" für Kilowatt und "x MW" für Megawatt. Gebrochene Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

    • "technology": Ignoriert

    • "temperature_coefficient": Wir erkennen Werte in der Form von x ppm/°C oder xppm/°C wobei x der Wert des Temperaturkoeffizienten ist. Gebrochene Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

    • "tolerance": Wir erkennen relative und absolute Toleranzen. Relative Toleranzen müssen ein Prozentzeichen enthalten (z.B. "1%"). Absolute Toleranzen werden nur in Bezug auf einen bestimmten Kapazitätswert oder Widerstandswert betrachtet und müssen Einheiten enthalten. Beispiel: Bei "Toleranz": "5Ω" und "Widerstandswert": "50Ω" wird ein Toleranzwert von "10 %" berechnet. Gebrochene Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

    • "voltage_rating": Wir erkennen Werte in der Form "x mV" für Millivolt, "x V" für Volt, "x kV" für Kilovolt und "x MV" für Megavolt an. Gebrochene Werte müssen mit einem Dezimalpunkt angegeben werden (z. B. 1.5).

RoHS Compliance Status

Wir wandeln den angegebenen Wert in Kleinbuchstaben und führen dann folgende Zuordnung durch:

  • "yes" ⇒ Compliant

  • "no" ⇒ Non-Compliant

  • "yes with exemption" ⇒ Compliant mit Ausnahme

  • "not required" or "nr" ⇒ Nicht erforderlich

  • "unknown" ⇒ Unbekannt

Alle anderen Werte führen zu einem unbekannten RoHS-Compliance-Status.

REACH Compliance Status

Wir berechnen den Status der REACH-Comliance auf der Grundlage der Werte der beiden Schlüssel "contains_svhc"und "svhc_exceed_threshold_limit". Dabei gilt die folgende Logik:

  • Wenn "svhc_exceed_threshold_limit": "Yes" ⇒ Non-Compliant (unabhängig vom Wert für "contains_svhc")

  • Wenn "svhc_exceed_threshold_limit": "No" ⇒ Compliant (unabhängig vom Wert für"contains_svhc")

  • Für andere Werte von "svhc_exceed_threshold_limit" (oder wenn nicht angegeben):

    • Wenn "contains_svhc": "yes" ⇒ Unbekannt

    • Wenn "contains_svhc": "no" ⇒ Compliant

    • Andernfalls ⇒ Unbekannt

Werfen Sie einen Blick auf die folgenden Vorlagen. Wenn Sie Fragen haben, können Sie uns gerne kontaktieren.

Führen Sie für die Integration folgende Schritte durch.

1. Exportieren Sie Ihre Daten in .csv oder .json Dateien, welche unseren Vorlagen entsprechen.

Möglicherweise müssen Sie einige Ihrer Daten von verschiedenen Stellen in Ihrem ERP-System zusammenführen und anpassen, um die von uns benötigten Spalten zu erhalten. Glücklicherweise unterstützen die meisten ERP-Systeme diese Exportfunktionalität von Haus aus. Wenden Sie sich an Ihren ERP-Experten oder Partner, um dies einzurichten.

2. Laden Sie Ihre .csv oder .json Dateien auf unsere Server.

Die meisten der hier beschriebenen Schritte sollten wahrscheinlich von einem IT-Experten in Ihrem Unternehmen durchgeführt werden. Aber keine Sorge: Die Schritte sind einfach und alles, was Sie wissen müssen, ist, wie man einen Befehl in der Kommandozeile ausführt.

Um die Dateien auf unsere Server hochzuladen, verwenden Sie das Kommandozeilentool AzCopy von Microsoft (Installationsanweisungen finden Sie hier). Es ist für Windows, macOS und Linux verfügbar.

Damit Sie sich anmelden können, müssen wir ein Azure-Konto mit den richtigen Rechten zum Hochladen der Daten auf unsere Server erstellen.

Für den Login erhalten Sie von uns Anmeldedaten der folgenden Art:

{ 
"appId": "ed1cf692-a353-4654-a4e6-f7b208246a09",
"displayName": "tenantname-erp",
"password": "pjP.x5~eRvP-5y2dbn0m4D62SIsabOg9Jk",
"tenant": "b063570f-c267-43be-83fb-c30a28eab1a2"
}

Um das azcopy Kommandozeielntool verwenden zu können, müssen Sie zunächst die folgenden Umgebungsvariablen setzen. Stelln Sie sicher dass Sie den Wert für AZCOPY_SPA_APPLICATION_ID mit Ihrer appId ersetzen und den Wert für AZCOPY_SPA_CLIENT_SECRET mit Ihrem password.

export "AZCOPY_AUTO_LOGIN_TYPE=SPN"
export "AZCOPY_SPA_CLIENT_SECRET=pjP.x5~eRvP-5y2dbn0m4D62SIsabOg9Jk"
export "AZCOPY_SPA_APPLICATION_ID=ed1cf692-a353-4654-a4e6-f7b208246a09"
export "AZCOPY_TENANT_ID=b063570f-c267-43be-83fb-c30a28eab1a2"

Unter einem Windows Command Prompt (CMD) sollten die Kommandos wie folgt aussehen:

set "AZCOPY_AUTO_LOGIN_TYPE=SPN"
set "AZCOPY_SPA_CLIENT_SECRET=pjP.x5~eRvP-5y2dbn0m4D62SIsabOg9Jk"
set "AZCOPY_SPA_APPLICATION_ID=ed1cf692-a353-4654-a4e6-f7b208246a09"
set "AZCOPY_TENANT_ID=b063570f-c267-43be-83fb-c30a28eab1a2"

In einer Windows PowerShell sollte die Kommandos wie folgt aussehen:

$env:AZCOPY_SPA_CLIENT_SECRET="pjP.x5~eRvP-5y2dbn0m4D62SIsabOg9Jk" 
$env:AZCOPY_AUTO_LOGIN_TYPE="SPN"
$env:AZCOPY_SPA_CLIENT_SECRET="pjP.x5~eRvP-5y2dbn0m4D62SIsabOg9Jk"
$env:AZCOPY_SPA_APPLICATION_ID="ed1cf692-a353-4654-a4e6-f7b208246a09"
$env:AZCOPY_TENANT_ID="b063570f-c267-43be-83fb-c30a28eab1a2"

Um Ihre .csv-Dateien hochzuladen, müssen Sie nur den folgenden Befehl ausführen. Achten Sie darauf, dass Sie den tenantname (im Dateinamen und am Ende des Befehls) durch den ersten Teil der URL ersetzen, die Sie für die Anmeldung bei Luminovo verwenden (normalerweise Ihr Firmenname in Kleinbuchstaben).

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"

3. Richten Sie einen täglichen Export- und Upload-Job ein

Jede Nacht ab 3 Uhr prüfen wir, ob neue Dateien hochgeladen wurden und synchronisieren Ihre Daten mit der Luminovo-Datenbank. Idealerweise automatisieren Sie die Export- und Upload-Schritte und richten einen Job ein, der Ihre Daten jede Nacht (vor 3 Uhr morgens) im Tool hochlädt, damit sie auf unseren Servern landen, bevor wir die Synchronisierung durchführen. Wir empfehlen Ihnen, sich bei Ihrem ERP Anbieter zu erkundigen, ob Ihr ERP die Planung eines automatisierten Skripts unterstützt. Ansonsten können Sie selbst einen automatisieren Job einrichten (z. B. via cron).

Häufig auftretende Probleme beim Dateiformat und empfohlene Lösungen

1. Kopfzeile

  • Die Kopfzeile in den Dateien fehlt oder es werden falsche Spaltentitel verwendet.

    • Die .csv-Dateien müssen eine Kopfzeile beinhalten, wie in den Beispieldateien für angegeben

    • Die Spaltentitel in der Kopfzeile sollten exakt mit den Namen im Template übereinstimmen. Dies beinhaltet auch die Groß- und Kleinschreibung sowie Leer- und Sonderzeichen, wie z. B. Klammern (korrekt wäre: "Standard lead time (Days)")

2. UTF-8 Kodierung

  • Die .csv-Dateien müssen UTF-8-kodiert sein.

  • Die UTF-8-Kodierung sollte beim Export aus dem ERP-System bereits ausgewählt werden.

  • Andere Kodierungen, wie ISO 8859-1/latin-1, führen beim Import zu Fehlern, wenn Sonderzeichen vorhanden sind.

3. Werte in Anführungszeichen setzen

Für .csv Dateien:

  • Wir beobachten häufig, dass Werte nicht in Anführungszeichen gesetzt sind oder selbst Anführungszeichen ohne Escape-Sequenz enthalten.

  • Wir empfehlen, Werte immer dann in Anführungszeichen zu setzen, wenn der Wert das Trennzeichen , oder ; enthält.

    • Beispiele:

      • Folgender Wert sollte so aussehen: "Manufacturer, Inc.".

      • Falls im Wert selbst ein Anführungszeichen enthalten ist, muss dieser escaped werden, indem das Anführungszeichen verdoppelt wird, so z. B. bei der Beschreibung Wire 3/8" . Diese sollte in der Datei wie folgt erscheinen: ...,"Wire 3/8""",....

      • Der Wert LCD 19" monitor sollte in der Datei als ...,"LCD 19"" monitor",... erscheinen.

Für .json Dateien:

  • Falls im Wert selbst ein Anführungszeichen enthalten ist, muss dieser escaped werden, indem das Anführungszeichen verdoppelt wird, so z. B. bei der Beschreibung Wire 3/8" . Diese sollte in der Datei wie folgt erscheinen: ...,"Wire 3/8""",....

4. Ungültige Werte

  • In den Spalten "Packaging" und "Unit of measurement (Unit)" sind nur englischsprachige Werte erlaubt. Beispiele dafür sind Reel oder Piece.

  • Die Spalte "Manufacturer" sollte lediglich den Herstellernamen enthalten. Der Name des Distributors sollte hier vermieden werden.

  • Füllen Sie die Spalte "Unit of measurement (Quantity)" nur aus, wenn eine Bestandseinheit in einem Teil- oder einem Vielfachen der “Unit of Measurement (Unit)” gemessen wird.

  • Füllen Sie die Spalte "Standard lead time (Days)" nur aus, wenn ein verlässlicher Wert für die Vorlaufzeit bekannt ist, in der ein Teil beschafft werden kann.

✉️ Haben Sie Fragen bezüglich der ERP-Integration?

Wenden Sie sich an unseren Product Partnerships Manager, Igor Rhzin, unter [email protected].

Dateivorlagen

Hat dies deine Frage beantwortet?