Inhalt
Beschreibung
Installation
Kardex-Funktionalität ohne Fertigung
Kardex-Funktionalität mit Fertigung
Windows-Service
PPG
Abhängigkeiten
Konfiguration
Kardex
Instanzen
Profile
Weitere Konfiguration
Initiale Umlagerung in Kardex Shuttle XP
Funktionsweise
Standardprozess (ohne Fertigung)
Interne Lieferungen
Ausgehende Lieferungen
Eingehende Lieferungen
Fertigungsprozess (eq_kardex_mrp/eq_kardex_mrp_csv)


Eingesetzte Software

Beschreibung

Dieser Artikel befasst sich mit der Anbindung des ERP-Systems Odoo V 10 an das Kardex System Power Pick Global (PPG V 4.11) zur Übergabe von Bewegungsdaten. Dazu gehören Lieferscheine und Produktdaten.

Installation

Kardex-Funktionalität ohne Fertigung

Installieren Sie unter Apps die Module:

1. eq_kardex
2. eq_kardex_csv

Kardex-Funktionalität mit Fertigung

Installieren Sie unter Apps die Module:

1. eq_kardex_mrp
2. eq_kardex_mrp_csv

Windows-Service

Auf dem Windows-Server bzw. dem Rechner von PPG (Wichtig: Internetverbindung) muss ein Windows-Dienst eingerichtet werden. Dieser holt die Dateien aus der Spooltabelle von Odoo ab und speichert diese in das vorgegebene Verzeichnis bzw. liefert die von PPG erzeugten Dateien an Odoo aus.

PPG

Wir empfehlen für die benötigten Einstellungen im PPG Kontakt mit Ihrem betreuenden Partner von Kardex aufzunehmen.

Abhängigkeiten

Konfiguration

Das Modul erweitert das Lager um das Menü „Kardex" mit Unterpunkten Kardex, Instanzen und Profile. Instanzen und Profile sind aktuell nur in der Entwicklungsansicht (Debug-Modus) sichtbar.

In diesen Menüs haben Sie nun folgende Einstellmöglichkeiten:

Kardex

Tabelle mit allen erzeugten Transferdateien, keine weiteren Einstellmöglichkeiten.

Instanzen

Konfiguration der möglichen Lagervorgänge, in der Basis-Konfiguration sind folgende Instanzen bereits vordefiniert:

• Order (Buchungen von Odoo → PPG)
• Confirmation PPG (Quittung von PPG → Odoo)
• Inventory PPG (Inventur/Bestandsabgleich von PPG → Odoo)

In jeder der Instanzen müssen Anpassungen vorgenommen werden, damit die Systeme korrekt zusammenarbeiten.

Name: Bezeichnung der Instanz, z. B. Order, Inventur, …
Intervall: Ausführung der automatischen Überprüfung des Verzeichnisses, Angabe in Sekunden
Aktiv: Aktivierung oder Deaktivierung der Instanz
Zeitstempel Ping: wird vom System gesetzt
Root Exportverzeichnis: Angabe des Verzeichnisses im Windows-System, auf welches Ihre Kardex-Software Zugriff hat, z. B. C:\documents\kardex\Odoo_export
Datei-Format: TXT oder CSV
Encoding Format: UTF-8 (Standard)
Activate Log for Create File: An- / Abschalten des Log-Files
Entity Source: Export oder Import. Bei Export wird die Datei von Odoo erzeugt und in das hinterlegte Root Exportverzeichnis geschrieben. Bei Import wird die von PPG erzeugte Datei in Odoo eingelesen.
Entity Csv Name (nur bei Import sichtbar): Bezeichnung der Datei aus dem zuvor definierten Verzeichnis. Hier muss der Name der Datei (dieser muss immer gleich sein) bzw. der Präfix des Dateinamens muss identisch sein.
Type (nur bei Import sichtbar): Je nach Anlass muss hier die passende Selektion getroffen werden:

• Outsourcing: Auslagerung (Auslagerung aus Kardex heraus) -> zu vernachlässigen
• Storage: Einlagerung (Einlagerung in Kardex) -> zu vernachlässigen
• Inventur: Bestandsabgleich zwischen Kardex und Odoo
• Confirmation: Quittierung von Kardex an Odoo

Die bereits vordefinierten Instanzen decken alle Standard-Lagervorgänge ab. Falls nötig können weitere Instanzen erzeugt werden, um individuelle Fälle abzudecken.
Gegebenenfalls müssen hier weitere Anpassung im Source Code getätigt werden.

Profile

Die vordefinierten Profile decken alle zuvor definierten Standard-Vorgänge ab. Diese mitgelieferten Profile sind bereits gemäß der Standard-Anforderung für die Software PPG vorkonfiguriert, können aber ggf. angepasst werden, falls die Zuordnung in PPG vom definierten Standard abweicht.

Im Einzelnen bieten sich folgende Einstellmöglichkeiten:
Name: Bezeichnung des Profils
Ausgangsdatenmodell: Hier wird das zugehörige Datenmodell gewählt
Instanz: Zuordnung zu den bestehenden Instanzen
*Name of CSV file:* Hier wird der Dateiname definiert. Dabei können die üblichen Odoo-Parameter genutzt werden, um z. B. ein Datum zum gewählten Dateinamen zu ergänzen. Zusätzlich sollte darauf geachtet werden, Windows-konforme Datei-Namen zu erzeugen. Die Endung des Dateinamens muss der entsprechenden Instanz entsprechen.
Mapping: Hier wird definiert, welche Informationen in welcher Reihenfolge in die Datei geschrieben (nur Export).
Die ausgelieferte Basis-Konfiguration ist bereits auf eine Standard-Konfiguration der PPG eingerichtet. Ggf. müssen Parameter für einen reibungslosen Einsatz angepasst werden.

Folgende Profile sind standardmäßig nach der Installation der Module voreingestellt:

• Einlagerung

• Auslagerung

• Einlagerung des Fertigprodukts in einem Fertigungsauftrag

• Auslagerung der einzelnen Stücklistenkompenenten in einem Fertigungsauftrag, sofern es sich um ein in Kardex eingelagertes Produkt handelt (Profil: Auslagerung)

• Bestandsabgleich von Odoo -> Kardex

Die Import Dateien von PPG zu Odoo können nicht frei definiert werden und sind statisch von Kardex vorgegeben und definiert:

• den Quittungen (Auszug aus Software Pflichtenheft Confidential kardexremstar)

• den Bestandsabgleich von Kardex →  Odoo (Auszug aus Software Pflichtenheft Confidential kardexremstar)

Weitere Konfiguration

Lager|Konfiguration|Lagerorte

Bei der Installation wird ein neuer Lagerort erzeugt: „WH/Kardex" (manuelle Umbenennung möglich). Dieser dient für die Auslagerung an Kardex. Alle Produkte, die im Kardex gelagert werden, liegen für Odoo im internen Lagerort „WH/Kardex".
Im Lagerort „WH/Kardex" muss zwingend die Checkbox „Ist Kardex-Lagerort" gesetzt sein, damit dieser von Odoo als Kardex Lagerort betrachtet wird.

Lager|Bestandsverwaltung|Produkte

Jedes Produkt, das in Kardex eingelagert werden soll, muss entsprechend manuell angepasst werden. Dafür muss im Tab Lager der Einlagerungsort hinterlegt werden.

Vorgehen:

1. Produkt bearbeiten
2. Tab „Lager" wählen
3. Neuen Einlagerungsort definieren:
   • Einlagerungsstrategie: Standard-Lager
   • Standort: WH/Kardex (bzw. individueller Kardex-Lagerort)
4. Bestätigen

Damit ist das Standard-Lager dieses Produkts auf das Kardex-Lager umgestellt. Für die tatsächliche Umlagerung siehe Initiale Umlagerung in Kardex Shuttle XP.

Lager|Konfiguration|Routen

Um die korrekten Lagerbewegungen zu gewährleisten sind über die Installation Routen hinzugefügt und entsprechend angepasst worden.
Bitte passen Sie die Routen nur an, wenn Sie mit der Thematik Routen vertraut sind.

Initiale Umlagerung in Kardex Shuttle XP

Für die initiale Umlagerung der Artikel aus dem physischen Lagerort in das Shuttle XP empfehlen wir die Umlagerung über interne Lieferscheine (Standard Odoo-Funktionalität).
Um Produkte initial in Kardex anzulegen, müssen zusätzlich Parameter bei der CSV-Datei mitgeliefert werden (siehe 'Einlagerung' unter Profile). Somit werden die Produkte, sofern diese in Kardex noch nicht vorhanden sind, in Kardex auch angelegt, ohne dass im Odoo-System extra dafür eine Funktionalität bereitgestellt werden muss.
Über einen internen Lieferschein können einzelne Produkte aus dem bisherigen Lagerort auf das Kardex-Lager transferiert werden. Nach der Bestätigung des Lieferscheins erzeugt Odoo eine entsprechende CSV-Datei und legt diese in der Spooltabelle ab. Nachdem diese in der Software PPG verarbeitet wurde, sind die entsprechenden Artikel im Kardex eingelagert (manuelle Bestätigung im PPG notwendig).

Funktionsweise

Standardprozess (ohne Fertigung)

Grundsätzlich ist der Grad der Automatisierung der Kardex-Erweiterung sehr hoch. Bei allen Vorgängen, die das Regalsystem Shuttle XP betreffen, werden die benötigten Informationen automatisch erzeugt bzw. die Rückmeldungen über einen Odoo Cronjob automatisch verarbeitet.
Zusätzlich wird am jeweiligen Vorgang in der Timeline ein Verweis auf den entsprechenden Eintrag in der Vorgangstabelle (Spooltabelle) erzeugt, damit der Austausch ggf. nachvollzogen werden kann.
Folgende Vorgänge werden durch das Kardex-Modul erweitert:

• Ausgehende Lieferungen
• Eingehende Lieferungen
• Interne Lieferungen
• Inventur

Interne Lieferungen

Wird in Odoo eine interne Lieferung erzeugt, entscheiden die angegebenen Lagerorte in der Übergeberzone bzw. Zielzone über eine Einlagerung (Zielzone: WH/Kardex) oder über eine Auslagerung (Übergeberzone: WH/Kardex).
Somit ist auch gewährleistet, dass manuell erstellte Ein- und Auslagerung in bzw. aus Kardex getätigt werden können (siehe Kapitel 'Initiale Umlagerung in Kardex Shuttle XP'), ohne zum Beispiel einen Verkaufsauftrag oder Bestellung.
Hat nun diese interne Lieferung den Status 'Verfügbar', so kann diese bestätigt werden. Odoo erzeugt jetzt eine CSV-Datei, welche in die Vorgangstabelle (Spooltabelle) abgelegt wird. Diese CSV-Datei wird vom Windows Service abgeholt, in das in der zugehörigen Instanz hinterlegte Verzeichnis abgelegt und schließlich von der PPG abgeholt. Durch die manuelle Bestätigung im PPG, erzeugt die PPG wiederum eine Quittung (siehe 4.4 Buchungen (PPG an Host)), welche vom Windows Service abgeholt, in die Odoo Spooltabelle abgelegt und durch Odoo verarbeitet wird.
Stimmt die Menge der Quittung (bestätigte Menge in Kardex) nicht mit der Menge der internen Lieferung überein, so wird eine Korrekturbuchung anhand einer Inventur getätigt.
Hat die interne Lieferung nicht den Status 'Verfügbar', so wird die normale Beschaffungslogik von Odoo inklusive die beim Produkt hinterlegte Einlagerungsstrategie angewandt.

Ausgehende Lieferungen

Wird ein Angebot erstellt, welches in den Positionen ein in Kardex eingelagertes Produkt enthält (siehe Rubrik Lager|Bestandsverwaltung|Produkte), so wird nach der Bestätigung des Angebots zu einem Verkaufsauftrag, sowohl der ausgehende Lieferschein (Standard-Odoo Funktionalität) als auch eine interne Lieferung (erweiterte Odoo Funktionalität) angelegt.


Ist kein in Kardex eingelagerte Produkt auf Positionsebene vorhanden, so greift nur die Standard-Odoo Funktionalität ohne weitere interne Lieferung.
Der ausgehende Lieferschein hat solange den Status 'Wartet auf anderen Vorgang' bis diese 'Interne Lieferung' abgearbeitet wurde. Wurde diese interne Lieferung abgearbeitet (siehe Rubrik 'Interne Lieferung'), kommt wieder die Standard Odoo Funktionalität zur Anwendung.

Eingehende Lieferungen

Wird eine Angebotsanfrage manuell oder durch den Beschaffungsprozess von Odoo erstellt, so wird nach der Bestätigung der Angebotsanfrage zur Bestellung die Standard-Odoo Funktionalität angewandt.


Lediglich das Lager 'Bis' wird auf Zeilenebene im Tab 'Vorgänge' entsprechend der Einlagerungsstrategie gesetzt. Ist bei einem Produkt als Einlagerungsstrategieort 'WH/Kardex' (siehe Rubrik Lager|Bestandsverwaltung|Produkte) ausgewählt, so wird hier das Lager 'WH/Kardex' gesetzt.

Fertigungsprozess (eq_kardex_mrp/eq_kardex_mrp_csv)

Die grundsätzliche Funktionsweise wird durch die Zusatzmodule eq_kardex_mrp sowie eq_kardex_mrp_csv auf die Fertigung erweitert. Somit können auch Stücklisten-Artikel eines Fertigungsauftrags ausgelagert bzw. gefertigte Produkte eines Fertigungsauftrags im Regalsystem eingelagert werden.
Bei einem Klick auf 'Verfügbarkeit prüfen' innerhalb eines Fertigungsauftrags (Standard-Odoo Funktionalität) wird überprüft, ob alle Produkte auf Lager sind. Ist eine Unterkomponente als Kardex Produkt gekennzeichnet (siehe Rubrik Lager|Bestandsverwaltung|Produkte) wird auch hier die Verfügbarkeit überprüft. Odoo erstellt nun eine 'Interne Lieferung' und prüft auch hierbei die Verfügbarkeit (Standard-Odoo Funktionalität).



Sollte das in Kardex eingelagerte Produkt auf Lage r sein, so wird diese interne Lieferung mit dem Status 'Verfügbar' gekennzeichnet und kann anschließend manuell bestätigt werden.

Anschließend wird die in Kapitel 'Funktionsweise Standardprozess (ohne Fertigung)' beschriebene Abarbeitung der internen Lieferung durchgeführt (siehe 'Interne Lieferung').
Jetzt ist die Auslagerung der Unterkomponente beendet und die interne Lieferung wird auf 'Erledigt' gesetzt.
Sollte das in Kardex eingelagerte Produkt nicht verfügbar sein, so kommt wiederum der Odoo Standardprozess inklusive Beschaffung zum Einsatz, bis das in Kardex eingelagerte Produkt verfügbar ist und die interne Lieferung bestätigt werden kann.