n8n-nodes-tracepass è un nodo community per n8n che vi consente di automatizzare TracePass — prodotti, passaporti digitali di prodotto, eventi GS1 EPCIS 2.0 della catena di approvvigionamento — direttamente dai vostri flussi n8n. Senza codice, routing dichiarativo, gratuito. Codice sorgente su GitHub.
Installare in n8n
In qualsiasi istanza n8n (cloud o self-hosted), aprite Settings → Community Nodes → Install e inserite il nome del pacchetto:
n8n-nodes-tracepassUna volta installato, cercate TracePass nel pannello dei nodi. Consultate la guida all'installazione dei nodi community di n8n per le istruzioni complete.
Credenziale
Create una credenziale TracePass API e incollate una chiave API tp_ (generatela nella dashboard TracePass in Developer → API Keys). La Base URL è impostata su https://app.tracepass.eu — modificatela solo per un deployment self-hosted o di staging. Il pulsante Test di n8n verifica la chiave su un endpoint di lettura leggero.
Risorse e operazioni
Tre risorse rispecchiano l'API REST v1. Ogni operazione corrisponde a una chiamata HTTP (routing dichiarativo), quindi il nodo non porta dipendenze a runtime oltre a quelle che n8n già fornisce.
| Risorsa | Operazioni |
|---|---|
| Product | Create · Get · Get Many · Update |
| Passport | Archive · Create · Get · Get by Serial · Get Many · Suspend · Update Field |
| EPCIS Event | Capture · Export · Get Capture Job · Query |
Trigger
TracePass invia inoltre webhook firmati HMAC per gli eventi del ciclo di vita (passport.published, extraction.completed, supplier.submitted, epcis.event.captured ecc.). Per usarli come trigger in n8n, configurate una sottoscrizione webhook nella dashboard TracePass (Developer → Webhooks) puntando a un nodo trigger Webhook di n8n — il nodo integrato di n8n è sufficiente; non serve un nodo trigger TracePass separato.
Flussi di esempio
Shopify → TracePass. A ogni nuovo ordine Shopify, create un passaporto (prodotto mappato via SKU, numero di serie = id ordine), quindi inviate il codice QR al cliente via e-mail. Digest quotidiano. Un trigger Schedule elenca i passaporti di ieri e pubblica un riepilogo in Slack. CSV → passaporti. Leggete un CSV di numeri di serie e create un passaporto per riga. Sollecito fornitori. Un trigger Schedule elenca le richieste a fornitori più vecchie di sette giorni e invia promemoria.
- Shopify → TracePass
- Daily analytics digest → Slack
- CSV import → batch passports
- Supplier follow-up reminders