n8n-nodes-tracepass е n8n community node, който ви позволява да автоматизирате TracePass — продукти, цифрови продуктови паспорти, GS1 EPCIS 2.0 събития във веригата на доставки — директно от работните си процеси в n8n. Без код, декларативен routing, безплатно. Изходен код в GitHub.
Инсталация в n8n
Във всяка self-hosted n8n инстанция или n8n Cloud на Enterprise отворете Settings → Community Nodes → Install и въведете името на пакета:
n8n-nodes-tracepassСлед като се инсталира, потърсете TracePass в панела с nodes. Вижте ръководството за инсталиране на community nodes на n8n за пълни инструкции.
Удостоверяване
Създайте credential от тип TracePass API и поставете API ключ tp_ (генерирайте в таблото на TracePass от Developer → API Keys). За OAuth връзки, авторизирани от потребители, използвайте вместо това credential тип TracePass OAuth2 API. Бутонът Test на n8n проверява ключа спрямо евтин read endpoint.
Ресурси и операции
Пет ресурса повтарят v1 REST API. Всяка операция се свежда до едно HTTP извикване (декларативен routing), така че node-ът няма runtime зависимости извън тези, които n8n вече предоставя.
| Ресурс | Операции |
|---|---|
| Product | Create · Get · Get Many · Update |
| Passport | Archive · 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 Event | Capture · Export · Export by Serial · Get Capture Job · Query |
| Template | Get · Get Many |
| Scope | Check · Get Catalogue Report |
Update Field има опция Source. Оставете я на Manual за стойности от вашите собствени системи, например ERP или PIM; те се записват с правата на вашите идентификационни данни. Изберете AI Suggested, когато стойността е създадена от AI стъпка по-рано в работния поток: тя попада в опашката за преглед в таблото, докато човек я одобри, а полета, които може да декларира само икономическият оператор или които трябва да бъдат измерени, я отказват. Всяка промяна се записва в историята на паспорта с идентификационните данни и канала (n8n).
Тригери
TracePass изпраща и HMAC-подписани webhooks за събития от жизнения цикъл (passport.published, extraction.completed, supplier.submitted, epcis.event.captured и др.). За да ги използвате като тригери в n8n, конфигурирайте webhook абонамент в таблото на TracePass (Developer → Webhooks), сочещ към node Webhook на n8n — вграденият node на n8n е достатъчен; не е нужен отделен TracePass trigger node.
Примерни работни процеси
Shopify → TracePass. При нова поръчка в Shopify създавате паспорт (продуктът е намерен по SKU, серийният номер е id на поръчката), след което изпращате QR кода на клиента по e-mail. Дневен дайджест. Schedule trigger извежда вчерашните паспорти и публикува резюме в Slack. CSV → паспорти. Прочитате CSV или Excel със серийни номера и ги създавате с едно извикване на Create Batch (до 100 на извикване), вместо да създавате по един за всеки ред.
- Shopify → TracePass
- Daily analytics digest → Slack
- CSV import → batch passports
- Supplier follow-up reminders