Topkunden-Ranking
jtl_topkunden
Was das Tool macht
Rankt die umsatzstärksten Kunden eines Zeitraums auf Basis der JTL-Rechnungen (netto, ohne stornierte Belege). Nutze dieses Tool für 'Wer sind unsere Topkunden?', 'Top 10 Kunden im Juli' oder Umsatzrankings je Kunde.
Eingaben
| vonoptional | Zeitraum-Beginn ISO, z.B. '2026-07-01' (Default: letzte 30 Tage) |
| bisoptional | Zeitraum-Ende ISO (Default: heute) |
| topNoptional | Anzahl Kunden (Default 20) |
Die Eingaben füllt die KI aus deiner Frage. Du musst dir keine Parameternamen merken.
So wird gerechnet
Der Rechenweg in der Reihenfolge, in der das Tool arbeitet: Abruf, Filter, Berechnung, Ausgabe. Aus dem Tool-Code abgeleitet, damit nachvollziehbar ist, warum eine Zahl so ist. Dieselbe Auskunft liefert das Tool kiuser_tool_logik direkt im KI-Chat.
- 1Lädt die Rechnungen des Zeitraums (Default: letzte 30 Tage) über die GraphQL-Rechnungsliste mit serverseitigem Filter auf salesInvoiceDate, in Seiten zu 100 bis maximal 5000 Belegen.
- 2Fällt der Datumsfilter auf dem JTL-Server aus, wird die Rechnungsliste rückwärts (neueste zuerst) gelesen und clientseitig gefiltert, bis eine Seite überwiegend aus Belegen vor dem Zeitraumbeginn besteht.
- 3Stornierte Rechnungen werden ausgeschlossen; korrigierte Belege bleiben enthalten.
- 4Je Kunde (Schlüssel Kundennummer, ersatzweise Name) werden Nettoumsatz (totalNetAmount aus dem Rechnungskopf) und Anzahl Rechnungen summiert.
- 5Ausgabe absteigend nach Nettoumsatz mit Platz, auf topN gekürzt (Default 20, maximal 100), dazu Gesamtzahl der Rechnungen und Gesamt-Nettoumsatz.
Annahmen und Grenzen
- Der angezeigte Name kommt aus der Rechnungsadresse (Firma, sonst Vor- und Nachname), ersatzweise aus der Kundennummer; das Rechnungsfeld companyName wird nicht verwendet, weil es den eigenen Mandanten enthält.
- Rechnungen ohne Kundennummer werden nach Name zusammengefasst; verschiedene Schreibweisen ergeben getrennte Einträge.
- Der Abruf ist auf 5000 Rechnungen gedeckelt; beim Erreichen des Deckels nennt ein Hinweis die Gesamtzahl im Zeitraum, denn die neuesten Belege fehlen dann.
- Basis sind Rechnungen, nicht Aufträge; unfakturierte Aufträge fehlen, der Zahlungseingang spielt keine Rolle.
So sieht eine Antwort aus
Im August habt ihr 482.984 € netto aus 268 Rechnungen fakturiert. Die größten Kunden: 1. Muster Handels GmbH (K-10042) – 100.000 € aus 12 Rechnungen 2. Beispiel Distribution AG (K-10088) – 45.259 € aus 7 Rechnungen Allein der größte Kunde macht rund 21 % des Monatsumsatzes – eine spürbare Abhängigkeit.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.