Neu REST API - JTL WAWI

[danielat]

REST API - JTL WAWI

Hallo, wann wird die Rest API für JTL WaWi erscheinen ?

 

[raymond-de]

Das würde mich auch brennend interessieren.

 

[sjk]

50 %...

https://www.jtl-software.de/roadmap

 

[raymond-de]

Das habe ich auch schon gelesen. Es geht bei uns um Anbindung eines PIM und selbst programmiertes CRM. Mit der JTLwawiExtern.dll ist eines möglich, leider ist die Dokumentation nicht sehr umfangreich. Oder gibts hier doch was umfangreiches? Ist damit jedes Feld in JTL Wawi ansprechbar, auch die erstellten Felder und auch jedes Modul in JTL Wawi? Also ich brauche nicht nur Aufträge ansteuerbar.

Besser auf die API warten?

 

[mh1]

JTL-Wawi hat soviel ich weiß keine API.
So wie ich das sehe ermöglicht die DLL nur , dass man nicht direkt in die Datenbank schreiben muss, und stattdessen halt nur die nötigen Parameter übergibt um ein paar bestimmte Standardfunktionen oder Workflows anzustoßen.
Wird diese DLL denn aktiv weiterentwickelt? Ich dachte, das war nur mal so eine Art Projektidee und wird aber nicht mehr weiterverfolgt...
Würd mich echt mal interessieren

Und was kann man mit der JTL.Wawi.RestApi.exe machen?

 

[waagenwelt]

Von JTL aktuell veröffentlicht:

https://www.jtl-software.de/blog/loesungen-von-jtl/e-commerce-api

 

[juergenl]

Hat schon jemand die Dokumentation für die e-commerce-api/rest-api gefunden? Ich hab nicht so recht verstanden wo und wie ich die finden kann.

 

[SebastianB]

Hi,

also:
Die Wawi-API ist Teil der JTL-Wawi 1.6. Sie befindet sich in einem "nutzbaren" aber nicht "stabilen" Zustand, d.h. die Endpunkte werden sich vermutlich noch ändern bevor wir das Ding als " stable" deklarieren. Sie ist auch noch lange nicht Feature-Complete. Die JTL-Wawi-App nutzt diese API zur Kommunikation mit der JTL-Wawi - sprich: Das, was die Wawi-App braucht, ist schon da, alles andere vermutlich noch nicht so wirklich.

Der Server ist der POS-Server, d.h. in den globalen Einstellungen konfigurieren, dann den POS-Server starten.

Die Swagger-Doku findet sich dann unter https://localhost/rest/swagger/ui/index.

 

[raymond-de]

Das klingt doch schonmal sehr gut. An der 1.7 wird ja auch schon gearbeitet, vielleicht ist es dann schon stable?!

 

[SebastianB]

Nein, auf keinen Fall. Zwischen 1.7 und 1.6 wird sich an der REST API nicht sehr viel tun.

 

[forumjtlolshopag]

Hat jemand schon gute Erfahrung mit der JTL Wawi App gemacht? Wenn da so tägliche kleinere Arbeitsvorgänge gut funktionieren (Lieferdatum setzen, Prios ändern, Zurückhalten, etc.) Dann würde ich da in Zukunft sogar lieber die Beta API nutzen, als direkt in der DB abzufragen.

 

[juergenl]

Da sind ja schon viele Endpoints verfügbar und wenn man per API mit der Wawi kommunizieren kann bieten sich ganz neue Möglichkeiten. Finde ich schon mal super.

Leider habe ich noch nicht ganz verstanden wie die Authentifizierung funktioniert. Vermutlich muss man sich irgendwo bei JTL registrieren und kommt dann an das bearer token?

 

[frankw]

Hallo,

Server und Benutzer einrichten, wie für die JTL- App beschrieben:

https://guide.jtl-software.de/jtl-wawi/jtl-wawi-app-mit-jtl-wawi-verbinden/

Den API-Key als base64 kodieren und dieser kann dann als bearer Token verwendet werden.

Gruss,
Frank

 

[m.lembke@lembke-it-servic]

Hallo,

Server und Benutzer einrichten, wie für die JTL- App beschrieben:

https://guide.jtl-software.de/jtl-wawi/jtl-wawi-app-mit-jtl-wawi-verbinden/

Den API-Key als base64 kodieren und dieser kann dann als bearer Token verwendet werden.

Gruss,
Frank

Hallo Frank,

ich habe irgendwie ein Problem mit dem Aufruf.
Ich habe einen Benutzer restapi mit API-Token eingerichtet.
Der ist in den Administratoren drinnen.

Wenn ich in .Net 6.0 den Aufruf mache, bekomme ich immer kein Ergebnis.
Ich bin mir nicht sicher, was ich in "searchKeyWord" angeben muss um etwas zu finden.
Ich habe ein paar Aufträge in der Testdatenbank, die ich hier erwarten würde.
Evtl. hast Du ja einen Tipp für mich.

var EndPoint = "https://localhost/rest";

var httpClientHandler = new HttpClientHandler();
httpClientHandler.ServerCertificateCustomValidationCallback = (message, cert, chain, sslPolicyErrors) =>
{
return true;
};

var base64EncodedBytes = System.Convert.ToBase64String(System.Text.Encoding.UTF8.GetBytes("EAF69FEA-B541-49D7-8615-438C45FD3ABE"));

var client = new HttpClient(httpClientHandler) { BaseAddress = new Uri(EndPoint) };

client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", base64EncodedBytes);


SalesOrderClient salesOrderClient = new SalesOrderClient(client);

var listOfSalesOrder = await salesOrderClient.FetchSalesOrdersAsync(searchKeyWord: "", pageNumber: null, pageSize: null, database: "eazybusiness");


Mfg.
Markus Lembke

 

[frankw]

Hallo Markus,

das kann leider an vielen keinen Dingen liegen. Ich hab meine Calls an die Rest Api erstmal alle mit Postman zusammengebaut und getestet.
Die Auftragsanlage beim WMS-Demolager auf der JTL-Connect lief über die Rest-Api.

Ist das automatisch generierter Code aus dem swagger Kram?
Ich hab lieber mehr Kontrolle und schreibe sowas selbst. Ohne Doku und Beispiele ist das leider immer etwas kompliziert.

Die Angabe des searchKeywords ist auf jeden Fall optional. Mal mit null probiert?

Ich kann Montag mal einen Demo-Call für Postman raussuchen.

Gruss,
Frank

 

[m.lembke@lembke-it-servic]

Hallo Markus,

das kann leider an vielen keinen Dingen liegen. Ich hab meine Calls an die Rest Api erstmal alle mit Postman zusammengebaut und getestet.
Die Auftragsanlage beim WMS-Demolager auf der JTL-Connect lief über die Rest-Api.

Ist das automatisch generierter Code aus dem swagger Kram?
Ich hab lieber mehr Kontrolle und schreibe sowas selbst. Ohne Doku und Beispiele ist das leider immer etwas kompliziert.

Die Angabe des searchKeywords ist auf jeden Fall optional. Mal mit null probiert?

Ich kann Montag mal einen Demo-Call für Postman raussuchen.

Gruss,
Frank

Hi Frank,

ja, ich habe das mal über die NStudio Erzeugung versucht.
Scheint etwas wackelig zu sein .

Ich mache es dann mal klassisch, da bin ich eigentlich auch eher ein Freund von.

Dank für die Infos,
Gruss Markus

 

[m.lembke@lembke-it-servic]

Hi Frank,

mit Postman hat natürlich alles soweit funktioniert.
Mit PUT und POST habe ich das so verstanden, dass PUT das in JTL validiert TAX usw. berechnet und mit POST dann real speichert.

Ich verwende an der Bestellposition die Hinweise und Drucke diese auf den Dokumenten auch mit an.
Kann ich die Note am Item ach schreiben?

An der SalesOrder geht das?

Mfg.
Markus

 

[raymond-de]

Gibts eine öffentliche API Doku mit ein paar Beispiele zur Abfrage und Schreiben in Artikeln, Kunden, Aufträge? Der Verweis auf die Swagger Doku per https://localhost … ist etwas unpraktisch.

 

[frankw]

Bzgl. Doku, nein, das ganze "JTL Rest-Api Projekt" ist noch nicht mal in einer Beta-Phase.
Wie Sebastian oben schon geschrieben hat wird das erst nach der Wawi 1.7 angegangen.

Die aktuelle Rest-Api ist nur für die JTL interne Verwendung mit der JTL-Wawi App gedacht und wird die Basis für die kommenden allgemein nutzbare Rest-Api sein. Hier kann sich aber auch noch sehr viel Ändern.

Wir können hier auch keinen umfangreichen Support leisten. Da muss ich die Erwartungen leider bremsen.

Trotzdem ist das eine funktionierende Api mit der man etwas experimentieren kann.

Gruss,
Frank

 

[m.lembke@lembke-it-servic]

Hallo Markus,

das kann leider an vielen keinen Dingen liegen. Ich hab meine Calls an die Rest Api erstmal alle mit Postman zusammengebaut und getestet.
Die Auftragsanlage beim WMS-Demolager auf der JTL-Connect lief über die Rest-Api.

Ist das automatisch generierter Code aus dem swagger Kram?
Ich hab lieber mehr Kontrolle und schreibe sowas selbst. Ohne Doku und Beispiele ist das leider immer etwas kompliziert.

Die Angabe des searchKeywords ist auf jeden Fall optional. Mal mit null probiert?

Ich kann Montag mal einen Demo-Call für Postman raussuchen.

Gruss,
Frank

Hi Frank,

ja das war automatisch generiert aus dem NStudio.
Ich wollte es mal testen und... na, ja... ist hat nicht so stabil würde ich mal sagen.

Ich habe es mit Postman wie gehabt gemacht, und das funzt wie ne Eins.
Ich mache es nun wieder klassisch in .Net 6.0 und fertig .

Wenn ich das Konzept korrekt verstanden habe, ist der PUT ist ein Check, berechnen usw. und liefert dann die berechneten Werte zurück.
Und mit POST wird dann gespeichert.

Bezüglich der SalesOrder Items...
Ich benutze im JTL oft die Hinweise an der Position um hier Zeiträume usw. zu hinterlegen.
Die werden dann auch mit auf den Dokumenten angezeigt.

Kann ich das in der API auch machen?
Ich habe es für die SalesOrder gefunden.

Mfg.
Markus