Flux de matières, remises et un journal d’exploitation qui se clôt

Les quantités d’une journée figurent sur un papier près de la bascule, les remises dans des courriels, et le journal naît de l’ensemble la veille du contrôle. Cela fonctionne tant que personne ne demande d’où vient un chiffre — et cela échoue exactement une fois.

Le contrat exige donc clôture quotidienne et validation hebdomadaire par une personne connectée au rôle de journal ; tapinoma ne signe pas en son nom propre. Les événements portent hash et previousHash : cela ne rend pas une lacune impossible, mais la rend visible — et c’est bien le but.

Ce que ce cas suppose

• Des masses mesurées, non estimées. La masse s’indique avec l’unité kg ou t.
• Un code matière par mouvement. Sans lui, une quantité est un nombre sans objet.
• L’autorisation du destinataire. Une remise renvoie à un instantané d’autorisation ; sans elle, le destinataire n’est pas justifié.
• Une personne habilitée à signer la semaine. La validation est imputable et non un traitement en lot.

Le déroulement

Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.

Pourquoi chaque étape est nécessaire

1. Enregistrer le mouvement. POST /compliance/material-movements prend facilityId, movementType, materialCode, mass et unit, ainsi que lieux d’origine et de destination et l’instant de mesure measuredAt. L’enregistrement a lieu à la pesée, non au moment du rapport — seule différence qui décide de la fiabilité.
2. Justifier la remise. POST /compliance/downstream-transfers renvoie aux assetRefs remis, à l’organisation et à l’installation destinataires, à leur instantané d’autorisation dans permitSnapshotId et au transport, et exige au moins une indication dans masses. L’instantané d’autorisation est l’essentiel : il consigne sur quelle habilitation du destinataire la remise reposait.
3. Clôturer la journée. POST /compliance/journal-periods/{date}/close-daily prend facilityId, timeZone, closedAt et une attestationId. La clôture est imputée à la personne connectée et à son rôle de journal ; elle reconfirme son authentification pour cela, et tapinoma ne signe pas en son nom propre.
4. Valider la semaine. POST /compliance/journal-periods/{week}/sign-off-weekly renvoie aux clôtures quotidiennes de la semaine et porte une attestation. La validation revient à une personne.
5. Extraire le dossier d’audit. GET /compliance/audit-exports/{case_or_period} restitue les événements avec leurs empreintes — pour un dossier ou une période. C’est là qu’une lacune apparaît, et elle vous apparaît avant d’apparaître au contrôleur.

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'

Ce que l’on obtient

Il reste une période qui résiste au contrôle, car elle n’est pas racontée après coup : quantités saisies à la pesée, remises justifiées contre l’autorisation du destinataire, journées closes et semaines signées par une personne.

Où cela figure dans la documentation

Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-compliance). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.