n8n-nodes-tracepass е общностен node за n8n, който ви позволява да автоматизирате TracePass — продукти, цифрови продуктови паспорти, GS1 EPCIS 2.0 събития във веригата на доставки — директно от работните си процеси в n8n. Без код, декларативен routing, безплатно. Изходен код в GitHub.
Инсталация в n8n
Във всяка n8n инстанция (cloud или self-hosted) отворете Settings → Community Nodes → Install и въведете името на пакета:
n8n-nodes-tracepassСлед като се инсталира, потърсете TracePass в панела с nodes. Вижте ръководството за инсталиране на общностни nodes на n8n за пълни инструкции.
Удостоверяване
Създайте credential от тип TracePass API и поставете API ключ tp_ (генерирайте в таблото на TracePass от Developer → API Keys). Base URL по подразбиране е https://app.tracepass.eu — променете го само за self-hosted или staging внедряване. Бутонът Test на n8n проверява ключа спрямо евтин read endpoint.
Ресурси и операции
Три ресурса повтарят v1 REST API. Всяка операция се свежда до едно HTTP извикване (декларативен routing), така че node-ът няма runtime зависимости извън тези, които n8n вече предоставя.
| Ресурс | Операции |
|---|---|
| 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 |
Тригери
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 със серийни номера и създавате по един паспорт за всеки ред. Проследяване на доставчици. Schedule trigger извежда заявки към доставчици на повече от седем дни и изпраща напомняния.
- Shopify → TracePass
- Daily analytics digest → Slack
- CSV import → batch passports
- Supplier follow-up reminders