REST-API: Grundpreis (§ 2 PAngV) über /items nicht lesbar und nicht schreibbar

[TomH76]

Hallo zusammen,

wir pflegen unseren Artikelbestand (u. a. Liquid-Sortiment, verpflichtend mit Grundpreisangabe nach PAngV) teilautomatisiert über die JTL-Wawi-REST-API. Dabei ist uns aufgefallen, dass sich die Grundpreisangabe (Grundpreismenge/-einheit, z. B. "je 1 Liter") über die API weder auslesen noch schreiben lässt.

Was wir geprüft haben:

• GET /items/{id} liefert kein Feld für Grundpreismenge/-einheit — weder in ItemPriceData noch anderswo im Item-Objekt.
• Im Swagger (/swagger/v1/swagger.json, aktuell 318 Endpunkte) existiert kein Endpunkt, der sich Grundpreis, Attributen oder vergleichbaren Bezeichnungen zuordnen lässt (u. a. gesucht nach "Grundpreis", "BasePrice", "UnitPrice", "Attribute").
• Der in der Doku genannte Scope item.getitemattributes ist in unserer Berechtigungsverwaltung als verfügbar/aktivierbar markiert, führt aber ins Leere — es gibt aktuell keine Route, die diesen Scope tatsächlich bedient.

Auswirkung: Für jeden neu angelegten Liquid-Artikel (bei uns aktuell mehrere hundert im Jahr) muss die Grundpreisangabe manuell in der Wawi-Oberfläche nachgetragen werden, obwohl Gewicht, EK/VK, Bilder, Lieferantenzuordnung, Beschreibung und sogar die CLP-Kennzeichnung (Freifelder, seit 2.0.5 dankenswerterweise per API schreibbar) längst vollautomatisiert laufen. Das ist bei uns der einzige verbleibende manuelle Pflichtschritt in einem ansonsten durchgängig automatisierten Workflow.

Frage an die Community/JTL:

• Ist das ein bekanntes Thema bzw. für eine kommende Version geplant?
• Gibt es einen alternativen, uns bislang unbekannten Weg (anderer Endpunkt, andere Berechtigung), über den Grundpreisdaten zugänglich sind?

Über Rückmeldungen — auch "ist geplant, aber noch nicht spruchreif" — würden wir uns sehr freuen.

Danke & Grüße

 

[neoautark]

Hallo TomH76,
einen versteckten Endpunkt dafür kenne ich auch nicht. Solange die REST-API den Grundpreis nicht kann, würde ich ihn als eigenen Schritt über die Ameise laufen lassen.

Im Artikeldatenimport lassen sich die Felder unter Grundpreis/Einheit zuordnen. Laut Guide reichen Spalten wie Artikelnummer;Grundpreis ausweisen;Menge;Mengeneinheit;GP-Bezugsmenge;Bezugsmengeneinheit. Das einmal in der Oberfläche einrichten und als Vorlage speichern.
https://guide.jtl-software.com/jtl-wawi/jtl-ameise/grundpreise-importieren

Die Vorlage lässt sich danach ohne Oberfläche per Kommandozeile starten (Vorlagen-ID mit -t, CSV mit -i). Euer Skript kann also nach dem Anlegen über die API eine CSV schreiben und den Import direkt oder per Aufgabenplaner anstoßen. Zwei Einschränkungen: Dafür braucht es direkten Zugriff auf die SQL-Datenbank, und laut Guide ist die Kommandozeilen-Version je nach gebuchter Edition nicht dabei. Mit Grundpreisen bin ich den Weg selbst noch nicht gefahren, ich würde also erst ein paar Artikel mit --mode=test und --csv_errors durchlaufen lassen.
https://guide.jtl-software.com/jtl-wawi/jtl-ameise/cmd-line-version

ist nur ein Workaround, aber man macht was man kann, solange die API halbgar ist

Grüße, Minh

 

[Morimus]

bzw. für eine kommende Version geplant?

In der JTL Cloud-API v2 gibt es beim Artikel das Objekt unitPricing.
Darin sind unter anderem innerQuantity, innerQuantityUnitId, isBasePriceDeclared, basePriceReferenceUnitId und basePriceReferenceAmount dokumentiert.

 

[TomH76]

In der JTL Cloud-API v2 gibt es beim Artikel das Objekt unitPricing.
Darin sind unter anderem innerQuantity, innerQuantityUnitId, isBasePriceDeclared, basePriceReferenceUnitId und basePriceReferenceAmount dokumentiert.

Das scheint zu funktionieren, herzlichen Dank für den Tipp 😀

 

[Morimus]

Ja, sehr gern.