Stoffströme, Übergaben und ein Betriebstagebuch, das schliesst

Die Mengen eines Betriebstages stehen auf einem Zettel an der Waage, die Übergaben in E-Mails, und das Betriebstagebuch entsteht am Abend vor der Prüfung aus beidem. Das funktioniert, solange niemand fragt, woher eine Zahl kommt — und es funktioniert genau einmal nicht.

Der Vertrag verlangt deshalb Tagesabschluss und Wochenabzeichnung durch eine angemeldete Person in der Journalrolle; tapinoma zeichnet nicht im eigenen Namen ab. Die Ereignisse tragen hash und previousHash: Eine Lücke wird dadurch nicht unmöglich, aber sie wird sichtbar — und genau das ist der Zweck.

Was dieser Fall voraussetzt

• Massen, die gemessen und nicht geschätzt sind. Die Masse wird mit der Einheit kg oder t angegeben.
• Ein Materialcode je Bewegung. Ohne ihn ist eine Menge eine Zahl ohne Gegenstand.
• Die Genehmigung des Empfängers. Eine Übergabe verweist auf einen Abzug der Genehmigung; ohne sie ist der Empfänger nicht belegt.
• Eine zeichnungsberechtigte Person für die Woche. Die Abzeichnung ist personenzurechenbar und kein Stapellauf.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Warum jede Stufe nötig ist

1. Die Bewegung erfassen. POST /compliance/material-movements nimmt facilityId, movementType, materialCode, mass und unit sowie Quell- und Zielort und den Messzeitpunkt measuredAt. Erfasst wird beim Wiegen, nicht beim Berichten — das ist der einzige Unterschied, der über die Belastbarkeit entscheidet.
2. Die Übergabe belegen. POST /compliance/downstream-transfers verweist auf die übergebenen assetRefs, auf Empfängerorganisation und Empfängeranlage, auf deren Genehmigungsabzug in permitSnapshotId und auf den Transport und verlangt mindestens eine Angabe in masses. Der Genehmigungsabzug ist der Punkt: Er hält fest, auf welcher Berechtigung des Empfängers die Übergabe beruhte.
3. Den Tag abschließen. POST /compliance/journal-periods/{date}/close-daily nimmt facilityId, timeZone, closedAt und eine attestationId. Der Abschluss wird der angemeldeten Person und ihrer Journalrolle zugerechnet; sie bestätigt ihre Anmeldung dafür erneut, und tapinoma zeichnet nicht im eigenen Namen ab.
4. Die Woche abzeichnen. POST /compliance/journal-periods/{week}/sign-off-weekly verweist auf die Tagesabschlüsse der Woche und trägt ein Attest. Die Abzeichnung liegt bei einer Person.
5. Die Prüfakte ziehen. GET /compliance/audit-exports/{case_or_period} gibt die Ereignisse mit ihren Hashwerten aus — für einen Fall oder für einen Zeitraum. Das ist die Stelle, an der eine Lücke auffällt, und zwar Ihnen und nicht erst dem Prüfer.

curl -X POST \
  -H 'Cookie: __Host-tapinomahub_session=<SITZUNG>' \
  -H 'X-CSRF-Token: <CSRF_TOKEN>' \
  -H 'X-Compliance-Organisation-Id: <ORGANISATION>' \
  -H 'Idempotency-Key: tagesabschluss-2026-09-12' \
  -H 'Content-Type: application/json' \
  -d '{"facilityId":"<facilityId>","timeZone":"Europe/Berlin","closedAt":"2026-09-12T18:00:00Z","attestationId":"<attestationId>"}' \
  'https://api.tapinomahub.com/compliance/journal-periods/2026-09-12/close-daily'

Was am Ende vorliegt

Am Ende steht ein Zeitraum, der einer Prüfung standhält, weil er nicht nachträglich erzählt wird: Mengen beim Wiegen erfasst, Übergaben gegen die Genehmigung des Empfängers belegt, Tage geschlossen und Wochen von einer Person gezeichnet.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-compliance). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.