Workflows

Typische Workflows

Diese Seite beschreibt die typischen Integrationsszenarien fuer die Uebernahme von Daten nach wme.fact.

---

Workflow 1: Wiegescheine automatisch abholen

Automatisierter Prozess zum Abholen freigegebener Wiegescheine aus dem Scanner.

Ablauf

1. Anzahl pruefen: Vor der Verarbeitung pruefen, ob Wiegescheine vorhanden sind

   GET /v1/released_wiegeschein_data_count?apiKey=ihr-api-key
   Response: 5

2. Wiegeschein abrufen: Naechsten Wiegeschein holen (FIFO-Prinzip)

   GET /v1/released_wiegeschein_data?apiKey=ihr-api-key
   Response: { "id": 12345, ... }

3. In wme.fact verarbeiten: Daten in lokale Datenbank uebernehmen
4. Erfolg bestaetigen: Transfer als erfolgreich markieren

   POST /v1/released_wiegeschein_data
   Body: {"apiKey":"...","wiegescheinId":12345,"errorMessage":null}

5. Wiederholen: Schritte 2-4 wiederholen bis keine Wiegescheine mehr vorhanden (204)

Pseudocode

apiKey = "ihr-api-key"

while true:
    # Naechsten Wiegeschein abrufen
    response = GET("/v1/released_wiegeschein_data?apiKey=" + apiKey)

    if response.status == 204:
        # Keine weiteren Wiegescheine
        break

    if response.status != 200:
        # Fehler behandeln
        log_error(response)
        break

    wiegeschein = response.body

    try:
        # In wme.fact importieren
        import_to_wmefact(wiegeschein)

        # Erfolg melden
        POST("/v1/released_wiegeschein_data", {
            "apiKey": apiKey,
            "wiegescheinId": wiegeschein.id,
            "errorMessage": null
        })
    except Exception as e:
        # Fehler melden (Wiegeschein bleibt in Queue)
        POST("/v1/released_wiegeschein_data", {
            "apiKey": apiKey,
            "wiegescheinId": wiegeschein.id,
            "errorMessage": str(e)
        })

---

Workflow 2: Inventurdaten exportieren

Periodischer Export der freigegebenen Inventurdaten.

Ablauf

1. Export abrufen: Alle freigegebenen Inventureintraege auf einmal abrufen

   GET /v1/inventur/export?apiKey=ihr-api-key
   Response: { "entries": [...], "totalCount": 42 }

2. Daten verarbeiten: Alle Eintraege in wme.fact uebernehmen
3. Fertig: Die Eintraege wurden automatisch als exportiert markiert und geloescht

Wichtig

• Anders als bei Wiegescheinen gibt es keine separate Bestaetigung
• Der Export-Abruf ist einmalig - Eintraege werden danach automatisch geloescht
• Bei Verarbeitungsfehlern auf Client-Seite sind die Daten verloren - sichern Sie die Response vor der Verarbeitung!

Pseudocode

apiKey = "ihr-api-key"

# Inventurdaten abrufen (einmaliger Abruf!)
response = GET("/v1/inventur/export?apiKey=" + apiKey)

if response.status == 404:
    # Keine freigegebenen Eintraege
    log("Keine Inventurdaten zum Export vorhanden")
    return

if response.status != 200:
    # Fehler behandeln
    log_error(response)
    return

# WICHTIG: Daten sichern bevor Verarbeitung
backup_to_file(response.body)

for entry in response.body.entries:
    try:
        import_inventur_to_wmefact(entry)
    except Exception as e:
        log_error("Fehler bei Entry " + entry.id + ": " + str(e))
        # Eintrag ist bereits aus dem System geloescht
        # Manuelle Nacharbeit erforderlich

---

Empfohlene Intervalle

API	Empfohlenes Intervall	Hinweis
Wiegeschein Export	Alle 5-15 Minuten	Regelmaessig pruefen, sofort verarbeiten
Inventur Export	Taeglich oder nach Bedarf	Meist nur bei Inventurabschluss

Fehlerbehandlung

• 401 Unauthorized: API-Key ungueltig oder abgelaufen - neuen Key in der Anwendung generieren
• 404 Not Found: Keine Daten vorhanden - normal, spaeter erneut versuchen
• 500 Server Error: Temporaeres Problem - nach kurzer Wartezeit erneut versuchen