Neu JTL Wawi REST API

[DrGreen]

Ich blicke bei der JTL WAWI REST API nicht durch.

Gibt es dazu einen Leitfaden?

Ich brauche zunächst zb
- die Credentials
- den API Aufruf um die Anwendung in der Wawi zu registrieren.

Kann mir da jemand weiterhelfen?

 

[dapole]

Als erstes muss du dich für das BEta PRogramm anmelden-....
Dann bekommst du die Lizenz:

https://guide.jtl-software.com/jtl-wawi/jtl-wawi-api/anwendung-ueber-jtl-wawi-api-anbinden/


https://developer.jtl-software.com/products/erpapi/openapi


https://guide.jtl-software.com/jtl-...der-jtl-wawi-api-ueber-kommandozeile-starten/

-> Falls du mit deinem API tool diverse Sachen machen möchtest /testen möchtest, ist das 'ranzigste' dabei, dem die ganzen rechte zuzuweisen ....

Ich habe die APP-Reshgistoirerung über POST-Man getätigt:

Dort kannst du die die ganzen 'requests' importieren, dann ist es eine einfache nummer ....

-> Um meine APP zu registrieren, sah der 'body' teil so aus: ( so viel wegen den ganzen rechten):

{
  "AppId": "Test-V4",
  "DisplayName": "TestAppV4",
  "Description": "All Rechte?",
  //"LocalizedDisplayNames": "DE",
  //"LocalizedDescriptions": "DE",
  "Version": "1.0.0",
  "ProviderName": "JTL-Software-GmbH",
  "ProviderWebsite": "https://www.jtl-software.de",
 "MandatoryApiScopes": [
    "all.read",
    "availability.queryavailabilities",
    "condition.queryconditions",
    "item.queryitems",
    "item.createitem",
    "item.updateitem",
    "item.assignchilditemtoparent",
    "item.queryitemcustomerprices",
    "item.createitemcustomerprice",
    "item.deleteitemcustomerprice",
    "item.updateitemcustomerprice",
    "item.getitem",
    "item.queryitemcustomfieldvalues",
    "item.deleteitemcustomfield",
    "item.updateitemcustomfield",
    "item.queryitemdescriptions",
    "item.createitemdescription",
    "item.deleteitemdescription",
    "item.updateitemdescription",
    "item.queryitemimages",
    "item.createitemimage",
    "item.deleteitemimage",
    "item.updateitemimage",
    "item.queryitemproperties",
    "item.createitemproperty",
    "item.deleteitemproperty",
    "item.queryitemsaleschannelprice",
    "item.createitemsaleschannelprice",
    "item.deleteitemsaleschannelprice",
    "item.updateitemsaleschannelprice",
    "item.queryitemspecialprice",
    "item.updateitemspecialprice",
    "item.queryitemsuppliers",
    "item.createitemsupplier",
    "item.deleteitemsupplier",
    "item.updateitemsupplier",
    "item.queryitemvariations",
    "item.createitemvariation",
    "item.deleteitemvariation",
    "item.updateitemvariation",
    "item.queryitemvariationvalues",
    "item.deleteitemvariationvalue",
    "item.updateitemvariationvalue",
    "item.triggeritemworkflowevent",
    "item.queryitemcustomfields",
    "item.queryitemimagedata",
    "item.queryitemworkflowevents",
    "manufacturer.querymanufacturers",
    "productgroup.queryproductgroups",
    "shippingclass.queryshippingclasses",
    "taxclass.querytaxclasses",
    "property.queryproperties",
    "property.createproperty",
    "property.querypropertyvalues",
    "property.createpropertyvalue",
    "property.deletepropertyvalue",
    "property.updatepropertyvalue",
    "property.querypropertyvaluedescriptions",
    "property.createpropertyvaluedescription",
    "property.deletepropertyvaluedescription",
    "property.updatepropertyvaluedescription",
    "property.querypropertygroups",
    "property.createpropertygroup",
    "onholdreason.queryonholdreasons",
    "saleschannel.getsaleschannels",  
    "customergroup.querycustomergroups",
    "customergroup.createcustomergroup",
    "customergroup.getcustomergroup",
    "customergroup.deletecustomergroup",
    "customergroup.updatecustomergroup",
    "paymentmethod.querypaymentmethods",
    "shippingmethod.queryshippingmethods",
    "warehouse.querywarehouses",
    "warehouse.querystoragelocations",
    "warehouse.querystoragelocationtype",
    "warehouse.querywarehousetypes",
    "customercategory.querycustomercategories",
    "customercategory.createcustomercategory",
    "customercategory.getcustomercategory",
    "customercategory.deletecustomercategory",
    "customercategory.updatecustomercategory",
    "cancellationreason.querycancellationreasons",
    "transactionstatus.querytransactionstatus",
    "category.querycategories",
    "category.createcategory",
    "category.getcategory",
    "category.updatecategory",
    "category.querycategorydescriptions",
    "category.createcategorydescription",
    "category.deletecategorydescription",
    "category.updatecategorydescription",
    "category.addcategoryitems",
    "salesorder.querysalesorders",
    "salesorder.createsalesorder",
    "salesorder.getsalesorder",
    "salesorder.updatesalesorder",
    "salesorder.cancelsalesorder",
    "salesorder.querysalesordercustomfieldvalues",
    "salesorder.deletesalesordercustomfield",
    "salesorder.updatesalesordercustomfield",
    "salesorder.querysalesorderfiles",
    "salesorder.createsalesorderfile",
    "salesorder.querysalesorderfiledata",
    "salesorder.deletesalesorderfile",
    "salesorder.querysalesorderlineitems",
    "salesorder.createsalesorderlineitem",
    "salesorder.deletesalesorderlineitem",
    "salesorder.updatesalesorderlineitem",
    "salesorder.querysalesordernotes",
    "salesorder.createsalesordernote",
    "salesorder.deletesalesordernote",
    "salesorder.updatesalesordernote",
    "salesorder.triggersalesorderworkflowevent",
    "salesorder.querysalesordercustomfields",
    "salesorder.querysalesorderworkflowevents",
    "wms.querypicklist",
    "wms.createpicklist",
    "wms.querypicklistposition",
    "wms.querypicklisttemplate",
    "stock.querystocksperitem",
    "stock.stockadjustment",
    "stock.querystockchanges",
    "stock.queryserialnumberperwarehouse",
    "cancellationreason.querycancellationreasons",
//    "returnreason.queryreturnreasons",
    "paymentmethod.querypaymentmethods",
    "shippingmethod.queryshippingmethods",
    "warehouse.querywarehouses",
    "customercategory.querycustomercategories",
//    "return.queryreturns",
    "colorcode.querycolorcodes",
    "transactionstatus.querytransactionstatus",
    "invoice.queryinvoices",
    "invoice.queryinvoicelineitems",
    "invoice.getinvoice",
    "invoice.triggerinvoiceworkflowevent",
    "invoice.queryinvoiceworkflowevents",
    "supplier.querysuppliers",
    "company.querycompanies",
    "customer.querycustomers",
    "customer.createcustomer",
    "customer.getcustomer",
    "customer.updatecustomer",
    "customer.querycustomerbankaccounts",
    "customer.createcustomerbankaccount",
    "customer.getcustomerbankaccount",
    "customer.deletecustomerbankaccount",
    "customer.updatecustomerbankaccount",
    "customer.querycustomernotes",
    "customer.getcustomernote",
    "customer.updatecustomernote",
    "customer.triggercustomerworkflowevent",
    "customer.querycustomercustomfields",
    "customer.querycustomerworkflowevents",
    "customer.deletecustomernote",
    "customer.createcustomernote",
    "customer.updatecustomercustomfield",
    "customer.deletecustomercustomfield",
    "customer.querycustomercustomfieldvalues",
    "customer.updatecustomercontact",
    "customer.deletecustomercontact",
    "customer.getcustomercontact",
    "customer.createcustomercontact",
    "customer.querycustomercontacts",
    "customer.deletecustomerbankaccount",
    "category.querycategories",
    "category.createcategory",
    "category.getcategory"
    ],
  "OptionalApiScopes": [],
  "AppIcon":""

}

-> Ich glaube trotzdem, dass ich damit nicht ganz alle abgedeckt hab ....

Um die APP zu registrieren, muss du die c# Version starten ...
Und dann sich eigentlich an die Beschreibung halten.

Ich habe noch ein Screenshot von Postman angehängt ... ( 2 Screenshots in einem Bild)
APPID und APPVersion muss bei jedem request mit gesendet werden ...-> habe ich als Variable angelegt ...
Genau so wie der API Token ....

URL steht, wenn du den Server startest ...

Wenn man noch keinen kontakt mit postman etc. hatte, ist es auf den ersten Blick sehr undurchsichtig ... Abner ich war gottseidank bei der connect dabei, und dort gab es genau diese Einführung

Hoffe konnte dfir zumindest etwas input geben

 

[talis3r]

Alternativ besteht auch die Möglichkeit anstatt API , N8N auf dem eigenen Server zu installieren und sich alle Daten einfach über die SQL Datenbank zu ziehen oder zu erstellen.
Hier habe ich ein Video dazu gemacht.
Man kann so gut wie alles damit umsetzten
VG Lukas

 

[DrGreen]

@dapole Danke dir, ja das hilft schon mal sehr

@talis3r ja mit SQL arbeiten wir schon länger, aber ist halt pfusch wenn man nicht genau weiß welche DB Trigger an welcher tabelle hängen.
Wir importieren zB Aufträge ausschließlich über die Ameise, weil man da ein stück weit abgesichert ist was das thema betrifft.
Kleine Änderungen wie Artikelbeschreibungen etc. machen wir direkt mit SQL.

Die API soll ja eben hier nochmal mehr Schutz bieten nicht kaputt zu machen denk ich mir.

Wo finde ich denn die API Credentials?

 

[talis3r]

Ob per SQL oder API kannst deine Datenbank trotzdem zerschießen , was bringt dir API mehr Schutz ?

API / SQL Anfrage Daten expotieren - in CSV aufbereiten - Human Control - Import per Ameise

Wenn dir dann irgendwann sicher bist kannst es ja voll automatisieren

VG

 

[DrGreen]

Sowohl der Import mittels CSV als auch über die API bieten mehr Sicherheit, da eine Validierung stattfindet und eben sog. Datenbank-Trigger ordnungsgemäß, und vor allem mit allen nötigen Daten angestoßen werden, was bei einer reinen SQL "Manipulation" fehlen kann.

Kannst du mir sagen wo ich die API Credentials einsehen kann?

 

[dapole]

Ob per SQL oder API kannst deine Datenbank trotzdem zerschießen , was bringt dir API mehr Schutz ?

API / SQL Anfrage Daten expotieren - in CSV aufbereiten - Human Control - Import per Ameise

Wenn dir dann irgendwann sicher bist kannst es ja voll automatisieren

VG

Yo,

API istr aber ein Kernprodukt der WaWi ...

-> Das wird mehr doer weniger supportet. ..
Zerballerst du dir die wawi, also die Datenbvank per SQL direkt - pfussch ....

->Dann hat der Support das Recht dir den Support zu unterbeinden ...( bzw nicht durchzuführen)

-> Meines´Wissens nach, kann das per API nicht passieren.

(Korrigiert mich wenn ich richtrig liege) ....
-> Hab bis zu API, auch recht viel DB - Seitig gemacht. GEhjt, geht auch teilweise schneller wie API ...

Aber die PI hat auch wirklich seine Vorteie. Alleine das Ausführen iensw Workflows von Außen ist Goldwert. Man braucht keine C#extern.dll ijn irgendwelche c# projekte anbinden, sondern kann den workflow einfach per API triggern ...

-> Diese Funktion ist beio uns zum Beispiel nicht mehr weg zu denken ....

Ansonsten freue ioch mich, dass ich etwas helfen konnte. Ansonsten: Gerne weiter Fragn, falls man nicht weiter kommt ....

Grüße

 

[gre000]

Mein Problem mit der API sind die Kosten wenn es aus der Beta ist 200€ find ich schon viel (100€ bei Pro)

 

[John]

Mein Problem mit der API sind die Kosten wenn es aus der Beta ist 200€ find ich schon viel (100€ bei Pro)

Ganz genau.
Eine tolle Idee, ist damit einer breiten Zielgruppe entzogen und es bleibt weiterhin bei Ameise oder SQL selbst machen.
Es gab glaube ich die ersten Projekte von externen Anbietern, die auf API aufsetzen (KI Übersetzer?) aber bei 2400,- EUR Zusatzkosten nur für die JTL-seitige Anbindung ist die Hürde hoch.

Auch habe ich noch überhaupt kein Feedback bzgl. erreichbarer gelesen. Ameise ist ja schon in einigen Belangen sehr langsam gegenüber SQL aber wo ist die API einzuordnen?

 

[frankell]

Eigentlich eher peinlich, in 2025 für ne API überhaupt Geld zu verlangen.

Und richtig arg wird es, wenn man bedenkt, dass die schönen neuen "akquirierten" Tools wie Dealavo, Returnless, und was da nicht noch kommen wird, auf dem Vorhandensein der API basieren. Man zahlt also für die nicht unbewusst funktionsarm gehaltene Wawi UND - um die fehlenden Funktionen zu ergänzen - für die API UND für die akquirierten Dienste.

 

[css-umsetzung]

Eigentlich eher peinlich, in 2025 für ne API überhaupt Geld zu verlangen.

Das finde ich gar nicht so schlimm, aber das man für eine BETA Version Geld nimmt, das finde ich bedenklich

 

[frankell]

aber das man für eine BETA Version Geld nimmt, das finde ich bedenklich

Tut man das? Zumindest für die API aktuell ja nicht.

 

[css-umsetzung]

Tut man das? Zumindest für die API aktuell ja nicht.

 

[frankell]

Ist in der Beta-Phase noch nicht umgesetzt. Sobald entbetaisiert wird, regnet es Dollarscheine.

 

[css-umsetzung]

Sicher, das die noch nicht berechnet wird?
Dann sollte man das auch so schreiben

 

[John]

Sicher, das die noch nicht berechnet wird?
Dann sollte man das auch so schreiben

Naja, der Investoren-Traum ist halt schneller zu Papier gebracht, als die Programmierer das in Code umgesetzt bekommen.

Ist ja mit der Ameise CMD genauso.
Eigentlich per Lizenz nicht in Start enthalten aber erst ab der 1.10 umgesetzt.

 

[frankell]

Sicher, das die noch nicht berechnet wird?

Sicher.

Dann sollte man das auch so schreiben

SIeht man bei der Buchung im Kundencenter, und im Guide steht es auch. Ansonsten das, was @John sagt. Siehe auch Begrenzung der manuellen Workflows und CustomWorkflows, die ja "offiziell" bereits seit 1.9.24 greift, aber erst in 1.10 umgesetzt ist.

 

[css-umsetzung]

Ja stimmt, steht im Guide, ich sehe das bei mir im Kundencenter ja nicht weil ich als SP ja alles frei habe.

Hinweis: Die JTL-Wawi API befindet sich derzeit in der Open-Beta-Phase. Bis zum offiziellen Release nutzen Sie die Schnittstelle im Rahmen des Pilotprogramms kostenfrei. Je nachdem, welche JTL-Edition/Paketkonfiguration Sie gebucht haben, steht Ihnen JTL-Wawi API aber nach dem offiziellen Release möglicherweise nicht zur Verfügung.

 

[frankell]

weil ich als SP ja alles frei habe.

Neid!

 

[gre000]

Eigentlich eher peinlich, in 2025 für ne API überhaupt Geld zu verlangen.

Ja zumindest in der Pro hätte es mit drin sein müssen und in der Advanced für 99€ dazu wäre nicht schön aber ok.
Ich sehe da auch verlorendes Potenzial das wären aus der Comunity so viele schöne Ideen gekommen...

tionen zu ergänzen - für die API UND für die akquirierten Dienste.

Für solche Produkte muss die API ja nicht gezahlt werden nur wenn man das frei nutzen will