JTL FFN — n8n Community Node

n8n-Community-Node für die JTL Fulfillment Network REST API.

Paket: @t4dt/n8n-nodes-jtl-ffn

Installation

In n8n unter Settings → Community Nodes das Paket @t4dt/n8n-nodes-jtl-ffn installieren (oder lokal linken).

Credentials (OAuth2)

Die FFN-API unterstützt nur OAuth2 Authorization Code (kein Client Credentials).

1. OAuth-Client im JTL Kundencenter anlegen
2. Redirect-URI der n8n-Instanz hinterlegen (OAuth-Callback der Credentials)
3. Scopes je nach Rolle, z. B.:
   • ffn.merchant.read / ffn.merchant.write
   • ffn.fulfiller.read / ffn.fulfiller.write
4. In n8n Credential JTL FFN OAuth2 API verbinden
5. API Base URL
   • Produktion: https://ffn2.api.jtl-software.com/api
   • Sandbox: https://ffn-sbx.api.jtl-software.com/api

Credential-Test: GET /v1/users/current
Hinweis: Mindestens einmal im FFN-Portal (Prod/Sandbox) einloggen, sonst kann der User-Endpoint 404 liefern.

Node-Nutzung

Parameter API Side:

| API Side | Beschreibung | |----------|--------------| | Merchant | Händler-API /api/v1/merchant/... | | Fulfiller | Fulfillment-Dienstleister /api/v1/fulfiller/... | | Shared | z. B. aktueller User |

Merchant-Ressourcen

Fulfiller, Warehouse, Product, Stock, Inbound, Outbound, Return, Shipping Method, Amazon SFP Credential

Fulfiller-Ressourcen

Merchant, Authorization, Warehouse, Shipping Method, Product, Stock, Inbound, Outbound, Return

Write-Operationen erwarten den Body als Request (JSON) gemäß API-Docs.

Entwicklung (WSL)

n8n läuft bei uns unter WSL — Build und Link ebenfalls dort:

cd /mnt/c/ProgramData/repositories/NodeJs/n8n-jtl-ffn-community-node
export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh"
pnpm install
pnpm build
pnpm lint
chmod +x scripts/link-to-n8n-wsl.sh
./scripts/link-to-n8n-wsl.sh

Details: Developerhints.md. Node LTS (nvm). CI publisht bei Git-Tags nach npm (azure-pipelines.yml).

Architektur

View (*Description.ts, JtlFfn.node.ts) → Service (*.service.ts) → Repository (shared/ffnHttp.repository.ts). Strikt typisiert, kein any.

Lizenz

MIT — T4DT GmbH