jtl-ffn

n8n community node for the JTL Fulfillment Network (FFN) REST API

Package Information

Released: 2 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0

Available Nodes

Documentation generating…

JTL FFN icon
JTL FFN
Interact with the JTL Fulfillment Network (FFN) REST API

Documentation

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

Discussion