Vorgang komplett (Auftrag + Rechnungen + Marge)
jtl_vorgang_komplett
Was das Tool macht
Zeigt den kompletten Vorgang zu einer Auftragsnummer: Auftragskopf, Positionen (mit Hinweis und Zulauf des Artikels), 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.
- 5Je Position zusätzlich der Hinweis (Feld Notice) und der Zulauf des Artikels (stockIncoming per GraphQL, gilt für den Artikel, nicht für den Auftrag).
- 6Summen: 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.
- 7Rechnungen 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.