Willkommen im ELAM Solutions Hilfecenter

Der ELAM ERP-Connector ist eine freie REST-API (Representational State Transfer), die es ermöglicht Daten in ELAM zu importieren und Daten abzurufen.

‍

Die Hauptfunktionen umfassen den Import von Fertigungsaufträgen, Varianten und Bauteilen, wodurch manuelle Fehler reduziert und die Effizienz gesteigert wird. Fertigungsaufträge werden nach dem Import automatisch den richtigen Stationen zugewiesen und können durch Mitarbeiter sofort gestartet werden.

Datenabfragen ermöglichen es, aktuelle Informationen über Fertigungsaufträge zu erhalten, wie z.B. Status, Fortschritte und verbaute Bauteile in Produkten.

‍

OpenAPI Dokumentation

Die Vollständige OpenAPI Dokumentation finden Sie hier: https://app.elam-solutions.com/erpconnector/swagger/index.html

Die Dokumentation enthält alle Informationen über die verfügbaren Endpunkte, die erforderlichen HTTP-Methoden (GET, POST, PUT, DELETE usw.), die erforderlichen und optionalen Parameter sowie die erwarteten Antworten.

‍

Datenaustausch

Für den Datenaustausch wird eine JSON-Struktur verwendet (JavaScript Object Notation).

‍

Transportprotokoll

Als Transportprotokoll wird HTTPS (Hypertext Transfer ProtocolSecure) verwendet.

‍

Verschlüsselung

Bei derKommunikation wird das Sicherheitsprotokoll TLS (Transport Layer Security)verwendet um sicherzustellen, das Daten privat und geschützt bleiben

‍

Voraussetzungen

Um mit der REST-API kommunizieren zu können, muss das ERP Connector Feature für Ihr Kundensystem aktiviert sein. Kontaktieren Sie Ihren Ansprechpartner, damit das Feature für Ihr Kundensystem aktiviert wird.

Für die Kommunikation müssen Sie HTTP-Anfragen an den ERP Connector senden. In den weiteren Abschnitten des Artikels wird beschrieben, welche Informationen Sie benötigen, um Anfragen an den ERP Connector schicken zu können.

‍

Verbindungseinstellungen

Das ERP Connector Feature für Ihr System freigeschaltet wurde, erscheint es in der ELAM Administration.

Autorisierung

Damit man mit dem ELAM ERP Connector kommunizieren kann, wird die Tenant-ID und das Bearer Token benötigt.

• Tenant ID: Mit der Tenant-ID wird sichergestellt, dass der Kunde die nötigen Rechte für das Kundensystem hat. Jeder Endpunkt hat eine eigene URL. In der URL muss immer die Tenant-ID angegeben werden, die pro Kundensystem individuell ist.
• Bearer Token: Ein Bearer Token ist eine Art von Zugangstoken, das in der Authentifizierung und Autorisierung von Webanwendungen verwendet wird. Es handelt sich um ein kryptografisch sicheres Token, das dem Inhaber (englisch "bearer") den Zugriff auf geschützte Ressourcen erlaubt, ohne dass weitere Authentifizierungsschritte erforderlich sind.

Hinweis: Das Bearer Token wird im Autorisierungs-Header angegeben und ist aktuell 30 Tage gültig. Das Token muss spätestens nach 30 Tagen neu erzeugt werden.

‍

Bearer Token erzeugen

1. Klicken Sie in der ELAM Administration auf die Seite ERP Connector
2. Klicken Sie auf der Schaltfläche auf Neuer Bearer Token

Anschließend werden Sie auf eine Seite weitergeleitet. Klicken Sie auf der Schaltfläche Ja, damit ein neuer Bearer Token generiert wird und schließen Sie das Browser Fenster.

Hinweis: Die Token Generiert wird demnächst auf API-Keys geändert.

Das Token wird im Feld Bearer Token angezeigt und kann über der Kopier-Button kopiert werden.

‍

Mit der Tenant-ID und dem Bearer Token können jetzt HTTP-Anfragen an den ERP Connector geschickt werden.

‍

Begrifflichkeiten

Generell werden im ELAM-System Produkte abgearbeitet. Damit das ELAM-Solutions System die Rückverfolgbarkeit gewährleisten kann, besitzt ein Produkt immer die Losgröße=1 . In den ERP-Systemen werden in der Regel aus Kundenaufträgen sortenreine Fertigungsaufträge abgeleitet, die eine Losgröße>1 besitzen können. Solche Fertigungsaufträge werden in ELAM immer vereinzelt.

1. Kundenauftrag: Anzahl mehrerer Produkte, die für einen Kunden produziert werden sollen. Dieskönnen Produkte unterschiedlicher Ausprägung in verschiedenen Stückzahlen sein.
2. Fertigungsauftrag: Sortenreine Anzahl mehrerer Produkte, dieproduziert werden sollen. Alle Produkte beziehen sich auf dieselbe Variante.
3. Losgröße: Die Losgröße ist die Menge an Produkten, die produziert werden soll.
4. Variante: Eine Variante ist eine bestimmte Ausprägung eines Produkts.
5. Produkt: Einzelnes Produkt, das mit dem Auftragsimport produziert werden soll.
6. Seriennummern: Seriennummern sind eindeutig und werden zu jedem Produkt entweder importiert oder vom ELAM-System erzeugt. Über die Seriennummer wird ein Produkt eindeutig identifiziert.

‍

Welche Daten können importiert werden?

Über den ERP-Connector können folgende Daten in das ELAM Solutions importiert werden:

1. Fertigungsaufträge: Fertigungsaufträge, die importiert werden, erscheinen automatisch in der ELAM Administration auf der Seite Auftragsübersicht und im ELAM Assistenten an den jeweiligen Stationen. Importierte Fertigungsaufträge können an Stationen sofort gestartet werden.
2. Varianten
3. Bauteile

‍

In den folgenden Abschnitten ist beschrieben, welche Daten im Detail importiert werden können.

‍

Fertigungsaufträge

Folgende Daten zu Fertigungsaufträgen können importiert werden:

• Fertigungsauftrags-ID (Pflicht): Eindeutige Kennung des Fertigungsauftrags. Ein Fertigungsauftrag darf nur einmal im System existieren.
• Varianten-ID (Pflicht): Eindeutige Kennung des Produkts, damit diese zurückverfolgt werden können. Wenn eine Varianten-ID übermittelt wird, die in ELAM Solutions nicht bekannt ist, dann wird die Variante automatisch im System angelegt. Bitte beachten Sie, dass die Variante von Ihnen manuell um System zu Stationen und Flowcharts zugewiesen werden muss, damit der Fertigungsauftrag im ELAM Assistenten gestartet werden kann.
• Losgröße: Die Menge der Produkte, die produziert werden soll.
• Seriennummer(n) (Optional): Seriennummern der Produkte.

‍

Hinweis: Wenn keine Seriennummern zum Fertigungsauftrag übermittelt wird, erzeugt ELAM-Solutions automatisch Seriennummern in einem festen Format in Abhängigkeit der importierten Losgröße. Das Format der automatisch generierten Seriennummer kann nicht geändert werden.

Die automatisch generierte Seriennummern setzt sich wie folgt zusammen:

Beispiel mit 10 automatisch generierten Seriennummern:

1. ID0815 - 000001
2. ID0815 - 000002
3. ID0815 - 000003
4. ID0815 - 000004
5. ID0815 - 000005
6. ID0815 - 000006
7. ID0815 - 000007
8. ID0815 - 000008
9. ID0815 - 000009
10. ID0815 - 000010

Hinweis: Die laufende Nummer (RunningNumber) startet mit jedem Import eines neuen Fertigungsauftrags ab der Losgröße=1.

‍

Varianten

Varianten können separat importiert werden. Dies ist für auftragsunabhängige Stücklistenaktualisierungen notwendig, die zwischen dem ERP-System und ELAM Solutions synchronisiert werden sollen.

Folgende Daten zu Varianten können importiert werden:

• Varianten-ID (Pflicht): Eindeutige Kennung oder Ausprägung eines Produkts.
• Name (Optional): Beschreibung oder Titel der Variante. Der Name ist nicht eindeutig und kann im ELAM Solutions System mehrmals vorkommen.
• Kommentar (Optional): Zusätzliche Textinformation zur Variante. Der Kommentar ist nicht eindeutig und kann im System mehrmals vorkommen.
• Scancode (Optional): Eindeutige Identifikation der Variante unter Angabe eines RegEx(Regular Expression) Codes. Ein Scancode wird üblicherweise in Form eines Barcodes oder QR-Codes auf das Produkt angebracht und zur Identifikation während der Montage genutzt.

‍

Bauteile

Bauteile können separat importiert werden. Dies ist für auftragsunabhängige Stücklistenaktualisierungen notwendig, die zwischen dem ERP-System und ELAM Solutions synchronisiert werden sollen.

Folgende Daten zu Bauteilen können importiert werden:

• Bauteil-ID (Pflicht): Eindeutige Kennung oder Ausprägung eines Bauteils, oft auch als Artikelnummer bekannt.
• Name (Optional): Beschreibung oder Titel des Bauteils. Der Name ist nicht eindeutig und kann im ELAM Solutions System mehrmals vorkommen.
• Kommentar (Optional): Zusätzliche Textinformation zum Produkt. Der Kommentar ist nicht eindeutig und kann im System mehrmals vorkommen.
• Scancode (Optional): Eindeutige Identifikation des Bauteils unter Angabe eines RegEx(Regular Expression) Codes. Ein Scancode wird üblicherweise in Form eines Barcodes oder QR-Codes auf das Bauteil angebracht und zur Identifikation während der Montage genutzt.

‍

Welche Daten können gelöscht werden?

Über den ERP-Connector können folgende Daten in ELAM Solutions gelöscht werden:

1. Fertigungsaufträge
2. ‍Varianten
3. Bauteile

‍

In den folgenden Abschnitten ist beschrieben, welche Daten im Detail gelöscht werden können.

‍

Fertigungsaufträge löschen

Fertigungsaufträge können nur gelöscht werden, wenn kein einziges Produkt eines Fertigungsauftrages gestartet wurde.

‍

Varianten löschen

Mit dem Löschen der Variante werden folgende Daten automatisch gelöscht, die zur Variante zugewiesen sind:

1. Zuweisungen von Flowcharts zur Variante
2. Zuweisungen von Stationen zur Variante
3. Produkte, die mit dem Auftragsimport angelegt sind und folgenden Status haben:
   • Freigegeben
   • In Bearbeitung
   • Gesperrt

Hinweis: Abgeschlossene Produkte werden niemals gelöscht.

‍

Bauteile löschen

Mit dem Löschen der Bauteile werden folgende Daten automatisch gelöscht, die zu Bauteilen zugewiesen sind:

1. Zuweisungen von folgenden Modulen
   • Bossard SmartLabels
   • Bossard SmartTower
   • KBS Pick to Light

‍

Welche Daten können aktualisiert werden?

‍

Über den ERP-Connector können folgende Daten in ELAM Solutions aktualisiert werden:

1. Fertigungsaufträge
2. Varianten
3. Bauteile

‍

In den folgenden Abschnitten ist beschrieben, welche Daten im Detail aktualisiert werden können.

‍

Fertigungsaufträge aktualisieren

Bereits importierte Fertigungsaufträge können über das ERP-System im Nachhinein aktualisiert werden, solange noch kein Produkt aus dem Fertigungsauftrag begonnen wurde.

Folgende Daten eines Fertigungsauftrags können über den ERP-Connector unter Angabe der eindeutigen Fertigungsauftrags-ID aktualisiert werden:

1. Fertigungsauftrags-ID (Pflicht)
   • Varianten-ID
   • Losgröße
   • Seriennummern

Dies ist für auftragsabhängige Auftragsaktualisierungen notwendig, die zwischen dem ERP-System und ELAM Solutions synchronisiert werden sollen.

‍

‍

Varianten aktualisieren

Bereits importierte Varianten können über das ERP-System im Nachhinein unter Angabe der eindeutigen Varianten-ID aktualisiert werden:

1. Varianten-ID (Pflicht)
   • Name
   • Kommentar
   • Scancode

Dies ist für auftragsunabhängige Materialaktualisierungen notwendig, die zwischen dem ERP-System und ELAM Solutions synchronisiert werden sollen.

‍

Bauteile aktualisieren

Bereits importierte Bauteile können über das ERP-System im Nachhinein unter Angabe der eindeutigen Bauteil-ID aktualisiert werden:

1. Varianten-ID (Pflicht)
   • Name
   • Kommentar
   • Scancode

Dies ist für auftragsunabhängige Stücklistenaktualisierungen notwendig, die zwischen dem ERP-System und ELAM Solutions synchronisiert werden sollen.

‍

Welche Daten können abgefragt werden?

Über die Endpunkte des ELAM ERP-Connectors können folgende Daten von ELAM-Solutions abgefragt werden:

1. Fertigungsaufträge
2. Produkte
3. Varianten
4. Bauteile

‍

Fertigungsauftragsdaten abrufen

Unter angabe der eindeutigen Fertigungsauftrags-ID können folgende Daten zum Fertigungsauftrag abgefragt werden:

1. Varianten-ID: Eindeutige ID der Variante.
2. Losgröße: Die Menge an Produkten die produziert worden ist.
3. Menge gut: Die Menge an Produkten, die mit dem Status OK abgeschlossen worden sind.
4. Menge schlecht: Die Menge an Produkten, die mit dem Status OK abgeschlossen worden sind.
5. Status des Fertigungsauftrags:
   1. Freigegeben
   2. Gesperrt
   3. In Bearbeitung
   4. Abgeschlossen
6. Importzeitpunkt: Datum und Uhrzeit, wann der Fertigungsauftrag importiert wurde.
7. Startzeitpunkt: Datum und Uhrzeit, wann das erste Produkt des Fertigungsauftrags gestartet wurde.
8. Endzeitpunkt: Datum und Uhrzeit, wann das letzte Produkt des Fertigungsauftrags abgeschlossen wurde.

Ein Abruf der Fertigungsauftragsdaten ermöglicht Ihnen den aktuellsten Auftragszustand abzurufen und diesen mit Ihrem ERP-System zu synchroniesieren.

‍

Produktdaten abrufen

Unter angabe der eindeutigen Produkt-ID können folgende Daten zum Fertigungsauftrag abgefragt werden:

1. Varianten-ID: Die eindeutige Bezeichnung der Variante.
2. Varianten-Name: Name der Variante.
3. Seriennummer: Eindeutige Seriennummer des Variante.
4. ELAM-ID: Universelle ELAM-ID, die für menschen lesbar ist.
5. Status des Produkts
   1. Importiert, aber noch nicht gestartet
   2. In Bearbeitung
   3. Abgeschlossen
6. Gesperrt: Information ob das Produkt derzeit gesperrt ist oder nicht.
7. Gesperrt von: Wenn das Produkt gesperrt ist, wird der Benutzername angezeigt von wem die Sperrung erfolgt ist. (z.B. Benutzername)
8. Fertigungsauftrag: ID des Fertigungsauftrags.
9. Startzeitpunkt: Zeitstempel wann das Produkt gestartet wurde.
10. Letzte Änderung: Zeitstempel wann das Produkt das letzte Mal aktualisiert wurde.
11. Endzeitpunkt: Zeitstempel wann das Produkt abgeschlossen wurde.
12. Durchlaufzeit: Zeit wie lange das Produkt gebraucht hat vom Start- bis zum Abschluss.
13. Montagezeit: Zeit wie lange das Produkt im ELAM Assisteten tatsächlich aktiv war. Aus dieser Information leitet sich die Montagezeit ab.
14. Stationen: Information an welchen Stationen das Produkt durchgelaufen ist.
    1. Benutzer: Information welcher Benutzername aktiv eingeloggt war im ELAM Assistenten
    2. Bauteile: Bauteile die entommen worden sind während der Montage.
       1. Entnahmemenge: IST-Menge die entnommen wurde.
       2. Bauteil-ID: Eindeutige ID des Bauteils
       3. Scancode: IST-Scanwert des Bauteils
    3. Schraubwerte:
       1. Tool-Werkzeugnummer: Werzeugnummer des Tools mit der die Verschraubungen gemacht wurden.
          1. Programmnummer: Programm oder Job nach der Verschraubung.
          2. Status: Status der Verschraubung (OK/ NOK)
          3. Zeitstempel: Wann die Verschraubung gemacht wurde
          4. Drehwinkel
             1. IST-Wert
             2. SOLL-Wert
             3. Untergrenze
             4. Obergrenze
             5. Einheit: °
          5. Drehmoment
             1. IST-Wert
             2. SOLL-Wert
             3. Untergrenze
             4. Obergrenze
             5. Einheit
15. Produktfortschritte: ID eines individeull eingestellten Produktfortschrittes. Auch genannt als Vorgang.

‍

‍