Beleganlage / Positionsübergabe + Sperre

[manueljussel]

Details

• Current version number: 25.4.1
• Previous version number (optional):
• Test status checked in Mobile Manager
• Function or route (request): /Documents/{documentKey}/ArticleItem
• Error (response):

Steps to replicate the behavior:

Über POST /Documents wird ein neuer Beleg (Auftrag) angelegt.
Dann werden X Positionen über /Documents/{documentKey}/ArticleItem hinzugefügt.
Werden diese Aufrufe schnell hintereinander abgesetzt, stimmt unter Umständen die Reihenfolge der Positionen nicht mehr. Mit einem Wartezeit zwischen den Aufrufen kann man das Problem umgehen, aber dadurch dauert die Anlage speziell von großen Belegen viel länger.
Außerdem kann es vorkommen, dass während der Beleganlage (bzw. eigentlich dem Hinzufügen von Positionen) ein User in der WAWI diesen Beleg öffnet und in den Bearbeitungsmodus wechselt - dann bekommt die API (die ein eigener Hintergrundprozess für die Verarbeitung von Webshop-Bestellungen ist) eine Fehlermeldung, dass der aktuelle Datensatz bereits in Verwendung ist.

Also 2 Fragen:

1. Wieso kann man nicht mehrere Positionen gleichzeitig (als Array) übergeben bzw. wenn es nur einzeln geht, wie kann man garantieren (ohne manuelle Wartezeit), dass die Positionen exakt in der Reihenfolge eingefügt werden, wie die Aufrufe stattfinden?
2. Ist es möglich, bei Anlage eines Belegs über die API diesen Beleg (bis zu einem definierten Zeitpunkt) für die normale WAWI zu sperren?

Vielen Dank für eine rasche Rückmeldung,
Manuel Jussel

[Micha-Richter]

Punkt 1 finde ich komisch und kann ich mir ehrlich gesagt auch nur vorstellen, wenn ihr das Ergebnis der Positionsanlage nicht abwartet, bevor der Call zur Anlage der nächsten Position rausgeht!? 🤔

Die Möglichkeit der Übergabe mehrerer Positionen am Stück wäre auf alle Fälle eine willkommene Verbesserung der API!

[SirGamsay]

Ähnliches Verhalten musste ich an ganz anderer Stelle auch schon öfter bemerken.

Mein anderer Fall war, Successors Call mit mehreren Positionen, Ergebnis abwarten, direkt danach GET Anfrage an /Positions machen um die Positionen des neuen Belegs zu bekommen. Dort bekomme ich dann in seltenen Fällen (bis jetzt nur bei custom erstellen Belegtypen) zurück, dass es keine Positionen gibt. Wenn ich den Beleg danach in der Warenwirtschaft öffne, sind dort die Positionen.
In dem Fall muss ich leider einen so blöden GET Positions Call hinterher machen, da der Successors Call einem keine Fehler gibt, wenn der Beleg zwar angelegt wurde, aber die Positionen es nicht in den Nachfolge Beleg geschafft haben.

Was ich sagen möchte, ist dass ich es nicht für unwahrscheinlich halte, dass SelectLine die Reihenfolge an Requests teilweise nicht respektiert.

Ist es möglich, bei Anlage eines Belegs über die API diesen Beleg (bis zu einem definierten Zeitpunkt) für die normale WAWI zu sperren?

Der Punkt wäre aus meiner Sicht auch höchste relevant und eine willkommene Verbesserung der API, jedoch habe ich da auch keine Idee, wie man das realistisch umsetzen kann.

[manueljussel]

Punkt 1 finde ich komisch und kann ich mir ehrlich gesagt auch nur vorstellen, wenn ihr das Ergebnis der Positionsanlage nicht abwartet, bevor der Call zur Anlage der nächsten Position rausgeht!? 🤔

Das kann ich ausschließen, erst wenn das Ergebnis da ist, wird der nächste Call abgeschickt.

[Micha-Richter]

Punkt 1 finde ich komisch und kann ich mir ehrlich gesagt auch nur vorstellen, wenn ihr das Ergebnis der Positionsanlage nicht abwartet, bevor der Call zur Anlage der nächsten Position rausgeht!? 🤔

Das kann ich ausschließen, erst wenn das Ergebnis da ist, wird der nächste Call abgeschickt.

😳 Das ist ja wild..
Da wird aber nur SelectLine selbst etwas zu sagen können.

[MaikGoertz]

Moin.

wie kann man garantieren (ohne manuelle Wartezeit), dass die Positionen exakt in der Reihenfolge eingefügt werden, wie die Aufrufe stattfinden?

Ein derartiges Verhalten konnten wir nicht in unseren Tests nachstellen. Unsere Requests warten bis die Anfrage abgeschlossen ist.
Können Sie uns einen detaillierten Ablauf, am besten auf dem Mustermandanten, zur Verfügung stellen, wie wir das Verhalten nachvollziehen können?
Alternativ Log-Einträge die das Verhalten aufzeigen?

Wieso kann man nicht mehrere Positionen gleichzeitig (als Array) übergeben bzw. wenn es nur einzeln geht,

Dies ist bisher nicht vorgesehen und würde m.M.n. den Wartungsaufwand erhöhen.
Der Weg sollte hier sein das eigentliche Problem zu lösen und nicht eine neue Variante zu etablieren.

Ist es möglich, bei Anlage eines Belegs über die API diesen Beleg (bis zu einem definierten Zeitpunkt) für die normale WAWI zu sperren?

Es ist bisher kein automatischer Weg dafür vorgesehen. Sie könnten dafür einen eigenen Prozess etablieren.
Da gebe es bspw. die Möglichkeit mit dem Belegstatus zu arbeiten oder ein Freies Feld oder Extrafeld zu befüllen mit einem Hinweis, dass der Beleg gerade über die API bearbeitet wird.