Vorgang komplett (Auftrag + Rechnungen + Marge)
jtl_vorgang_komplett
Was das Tool macht
Zeigt den kompletten Vorgang zu einer Auftragsnummer: Auftragskopf, Positionen, alle zugehörigen Rechnungen und die Marge. Beantwortet 'Wie ist der Stand von Auftrag X?' in einem Aufruf. Nutze dieses Tool für 'Kompletter Vorgang zu OR-123', 'Auftrag und Rechnung zusammen', 'Status von Auftrag X'.
Eingaben
| auftragsnummerPflicht | Auftragsnummer, z.B. 'OR-526202' |
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 den Auftragskopf per GraphQL und sucht den Beleg in der REST-v1.3-Auftragsliste (Auftragsdatum als Sortierschlüssel, Interpolation und Intervallhalbierung).
- 2Bei Treffer werden die Positionen über REST v1.3 geladen; je Position gilt: Umsatz netto = Nettopreis × (1 − Rabatt / 100) × Menge.
- 3EK je Position = durchschnittlicher Einkaufspreis der Belegposition (PurchasePriceNet); ein EK von 0 oder leer gilt als unbekannt, damit keine 100-Prozent-Marge vorgetäuscht wird.
- 4Marge je Position = Umsatz − EK × Menge; Marge in Prozent = Marge / Umsatz × 100.
- 5Summen: Umsatz über alle Positionen mit SKU; Marge nur über Positionen mit bekanntem EK, Margenprozent bezogen auf deren Umsatz; die Anzahl der Positionen ohne EK wird mitgegeben.
- 6Rechnungen zum Auftrag kommen per GraphQL über die Auftragsnummer (höchstens 20) mit Betrag, offenem Betrag, Zahlungsstatus, Zahlungsdatum, Mahnstufe und Storno-Kennzeichen.
Annahmen und Grenzen
- Freifelder wie ein manuell gepflegter Einstandspreis werden für die Marge nicht herangezogen.
- Positionen ohne SKU (z. B. Versandpositionen) bleiben bei den Summen außen vor.
- Schlägt die Rechnungsabfrage fehl, wird eine leere Rechnungsliste ausgegeben; mehr als 20 Rechnungen je Auftrag werden nicht geladen.
- Ohne exakten Treffer in der Belegliste gibt es keine Positionen und damit keine Marge.
So sieht eine Antwort aus
Der komplette Vorgang zu OR-500123: Auftrag vom 28.08. für Muster Handels GmbH über 4.820,50 € netto, vollständig versendet. Marge: 2.010,10 € bei 2.810,40 € Einkaufswert – 41,7 %. Dazu gibt es eine Rechnung: IN-400512 vom 28.08. über 4.820,50 €, vollständig bezahlt. Der Vorgang ist damit abgeschlossen – geliefert, fakturiert, bezahlt.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.