---
title: n8n community node
description: Automatizzate TracePass in n8n senza codice — prodotti, passaporti, eventi EPCIS. community node gratuito, installabile da ogni istanza n8n.
canonical: "https://www.tracepass.eu/it/docs/n8n"
locale: it
source: "https://www.tracepass.eu/it/docs/n8n"
---

# n8n community node

> Automatizzate TracePass in n8n senza codice — prodotti, passaporti, eventi EPCIS. community node gratuito, installabile da ogni istanza n8n.

[n8n-nodes-tracepass](https://www.npmjs.com/package/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](https://github.com/malinoto/n8n-nodes-tracepass).

## Installare in n8n

In qualsiasi istanza n8n (cloud o self-hosted), aprite **Settings → Community Nodes → Install** e inserite il nome del pacchetto:

```text
n8n-nodes-tracepass
```

Una volta installato, cercate `TracePass` nel pannello dei nodi. Consultate la [guida all'installazione dei community node](https://docs.n8n.io/integrations/community-nodes/installation/) 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                                                                                                                                                                                      |

**Sicurezza delle azioni di scrittura.** La descrizione di ogni operazione segnala il rischio — **Create** su _Passport_ consuma uno slot DPP a pagamento del piano (usate _Confirm Overage Charge_ per accettare il costo per passaporto in eccedenza); **Archive** è irreversibile e il QR pubblico restituisce permanentemente 404 — usate **Suspend** se una modifica potrebbe essere annullata. **EPCIS Capture / Query / Export** sono inclusi in ogni piano a pagamento e tariffati per numero di eventi al mese secondo la tabella dei piani su [/pricing](https://www.tracepass.eu/pricing).

## 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