🔍 Supplier Lookup API

Intelligente Lieferanten-Erkennung für Rechnungsverarbeitung

✅ AKTIV v1.0 n8n Integration

📊 Performance Metriken

<100ms
Response Time
99.5%
Uptime
2
Aktive Endpoints

✅ Erfolgreiche Tests

Blanco GmbH - Fuzzy Matching 25% Skonto erkannt ✓
Liebherr - Firmenerkennung 3% Skonto erkannt ✓

🔗 API Endpoints

POST https://supplier-api.flowcenters.de/lookup-supplier
Request
Response
Beispiele
Live Test

Request Body

{ "supplierText": "Blanco GmbH + Co KG" }

Headers

Content-Type: application/json Authorization: Bearer YOUR_API_KEY

Success Response (200)

{ "success": true, "supplier": { "id": "uuid-here", "name": "Blanco GmbH + Co KG", "variations": [ "Blanco GmbH", "Blanco", "BLANCO" ], "skonto_rate": 0.25, "payment_terms": "14 Tage 2,5% Skonto, 30 Tage netto", "confidence": 0.95, "created_at": "2024-09-12T10:30:00Z" }, "processing_time_ms": 45 }

Error Response (404)

{ "success": false, "error": "SUPPLIER_NOT_FOUND", "message": "Kein Lieferant für 'UnbekannterName' gefunden", "suggestions": [ "Überprüfen Sie die Schreibweise", "Verwenden Sie Abkürzungen oder Varianten" ], "processing_time_ms": 12 }

Erfolgreiche Lookups

Beispiel 1: Exakte Übereinstimmung

curl -X POST https://supplier-api.flowcenters.de/lookup-supplier \ -H "Content-Type: application/json" \ -d '{"supplierText": "Liebherr"}'

Beispiel 2: Fuzzy Matching

curl -X POST https://supplier-api.flowcenters.de/lookup-supplier \ -H "Content-Type: application/json" \ -d '{"supplierText": "Blanco GmbH & Co"}'

n8n HTTP Request Node Konfiguration

{ "method": "POST", "url": "https://supplier-api.flowcenters.de/lookup-supplier", "headers": { "Content-Type": "application/json" }, "body": { "supplierText": "{{ $json.extracted_supplier_name }}" } }

🧪 Live API Test

Testen Sie die API direkt hier:

Bereit für API-Test... Geben Sie einen Lieferantennamen ein und klicken Sie auf "API Testen".

⚙️ n8n Integration

Die API ist speziell für die Integration in n8n-Workflows optimiert:

Workflow-Verwendung

  1. PDF-Verarbeitung: Tesseract OCR extrahiert Lieferanteninformationen
  2. Text-Bereinigung: Entfernung von Sonderzeichen und Normalisierung
  3. API-Aufruf: Lookup mit bereinigtem Lieferantentext
  4. Datenverarbeitung: Skonto-Rate für weitere Workflow-Schritte
// n8n Expression für bereinigten Lieferantentext {{ $json.supplier_raw.replace(/[^\w\s&]/g, '').trim() }}

🚀 Geplante Features

GET /suppliers 🔄 In Entwicklung
POST /suppliers 🔄 In Entwicklung
POST /webhooks/invoice-processed 🔄 In Entwicklung

Warenwirtschaft APIs (Q4 2024)