Dokumentation
Schnellstart-Anleitung
Willkommen bei ZincirX! Diese Anleitung hilft Ihnen beim Einstieg in unsere Plattform für Rückverfolgbarkeit in der Lieferkette.
Schritt 1: Konto anlegen
- Rufen Sie ZincirX auf und klicken Sie auf „Konto erstellen“
- Geben Sie Ihren Namen und Ihre E-Mail-Adresse ein
- Wählen Sie ein Passwort mit mindestens acht Zeichen, oder registrieren Sie sich stattdessen mit Ihrem Google- oder Facebook-Konto
- Akzeptieren Sie die Nutzungsbedingungen, die Verkaufs-, Liefer- und Rückerstattungsrichtlinie und die Bedingungen zur Auftragsverarbeitung und lesen Sie die Datenschutzerklärung
- Melden Sie sich mit dem soeben angelegten Konto an
Schritt 2: Einrichtung abschließen
- Geben Sie Ihre E-Mail-Adresse für Benachrichtigungen an
- Bestätigen Sie Ihre E-Mail-Adresse über den Bestätigungslink
- Geben Sie die Angaben zu Ihrem Unternehmen und Ihre Kategorie ein
- Schließen Sie die Einrichtung Ihres Unternehmensprofils ab
Schritt 3: Erste Vorlage anlegen
- Wechseln Sie in den Bereich „Vorlagen“
- Klicken Sie auf „Neue Vorlage anlegen“
- Legen Sie die Prozessschritte Ihrer Lieferkette fest
- Bestimmen Sie für jeden Schritt die Prüfanforderungen
- Speichern und aktivieren Sie Ihre Vorlage
Schritt 4: Chargen verfolgen
- Gehen Sie in den Bereich „Chargen“
- Legen Sie mit Ihrer Vorlage eine neue Charge an
- Führen Sie jeden Schritt aus, während die Produkte Ihre Lieferkette durchlaufen
- Laden Sie belegende Dokumente und Medien hoch
- Teilen Sie Prüflinks mit den Beteiligten
Grundbegriffe
Vorlagen
Vorlagen legen den Standardprozess für Ihre Lieferkette fest. Sie enthalten eine Reihe von Schritten, die Produkte durchlaufen müssen, samt den Prüfanforderungen für jeden Schritt.
- Wiederverwendbare Ablaufdefinitionen
- Anpassbare Anforderungen je Schritt
- Rollenbasierte Zugriffsrechte
- Prüfregeln und Abhängigkeiten
Chargen
Chargen stehen für bestimmte Produktionsdurchläufe oder Produktgruppen, die einer Vorlage folgen. Jede Charge hat eine eindeutige UUID für Verfolgung und Prüfung.
- Eindeutige Kennzeichnung über eine UUID
- Schrittweise Ausführung mit Datum und Uhrzeit jedes Schritts
- Medien- und Dokumentanhänge
- Öffentliche Prüfmöglichkeiten
Chargenschritte
Einzelne Schritte innerhalb der Ausführung einer Charge, jeweils mit eigenem Status, eigenen Zeitstempeln und eigenen belegenden Dokumenten.
- Statusverfolgung (ausstehend, in Bearbeitung, abgeschlossen, fehlgeschlagen)
- Zeitstempel für jede Statusänderung
- Standortdaten und GPS-Koordinaten
- Dateianhänge und Notizen
Unternehmensprofile
Mit Nutzerkonten verknüpfte Unternehmensangaben, die die Zusammenarbeit mehrerer Beteiligter und rollenbasierten Zugriff ermöglichen.
- Identifikation und Prüfung des Unternehmens
- Einordnung nach Unternehmenskategorie
- Kontaktangaben und Einstellungen
- Verwaltung von Zugriffsrechten
Nutzerrollen und Berechtigungen
| Rolle | Berechtigungen | Typischer Anwendungsfall |
|---|---|---|
| Hersteller | Vorlagen anlegen, Chargen starten, alle Schritte ausführen | Ursprungshersteller, die Produkte herstellen und verwalten |
| Händler | Bestimmte Schritte ausführen, Standorte aktualisieren, Dokumente hinzufügen | Logistik- und Vertriebsunternehmen, die Produkte befördern |
| Einzelhändler | Chargendaten einsehen, letzte Schritte ausführen, Prüfung gegenüber Kunden | Geschäfte und Verkaufsstellen, die an Endverbraucher verkaufen |
| Prüfer | Alle Daten einsehen, Zertifizierungen hinzufügen, Dokumente zur Qualitätskontrolle | Aufsichtsbehörden und Qualitätssicherungsteams |
| Verbraucher | Öffentliche Prüfung über UUID/QR-Codes | Endkunden, die den erfassten Weg eines Produkts einsehen |
API-Integration
Authentifizierung
ZincirX verwendet eine Authentifizierung per API-Token (Laravel Sanctum). So binden Sie unsere API an:
- Fordern Sie ein Token an, indem Sie Ihre E-Mail-Adresse und Ihr Passwort an /api/auth/login senden
- Senden Sie dieses Token bei jeder Anfrage als Bearer-Token im Authorization-Header
- Die öffentlichen Prüf-Endpunkte unter /api/public benötigen kein Token
Wichtige Endpunkte
Chargenvorgänge
GET /api/batchesPOST /api/batchesGET /api/batches/{id}POST /api/batches/{id}/steps/{stepId}/complete
Vorlagenverwaltung
GET /api/templatesPOST /api/templatesPUT /api/templates/{id}
Öffentliche Prüfung
GET /verify/{uuid}GET /qr/{uuid}/image
Aufzeichnungen und Prüfung
Wo Ihre Daten liegen
- Speicherung: Die eigene Datenbank von ZincirX, auf Servern, die wir betreiben
- Pass-Revisionen: Nur ergänzend — eine Änderung wird als neue Fassung erfasst, frühere bleiben erhalten
- Nachweisdateien: Jeder Upload trägt einen SHA-256-Fingerabdruck, sodass sich zeigen lässt, dass die Datei unverändert ist
- Verfügbarkeit: Ein Pass bleibt für die mit ihm verkaufte Laufzeit erreichbar, standardmäßig zehn Jahre ab dem Tag seiner Ausstellung
Prüffunktionen
Die Aufzeichnungen zur Lieferkette liegen in der eigenen Datenbank von ZincirX auf eigenen Servern. Die Plattform ist darauf ausgelegt, diese Aufzeichnungen für Dritte überprüfbar zu machen:
- Registrierung der Vorlage, einschließlich einer optionalen GTIN für das Produkt
- Aufzeichnungen über das Anlegen von Chargen und den Abschluss von Schritten, mit Zeitstempeln
- Ein SHA-256-Fingerabdruck für jede hochgeladene Datei, sodass sich zeigen lässt, dass eine Datei nicht verändert wurde
- Nur ergänzende Fassungen des Digitalen Produktpasses: Eine Änderung wird als neue Fassung erfasst, frühere Fassungen bleiben erhalten
Bewährte Vorgehensweisen
Sicherheit
- Verwenden Sie für Ihr ZincirX-Konto ein starkes, einmaliges Passwort und geben Sie Ihre Anmeldedaten niemals weiter
- Prüfen Sie regelmäßig die Mitglieder Ihres Unternehmens und entziehen Sie nicht mehr benötigte Zugriffsrechte
- Prüfen Sie die Angaben zu einem Schritt und die angehängten Dateien, bevor Sie ihn als abgeschlossen markieren
- Verwenden Sie starke Passwörter für das E-Mail-Konto Ihres Unternehmens
Datenverwaltung
- Machen Sie für jeden Schritt genaue und vollständige Angaben
- Laden Sie klare, aussagekräftige Mediendateien für die Prüfung hoch
- Verwenden Sie einheitliche Namenskonventionen für Chargen und Vorlagen
- Prüfen und aktualisieren Sie Ihr Unternehmensprofil regelmäßig
Zusammenarbeit
- Teilen Sie den Zugriff auf Chargen mit den beteiligten Partnern in der Lieferkette
- Kommunizieren Sie die Anforderungen an jeden Schritt klar an alle Beteiligten
- Nutzen Sie QR-Codes, damit Endkunden einfach prüfen können
- Pflegen Sie den regelmäßigen Austausch mit Ihrem Netzwerk in der Lieferkette
Fehlerbehebung
Probleme bei der Anmeldung
- Prüfen Sie, ob Sie Ihre E-Mail-Adresse und Ihr Passwort korrekt eingegeben haben
- Wenn Sie sich mit Google oder Facebook registriert haben, melden Sie sich mit demselben Anbieter an
- Leeren Sie Cache und Cookies des Browsers
- Nutzen Sie den Link zum Zurücksetzen des Passworts auf der Anmeldeseite, wenn Sie Ihr Passwort nicht mehr wissen
Fehler bei Chargen und Uploads
- Prüfen Sie, ob vorab bezahlte Produktpässe (UUIDs) verfügbar sind, bevor Sie eine Charge anlegen
- Stellen Sie sicher, dass die Netzverbindung stabil ist
- Warten Sie, bis ein vorheriger Upload abgeschlossen ist, bevor Sie einen weiteren starten
- Prüfen Sie, ob jede hochgeladene Datei die im Upload-Formular angegebene Größenbeschränkung einhält
Leistungsprobleme
- Verwenden Sie aktuelle Browser (Chrome, Firefox, Safari)
- Schließen Sie nicht benötigte Browser-Tabs und Anwendungen
- Prüfen Sie die Geschwindigkeit Ihrer Internetverbindung
- Löschen Sie die Browserdaten und starten Sie den Browser bei Bedarf neu
Support und Ressourcen
Community-Support
Tauschen Sie sich mit anderen ZincirX-Nutzern aus und erhalten Sie Unterstützung aus der Community zu Ihren Fragen und Herausforderungen.
- Nutzerforen und Diskussionen
- Austausch bewährter Vorgehensweisen
- Funktionswünsche und Rückmeldungen
Technischer Support
Erhalten Sie direkte Unterstützung von unserem technischen Team bei Fragen zur Integration und zur Plattform.
- Unterstützung bei der API-Integration
- Beratung zum Digitalen Produktpass und zu GS1 Digital Link
- Beratung zu individuellen Lösungen