Zum Inhalt springen

App-Dokumentation · DE

Chargen-Splitting

Mit Chargen-Splitting teilen Sie eine lebensmitteltaugliche Eltern-Charge in mehrere Kind-Chargen auf Basis des ERP-Splitting-Backends: Ein Split-Lauf verbraucht genau eine Eltern-Charge und erzeugt N Kind-Chargen (Umpacken, Sub-Lotting) und erfasst jede Eltern-Kind-Verknüpfung für vollständige Vorwärts- und Rückwärts-Rückverfolgbarkeit.

Bereiche

  • Split erstellen: eine Eltern-Charge und einen ausführenden Benutzer wählen, dann eine oder mehrere Kind-Chargen mit jeweils einer Menge und einem optionalen Chargencode hinzufügen. Der Lauf verbraucht die Eltern-Charge für die erhaltene Summe aller Kindmengen und erzeugt die Kind-Chargen.
  • Läufe: die erfassten Split-Läufe auflisten (optional nach Ausgabeartikel gefiltert) und einen Lauf öffnen, um seine Eltern-Charge, die verbrauchte Menge und jede Kind-Charge zu sehen.
  • Rückverfolgung: vorwärts von einer Eltern-Charge zu allen erzeugten Kind-Chargen oder rückwärts von einer Kind-Charge zu der einen Eltern-Charge, aus der sie geteilt wurde.
  • Hilfe: In-App-Hinweise.

Felder und Begriffe

  • Split-Lauf: parent_lot_id, output_item_id, consumed_qty, optional document_ref, die Eltern-parent_movement_ref, by_user_id, created_at.
  • Kind-Charge: child_lot_id, child_lot_code, qty, die Verknüpfung split_parent_movement_id und eine position.
  • Mengen sind Dezimal-Zeichenketten; die erhaltene Kindsumme darf die verbleibende Menge der Eltern-Charge nicht überschreiten (Über-Splitten wird vom Backend abgelehnt).

Backend-Vertrag

Alle Routen liegen unter /api/erp/splitting, mandantenbezogen, mit dem {success, data}-Umschlag.

  • POST /runs — einen Split erstellen. Body (snake_case): {parent_lot_id, children:[{qty, lot_code?}], user_id, output_item_id?, document_ref?}. Liefert 201, 422 bei Validierungsfehlern oder 409 bei zu geringer Elternmenge.
  • GET /runs?output_item_id=&limit= — Läufe auflisten.
  • GET /runs/{runId} — einen Lauf + seine Kind-Chargen lesen.
  • GET /trace/{parentLotId} — Vorwärts-Trace (Eltern → Kinder).
  • GET /trace-parent/{childLotId} — Rückwärts-Trace (Kind → Eltern).

Die Authentifizierung erfolgt über httpOnly-Cookie + CSRF mittels @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus localStorage gelesen.

Typischer Ablauf

  1. Einen Split von einer Eltern-Charge in N Kind-Chargen mit Mengen erstellen.
  2. Den Lauf öffnen, um die verbrauchte Menge und die erzeugten Kind-Chargen zu bestätigen.
  3. Bei einem Rückruf vorwärts von einer verdächtigen Eltern-Charge zu jeder Kind-Charge verfolgen, die sie gespeist hat.
  4. Rückwärts von einer verdächtigen Kind-Charge zu ihrer einzigen Quell-Eltern-Charge verfolgen.

Während ein Vorgang läuft, sind die schreibenden Aktionen gesperrt. Mehrfaches Absenden erzeugt keinen zweiten Auftrag. Nach Abschluss oder Fehler können Sie einen neuen Versuch starten.