Versandkosten eines Auftrags setzen
jtl_auftrag_versandkosten_setzen
Was das Tool macht
Setzt die Versandkosten eines Auftrags: ändert den Betrag der vorhandenen Versandposition oder legt eine an, wenn der Auftrag noch keine hat - mit Vorschau und Backup. Nutze dieses Tool für 'Setze die Versandkosten von OR-123 auf 10 Euro netto', 'OR-123 versandkostenfrei' (Betrag 0). Artikelpositionen ändern jtl_auftrag_position_aendern und jtl_auftrag_position_hinzufuegen. Vorschau zuerst: Ohne dryRun=false wird nichts geändert. Zeige dem Nutzer Vorher/Nachher aus der Vorschau, hole seine Zustimmung ein und rufe dann mit dryRun=false und der bestaetigung erneut auf.
Eingaben
| auftragsnummerPflicht | Auftragsnummer (exakt) |
| betragNettoPflicht | Versandkosten netto |
| bezeichnungoptional | Bezeichnung der Versandposition - Default: Name der Versandart |
| steuersatzoptional | Steuersatz in Prozent für eine neue Versandposition - Default: höchster Satz der Warenpositionen - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| workflowsAuslassenoptional | true = automatische JTL-Workflows für diese Änderung nicht auslösen (Default false). |
| dryRunoptional | true (Default) = nur Vorschau, in JTL wird nichts geändert. false = wirklich schreiben - nur zusammen mit der bestaetigung aus der Vorschau und nach ausdrücklicher Zustimmung des Nutzers. |
| bestaetigungoptional | Bestätigungs-Token aus der Vorschau (Dry-Run). Pflicht bei dryRun=false. |
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.
- 1Prüft zuerst die Rechte: Server erlaubt Schreiben, JTL-Verbindung für Schreibzugriff freigeschaltet, AVV in aktueller Fassung angenommen, Add-on „Schreiben“ aktiv. Fehlt eines, endet der Aufruf mit dem Grund.
- 2Findet den Auftrag per Nummer und liest ihn samt Positionen; ein stornierter Auftrag ist gesperrt. Die Versandposition ist die Position vom Typ Versand.
- 3Hat der Auftrag eine Versandposition, wird nur ihr Nettopreis (und auf Wunsch die Bezeichnung) per PATCH salesOrders/{id}/lineitems/{positionId} geändert.
- 4Hat er keine, entsteht sie über PATCH /v2/sales-orders/{guid}. Weil dieser Aufruf die Positionsliste ersetzt, werden die bestehenden Positionen unmittelbar vorher gelesen und mit ihrer Id mitgeschickt; weicht ihre Anzahl vom Stand der Vorschau ab, wird nichts geschrieben.
- 5Steuersatz einer neuen Versandposition: der angegebene, sonst der höchste Satz der Warenpositionen.
- 6Ohne Bestätigung endet der Aufruf als Vorschau mit einmaligem Token (15 Minuten gültig, an Eingaben und Ist-Stand gebunden); der scharfe Aufruf löst ihn ein, verbraucht die Limits und legt das Backup an.
- 7Danach wird der Auftrag erneut gelesen und Betrag und Bezeichnung der Versandposition mit der Erwartung verglichen.
Annahmen und Grenzen
- Der Steuersatz einer vorhandenen Versandposition wird nicht geändert.
- Eine neu angelegte Versandposition lässt sich nicht automatisch rückgängig machen (Betrag auf 0 setzen oder in JTL entfernen); eine Betragsänderung schon.
- Bereits erstellte Rechnungen ändern sich nicht mit.
- In der Einführungsphase gelten 3 Schreibvorgänge je Entität und Tag; das Limit entfällt, sobald der Admin alle drei Entitäten freigegeben hat. Vorschauen zählen nicht.
- Das Änderungsprotokoll wird 12 Monate aufbewahrt und danach automatisch gelöscht.
So sieht eine Antwort aus
Vorschau für Auftrag OR-526202 – noch nichts geändert: Versandkosten netto: 10,00 € → 0,00 € (Position „UPS - DAP Delivered“). Soll ich die Versandkosten ändern?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.