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, optionaldocument_ref, die Eltern-parent_movement_ref,by_user_id,created_at. - Kind-Charge:
child_lot_id,child_lot_code,qty, die Verknüpfungsplit_parent_movement_idund eineposition. - 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
- Einen Split von einer Eltern-Charge in N Kind-Chargen mit Mengen erstellen.
- Den Lauf öffnen, um die verbrauchte Menge und die erzeugten Kind-Chargen zu bestätigen.
- Bei einem Rückruf vorwärts von einer verdächtigen Eltern-Charge zu jeder Kind-Charge verfolgen, die sie gespeist hat.
- 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.