API-Integration zum Starten, Schließen und Abschließen von Versendungen

Last updated: June 19, 2026

Die meisten Abweichungen können manuell erfasst werden, indem ein neuer Versand in L2L gestartet wird. L2L bietet eine Möglichkeit, Versände über die API zu erstellen, zu aktualisieren und abzuschließen, um Prozesse zur Steigerung der Effizienz zu automatisieren. Hier sind einige Anwendungsfälle, bei denen die Automatisierung der Erstellung und des Abschlusses von Versänden hilfreich sein kann:

  • Starten eines Versands, um Techniker zu benachrichtigen, wenn eine Maschine einen bestimmten Fehler ausgibt
  • Starten eines Prozesses in L2L aus einer anderen Anwendung, z. B. einem QMS
  • Schließen eines Versands, wenn eine Fehlerbedingung nicht mehr aktiv ist
  • Verwenden von Hardwaregeräten zum Starten von Versänden

Starten eines Versands

Ziel: Automatisieren der Erstellung eines Versands zur Verbesserung der Effizienz und Genauigkeit der Versanddaten.
Empfohlenes Intervall: Bei Bedarf
Prozessübersicht:

  1. (Optional) Ermitteln, ob bereits ein Versand für die betroffene Maschine mit demselben Versandtyp gestartet wurde. Dies kann verwendet werden, um die Duplizierung von Daten zu verhindern. Wenn ein Versand mit derselben Maschine und demselben Versandtyp gefunden wird, ist möglicherweise kein neuer Versand erforderlich. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&machinecode=[machine code]&dispatchtypecode=[dispatch type code]&open=T&order_by=-reported&limit=1
  2. Erstellen eines neuen Versands. Es gibt zwei Methoden zum Erstellen eines Versands:
    1. Hinzufügen. Dadurch wird ein abgeschlossener und geschlossener Versand erstellt. Diese Methode wird verwendet, wenn Sie einfach ein Ereignis oder einen Stillstand erfassen möchten, ohne dass eine menschliche Interaktion erforderlich ist. 
      POST https://[customer].leading2lean.com/api/1.0/dispatches/add/?auth=[api key]
      1. POST-Parameter: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Eine vollständige Liste der POST-Parameter finden Sie in der offiziellen API-Dokumentation.
    2. Öffnen. Dies wird verwendet, um einen offenen Versand zu starten. Dies entspricht dem Starten eines Versands über das Formular „Neuer Versand“ in der Benutzeroberfläche.
    3. POST https://[customer].leading2lean.com/api/1.0/dispatches/open/?auth=[api key]
      1. POST-Parameter: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Eine vollständige Liste der POST-Parameter finden Sie in der offiziellen API-Dokumentation.

Schließen eines Versands

Ziel: Einen Versand programmgesteuert schließen
Empfohlenes Intervall: Bei Bedarf
Prozessübersicht:

  1. Suchen Sie den Versand, um die Versand-ID zu ermitteln. Dieser Schritt kann übersprungen werden, wenn die Versand-ID bereits bekannt ist. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Schließen Sie den Versand 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/close/[dispatch id]/?auth=[api key]

Versand abschließen

Ziel: Einen Versand programmgesteuert abschließen
Vorgeschlagenes Intervall: Bei Bedarf
Prozessübersicht:

  1. Suchen Sie den Versand, um die Versand-ID zu ermitteln. Dieser Schritt kann übersprungen werden, wenn die Versand-ID bereits bekannt ist. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Schließen Sie den Versand ab 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/complete/[dispatch id]/?auth=[api key]