# Konfiguration XML-Auswertung

<p class="callout info">Ab Version 2.13 verfügbar und nach Freischaltung durch Partner oder Dexpro !</p>

Standardmäßig liefert Squeeze eine Vielzahl von vordefinierten Mappings zur Extraktion von Kopfdaten aus Rechnungen. Um die bestmögliche Datenerfassung zu gewährleisten, können Sie diese Mappings individuell anpassen und erweitern. Diese Seite bietet eine Anleitung zur Konfiguration von Kopfdaten/Positionsdaten-Mappings im XML-Format.

In der Administration finden Sie einen neuen Unterpunkt (**ZUGFeRD und XRechnung**):

[![image-1729690323813.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729690323813.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729690323813.png)

- - - - - -

2\. Sobald Sie den Menüpunkt gewählt haben, kommen Sie in eine tabellarische Übersicht. Auf dieser sollten Sie bereits einige Einträge sehen, die sie nicht bearbeiten können, denn dabei handelt es sich um die Standard-Auswertungen; beschrieben in: [XRechnung und ZUGFeRD Auswertungstabellen](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/xrechnung-und-zugferd-auswertungstabellen "XRechnung und ZUGFeRD Auswertungstabellen"):

[![image-1729692901242.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729692901242.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729692901242.png)

- - - - - -

**Priorisierung der Mappings**

Die Reihenfolge der Mappings spielt eine wichtige Rolle bei der Auswertung der Kopffelder. Squeeze verwendet ein hierarchisches System, um zu bestimmen, welches Mapping für ein bestimmtes Feld verwendet werden soll.

**Hierarchie:**

1. **Spezifische Mappings:** Mappings, die für einen bestimmten Mandanten, Kreditor und eine Dokumentenklasse definiert sind, haben die höchste Priorität.
2. **Mandanten- und Kreditor-spezifische Mappings:** Sind keine spezifischen Mappings vorhanden, werden Mappings verwendet, die für einen Mandanten und Kreditor definiert sind, unabhängig von der Dokumentenklasse.
3. **Allgemeine Mappings:** Danach folgen Mappings, die nur für die Dokumentenklasse definiert sind, unabhängig von Mandant und Kreditor.
4. **Standard Mappings:** Mappings, die für alle Mandanten, Kreditoren und Dokumentenklassen gelten (Auslieferungszustand), haben die niedrigste Priorität.

Siehe:

<table id="bkmrk-prio-mandant-kredito" style="width: 585px; height: 306px;"><tbody><tr style="height: 53px;"><td style="width: 55px; height: 35px;">**Prio**

</td><td style="width: 104px; height: 35px;">**Mandant**

</td><td style="width: 100px; height: 35px;">**Kreditor**

</td><td style="width: 153px; height: 35px;">**Dokumentenklasse**

</td><td style="width: 173px; height: 35px;">**System-Konfiguration**

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">1

</td><td style="width: 104px; height: 34px;">definiert

</td><td style="width: 100px; height: 34px;">definiert

</td><td style="width: 153px; height: 34px;">definiert

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">2

</td><td style="width: 104px; height: 34px;">definiert

</td><td style="width: 100px; height: 34px;">definiert

</td><td style="width: 153px; height: 34px;">\*

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">3

</td><td style="width: 104px; height: 34px;">\*

</td><td style="width: 100px; height: 34px;">definiert

</td><td style="width: 153px; height: 34px;">definiert

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">4

</td><td style="width: 104px; height: 34px;">\*

</td><td style="width: 100px; height: 34px;">definiert

</td><td style="width: 153px; height: 34px;">\*

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">5

</td><td style="width: 104px; height: 34px;">definiert

</td><td style="width: 100px; height: 34px;">\*

</td><td style="width: 153px; height: 34px;">definiert

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">6

</td><td style="width: 104px; height: 34px;">\*

</td><td style="width: 100px; height: 34px;">\*

</td><td style="width: 153px; height: 34px;">definiert

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 34px;"><td style="width: 55px; height: 34px;">7

</td><td style="width: 104px; height: 34px;">definiert

</td><td style="width: 100px; height: 34px;">\*

</td><td style="width: 153px; height: 34px;">\*

</td><td style="width: 173px; height: 34px;">false vor true

</td></tr><tr style="height: 33px;"><td style="width: 55px; height: 33px;">8

</td><td style="width: 104px; height: 33px;">\*

</td><td style="width: 100px; height: 33px;">\*

</td><td style="width: 153px; height: 33px;">\*

</td><td style="width: 173px; height: 33px;">false vor true

</td></tr></tbody></table>

- - - - - -

**Anlage neuer Mappings für Kopffelder**

Im Tab **Kopffelder** können Sie neue Mappings anlegen. Dabei wählen Sie die Filterkriterien wie gewünscht.   
Beachten Sie dabei, solange keine Dokumentenklasse gewählt wurde, werden ihnen unter **Feldname** alle Felder aller verfügbaren Dokumentenklassen aufgelistet.

[![image-1729696517595.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729696517595.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729696517595.png)

- - - - - -

**Anlage neuer Mappings für Positionsfelder**

Im Tab **Positionen** können Sie neue Mappings anlegen, dabei wählen Sie die Filterkriterien wie gewünscht.   
Beachten Sie dabei, solange keine Dokumentenklasse gewählt wurde werden ihnen unter **Spaltenname** alle Spalten der verfügbaren <span style="text-decoration: underline;">("LineItems-Tabellen")</span> Dokumentenklassen angezeigt.

**Wichtig:** Es werden nur Spalten aus Dokumentenklassen angezeigt, deren technischer Tabellenname "LineItems" ist.

[![image-1729696997227.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729696997227.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729696997227.png)

<p class="callout danger">Bei der der Ermittlung der Spalten werden die konfigurierten Xpath-Ausdrücke mit folgendem Tabellenknotenpunkt ausgewertet: `/xr:invoice/xr:INVOICE_LINE`.  
Das hat zur folge, dass sie nur Kindelemente des Tabellenknotenpunktes `/xr:invoice/xr:INVOICE_LINE` zur Auswertung der Spalten verwenden dürfen.  
  
<span style="text-decoration: underline;">**Beispiel**:</span>   
Tabellenknotenpunkt-Xpath: `/xr:invoice/xr:INVOICE_LINE`  
  
Spalten-Xpath-Ausdruck: `xr:PRICE_DETAILS[1]/xr:Item_net_price[1]/text()`  
  
Daher achten Sie darauf bei den Spalten-Xpath-Audrücken **kein** "`/`" am Anfang zu setzen. </p>

- - - - - -

**Allgemeine Infos**

<p class="callout warning">Kontrollieren Sie ihren eingegeben XPath auf einer geeigneten Seite wie zum Beispiel:  
[http://xpather.com/](http://xpather.com/)</p>

<p class="callout warning">Die Auswertung der Xpaths erfolgt auf dem intermediate.xml . Die XML-Datei kann durch ein Download der Anhänge aus der technischen Warteschlange gewonnen werden.</p>