Modulüberblick

Dieses Modul ist für die tägliche Zusammenarbeit mit dem Profi-EDI-System von Hüngsberg ausgelegt: Es liefert die Funktionalität, um verschiedenste EDI-Prozesse aus den Branchen Handel und Automotive direkt in ihrem ERP-System abzubilden und zu verarbeiten.

Nach der Installation finden Sie den Bereich Hüngsberg EDI mit Dashboard, Importliste, API-Log und Einstellungen direkt in Odoo. Die Implementierung ist so aufgebaut, dass Probleme zwischen Odoo und Hüngsberg schnell lokalisiert und sauber nachbearbeitet werden können.

Funktionsumfang

• ORDERS-Import aus Hüngsberg: Das externe EDI-System Hüngsberg sendet XML an den dedizierten Odoo-Endpunkt, aus dem automatisch ein Importdatensatz erzeugt wird.
• Validierung in Odoo: Das Modul prüft GLN-Zuordnungen, Partner, Zahlungsbedingungen, Produktreferenzen, Mengen und Preisabweichungen.
• Geführte Nachbearbeitung: Fehlende Partner oder Produkte können direkt aus dem Import heraus angelegt oder zugeordnet werden, bevor der Verkaufsauftrag erstellt wird.
• Auftragserstellung: Nach erfolgreicher Validierung wird der Verkaufsauftrag automatisch oder manuell aus dem Import erzeugt.
• ORDRSP an Hüngsberg: Auftragsantworten und Statusänderungen werden per Outbound-Call an Hüngsberg zurückgesendet.
• Technische Nachvollziehbarkeit: Dashboard, Importprotokolle und API-Traffic-Logs dokumentieren Inbound und Outbound vollständig.

Voraussetzungen

• Odoo 19: Das Modul setzt eine Odoo-19-Installation voraus.
• Abhängigkeiten: Benötigt werden Sales, Mail und account_add_gln.
• Partnerstammdaten: Relevante Geschäftspartner sind mit gültiger GLN gepflegt.
• Produktstammdaten: Produkte und externe Artikelzuordnungen sind vorbereitet.
• Abstimmung mit Hüngsberg: Endpunkt, Zugangsdaten und Rückkanal (ORDRSP) sind mit Hüngsberg abgestimmt.

Konfiguration

Schritt 1: Zugriff und Rechte vorbereiten

Legen Sie fest, wer den laufenden EDI-Betrieb betreut. Operative Anwender benötigen Zugriff auf Dashboard, Imports und API-Traffic. Für die technische Einrichtung (API-Key, Callback-Ziele, Automatik-Verhalten) wird eine Administrator-Rolle benötigt.

Prüfen Sie vor dem Go-live die GLN des eigenen Unternehmens sowie die Partnerdaten, damit eingehende ORDERS aus Hüngsberg ohne manuelle Korrektur verarbeitet werden können.

Schritt 2: Inbound API einrichten

Hüngsberg sendet ORDERS als XML an den Inbound-Endpunkt in Odoo. Die Authentifizierung erfolgt über einen API-Key, den Sie im Bereich Hüngsberg EDI generieren und in Hüngsberg hinterlegen.

POST /huengsberg/edi/orders
Header: X-Api-Key: <ihr-api-key>
Content-Type: application/xml

Der API-Key wird nur bei der Erzeugung vollständig angezeigt. Dokumentieren Sie ihn sicher und übergeben Sie ihn an das Hüngsberg-Team für die Inbound-Konfiguration.

Schritt 3: Outbound-Callback konfigurieren

Für ORDRSP-Rückmeldungen benötigt Odoo die Ziel-URL von Hüngsberg sowie Benutzername und Passwort für HTTP Basic Authentication. Diese Felder werden in den Systemeinstellungen gepflegt.

Schritt 4: Verhalten und Validierung festlegen

Definieren Sie den Betriebsmodus für den Live-Betrieb mit Hüngsberg. Typisch sind automatische Auftragserstellung nach erfolgreicher Prüfung und automatisches ORDRSP beim Bestätigen des Auftrags.

Schritt 5: Stammdaten absichern

Für stabile Importe aus Hüngsberg sind vollständige Partner- und Produktzuordnungen entscheidend. So lassen sich Validierungsfehler und manuelle Nacharbeit deutlich reduzieren.

• GLN-Prüfung: Partner-GLNs werden auf 13 Stellen und gültige Prüfziffer geprüft.
• Partnerrollen: Käufer, Rechnungsempfänger und Lieferadresse werden getrennt aus dem ORDERS gelesen.
• Customer Product Codes: Externe Artikelnummern aus Hüngsberg werden Odoo-Produkten zugeordnet.

Fehlt ein Produkt, kann es direkt aus dem Prozess heraus angelegt werden, ohne den Importkontext zu verlassen.

Arbeitsablauf

Eingang von ORDERS aus Hüngsberg

Jede eingehende XML-Nachricht aus Hüngsberg erzeugt einen Importdatensatz. Darin werden Kopf- und Positionsdaten, Referenzen, Lieferinformationen und die Rohpayload gespeichert.

Prüfung und Nachbearbeitung

In der Importliste filtern Sie gezielt nach Vorgängen mit Handlungsbedarf und öffnen die betroffenen Datensätze für die Nachbearbeitung.

Im Import selbst zeigt die Validierung exakt, welche Daten aus Hüngsberg noch korrigiert oder ergänzt werden müssen, bevor ein Auftrag erzeugt werden kann.

Erstellung des Verkaufsauftrags

Nach erfolgreicher Validierung wird ein verknüpfter Verkaufsauftrag erstellt. Anschließend bleibt der Import als technische Dokumentation erhalten und ist nicht mehr frei veränderbar.

Rückmeldung an Hüngsberg

Die ORDRSP-Rückmeldung wird an Hüngsberg gesendet. Erfolgs- und Fehlerstatus werden am Import und am Auftrag protokolliert, damit jede Nachricht in beide Richtungen nachvollziehbar bleibt.

Monitoring und Fehleranalyse

Für den Betrieb zwischen Odoo und Hüngsberg sind vor allem Dashboard, Importliste und API-Traffic relevant:

• Dashboard: Überblick über Importmengen, Status und Verlauf.
• Imports: Arbeitsliste zur operativen Nachbearbeitung.
• API Traffic: Vollständiges Request/Response-Logging für Inbound und Outbound.

Im API-Log sehen Sie zuerst die Liste der Aufrufe und wechseln dann in den Detaildatensatz eines Vorgangs.

Bei Fehlern bleiben Header, Payload, Antwort und HTTP-Status gespeichert. Zusätzlich versucht ein Hintergrundjob fehlgeschlagene Outbound-Callbacks in Intervallen erneut.

Technische Details