Beleg-Volldaten (Auftrag, Rechnung, Lieferschein, Retoure)
jtl_beleg_volldaten
Was das Tool macht
Liefert ALLE Details zu einem Beleg - egal welcher Art. Der Belegtyp wird an der Nummer erkannt: OR-... = Auftrag, OR-...-001 = Lieferschein, IN-... = Rechnung, Ret-... = Retoure. Enthält Kopfdaten, Adressen, alle Positionen bzw. Pakete mit Tracking. Nutze dieses Tool für 'Zeig mir alles zu Beleg X', 'Alle Details zu OR-123456', 'Was steht in Ret-1143?'.
Eingaben
| belegnummerPflicht | Belegnummer, z.B. 'OR-527176', 'IN-450613', 'OR-527187-001' oder 'Ret-1143' |
| typoptional | Belegtyp erzwingen, falls die Automatik danebenliegt (Default auto) |
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.
- 1Erkennt den Belegtyp am Präfix: RET- = Retoure, IN- = Rechnung, OR- mit angehängter Nummer ab drei Ziffern (z. B. -001) = Lieferschein, sonst OR- = Auftrag; der Parameter typ übersteuert die Erkennung.
- 2Auftrag und Rechnung: Kopf per GraphQL über die exakte Nummer, inklusive Adressen, Kundengruppe, Storno-, Zahlungs- und Korrekturangaben; Positionen über REST v1.3 nach gezielter Suche in der sortierten Belegliste.
- 3Je Position: effektiver Preis = Nettopreis × (1 − Rabatt / 100), Positionswert = effektiver Preis × Menge; Positionssumme und Positionsanzahl zählen nur Artikelpositionen (Typ ungleich 2).
- 4Lieferschein: Auftragsnummer durch Abschneiden der Endung, Auftragskopf per GraphQL für Kunde und Lieferadresse; der Lieferschein wird gezielt gesucht und einzeln nachgeladen.
- 5Gesamtgewicht = Summe der Paketgewichte; ein Versanddatum, das mit „0001“ beginnt, gilt als leer; Versandarten werden über REST v1.3 (bis 200) in Namen aufgelöst.
- 6Retoure: Bezeichnungen für Status, Grund und Zustand über REST v1.3 (je bis 200); der Kopf wird auf der ersten Listenseite (100 Einträge) gesucht, sonst auf der aus der Nummer geschätzten Seite und ihren Nachbarn.
- 7Retourenpositionen liefern SKU, Menge, Grund, Warenzustand und Gutschrift-Kennzeichen; die retournierte Menge ist die Summe der Positionsmengen.
Annahmen und Grenzen
- Das Korrekturdokument zu einer Rechnung stellt die JTL-API nicht bereit; ausgegeben werden nur Kennzeichen und Korrekturbetrag.
- Retouren führen keine Preise, Lieferscheine keine Positionen.
- Die Beleglisten ignorieren Suchparameter; ohne exakten Nummerntreffer gibt es keinen Ersatzbeleg, bei Auftrag und Rechnung dann nur den Kopf mit Hinweis.
- Die Retourensuche prüft nur die erste Seite und die geschätzte Seite plus/minus eins; bei großen Nummernlücken wird die Retoure nicht gefunden.
So sieht eine Antwort aus
Retoure Ret-1043 vom 20.08. von Muster Handels GmbH, Status „Angemeldet“. Zwei Positionen mit zusammen 4 Stück: • 3× Powerbank Compact 10000mAh, schwarz – Grund „Defekt / beschädigt“, Zustand „Muss geprüft werden“, noch nicht gutgeschrieben • 1× Powerbank Travel 5000mAh mit Kabel, weiß – Grund „Falsche Bestellung“, Zustand „Verkaufsfähig“, bereits gutgeschrieben Die 3 defekten Stück sind noch offen – dort steht die Prüfung aus.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.