Neu REST API - JTL WAWI

[JTL_fwenzl]

Hallo,

vom Konzept her ist das bei REST-Apis so gedacht:

get => lesen,
post => neu anlegen
put => update und ggf. neu anlegen, wenn der datensatz nicht existiert
delete => löschen

Das mit den Hinweisen weiß ich nicht auswendig. Aber gibts da nicht sogar einen eigenen Endpunkt für... irgendwas mit order notes?
Kann ich Montag nachschauen.

Ich würde mal probieren einen Auftrag mit Hinweisen anlegen, per get abfragen, die werte im json ändern und die daten per put updaten.

Gruss,
Frank

 

[wawi-dl]

...
get => lesen,
post => neu anlegen
put => update und ggf. neu anlegen, wenn der datensatz nicht existiert
delete => löschen
...

Danke Frank, auch wenn es weit in der Zukunft ist ... kann denn seitens JTL grob sagen, was überhaupt geöffnet/ermöglicht wird?

So wie ich es gelesen hab, können Anbieter dann auch weitere Channels an JTL anbieten, sprich Aufträge übermitteln, Kunden anlegen, Artikel verwalten?

 

[SebastianB]

Hi,

wir können aktuell keine seriöse Auskunft darüber geben, wann was fertig sein wird. Die REST-API wird die bestehenden APIs ergänzen, d.h. das, was mit den bestehenden APIs geht (SCX, FFN usw) wird nicht Ziel der REST-API sein.

Viel mehr lässt sich zum jetzigen Zeitpunkt nicht verlässlich sagen. Das, was die Wawi-App braucht ist soweit getestet und funktionsfähig (und lässt sich am einfachsten über mitschneiden der Kommunikation rausziehen) - alles weitere wird sich zeigen.

 

[m.lembke@lembke-it-servic]

Hi,

wir können aktuell keine seriöse Auskunft darüber geben, wann was fertig sein wird. Die REST-API wird die bestehenden APIs ergänzen, d.h. das, was mit den bestehenden APIs geht (SCX, FFN usw) wird nicht Ziel der REST-API sein.

Viel mehr lässt sich zum jetzigen Zeitpunkt nicht verlässlich sagen. Das, was die Wawi-App braucht ist soweit getestet und funktionsfähig (und lässt sich am einfachsten über mitschneiden der Kommunikation rausziehen) - alles weitere wird sich zeigen.

Hi Sebastian

also ich hatte bisher immer die SQL Funktionen für die Antragsanlage und Anpassung verwendet.
Die sind ja leider seit der 1.6er weggefallen.
Daher hatte ich gehofft, dass ich nun auf die Rest-API wechseln könnte, um das damit zu erledigen.

Ich habe diverse Reportings meiner Lieferanten, die ich auslesen muss und daran dann Aufträge => Rechnungen für meine Kunden zu erstellen.
Also Kunde Suchen, prüfen, ob er schon eine Auftrag mit Rechnung erzeugt bekommen hat, wenn nicht, dann Auftrag anlegen oder ggf. anpassen.

Das bekomme ich soweit (mit auslesen aus der Datenbank) auch schon mit der Rest-API hin.

Ich habe allerdings z.B. hier das Problem, dass mit nicht ganz klar ist, was das SearchKeyWord alles sein könnte.

https://localhost/rest/eazybusiness/v1/SalesOrder?searchKeyWord=

Bisher habe ich es nur für die InternalSalesOrderKey nutzen können.

Die Ameise kann ich hier leider nicht verwenden, da die Aufträge z.B. keine Artikel preise der JtlWawi einsetzen.
Ich habe in den Listen keine Kundenpreise. Daher hatte ich das immer aus der Datenbank geholt.

Das alles per Hand am Ende des Monats zu machen, ist einfach zu aufwendig und schreit nach einer automation.

Mfg.
Markus

 

[zwitsch]

Hallo Markus,

mit der Rest-API kenne ich mich nicht aus. Aber wenn hier schon etwas programmiert wird, dann kann man eine neue CSV-Datei oder XML-Datei erstellen mit allen notwendigen Daten. Dann kann man die CSV-Datei mit der Ameise über einen parametergesteuerten Aufruf im eigenen Programm starten oder man stellt die XML-Datei für den Worker bereit. Einmal eingerichtet, dann läuft das gut.

 

[raymond-de]

@zwitsch
Klingt gut. Eine gut dokumentierte API mit Möglichkeit alle auszulesen und zu schreiben wäre zwar besser aber das klingt schon vielversprechend.

 

[m.lembke@lembke-it-servic]

Hallo Markus,

mit der Rest-API kenne ich mich nicht aus. Aber wenn hier schon etwas programmiert wird, dann kann man eine neue CSV-Datei oder XML-Datei erstellen mit allen notwendigen Daten. Dann kann man die CSV-Datei mit der Ameise über einen parametergesteuerten Aufruf im eigenen Programm starten oder man stellt die XML-Datei für den Worker bereit. Einmal eingerichtet, dann läuft das gut.

Hi,

mit der Ameise kann ich hier leider nicht viel anfangen.
Reports kann ich zwar auf die Ameise umschreiben, aber die Aufträge sind hierbei zu unflexibel.

Ich habe das schon angefangen, aber es werden z.B. keine Artikelpreise aus JtlWawi verwendet, sonder die müssen in der EXML / CSV vorhanden sein.
Also Steuern und Preise sind schwierig.

Wenn der Report mehrmals verarbeitet wird, dann werden die Artikel immer wieder neu angelegt.
Artikel mit einer Menge 0 werden z.B. gar nicht angelegt.
Dieses benötige ich aber, da ich hier z.B. in einem Angebot, Auftrag, Rechnung eine Titelzeile einfüge.

Es sind z.B. mehrere Positionen mit dem gleichen Artikel, aber unterschiedliche Mengen und Zeiträume usw.

Mfg.
Markus Lembke

 

[wawi-dl]

...
Ich habe das schon angefangen, aber es werden z.B. keine Artikelpreise aus JtlWawi verwendet, sonder die müssen in der EXML / CSV vorhanden sein.
Also Steuern und Preise sind schwierig.
...

Jein, du könntest doch zuvor per SQL Select alle Infos ziehen und dann die CSV / XML aufbauen, die du dann automatisiert per Worker Ameise importierst.

So machen wir es auch mit Excel-Kalkulatoren, ziehen uns alles in Excel, bauen Schema auf und leiten es per VBA als CSV aus, die dann ein Batch für Ameise Worker antriggert.

 

[m.lembke@lembke-it-servic]

Jein, du könntest doch zuvor per SQL Select alle Infos ziehen und dann die CSV / XML aufbauen, die du dann automatisiert per Worker Ameise importierst.

So machen wir es auch mit Excel-Kalkulatoren, ziehen uns alles in Excel, bauen Schema auf und leiten es per VBA als CSV aus, die dann ein Batch für Ameise Worker antriggert.

Dann bin ich aber wieder an zu vielen Orten mit der Kalkulation usw.
Das obige geht ja soweit mit der API. Ich mache den Rest via Entity Framework gegen die Datenbank.
Also Suchen von Aufträgen ohne Rechnung, Artikel prüfen und dann via Rest-API alles anlegen usw..

Das geht soweit auch alles gut.
Ich würde halt gerne noch die 2 oder 3 SQL aufrufe einsparen und via Rest-API machen wollen.

Mfg.
Markus Lembke

 

[magnificmedia]

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

Gibt es denn eine API-Dokumentation? Wir würden gerne einen Magento Shop mit dem JTL Wawi verbinden und die aktuellen Software-Lösung von IT-Unternehmen sind nicht wirklich gut. Daher würden wir gerne etwas eigenes entwickeln.

 

[forumjtlolshopag]

Gibt es denn eine API-Dokumentation? Wir würden gerne einen Magento Shop mit dem JTL Wawi verbinden und die aktuellen Software-Lösung von IT-Unternehmen sind nicht wirklich gut. Daher würden wir gerne etwas eigenes entwickeln.

Glaub da wäre die Connector Anbindung sinnvoller:
https://guide.jtl-software.de/jtl-connector/

Haben uns da auch was selbst "gebastelt" für unseren Shop.

 

[Guybrush]

Ich möchte hier mal meine Erfahrung mit der REST-API kurz zusammenfassen, insb. das Setup und Tests über Swagger - dazu sind doch einige Schritte notwendig.

Zuerst in die JTL Wawi und den POS Server aktivieren, dieser stellt die REST-API bereit:
- Menü "Admin -> Globale Einstellungen -> Server Einstellungen -> Rest-Server beim Workerstart starten"
- "Server konfigurieren" anklicken, für lokale Tests genügt "127.0.0.1", ansonsten auf die IP ändern, über die die REST-API verfügbar sein soll
- Port habe ich auf "4443" geändert, ist aber Geschmacksache, ich verwende nur ungern offizielle Ports, die evtl. auch von anderer Software verwendet wird wie von jedem Web Server
- "Zertifikat erstellen" -> Meldung bestätigen, passiert alles automatisch
- mit "OK" bestätigen, speichern und sicherheitshalber Wawi neu starten

POS Server starten und vorbereiten, damit dieser auch via Worker 2.0 verwendet werden kann:
- Menü "Admin -> JTL-Worker -> Status"
- " JTL-POS-Server" markieren und den Button "Starten" anklicken -> Status sollte sich auf "Läuft" ändern

Immer noch in der Wawi müssen wir einen Benutzer konfigurieren, der dann einen API Key erhält, mit dem auf die REST-API zugegriffen werden kann:
- Menü "Admin -> Benutzer / Rechte -> Benutzer anlegen oder per Doppelklick zum Bearbeiten öffnen -> rechts unten Key erzeugen anklicken -> Key kopieren"
- Key in Base64 encodieren, z. B. via PowerShell und somit ohne externe Tools oder Programmieraufwand:
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('12345678-ABCD-1234-1234-123456ABCDEF'))
- Ergebnis kopieren, im obigen Beispiel: MTIzNDU2NzgtQUJDRC0xMjM0LTEyMzQtMTIzNDU2QUJDREVG

Zu guter letzt Worker 2.0 neu starten, um den POS-Server zu starten -> neuer Tab "JTL-POS-Server" erscheint

WICHTIG für Swagger:
Man muss sich authentifizieren, dazu ist folgendes essentiell -> der Base64 encodierte API Key von oben muss wie folgt eingegeben werden:
bearer MTIzNDU2NzgtQUJDRC0xMjM0LTEyMzQtMTIzNDU2QUJDREVG

Man muss also noch das "bearer" voranstellen, sonst wird das nichts mit der Authentifizierung.

Swagger scheint den API Key rechts oben auch zu ignorieren, man muss also z. B. beim Customer Endpoint das kleine Ausrufezeichen anklicken und dort alles einfügen.

Viel Spaß damit, ich wollte auf Eigene Felder für Artikel zugreifen, leider scheint das nicht zu funktionieren, aber vllt. hilft's ja mal dem ein oder anderen

PS: Habe das erst im Nachhinein so zusammgeschrieben, kann also sein, dass ich etwas vergessen habe - dann bitte melden und ich versuche das zeitnah zu ergänzen.

 

[raymond-de]

Die Frage ist bei uns immer noch offen. Eine funktionierende API wäre schon praktisch, da mehrere externe Dienste angebunden werden müssten.
Tut sich vielleicht hier was bei JTL 1.8?

Auf https://www.jtl-software.de/roadmap steht die API-Umsetzung schon sehr lange auf 50%.

 

[hextheone]

Ja die Rest API kommt mit der 1.8. Ein vorschau der Doku findest du hier: https://wawi-api.jtl-software.com/?version=wawi-api-v1-1.8
Noch fehlen aber viele Endpunkte, dauert also noch etwas, aber wird sicherlich dieses Jahr noch was kommen

 

[Ace of Space]

Moin,

ich bin ein wenig trauig das man so schwer nur an die Closed Beta ran kommt, den wir würde auch gerne schon anfangen unsere sachen von wilden Linux -> Windows CSV-Übergaben ablösen, und dann eben auch auf die Ameise zum Auftragsimport verzichten. Open Beta wäre dem entsprechend sehr schön... ein Testsystem mit der 1.8er Open Beta ist fertig aufgesetzt.

Außerdem, da für die API ein Lizenzschlüssel benötigt wird, stellt sich mir natürlich die frage nach den zukünftigen kosten... weiß da schon jemand was?

 

[ANG]

Hi,

hat jemand vielleicht eine Idee, mit welcher Abfrage die Artikel gesucht werden können? Die APP kann ja die Artikel anhand der Artikelnummer, dem Namen, EAN, HAN usw. finden. Im Swagger habe ich nichts dazu gefunden und in den Docks auf der JTL-Seite https://wawi-api.jtl-software.com/ geht es anscheinend um die API die noch in der Closed-Beta ist.

Ich brauche eine Abfrage, die z.B. zur einer EAN das passende Produkt findet (Internen Produktschlüssel).

Es wäre super, wenn mir jemand auf die Sprünge helfen könnte. Ich nutze die WaWi 1.6

 

[TiK]

Hallo zusammen,
wir nutzen für unsere Systeme JTL's Rest API, die "eingebaute", nicht die aus der closed beta. Leider funktioniert seit der 1.7 das Anlegen neuer Produkte nicht mehr. Das ist der Endpunkt "/{database}/v1/Items"
Macht man einen POST bekommt man neuerdings "500 Internal Server Error". Die ganze Fehlermeldung sieht so aus:

HTTP/1.1 500 Internal Server Error
Content-Length: 217
Content-Type: application/json; charset=utf-8
Server: Microsoft-HTTPAPI/2.0
Date: Wed, 30 Aug 2023 07:04:27 GMT

Der Typ "JTL.Wawi.RestApi.Controller.ArtikelVerwaltung.ArtikelDetails.ItemController" in Assembly "JTL-Wawi-RestApi, Version=1.7.14.0, Culture=neutral, PublicKeyToken=null" ist nicht als serialisierbar gekennzeichnet.nalSalesTaxKey": 1,
      "Rate": 19.0000000000000
    },
    "SalesPriceGross": 0.0,
    "Discount": 0.0,
    "Type": 0,
    "PieceListRootKey": 0,
    "Variations": [],
    "Hint": null
  }
]$���t�xt�o����A�uI_m3�ǒ�ײ���n*�����EJ�A����?�!U�����j��]Z�3"���(�㮳Oо�>j.y�0'�޼���&?�

Wird das noch gefixt oder wird im Zuge der Entwicklung der neuen API hier nichts mehr passieren?
In der Wawi 1.8.6 ist der Fehler leider auch noch da, was sehr schade ist, weil wir die Funktion dringend brauchen...
Danke und Gruß
Tiberius

 

[wawi-dl]

JTL Ticket machen, das bringt hier nicht viel ...

 

[TiK]

Hi,

hat jemand vielleicht eine Idee, mit welcher Abfrage die Artikel gesucht werden können? Die APP kann ja die Artikel anhand der Artikelnummer, dem Namen, EAN, HAN usw. finden. Im Swagger habe ich nichts dazu gefunden und in den Docks auf der JTL-Seite https://wawi-api.jtl-software.com/ geht es anscheinend um die API die noch in der Closed-Beta ist.

Ich brauche eine Abfrage, die z.B. zur einer EAN das passende Produkt findet (Internen Produktschlüssel).

Es wäre super, wenn mir jemand auf die Sprünge helfen könnte. Ich nutze die WaWi 1.6

über die Rest API kannst du so nach einer EAN suchen:

rest/eazybusiness/v1/items?searchKeyWord=<EAN-Nummer>

searchKeyWord kann auch die Artikelbezeichnung sein.
Gruß

 

[TiK]

JTL Ticket machen, das bringt hier nicht viel ...

Hab ich auch gemacht