ERP-Export
Verwenden Sie den ERP-Export, um WSi-Projektdaten an Ihr ERP-System zu senden. Es gibt zwei Möglichkeiten zum Export:
- JSON → Server sendet Daten direkt an Ihr ERP über HTTP — keine manuelle Dateiverwaltung. WSi authentifiziert sich am Server und sendet ein JSON-Payload.
- JSON → Datei speichert dasselbe JSON in eine Datei auf Ihrem Computer oder Ihrer Netzwerklaufwerk.
Beide Modi verwenden dieselbe JSON-Struktur und Schnittstellenkonfiguration (tsGraphRep oder Stückliste). Die Wahl betrifft nur die Art der Datenübermittlung.
Wann ERP-Export Verwenden
Wählen Sie ERP-Export wenn:
- Ihre Organisation einen Server-Endpunkt für den Empfang von WSi-Daten konfiguriert hat
- Sie Exportdaten automatisch pushen möchten, ohne zuerst eine Datei zu speichern
- Sie eine Integration mit einem benutzerdefinierten ERP-System benötigen
INFO
Für IT-Blech oder Oseon ERP-Systeme bietet WSi dedizierte Exportformate:
- IT-Blech-Export — XML-Format, aktiviert bei lizenziertem IT-Blech-Modul
- Oseon-Export — natives Oseon-Format, aktiviert bei lizenziertem Oseon-Modul
Zum Speichern einer Datei auf Ihrem Computer oder Ihrer Netzwerklaufwerk siehe Lokaler Export.
JSON → Server
- Klicken Sie auf Datei → Export → ERP-Export (JSON → Server) oder verwenden Sie die Symbolleistenschaltfläche.
- WSi prüft, ob alle Bauteile exportbereit sind. Bei Fehlern listet ein Dialog sie auf — beheben Sie diese zuerst und versuchen Sie es erneut.
- Wenn keine URL konfiguriert ist, geben Sie Ihren ERP-Server-Endpunkt in das bereitgestellte Feld ein. WSi merkt sich die zuletzt verwendete URL.
- Wenn aufgefordert, geben Sie Ihre Authentifizierungsdaten ein (Basic Auth oder Bearer-Token). WSi speichert sie für nachfolgende Exporte.
- WSi sendet das JSON an Ihren Server. Eine Bestätigung erscheint beim erfolgreichen Transfer.
Zu den Schnittstellentypen und Ressourceneinstellungen siehe Standard-Schnittstelle.
WARNUNG
Exports werden blockiert, wenn einige Bauteile nicht lizenzierte Funktionen verwenden (Schweißen, Bearbeitung, Beschichtung, Stanzen). Wenden Sie sich an Ihren Vertriebspartner bei WSoptics, um diese Funktionen zu aktivieren.
HINWEIS
Wenn Ihr Server ein selbstsigniertes Zertifikat verwendet, fragt WSi beim ersten Verbinden, ob Sie ihm vertrauen möchten.
Eine Schritt-für-Schritt-Anleitung zum ERP-Export finden Sie oben unter JSON → Server.
Was wird gesendet
Das JSON-Payload enthält Ihre Projektdaten — entweder eine Grafikdarstellung (volle Projektstruktur mit Geometrie, Artikeln und eingebetteten CAD-Dateien als Base64) oder eine Stückliste (Bill of Materials mit Komponenten, Arbeitsschritten, Kosten und Abmessungen). Welches Format verwendet wird, hängt von Ihrer Schnittstellenkonfiguration ab.
JSON → Datei
Speichern Sie das ERP-JSON-Payload in eine Datei, anstatt es an einen Server zu senden:
- Klicken Sie auf Datei → Export → ERP-Export (JSON → Datei) oder drücken Sie Strg+J.
- WSi prüft, ob alle Bauteile exportbereit sind. Beheben Sie zuerst Fehler.
- Wählen Sie einen Ort und Dateinamen. Der standardmäßig vorgeschlagene Name ist
<projekt_name>.json. - Klicken Sie auf Speichern.
Das gespeicherte JSON ist identisch mit dem, was an den Server gesendet würde. Sie können es in einem beliebigen Texteditor öffnen oder in ein anderes System laden. WSi merkt sich das letzte Exportverzeichnis.
Authentifizierung
WSi unterstützt zwei Authentifizierungsmethoden:
- Basic Auth — Benutzername und Passwort
- Bearer-Token — eine Token-Zeichenkette
Anmeldedaten werden sicher gespeichert und für nachfolgende Exporte wiederverwendet.
Konfiguration
ERP-Server-URL, Authentifizierung und SSL-Optionen werden in WSi's lokalen Einstellungen gespeichert. Ihr Administrator kann diese vor konfigurieren, sodass Sie sie nicht jedes Mal manuell eingeben müssen.
ERP-Integrationseinstellungen
Zugriff über Einstellungen → Client → Lokale ERP Einstellungen → Konfiguration ERP Integration.
| Einstellung | Funktion |
|---|---|
| Endpunkt-URL | Die Serveradresse, an die WSi Daten sendet. Akzeptiert http://, https:// und file://. |
| Nach erfolgreichem Export schließen | Wenn aktiviert, schließt sich WSi automatisch nach einem erfolgreichen Export — nützlich für automatisierte Pipelines. |
| ERP-Integrationseingabe | Benutzerdefinierte Schlüssel-Wert-Paare, die in das Feld projectUserData jedes Exports gemergt werden. Ermöglicht das Einfügen unternehmensspezifischer Metadaten in das JSON-Payload. |
| HTTP-Anfrage-Header | Zusätzliche Header, die mit jeder Anfrage gesendet werden (z. B. X-API-Key, X-Company-ID). Jeder Header hat einen Namen und einen Wert. |
Die Endpunkt-URL, die Quit-on-Success-Flagge und die Integrationseingabe können jeweils auf Standard (von Ihrem Administrator vorkonfiguriert) oder Benutzerdefiniert (sitzungsbezogen im Dialog überschrieben) gesetzt werden.
Standard-Schnittstellenkonfiguration
Zugriff über Einstellungen → Datenbank. Wählen Sie Erweiterte Einstellungen aus der Tabellenliste und öffnen Sie dort den Reiter ERP Schnittstelle - Inhalt — siehe Erweiterte Einstellungen für mehr zum Datenbank-Dialog.
Wählen Sie, welchen Schnittstellentyp und welche Version WSi bei der Generierung des Export-JSON verwendet:
Schnittstellentypen
| Typ | Beschreibung |
|---|---|
| tsGraphRep (Grafikdarstellung) | Der volle Projektknoten — enthält alle Geometrien, Artikel, eingebettete CAD-Dateien als Base64 und die vollständige Knotenstruktur. Wird für Backups, Teilen oder Systemintegration verwendet. |
| Stückliste (Bill of Materials) | Eine fokussierte Teileliste — Komponenten mit Mengen, Kosten, Abmessungen und Arbeitsschritt-Zusammenfassungen. Wird für Beschaffung und Angebotserstellung verwendet. |
Ressourcen- und Anhangstypen (tsGraphRep)
Wenn der Schnittstellentyp tsGraphRep ist, wählen Sie, welche Ressourcen in den Export aufgenommen werden sollen:
| Ressource | Format | Beschreibung |
|---|---|---|
| B zeichnung | HTML | Biegeanweisungen pro Bauteil |
| Arbeitskarte | HTML | Fertigungsaufgaben-Zusammenfassung |
| DXF | 2D-CAD | Schnittkonturen |
| DXF komprimiert | .dxf.gz | Komprimiertes DXF |
| GEO | 2D-Geometrie | Gmsh-Geometrie |
| GEO komprimiert | .geo.gz | Komprimiertes GEO |
| SVG | 2D-Vektor | Skalierbarer Vektorgraphik |
| SVG komprimiert | .svg.gz | Komprimiertes SVG |
| STEP-Eingabe | 3D-CAD | Geladene Baugruppen-Geometrie |
| STEP-Eingabe komprimiert | .stp.gz | Komprimierte STEP-Eingabe |
| STEP-erzeugt | 3D-CAD | Erzeugte/Ausgangsgeometrie |
| STEP-erzeugt komprimiert | .stp.gz | Komprimierte STEP-erzeugt |
| PNG-Bilder | Raster | Screenshots von Baugruppen |
| Grafikkomponenten | .wsi | Sub-Graphen als separate WSi-Dateien |
| Anhänge | Verschiedenes | Benutzerdefinierte Dateianhänge |
Export-Flags (Stückliste)
Wenn der Schnittstellentyp Stückliste ist, wählen Sie, welche zusätzlichen Dateien gebündelt werden sollen:
| Flag | Beschreibung |
|---|---|
| Biegezeichnung | HTML-Biegezeichnungen einfügen |
| DXF | 2D-Schnittkonturen einfügen |
| GEO | 2D-Geometrie einfügen |
| Arbeitskarte | HTML-Arbeitskarten einfügen |
| PNG (Eingabebaugruppe) | Screenshot der geladenen Baugruppe |
| PNG (erzeugte Baugruppe) | Screenshot der erzeugten/Ausgangsbaugruppe |
| STEP (Eingabebaugruppe) | 3D-STEP der geladenen Baugruppe |
| STEP (erzeugte Baugruppe) | 3D-STEP der erzeugten/Ausgangsbaugruppe |
| SVG | 2D-Vektor-Ausgabe |
| Grafikkomponenten | Sub-Graphen als .wsi-Dateien |
| Anhänge | Benutzerdefinierte Dateianhänge |
| GLTF (Eingabebaugruppe) | GLTF der geladenen Baugruppe |
| GLTF (erzeugte Baugruppe) | GLTF der erzeugten/Ausgangsbaugruppe |
Versionen
Jeder Schnittstellentyp hat einen Version-Selektor:
- tsGraphRep: v0 (Alte Version, veraltet) oder v1 (aktuelle Standardversion)
- Stückliste: v0 (aktuelle Standardversion)
SSL und Zertifikate
Wenn Ihr ERP-Server HTTPS mit einem selbstsignierten Zertifikat verwendet, fordert WSi Sie beim ersten Verbinden auf, ihm zu vertrauen. Vertrauenswürdige Zertifikate werden lokal gespeichert.
Wenn Sie SSL-Fehler encounters, die die Verbindung blockieren, kann Ihr Administrator WSi so konfigurieren, dass bestimmte SSL-Fehlercodes ignoriert werden (in Produktion nicht empfohlen).
Siehe auch
- Stücklisten-Export — Details zum Stücklistenformat
- Lokaler Export — Exporte stattdessen in Dateien speichern
- BOM-CSV-Einstellungen — Konfigurieren des BOM-CSV-Spaltenexports
- Projektexport-Einstellungen — Konfigurieren der Standard-Dateiexportoptionen