n8n-nodes-tracepass е n8n community node, който ви позволява да автоматизирате TracePass — продукти, цифрови продуктови паспорти, GS1 EPCIS 2.0 събития във веригата на доставки — директно от работните си процеси в n8n. Без код, декларативен routing, безплатно. Изходен код в GitHub.
Инсталация в n8n
Във всяка n8n инстанция (cloud или self-hosted) отворете Settings → Community Nodes → Install и въведете името на пакета:
n8n-nodes-tracepassСлед като се инсталира, потърсете TracePass в панела с nodes. Вижте ръководството за инсталиране на community 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 · 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 |
Тригери
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 на извикване), вместо да създавате по един за всеки ред. Проследяване на доставчици. Schedule trigger извежда заявки към доставчици на повече от седем дни и изпраща напомняния.
- Shopify → TracePass
- Daily analytics digest → Slack
- CSV import → batch passports
- Supplier follow-up reminders