n8n-nodes-picnic

n8n Community Node, die das npm Paket picnic-api wrapped.

Features

• Produktsuche bei Picnic
• Warenkorb lesen, Artikel hinzufügen, Warenkorb leeren
• Lieferungen abrufen
• Nutzerdetails abrufen

Voraussetzungen

• Node.js >= 18.17
• npm Account + npm Access Token
• GitHub Repository

Lokale Entwicklung

npm install
npm test
npm run build

In n8n installieren (lokal)

npm install n8n-nodes-picnic

Danach n8n neu starten.

Nutzung mit n8n AI Agents

Der Node ist als Tool freigegeben (usableAsTool) und kann in AI-Agent-Workflows als Tool verwendet werden.

Beispiel-Setup:

1. AI Agent Node erstellen.
2. Picnic Node hinzufügen und Credentials setzen.
3. Im Picnic Node die gewünschte Operation wählen (z. B. Search Products).
4. Picnic als Tool mit dem Agent verbinden.

Der Agent kann dann den Picnic-Node als Tool aufrufen und das Ergebnis als JSON weiterverarbeiten.

GitHub Setup

1. Repository nach GitHub pushen.
2. In GitHub unter Settings -> Secrets and variables -> Actions folgendes Secret anlegen:
   • NPM_TOKEN (Classic npm token mit Publish-Recht)
3. In package.json diese Felder anpassen:
   • homepage
   • repository.url
   • bugs.url
   • optional author

Release nach npm

Dieser Repo enthält .github/workflows/publish.yml.

• Trigger: GitHub Release wird auf published gesetzt.
• Workflow baut das Paket und führt npm publish --access public aus.

Empfohlener Ablauf:

1. Version in package.json erhöhen (z. B. 0.1.1).
2. Commit + Tag erstellen.
3. GitHub Release zum Tag veröffentlichen.
4. GitHub Action published das Paket auf npm.

n8n Credentials

Credential-Typ Picnic API unterstützt:

• authKey (optional, bevorzugt)
• oder Email + password
• countryCode (NL, DE, FR)
• apiVersion (Default 15)

Hinweise

• Die konkrete Verfügbarkeit von Picnic-API-Funktionen kann sich ändern.
• Falls Methoden im picnic-api Paket abweichen, passe src/nodes/Picnic/Picnic.node.ts entsprechend an.
• Wenn authKey nicht manuell gesetzt ist, cached der Node den Login-Token im Prozessspeicher (Standard TTL: 6h), damit nicht jeder Aufruf login() ausführt.
• Optional kann die TTL über PICNIC_AUTH_CACHE_TTL_MS gesetzt werden.