Beschreibung
Die Schnittstelle Birner dient dem Import von Eingangslieferscheinen aus Birner-XML-Dateien (*.xml, DeliveryNote-Format) in das ERP.
Einsatz im Prozess:
• Einlesen von Lieferavis-/Lieferscheindaten aus Dateiverzeichnissen
• Zuordnung zur bestehenden Bestellung
• Erzeugung von Eingangslieferschein-Kopf und -Positionen
• Aktualisierung der gelieferten Mengen in den Bestellpositionen
• Optional technische Freigabe (TFG)
• Verschieben verarbeiteter Dateien in Erfolgs-/Fehlerverzeichnis
• Erzeugung eines Statusreports inkl. Mailversand
Konfiguration
Allgemeine Einstellungen (BirnerSettings)
|
Einstellung |
Bedeutung |
|---|---|
|
ImportDirectory |
Importpfad (im aktuellen Code für Autostart nicht aktiv verwendet) |
|
SuccessDirectory |
Zielordner für erfolgreich importierte Dateien |
|
ErrorDirectory |
Zielordner für fehlerhafte Dateien |
|
TechnicalApprovalType |
Technische Freigabe nach Import ( |
|
DirectDbConnect |
Import direkt über DB oder über Webservice |
|
MoveFileWithTimestamp |
Dateiverschiebung mit Zeitstempel im Dateinamen |
Autostart-/Parameter-Konfiguration
Für den Lauf werden aktiv folgende Parameter verwendet:
-
WatchFolders=<Pfad1;Pfad2;...>– wird inGetFiles()ausgewertet; es werden*.xml-Dateien gelesen. -
DirectDbConnect(Switch) – überschreibt den Laufmodus DB/Webservice.
Wichtig: Ohne WatchFolders werden keine Dateien verarbeitet.
Importablauf
-
Start via Autostart()
-
Dateisuche aus WatchFolders (*.xml)
-
Je Datei:
• Inhalt laden
• Modus wählen:
• Direct DB: Ermittlung passender Edifact-Implementierung (IdentifyContent), dann Import
• Webservice: Aufruf ImportPurchaseDeliveryNotes
• Ergebnis protokollieren
• Datei nach SuccessDirectory oder ErrorDirectory verschieben -
Statusreport + optional Mailversand
Aktiv verwendete Felder (mit Beschreibung)
Aktiv verwendete Import-Felder (XML)
|
XML-Feld |
Verwendung |
|---|---|
|
DeliveryNote.DeliveryNoteNumber |
Externe Lieferscheinnummer |
|
DeliveryNote.DeliveryNoteDate |
Externes Lieferscheindatum |
|
DeliveryNote.ItemList.Item[].OrderReference.OrderID |
Zentrale Bestellreferenz zur Ermittlung der ERP-Bestellung |
|
DeliveryNote.ItemList.Item[].ArticleNumber |
Lieferantenartikelnummer für Artikel-/Bestellpositionszuordnung |
|
DeliveryNote.ItemList.Item[].ManufacturerNumber |
Herstellerartikelnummer in Positionsdaten |
|
DeliveryNote.ItemList.Item[].Description |
Positionsbezeichnung |
|
DeliveryNote.ItemList.Item[].Quantity.Text |
Gelieferte Menge |
|
DeliveryNote.ItemList.Item[].Quantity.Unit |
Mengeneinheit |
|
DeliveryNote.ItemList.Item[].UnitPurchasePrice |
Einkaufspreis je Einheit |
Aktiv verwendete ERP-Felder/Objekte im Import
|
Feld/Objekt |
Verwendung |
|---|---|
|
Bestellung (GlobalHeadData) |
Quelle für Kopfdaten des Eingangslieferscheins |
|
SS_REFERENZ / ABNUMMER_LIEF / BESTELLNUMMER |
Suchreihenfolge zur Bestellnummerermittlung |
|
Bestellpositionen nach Artikel |
Zuordnung importierter Positionen |
|
BePosInx |
Verknüpfung Lieferscheinposition ↔ Bestellposition |
|
Gelieferte Menge je Position |
Update auf Bestellung (Erledigungslogik) |
|
BEPOS_KOND |
Basis zur Preis-/Konditionsberechnung |
|
Eingangslieferschein (ls_wareneingang) |
Datenbasis für nachgelagerte Workflow-Aktionen |