ZincirX ZincirX

Documentatie

Snelstartgids

Welkom bij ZincirX! Met deze gids gaat u aan de slag met ons platform voor traceerbaarheid in de toeleveringsketen.

Stap 1: Maak uw account aan

  1. Ga naar ZincirX en klik op "Registreren"
  2. Voer uw naam en e-mailadres in
  3. Kies een wachtwoord van ten minste acht tekens, of registreer u in plaats daarvan met uw Google- of Facebook-account
  4. Aanvaard de Gebruiksvoorwaarden, het Verkoop-, leverings- en terugbetalingsbeleid en de Verwerkingsvoorwaarden, en lees de Privacyverklaring
  5. Log in met het account dat u zojuist hebt aangemaakt

Stap 2: Voltooi de onboarding

  1. Geef uw e-mailadres op voor meldingen
  2. Verifieer uw e-mailadres via de bevestigingslink
  3. Voer de gegevens en de categorie van uw bedrijf in
  4. Voltooi het instellen van uw bedrijfsprofiel

Stap 3: Maak uw eerste sjabloon

  1. Ga naar het onderdeel Sjablonen
  2. Klik op "Nieuw sjabloon maken"
  3. Definieer de processtappen van uw toeleveringsketen
  4. Stel voor elke stap validatievereisten in
  5. Sla uw sjabloon op en activeer het

Stap 4: Begin met het volgen van partijen

  1. Ga naar het onderdeel Partijen
  2. Maak een nieuwe partij aan met uw sjabloon
  3. Voer elke stap uit terwijl de producten door uw toeleveringsketen gaan
  4. Upload ondersteunende documentatie en media
  5. Deel verificatielinks met belanghebbenden

Kernbegrippen

Sjablonen

Sjablonen definiëren het standaardproces voor uw toeleveringsketen. Ze bevatten een reeks stappen die producten moeten doorlopen, samen met validatievereisten voor elke stap.

  • Herbruikbare workflowdefinities
  • Aanpasbare vereisten per stap
  • Op rollen gebaseerde toegangscontrole
  • Validatieregels en afhankelijkheden

Partijen

Partijen vertegenwoordigen specifieke productieruns of groepen producten die een sjabloon volgen. Elke partij heeft een unieke UUID voor tracering en verificatie.

  • Unieke identificatie via UUID
  • Uitvoering stap voor stap, met de datum en tijd van elke stap
  • Media en documenten als bijlage
  • Mogelijkheden voor openbare verificatie

Partijstappen

Afzonderlijke stappen binnen de uitvoering van een partij, elk met een eigen status, tijdstempels en ondersteunende documentatie.

  • Statusbewaking (pending, in_progress, completed, failed)
  • Vastlegging van een tijdstempel bij elke statuswijziging
  • Locatiegegevens en gps-coördinaten
  • Bijgevoegde bestanden en notities

Bedrijfsprofielen

Bedrijfsgegevens gekoppeld aan gebruikersaccounts, die samenwerking tussen meerdere organisaties en op rollen gebaseerde toegang mogelijk maken.

  • Identificatie en verificatie van bedrijven
  • Indeling in bedrijfscategorieën
  • Contactgegevens en voorkeuren
  • Beheer van toegangsrechten

Gebruikersrollen en rechten

Rol Rechten Typisch gebruik
Fabrikant Sjablonen maken, partijen starten, alle stappen uitvoeren Oorspronkelijke producenten die producten maken en beheren
Distributeur Specifieke stappen uitvoeren, locaties bijwerken, documentatie toevoegen Logistieke en distributiebedrijven die producten behandelen
Detailhandelaar Partijgegevens bekijken, laatste stappen uitvoeren, verificatie voor klanten Winkels en verkooppunten die aan eindconsumenten verkopen
Inspecteur Alle gegevens bekijken, certificeringen toevoegen, documentatie van kwaliteitscontroles Regelgevende instanties en kwaliteitsborgingsteams
Consument Openbare verificatie via UUID/QR-codes Eindklanten die het vastgelegde traject van een product bekijken

API-integratie

Authenticatie

ZincirX gebruikt authenticatie met API-tokens (Laravel Sanctum). Zo integreert u met onze API:

  1. Vraag een token aan door uw e-mailadres en wachtwoord te posten naar /api/auth/login
  2. Stuur dat token als bearer-token mee in de Authorization-header van elk verzoek
  3. Openbare verificatie-endpoints onder /api/public vereisen geen token

Belangrijkste endpoints

Partijbewerkingen

  • GET /api/batches
  • POST /api/batches
  • GET /api/batches/{id}
  • POST /api/batches/{id}/steps/{stepId}/complete

Sjabloonbeheer

  • GET /api/templates
  • POST /api/templates
  • PUT /api/templates/{id}

Openbare verificatie

  • GET /verify/{uuid}
  • GET /qr/{uuid}/image

Registraties en verificatie

Waar uw gegevens worden bewaard

  • Opslag: De eigen database van ZincirX, op servers die wij beheren
  • Paspoortrevisies: Alleen toevoegen — een wijziging wordt vastgelegd als een nieuwe revisie en eerdere revisies blijven bewaard
  • Bewijsbestanden: Elke upload krijgt een SHA-256-vingerafdruk, zodat kan worden aangetoond dat een bestand niet is gewijzigd
  • Beschikbaarheid: Een paspoort blijft bereikbaar gedurende de termijn die ermee is verkocht, standaard tien jaar, gerekend vanaf de dag van uitgifte

Verificatiefuncties

Registraties in de toeleveringsketen worden bewaard in de eigen database van ZincirX, op zijn eigen servers. Het platform is erop gebouwd om die registraties verifieerbaar te maken voor derden:

  • Registratie van sjablonen, inclusief een optionele GTIN voor het product
  • Registraties van het aanmaken van partijen en het voltooien van stappen, met tijdstempels
  • Een SHA-256-vingerafdruk voor elk geüpload bestand, zodat kan worden aangetoond dat een bestand niet is gewijzigd
  • Revisies van het digitale productpaspoort die alleen worden toegevoegd: een wijziging wordt vastgelegd als een nieuwe revisie en eerdere revisies blijven bewaard

Aanbevolen werkwijzen

Beveiliging

  • Gebruik een sterk, uniek wachtwoord voor uw ZincirX-account en deel uw inloggegevens nooit
  • Controleer regelmatig de leden van uw bedrijf en trek toegang in die niet meer nodig is
  • Controleer de gegevens van een stap en de bijgevoegde bestanden voordat u de stap als voltooid markeert
  • Gebruik sterke wachtwoorden voor het e-mailaccount van uw bedrijf

Gegevensbeheer

  • Verstrek voor elke stap juiste en volledige informatie
  • Upload duidelijke, relevante mediabestanden voor verificatie
  • Gebruik consistente naamgevingsconventies voor partijen en sjablonen
  • Controleer en actualiseer uw bedrijfsprofiel regelmatig

Samenwerking

  • Deel de toegang tot partijen met relevante partners in de toeleveringsketen
  • Communiceer de vereisten van stappen duidelijk aan alle deelnemers
  • Gebruik QR-codes voor eenvoudige verificatie door eindklanten
  • Onderhoud regelmatig contact met uw netwerk in de toeleveringsketen

Probleemoplossing

Problemen met inloggen

  • Controleer of uw e-mailadres en wachtwoord correct zijn ingevoerd
  • Als u zich hebt geregistreerd met Google of Facebook, log dan in via dezelfde aanbieder
  • Wis de cache en cookies van uw browser
  • Gebruik de link voor het opnieuw instellen van uw wachtwoord op de inlogpagina als u uw wachtwoord niet meer weet

Mislukte partijen en uploads

  • Controleer of u vooraf betaalde paspoorten (UUID’s) beschikbaar hebt voordat u een partij aanmaakt
  • Zorg voor een stabiele netwerkverbinding
  • Wacht tot een eerdere upload is voltooid voordat u een nieuwe start
  • Controleer of elk geüpload bestand binnen de maximale grootte valt die op het uploadformulier wordt vermeld

Prestatieproblemen

  • Gebruik moderne browsers (Chrome, Firefox, Safari)
  • Sluit onnodige browsertabbladen en applicaties
  • Controleer de snelheid van uw internetverbinding
  • Wis browsergegevens en start zo nodig opnieuw op

Ondersteuning en bronnen

Ondersteuning door de community

Kom in contact met andere gebruikers van ZincirX en krijg ondersteuning vanuit de community bij uw vragen en uitdagingen.

  • Gebruikersforums en discussies
  • Uitwisseling van aanbevolen werkwijzen
  • Functieverzoeken en feedback

Technische ondersteuning

Krijg rechtstreeks hulp van ons technische team bij integratie en platformspecifieke problemen.

  • Ondersteuning bij API-integratie
  • Begeleiding bij het digitale productpaspoort en GS1 Digital Link
  • Advies over maatwerkoplossingen
Nu aan de slag