n8n-nodes-tracepass è un n8n community node 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 community node 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
Quattro 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 · Archive by Serial · Compliance · Create · Create Batch · Get · Get by Serial · Get Many · Get QR · Get QR by Serial · Suspend · Suspend by Serial · Update Field · Update Field by Serial |
| EPCIS Event | Capture · Export · Export by Serial · Get Capture Job · Query |
| Template | Get · Get Many |
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 o Excel di numeri di serie e create tutti con una sola chiamata Create Batch (fino a 100 per chiamata) invece di ripetere una create 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