Auslesen von eRechnungen (TSO.ReadXMLMetadata)

Die Vault App ermöglicht das automatische Auslesen von Daten aus E-Rechnungen und das Einfügen dieser in die Metadaten von Rechnungsdokumenten. Über ein Konfigurationstemplate können gängige XML-Formate und Mappings schnell eingerichtet werden. Die App bietet Funktionen zur Extraktion von Belegzeilen und zur Erstellung von Zeilenobjekten, die mit dem Rechnungsdokument verknüpft werden. Zudem kann durch die Objektsuche ein bestehendes Objekt anhand des ausgelesenen XML-Wertes zugeordnet werden. Eine Validierungsfunktion prüft, ob die angegebenen XML-Pfade korrekt sind oder mögliche Fehler beinhalten.

• Automatisches Auslesen von Kopf- und Zeileninformationen
• Unterstützung der beiden in Deutschland vorausgesetzten Formate UBL und UN/CEFACT bzw. CII
• Flexible Anpassungsmöglichkeiten der Mapping-Konfiguration

Konfigurationsanleitung

• Active - schaltet die App-Funktionalität ein/aus
• Logging Configuration - schaltet den Event-Log für Fehlermeldungen ein/aus
• Format and Mappings - zur Konfiguration und Anlage von Mappings je Format
  • Format - zur Auswahl des Formats, für welches ein Mapping vorgenommen wird
  • Type - gibt den Dokumententyp (Invoice oder Credit Note) an
  • Namespaces - Liste der XML-Namespaces für das gewählte Format
    • Prefix - der Präfix des XML-Namespaces
    • URI - der URI des XML-Namespaces
  • General Mappings - zur Anlage von konkreten Mappings
    • Description - gibt eine Beschreibung des Mappings an und wird in dessen Namen übernommen
    • Business Term - der offizielle Name des XML-Nodes am angegebenen XML-Pfad
    • Property - die Eigenschaft, die mit einem Wert gefüllt werden soll
    • XML Path - der Pfad, an dem der auszulesende Wert gefunden werden soll
    • Enable object search - aktiviert/deaktiviert die Suche nach einem Objekt im Vault zur Referenz (s.u.)
  • Enable Invoice Line (Obj.) creation - aktiviert/deaktiviert das Erstellen von Zeilenobjekten (s.u.)

Allgemein

Mapping

Konfiguration der Objektsuche

• Object to search for - gibt die Klasse des Objektes an, in der gesucht werden soll
• Property to compare - gibt die Eigenschaft auf dem Suchobjekt an, welche den ausgelesenen Wert enthalten soll

Konfiguration der Zeilenobjekt-Erstellung

• Object to create - zur Auswahl der Objektklasse, in der die Zeilenobjekte erstellt werden sollen
• Lookup Property on Invoice - gibt die Eigenschaft (als Lookup) auf dem Rechnungsdokument an, zu der die Zeilenobjekte hinzugefügt werden sollen
• XML Path - XML Pfad zu den Rechnungszeilen im XML-Format
• Invoice Line Mapping - Konfiguration des Mappings (analog zum Rechnungsobjekt Mapping)

Konfigurationsvalidierung

In M-Files Admin im Dashboard der Vault-App ist für jedes eingerichtete Format mit Mappings eine Tabelle zu sehen, welche für jedes Mapping den angegeben XML-Pfad gegen ein allgemeingültiges Template prüft und Hinweise gibt, ob der Pfad valide ist oder nicht. Dabei gibt es drei verschiedene Status:

• Valid – Der XML-Pfad wurde korrekt angegeben und es kann ein Wert zurückgeliefert werden
• Possibly wrong – Der XML-Pfad wurde nicht im Template gefunden, kann aber dennoch gültig sein (z.B. Erweiterung des Standards)
• Invalid – Der XML-Pfad ist syntaktisch falsch

Systemanforderungen

Zur vollständigen Funktionalität der Vault-App ist die aktuellste M-Files-Version erforderlich.