Lieferant anlegen
jtl_lieferant_anlegen
Was das Tool macht
Legt einen neuen Lieferanten in JTL an - mit Vorschau und Backup-Eintrag. Pflicht sind Firma, Straße, PLZ, Ort und Land; Währung (Default EUR) und Sprache (Default de) optional, ebenso Lieferantennummer, Kontakt, USt-IdNr., Lieferzeit, Zahlungsziel, Skonto, Mindestbestellwert, Frachtkosten, Kommentar und Standardlager. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Lege den Lieferanten Muster Ltd. in Shenzhen mit Währung USD an'. Einem Artikel zuweisen: jtl_artikel_lieferant_aendern. 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
| firmaPflicht | Firmenname |
| strassePflicht | Straße und Hausnummer |
| plzPflicht | Postleitzahl |
| ortPflicht | Ort |
| landIsoPflicht | Land als ISO-Code, z.B. CN |
| lieferantennummeroptional | Lieferantennummer - leer = keine |
| waehrungoptional | Währung als ISO-Code (Default EUR) |
| spracheIsooptional | Sprache als ISO-Code (Default de) |
| standardlageroptional | Lager für Bestellungen bei diesem Lieferanten (Name) - Default: das Lager der bestehenden Lieferanten |
| firmenzusatzoptional | Firmenzusatz - weglassen = unverändert, null = leeren |
| ansprechpartneroptional | Ansprechpartner - weglassen = unverändert, null = leeren |
| emailoptional | E-Mail - weglassen = unverändert, null = leeren |
| telefonoptional | Telefon - weglassen = unverändert, null = leeren |
| ustIdoptional | USt-IdNr. - weglassen = unverändert, null = leeren |
| steuerfreioptional | Lieferant liefert steuerfrei (z.B. Drittland-Import) |
| lieferzeitTageoptional | Lieferzeit in Tagen - weglassen = unverändert |
| zahlungszielTageoptional | Zahlungsziel in Tagen - weglassen = unverändert |
| skontoProzentoptional | Skonto in Prozent - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| skontoTageoptional | Skontofrist in Tagen - weglassen = unverändert |
| mindestbestellwertoptional | Mindestbestellwert - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| frachtkostenoptional | Frachtkosten - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| dropshippingoptional | Lieferant kann Dropshipping |
| statusoptional | Status (freier Text) - weglassen = unverändert, null = leeren |
| webseiteoptional | Webseite - weglassen = unverändert, null = leeren |
| kommentaroptional | Kommentar - weglassen = unverändert, null = leeren |
| 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.
- 2Prüft die Lieferantenliste: ein gleicher Name erzeugt eine Dubletten-Warnung, eine bereits vergebene Lieferantennummer wird abgelehnt.
- 3Firma (Mandant) kommt aus der Auftragsvorlage von JTL. Das Standardlager ist das genannte, sonst das Lager, das die bestehenden Lieferanten am häufigsten nutzen (Stichprobe).
- 4Ohne 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.
- 5Geschrieben wird per POST /v2/suppliers mit Adresse, Kontakt und den angegebenen Konditionen; Währung Default EUR, Sprache Default de.
- 6Danach wird der Lieferant gelesen und mit der Erwartung verglichen.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Löschen geht nicht über dieses Tool; in JTL lässt sich ein Lieferant deaktivieren.
- Die Zuordnung zu Artikeln macht jtl_artikel_lieferant_aendern.
- 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 – noch nichts angelegt: Neuer Lieferant „Muster Ltd.“, Tech Road 1, 518000 Shenzhen (CN), Währung USD, Sprache en, Lieferzeit 30 Tage, steuerfrei. Standardlager „Hauptlager - Moos“ von den bestehenden Lieferanten übernommen. Soll ich den Lieferanten anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.