---
title: n8n community node
description: Автоматизирайте TracePass работни процеси в n8n без код — продукти, паспорти, EPCIS събития. Безплатен community node, инсталируем от всяка n8n инстанция.
canonical: "https://www.tracepass.eu/bg/docs/n8n"
locale: bg
source: "https://www.tracepass.eu/bg/docs/n8n"
---

# n8n community node

> Автоматизирайте TracePass работни процеси в n8n без код — продукти, паспорти, EPCIS събития. Безплатен community node, инсталируем от всяка n8n инстанция.

[n8n-nodes-tracepass](https://www.npmjs.com/package/n8n-nodes-tracepass) е n8n community node, който ви позволява да автоматизирате TracePass — продукти, цифрови продуктови паспорти, GS1 EPCIS 2.0 събития във веригата на доставки — директно от работните си процеси в n8n. Без код, декларативен routing, безплатно. Изходен код в [GitHub](https://github.com/malinoto/n8n-nodes-tracepass).

## Инсталация в n8n

Във всяка n8n инстанция (cloud или self-hosted) отворете **Settings → Community Nodes → Install** и въведете името на пакета:

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

След като се инсталира, потърсете `TracePass` в панела с nodes. Вижте [ръководството за инсталиране на community nodes](https://docs.n8n.io/integrations/community-nodes/installation/) на 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                                                                                                                                                                                      |

**Безопасност на операциите за запис.** Описанието на всяка операция назовава риска — **Create** на _Passport_ заема платен DPP слот от плана (използвайте _Confirm Overage Charge_, за да приемете таксата над включеното); **Archive** е необратимо и публичният QR код започва да връща 404 — използвайте **Suspend**, когато промяната може да се отмени. **EPCIS Capture / Query / Export** са включени във всеки платен план и се таксуват по брой събития на месец според таблицата с планове на [/pricing](https://www.tracepass.eu/pricing).

## Тригери

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