TracePass
Referenz

n8n community node

TracePass in n8n ohne Code automatisieren — Produkte, Pässe, EPCIS-Ereignisse. Kostenloser community node für selbst gehostetes n8n (n8n Cloud: nur Enterprise).

n8n-nodes-tracepass ist ein n8n community node, der es erlaubt, TracePass — Produkte, Digitale Produktpässe, GS1-EPCIS-2.0-Lieferketten-Ereignisse — direkt aus n8n-Workflows zu automatisieren. Ohne Code, deklaratives Routing, kostenlos. Quellcode auf GitHub.

In n8n installieren

In jeder self-hosted n8n-Instanz oder n8n Cloud auf Enterprise Settings → Community Nodes → Install öffnen und den Paketnamen eingeben:

text
n8n-nodes-tracepass

Nach der Installation suchen Sie im Node-Panel nach TracePass. Siehe n8n's Installationsanleitung für community nodes für vollständige Hinweise.

Anmeldedaten

Eine TracePass API-Credential anlegen und einen tp_-API-Schlüssel einfügen (im TracePass-Dashboard unter Developer → API Keys erzeugen). Die Base URL ist standardmäßig https://app.tracepass.eu — nur für Self-Hosted- oder Staging-Deployments ändern. Mit n8n's Schaltfläche Test wird der Schlüssel gegen einen günstigen Read-Endpoint geprüft.

Ressourcen & Operationen

Vier Ressourcen spiegeln die v1-REST-API. Jede Operation entspricht einem HTTP-Call (deklaratives routing), sodass der Node keine Laufzeit-Abhängigkeiten über die hinaus mitbringt, die n8n bereitstellt.

RessourceOperationen
ProductCreate · Get · Get Many · Update
PassportArchive · Archive by Serial · Capture Measurements · Capture Measurements by Serial · Compliance · Create · Create Batch · Get · Get by Serial · Get Condition Flags · Get Condition Flags by Serial · Get Latest Measurements · Get Many · Get Measurements · Get QR · Get QR by Serial · Get Snapshot · Get Snapshots · Registry Readiness · Set Condition Flags · Set Condition Flags by Serial · Suspend · Suspend by Serial · Update Field · Update Field by Serial
EPCIS EventCapture · Export · Export by Serial · Get Capture Job · Query
TemplateGet · Get Many

Update Field hat eine Option Source. Lassen Sie sie für Werte aus Ihren eigenen Systemen, etwa ERP oder PIM, auf Manual; sie werden mit den Rechten Ihrer Zugangsdaten geschrieben. Wählen Sie AI Suggested, wenn ein KI-Schritt weiter vorne im Workflow den Wert erzeugt hat: Er landet in der Prüf-Queue des Dashboards, bis ein Mensch ihn freigibt, und Felder, die nur der Wirtschaftsakteur erklären darf oder die gemessen werden müssen, lehnen ihn ab. Jede Änderung wird mit Zugangsdaten und Kanal (n8n) in der Historie des Passes festgehalten.

Trigger

TracePass sendet außerdem HMAC-signierte Webhooks für Lebenszyklus-Ereignisse (passport.published, extraction.completed, supplier.submitted, epcis.event.captured u. a.). Um sie als n8n-Trigger zu nutzen, konfigurieren Sie ein Webhook-Abonnement im TracePass-Dashboard (Developer → Webhooks), das auf einen Webhook-Trigger-Node von n8n zeigt — n8n's eingebauter Node genügt; ein separater TracePass-Trigger-Node ist nicht nötig.

Beispiel-Workflows

Shopify → TracePass. Bei einer neuen Shopify-Bestellung einen Pass erstellen (Produkt per SKU zugeordnet, Seriennummer = Order-ID) und den QR-Code per E-Mail an den Kunden senden. Tägliches Digest. Ein Schedule-Trigger listet die Pässe von gestern und postet eine Zusammenfassung in Slack. CSV → Pässe. Eine CSV oder Excel mit Seriennummern einlesen und alle mit einem Create Batch-Aufruf erstellen (bis zu 100 pro Aufruf), statt je Zeile einen Create-Aufruf zu schleifen. Lieferanten-Nachfassung. Ein Schedule-Trigger listet Lieferantenanfragen, die älter als sieben Tage sind, und sendet Erinnerungen.

  • Shopify → TracePass
  • Daily analytics digest → Slack
  • CSV import → batch passports
  • Supplier follow-up reminders