TracePass
Reference

n8n community node

Automate TracePass in n8n without code — products, passports, EPCIS events. Free community node for self-hosted n8n (on n8n Cloud: Enterprise only).

n8n-nodes-tracepass is an n8n community node that lets you automate TracePass — products, Digital Product Passports, GS1 EPCIS 2.0 supply-chain events — directly from your n8n workflows. No code, declarative routing, free. Source on GitHub.

Install in n8n

In any self-hosted n8n instance, or n8n Cloud on Enterprise, open Settings → Community Nodes → Install and enter the package name:

text
n8n-nodes-tracepass

Once installed, search for TracePass in the node panel. See n8n's community-nodes installation guide for full instructions.

Credential

Create a TracePass API credential and paste a tp_ API key (mint one in the TracePass dashboard under Developer → API Keys). The Base URL defaults to https://app.tracepass.eu — change it only for a self-hosted or staging deployment. n8n's Test button verifies the key against a cheap read endpoint.

Resources & operations

Four resources mirror the v1 REST API. Each operation maps to one HTTP call (declarative routing), so the node carries zero runtime dependencies beyond what n8n provides.

ResourceOperations
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 has a Source option. Leave it at Manual for values from your own systems, such as an ERP or PIM; they are written with your credential's rights. Choose AI Suggested when an AI step earlier in the workflow produced the value: it lands in the dashboard review queue for a person to approve, and fields that only the economic operator may state, or that must be measured, refuse it. Every change is recorded in the passport's history with the credential and the channel (n8n).

Triggers

TracePass also dispatches HMAC-signed webhooks for lifecycle events (passport.published, extraction.completed, supplier.submitted, epcis.event.captured, etc.). To use them as n8n triggers, configure a webhook subscription in the TracePass dashboard (Developer → Webhooks) pointing at an n8n Webhook trigger node — n8n's built-in node is all you need; no separate TracePass trigger node is required.

Example workflows

Shopify → TracePass. On a new Shopify order, create a passport (product mapped by SKU, serial = order id), then email the QR code to the customer. Daily digest. A Schedule trigger lists yesterday's passports and posts a summary to Slack. CSV → passports. Read a CSV or Excel sheet of serial numbers and create them with one Create Batch call (up to 100 per call) instead of looping a create per row. Supplier follow-up. A Schedule trigger lists supplier requests older than seven days and sends reminders.

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