Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- soennecken:bestandsabgleich [2023/03/03 11:09] – [Voraussetzungen] Andrea Müller
+++ soennecken:bestandsabgleich [2026/10/09 07:55] (aktuell) – [Abruf des Lagerbestandes in Concept Office] Isabel Pinder
@@ Zeile 3: / Zeile 3: @@
 Die Soennecken eG stellt einen Webservice zur Verfügung, mit dem es möglich ist, den aktuellen Lagerbestand abzufragen. Damit kann einem Sachbearbeiter diese Information direkt in der Warenwirtschaft zur Verfügung gestellt werden.
-Hier sehen Sie ein kurzes Video zum Thema
-{{:laeger:bestandsabfrage720.mp4|}}
 ===== Voraussetzungen =====
+==== Externe Systeme ====
-Die bei Soennecken erhältlichen Zugangsdaten müssen unter **Administration** im Modul [[externe_systeme:externe_systeme|Externe Systeme]] eingetragen werden. In der nachfolgenden Eingabemaske tragen Sie Benutzer, Passwort,
+Die bei Soennecken erhältlichen Zugangsdaten müssen unter **Administration** im Modul [[externe_systeme:externe_systeme|Externe Systeme]] (XS) eingetragen werden. In der nachfolgenden Eingabemaske müssen:
- URL und Kundennummer ein.
+  * Benutzer
+  * Passwort
+  * URL
+  * Kundennummer eingetragen werden.
-{{:laeger:soennecken-bestandsabfragen-voraussetzungen.png?direct|}}
+Aktualisierung **Web-API** Bestandsabfrage Soennecken **ab 06/2025** (nur zusammen mit CO **8.0** / ab Patch 8.3460.xx):
+  * Benutzer
+  * Passwort = API-Key
+  * URL: neue URL seitens SOE (Hinweis: Hier wird immer der SOE-Mandant (Tenant-ID) zum API-Key in der URL eingesetzt)
+{{:soennecken:soe_api.png?nolink&1200|}}
+<note tip>https://api.soennecken.de/api/**Mandant(Mitglied**)/logistics/v1/stocks/</note>
+  * Als Benutzer kann die Mandanten-ID angegeben werden, auch wenn diese momentan keine Verwendung findet.
+  * Die Zusatzinfo3 "**neu**" wird ab dem Stand 8.4621.2 __nicht mehr benötigt__. Bestehende Einträge müssen jedoch nicht zwingend entfernt werden.
+{{:soennecken:bild_7_.png?nolink|}}
 Zur Aktivierung der Zugangsdaten klicken Sie {{:wiki:haekchen.png?nolink&15|}} Aktiv an und speichern abschließend die Eingabe.
 ==== Firma ====
-{{:laeger:edifact.png|}}
+{{:soennecken:be1.jpg?nolink|}}
 Um mit der Soennecken-Bestandsabfrage eine Verkaufssperre an einem Artikel setzen zu können, so muss am Lieferanten im Abschnitt EDIFact der Reiterkarte Lieferantendaten der Haken auf das Feld '//Wenn Hauptlieferanten, dann den Bestellstatus des Lieferanten an den Artikel übernehmen//' gesetzt sein.
@@ Zeile 24: / Zeile 44: @@
 Sofern die alte Sortimentskennung (Kern, Besorger) es zulässt, wird der Status 'Auslaufartikel' als Sortimentskennung gesetzt.
-Die Verkaufssperre wird gesetzt, sofern der Artikel 'Auslaufartikel' oder 'Bestellsperre' hat und seitens Soennecken Bestand = 0 hat. So lange der Artikel an Ihrem Lager Bestand hat, können Sie den Artikel aber trotzdem verkaufen.
+Die Verkaufssperre wird gesetzt, sofern der Artikel ‚Auslaufartikel‘ oder ‚Bestellsperre‘ hat und seitens Soennecken Bestand = 0 und Bestand im Zulauf = 0 hat. So lange der Artikel an Ihrem Lager Bestand hat, können Sie den Artikel aber trotzdem verkaufen.
 Zusätzlich können noch mit den Feldern 'Verfügbar ab Intervall in Tagen für gesperrte Artikel' und 'Für angekündigte' noch festlegen, wann die Artikel wieder entsperrt werden. Soennecken schickt ja auch noch einen voraussichtlichen Termin mit, wann Bestand erwartet wird. Bei Intervall 0 wird die Verkaufssperre nur entfernt, wenn der Artikel Bestand hat. Bei einem größeren auch schon so viele Tage vor dem vom Soennecken gemeldeten Termin.
 ===== Abruf des Lagerbestandes in Concept Office =====
+==Allgemein==
+Für den Soennekenbestandsabgleich gibt folgende Funktionalitäten:
+  * Abruf und die Hinterlegung des 'Verfügbar ab'-Datums von Soennecken am Lieferantenartikel
+  * Abgleich des Soenneckenbestallstatus (50=neu nur angekündigt, 100=normal, 600=Bestellsperre, 900=Auslauf (Lieferant/Hersteller), 905=Auslauf Distributor (Soennecken))
+  * Abruf und die Hinterlegung der kurzfristig verfügbaren Menge von Soennecken als ‚Bestand im Zulauf‘ am Lieferantenartikel. Der Bestand im Zulauf wird bei Verkaufssperre und Bestellsperre wie Bestand berücksichtigt. Die zusätzlich angezeigte Spalte ‚Außenlager‘ wird von Soennecken nicht befüllt.
+Am Lieferanten gibt es das Kennzeichen 'Setzt als Hauptlieferant den Artikelstatus', sowie die Option 'Verfügbar ab Intervall'. Ist das Kennzeichen gesetzt, dann wird Folgendes mit durch den Abgleich realisiert:
+  * der Status von Soennecken bei Auslaufartikeln wird in das Sortiment übernommen, sofern es sich um einen Kern- oder Besorgerartikel handelt
+  * hat der Artikel eine Bestellsperre oder ist Neu nur angekündigt, dann wird am Artikel die Verkaufssperre gesetzt
+  * hat der Artikel Bestand und einen bestellbaren Status, dann wird die Verkaufssperre entfernt
+  * sowohl für die Sortimentskennung, als auch die Verkaufssperre können am Lieferantenartikel Sperren hinterlegt werden, so dass diese Funktionen dann für diesen Artikel nicht ausgeführt werden
+Sofern ein Intervall hinterlegt ist:
+  * hat der Artikel eine Bestellsperre oder keinen Bestand und das Verfügbar ab-Datum liegt weiter in der Zukunft, als durch das Intervall festgelegt, dann wird am Lieferantenartikel die Bestellsperre gesetzt, sofern dieser nicht Streckenmengeab = 1 hat und somit nie Bestand bei Soennecken aufweist
+  * hat der Artikel Bestand oder ist in einem Zeitraum kleiner dem Intervall bestellbar, dann wird die Bestellsperre entfernt
 ==== Abruf im Auftrag ====
@@ Zeile 34: / Zeile 72: @@
 (Darüber hinaus gehende Informationen zur EK-Analyse finden sie [[vorgaenge:ekanalyse|hier.]])
-Klickt der Sachbearbeiter auf die Schaltfläche „Soennecken abfragen“ nimmt Concept office Verbindung mit dem Webservice von Soennecken auf und liefert den aktuellen Bestand und den Status, farblich dargestellt in grün, gelb oder rot. Zudem wird die Spalte „aktualisiert“ mit dem aktuellen Datum versehen, damit man erkennen kann, wann der Bestand das letzte Mal  abgerufen wurde.
+Klickt der Sachbearbeiter auf die Schaltfläche „Soennecken abfragen“ nimmt Concept office Verbindung mit dem Webservice von Soennecken auf und liefert den aktuellen Bestand, den Bestand im Zulauf und den Status, farblich dargestellt in grün, gelb oder rot. Zudem wird die Spalte „aktualisiert“ mit dem aktuellen Datum versehen, damit man erkennen kann, wann der Bestand das letzte Mal  abgerufen wurde.
-{{:laeger:soe_bestand2.png|}}
+{{:laeger:soe_bestand2.png?1000|}}
 Dabei werden alle Artikel berücksichtigt, die sich im Auftrag befinden und von Soennecken geliefert werden können.
@@ Zeile 46: / Zeile 84: @@
 === Abruf in der Bestellung ===
-{{:laeger:soe_bestand5.png|}}
+{{:laeger:soe_bestand5.png?200|}}
 Bei Klick auf die Modulfunktion „Soe Bestand prüfen“ wird der Status entsprechend farblich dargestellt. (siehe vorheriges Kapitel)
@@ Zeile 54: / Zeile 92: @@
 === Abruf im Modul Bestellvorschläge ===
-Ruft man einen Artikel im Modul Bestellvorschläge auf, hat man ebenfalls die Möglichkeit die Funktion „EK-Analyse“ zu nutzen. Im sich öffnenden Fenster werden alle für diesen Artikel verfügbaren Lieferanten angezeigt. Neben dem aktuellen EK (KIP) wird nach Klick auf „Soennecken abfragen“ der bestand und der Status angezeigt. Auch hier wird zusätzlich das Datum der letzten Abfrage aufgeführt.
+Ruft man einen Artikel im Modul Bestellvorschläge auf, hat man ebenfalls die Möglichkeit die Funktion „EK-Analyse“ zu nutzen. Im sich öffnenden Fenster werden alle für diesen Artikel verfügbaren Lieferanten angezeigt. Neben dem aktuellen EK (KIP) wird nach Klick auf „Soennecken abfragen“ der Bestand, der Bestand im Zulauf und der Status angezeigt. Auch hier wird zusätzlich das Datum der letzten Abfrage aufgeführt.
 {{:laeger:soe_bestand3.png|}}
-Für den Soennekenbestandsabgleich gibt es neue Funktionalitäten:
+==== Automation ====
-- Abruf und die Hinterlegung des 'Verfügbar ab'-Datums von Soennecken am Lieferantenartikel
-- Abgleich des Soenneckenbestallstatus (50=neu nur angekündigt, 100=normal, 600=Bestellsperre, 900=Auslauf (Lieferant/Hersteller), 905=Auslauf Distributor (Soennecken))
-Am Lieferanten gibt es ein neues Kennzeichen 'Setzt als Hauptlieferant den Artikelstatus', sowie die Option 'Verfügbar ab Intervall'. Ist das Kennzeichen gesetzt, dann wird Folgendes mit durch den Abgleich realisiert:
+Über die Automation kann die aus dem Artikelstamm und der EK-Analyse bekannten Soennecken-Bestandsabfrage über den gesamten Artikelstamm des Lieferanten ausgeführt werden.
-- der Status von Soennecken bei Auslaufartikeln wird in das Sortiment übernommen, sofern es sich um einen Kern- oder Besorgerartikel handelt
-- hat der Artikel eine Bestellsperre oder ist Neu nur angekündigt, dann wird am Artikel die Verkaufssperre gesetzt
-- hat der Artikel Bestand und einen bestellbaren Status, dann wird die Verkaufssperre entfernt
-- sowohl für die Sortimentskennung, als auch die Verkaufssperre können am Lieferantenartikel Sperren hinterlegt werden, so dass diese Funktionen dann für diesen Artikel nicht ausgeführt werden
-Sofern ein Intervall hinterlegt ist:
-- hat der Artikel eine Bestellsperre oder keinen Bestand und das Verfügbar ab-Datum liegt weiter in der Zukunft, als durch das Intervall festgelegt, dann wird am Lieferantenartikel die Bestellsperre gesetzt, sofern dieser nicht Streckenmengeab = 1 hat und somit nie Bestand bei Soennecken aufweist
+<code>
-- hat der Artikel Bestand oder ist in einem Zeitraum kleiner dem Intervall bestellbar, dann wird die Bestellsperre entfernt
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<task>
+    <name>SoenneckenBestandsAbfrage</name>
+    <mandant>98</mandant>
+    <operations>
+        <operation name = "SoenneckenBestandsAbfrage">
+            <call></call>
+        </operation>
+    </operations>
+</task>
+</code>
+=== Parameter ===
+<**LieferantenNr**> Angabe des zu aktualisierenden Lieferanten, ist kein Lieferant angegeben, dann werden LS1 & LS3 über die Betriebsnummer ermittelt.\\ \\
+< **AnzahlArtikelProRequest** > , mit dem definiert werden kann, wie viele Artikel pro Request bei Soennecken abgefragt werden sollen. Wird kein Wert angegeben, werden 100 Artikel pro Request abgefragt. \\ \\
+< **AnzahlRetries** >, mit dem festgelegt werden kann, wie oft im Falle eines Fehlers die Anfrage an Soennecken wiederholt wird. Standardmäßig wird dieser Wert mit 1 vorbelegt. \\ \\
+< **FehlerhafteBestellnummernProtokollieren** > , (1/0) kann gesteuert werden, ob Bestellnummern, die **nicht** den Vorgaben von Soennecken entsprechen, protokolliert werden sollen.