n8n-nodes-bricklink-sales

Ein n8n Community Node für die BrickLink API.

Funktionen

Order (Bestellungen)

• Get Many – Liste aller Bestellungen abrufen (filterbar nach Richtung, Status, archiviert)
• Get – Eine einzelne Bestellung abrufen
• Update – Bestellstatus, Tracking-Nr., Anmerkungen etc. aktualisieren

Order Item (Bestellpositionen)

• Get Many – Alle Artikel einer Bestellung abrufen

Inventory (Inventar)

• Get Many – Gesamtes Shop-Inventar abrufen (filterbar nach Typ und Status)
• Get – Einen einzelnen Inventar-Eintrag abrufen
• Update – Menge, Preis, Beschreibung etc. aktualisieren

Catalog Item (Katalog)

• Get – Katalog-Informationen zu einem Artikel abrufen
• Get Price Guide – Preisführer (verkauft/gelistet, nach Region, Währung)
• Get Known Colors – Verfügbare Farben eines Teils

Installation

Option 1: Über die n8n Oberfläche (empfohlen)

1. Öffne n8n im Browser
2. Gehe zu Settings → Community Nodes
3. Klicke auf Install a community node
4. Gib ein: n8n-nodes-bricklink-sales
5. Bestätige die Installation
6. Fertig – der Node ist sofort verfügbar!

Option 2: Manuell auf dem Server

Schritt 1: Node auf dem n8n Server bauen

Kopiere den gesamten n8n-nodes-bricklink-sales-Ordner auf deinen Server (z.B. per SCP/SFTP), dann:

cd n8n-nodes-bricklink-sales
npm install
npm run build

Schritt 2: Node in n8n installieren

Es gibt zwei Möglichkeiten:

Option A – npm link (empfohlen für Entwicklung):

cd n8n-nodes-bricklink-sales
npm link

# Dann im n8n-Installationsverzeichnis:
cd /pfad/zu/n8n
npm link n8n-nodes-bricklink-sales

Option B – In den custom extensions Ordner kopieren:

# Das n8n-Datenverzeichnis finden (oft ~/.n8n):
cp -r n8n-nodes-bricklink-sales ~/.n8n/custom/node_modules/n8n-nodes-bricklink-sales

Falls der Ordner ~/.n8n/custom/node_modules/ nicht existiert, erstelle ihn vorher:

mkdir -p ~/.n8n/custom/node_modules

Schritt 3: n8n neu starten

# Je nach Installation:
systemctl restart n8n
# oder
pm2 restart n8n
# oder n8n manuell neu starten

Einrichtung in n8n

1. Öffne n8n im Browser
2. Gehe zu Settings → Credentials → Add Credential
3. Suche nach BrickLink API
4. Trage deine vier API-Schlüssel ein:
   • Consumer Key
   • Consumer Secret
   • Token Value
   • Token Secret

Die API-Schlüssel bekommst du auf BrickLink unter:
My BrickLink → API → Register a new consumer

Wichtig: Token Value und Token Secret sind an deine IP-Adresse gebunden.
Verwende die IP deines n8n-Servers!

Verwendung

Nach der Installation findest du den BrickLink-Node in der Node-Palette.
Ziehe ihn in deinen Workflow und wähle Resource + Operation aus.

Beispiel: Alle offenen Bestellungen abrufen

1. Manual Trigger → BrickLink
2. Resource: Order
3. Operation: Get Many
4. Direction: Eingehend (Verkäufe)
5. Status: Paid (oder leer für alle)

Beispiel: Preis eines Sets abfragen

1. Manual Trigger → BrickLink
2. Resource: Catalog Item
3. Operation: Get Price Guide
4. Item Type: Set
5. Item Number: 10252
6. Price Guide Options → New or Used: New, Guide Type: Sold

Projektstruktur

n8n-nodes-bricklink-sales/
├── package.json
├── tsconfig.json
├── gulpfile.js
├── README.md
└── src/
    ├── credentials/
    │   └── BrickLinkApi.credentials.ts
    ├── nodes/
    │   └── BrickLink/
    │       ├── BrickLink.node.ts
    │       └── bricklink.svg
    └── utils/
        └── oauth1.ts