======Was brauche ich dazu?======
=====Import-Ordner=====
++++|
Die Rechnungsdaten werden aus XML-Dateien in iX-Haus importiert. Die Datenstruktur der XML-Datei ist im Abschnitt ''Datenstruktur für den Rechnungsimport'' beschrieben. Die XML-Dateien werden aus dem in der Systemeinstellung ''OrdnerImport'' definierten Ordner importiert. Standardmäßig werden die XML-Dateien aus dem Ordner ''data\KUNDENLIZENZ\import'' importiert, wobei die Kundenlizenz die iX-Haus-Lizenznummer ist. Nach dem Import werden die XML-Dateien in einen Unterordner verschoben. Per Systemeinstellung kann ein Ordner für erfolgreich importierte und fehlerhafte Rechnungen definiert werden (s. Systemeinstellungen, Systemeinstellung ''OrdnerErfolg'' und ''OrdnerFehler''). Standardmäßig werden erfolgreich importierte und fehlerhafte Rechnungen in den Unterordner ''feedback'' verschoben.
++++

=====Mapping Optionen=====
++++|
In der Buchungsimportdatei können Objektnummern und Kreditorennummer aus Fremdsystemen über Mappings auf die iX-Haus-Nummern übersetzt werden. 

Der Mehrwertsteuer-Code wird immer aus der Spalte ''MwSt.-Code Fremdsystem (Import)'' der jeweiligen MwSt.-Tabelle in iX-Haus ermittelt. Es wird immer ein Fremdsystem MwSt.-Code erwartet.

Das Mapping von Fremdsystem Objektnummer erfolgt über den Objektbeschrieb in der [[stammdaten:objektauswahl:start|Objektauswahl]]. Dafür wird der Objektbeschrieb um ein zusätzliches Feld für die Fremdsystem-Objektnummer erweitert, wo die Fremdsystem-Objektnummer für jedes Objekt eingetragen wird (s. [[fachadministration:beschriebeditor:start|Beschriebeditor]]). Das Beschriebfeld wird zusätzlich über Systemeinstellung für den Buchungsimport festgelegt:

^Bereich^Abschnitt^Name^Info^
|Schnittstelle|Buchungsimport|''FremdeObjektNrVariable''|Das Objektnummer-Mapping kann für die Hauptbuchungskreisnummer und die Objektnummer verwendet werden. Beide Felder können separat voneinander übersetzt werden, allerdings muss für das Kontierungsobjekt für alle Kontierungen die gleiche Logik verwendet werden; entweder wird bei allen Kontierungen die iX-Haus-Objektnummer eingegeben oder die Fremdsystem-Nummer. Die Eingabe von Hauptbuchungskreisnummer kann bei beiden Varianten aus dem Objekt der ersten Kontierung vom Import automatisch ermittelt werden.|

Das Mapping von Kreditorennummer erfolgt über das Feld Fremdsystem-Nr im Kreditoren/Debitoren Stamm, wo die Fremdsystemnummer des jeweiligen Kreditors/Debitors eingetragen wird. Das Feld Fremdsystem-Nr wird über Systemeinstellung eingeschaltet:

^Bereich^Abschnitt^Name^
|Kreditor|Allgemein|''FremdsystemNr''|

Zusätzlich kann das Feld Fremdsystem-Nr per Systemeinstellung als Pflichtfeld definieren werden:

^Bereich^Abschnitt^Name^
|Kreditor|Allgemein|''FremdsystemNrPflicht''|
++++

=====Historisierung=====
++++|
Die durchgeführten Importe werden in einer Historie angezeigt. Je Eintrag kann per rechter Maustaste das Protokoll aus der Datenbank aufgerufen werden. <wrap tip>Leerläufe werden nicht in der Datenbank gespeichert.</wrap>

Die Historie wird in der Maske Rechnungsimport angezeigt.

In Historie wird angezeigt:
  * Importzeit
  * Benutzer, der Import durchgeführt hat
  * Anzahl der importierten Rechnungen. Es sind die Rechnungen, die ohne Fehler importiert wurden.
  * Anzahl der fehlerhaften Rechnungen. Es sind die Rechnungen, die mit Fehler importiert wurden.
++++


===== Datenstruktur für den Rechnungsimport =====
++++|
Die Daten für den Rechnungsimport werden in Form einer XML-Datei für iX-Haus bereitgestellt. Die Daten der zu importierenden Rechnungen werden in einzelne „rechnung“-XML Elemente eingegeben wie in der folgenden Basisstruktur:

<?xml version='1.0' encoding='ISO-8859-1'?>\\ 
<rechnung>\\ 
… Rechnungsdaten\\ 
</rechnung>\\ 
<rechnung>\\ 
… Rechnungsdaten\\ 
</rechnung>\\ 
… weitere Rechnungen\\ 
<rechnung>\\ 
… Rechnungsdaten\\ 
</rechnung>\\ 

Die einzelnen Rechnungen werden so dargestellt:
<WRAP>
++++|
<code>
<rechnung>
  <gvc></gvc>
  <ixhaususerid></ixhaususerid>
  <rechnungseingangsbuch></rechnungseingangsbuch>
  <internerechnungsnummer></internerechnungsnummer>
  <rebustatus></rebustatus>
  <rebustatusinfo></rebustatusinfo>
  <typ></typ>
  <rechnungsinfo></rechnungsinfo>
  <bukreis></bukreis>
  <bukreisfremdsystem></bukreisfremdsystem>
  <wirtschaftsjahr></wirtschaftsjahr>
  <kreditornr></kreditornr>
  <kreditornrfremdsystem></kreditornrfremdsystem>
  <kreditoriban></kreditoriban>
  <gegenkonto></gegenkonto>
  <auftrag>
    <nummer></nummer>
    <rechnungstyp></rechnungstyp>
  </auftrag>
  <rechnungsnummer></rechnungsnummer>
  <rechnungsdatum></rechnungsdatum>
  <wertstellungsdatum></wertstellungsdatum>
  <wdatumhochsetzen></wdatumhochsetzen>
  <faelligkeitsdatum></faelligkeitsdatum>
  <lzvon></lzvon>
  <lzbis></lzbis>
  <beleg></beleg>
  <belegeindeutigpruefen></belegeindeutigpruefen>
  <kundennummer></kundennummer>
  <buchungstext></buchungstext>
  <gesamtbetrag></gesamtbetrag>
  <sicherheitseinbehaltprozent></sicherheitseinbehaltprozent>
  <sicherheitseinbehaltbetrag></sicherheitseinbehaltbetrag>
  <sicherheitseinbehaltistversteuerung></sicherheitseinbehaltistversteuerung>
  <sicherheitseinbehaltfaelligkeit></sicherheitseinbehaltfaelligkeit>
  <kuerzungen>
	<kuerzung>
		<Grund> </Grund>
		<BruttoBetrag></BruttoBetrag>
	</kuerzung>
  </kuerzungen>
  <skonto>
    <methode></methode>
    <tage1></tage1>
    <satz1></satz1>
    <tage2></tage2>
    <satz2></satz2>
    <tage3></tage3>
    <satz3></satz3>
  </skonto>
  <dcl></dcl>
  <flag15a></flag15a>
  <par13b></par13b>
  <zre-id></zre-id>
  <wkzgueltigab></wkzgueltigab>
  <wkzgueltigbis></wkzgueltigbis>
  <wiederholungsoptionen>
    <wiederholungsoption>
      <wdattagmonat></wdattagmonat>
      <fdattagmonat></fdattagmonat>
      <lzvontagmonat></lzvontagmonat>
      <lzbistagmonat></lzbistagmonat>
    </wiederholungsoption>
  </wiederholungsoptionen>
  <ectexte>
    <ecstdtext></ecstdtext>
    <ecstdtext></ecstdtext>
    <eczustext></eczustext>
    <eczustext></eczustext>
    <eczustext></eczustext>
    <eczustext></eczustext>
  </ectexte>
  <kontierungen>
    <kontierung>
      <objekt></objekt>
      <konto></konto>
      <kontotyp></kontotyp>
      <alleanlagenkonten></alleanlagenkonten>
      <betrag>
        <wert></wert>
        <typ></typ>
      </betrag>
      <mwstcode></mwstcode>
      <hndl></hndl>
      <text></text>
      <lzvon></lzvon>
      <lzbis></lzbis>
      <aposnr></aposnr>
      <projekt></projekt>
      <koststelle></koststelle>
      <kosttraeger></kosttraeger>
      <ahkostenabgang></ahkostenabgang>
      <mieternr></mieternr>
      <flaechenr></flaechenr>
      <vertragsbeginn></vertragsbeginn>
      <mieterweiterbelastungtext></mieterweiterbelastungtext>
      <flbelid></flbelid>
      <ihbartnr></ihbartnr>
    </kontierung>
    … weitere Kontierungen
  </kontierungen>
  <import>
    <status></status>
    <fehlerbeschreibung></fehlerbeschreibung>
    <hinweis></hinweis>
    <bukreis></bukreis>
    <wirtschaftsjahr></wirtschaftsjahr>
    <buchungsnummer></buchungsnummer>
    <wertstellungsdatum></wertstellungsdatum>
  </import>
</rechnung>
</code>
++++
</WRAP>

=====Beschreibung der einzelnen Datenfelder aus der XML-Struktur=====
====XML-Elemente rechnung====
Beschreibung der einzelnen XML-Elemente, die im XML-Element „rechnung“ enthalten sind.

|XML-Element|Pflicht|Datentyp|Werte|Beschreibung|
|gvc|Ja|Zahl|701, 706, 709|GVC Code:\\ 701 – Rechnungseingang\\ 706 – Gutschrift\\ 709 – Rechnungsausgang|
|ixhaususerid|Nein|Zahl| |Hiermit kann die iX-Haus Benutzer-Id übergeben werden des Benutzers, der die Rechnung importiert bzw. im Fremdsystem erfasst hat. Wenn das Feld leer ist, wird die Rechnung mit dem aktuellen iX-Haus Benutzer (wenn der Import aus iX-Haus gestartet wird) oder mit dem in der Batch-Datei definierten Benutzer-Id importiert.|
|rechnungseingangsbuch|Nein|Ja/Nein|''Ja''\\ ''Nein''|Definiert, ob die Rechnung in die Dialogbuchhaltung oder in das Rechnungseingangsbuch importiert wird. \\ Ja => Die Rechnung wird in das Rechnungseingangsbuch importiert.\\ Nein oder Leer => Die Rechnung in die Dialogbuchhaltung importiert.|
|internerechnungsnummer|Nein|Text| |Interne Rechnungsnummer für das Rechnungseingangsbuch. Diese Nummer wird bei der Rechnungserfassung im Rechnungseingangsbuch vergeben. Sie muss bei Aktualisierung der Rechnung angegeben werden, damit die Rechnung eindeutig identifiziert wird. Bei Neuanlage muss das Feld leer bleiben. Sobald die Rechnung verbucht ist, ist eine Aktualisierung nicht mehr möglich und wird abgelehnt.|
|rebustatus|Nein|Text|''Vorerfasst\\ Fachlich freigegeben\\ Fachlich bestätigt\\ Gelöscht\\ Abgelehnt\\ Verbucht\\ WKZ angelegt''|Gibt den Rechnungseingangsbuch Status vor. Folgende Werte sind möglich:\\ „Vorerfasst“, „Fachlich freigegeben“, „Fachlich bestätigt“, „Gelöscht“, „Fachlich abgelehnt“, „Verbucht“, „WKZ angelegt“.|
|rebustatusinfo|Nein|Text| |Statusinfo für den angegebenen rebustatus. Die Information wird im Rechnungseingangsbuch im Reiter Status und auch im Grid angezeigt, wo es danach gefiltert werden kann.|
|typ|Nein|Rechnung/wiederkehrende Zahlung|''Rechnung\\ wiederkehrende Zahlung''|<WRAP>
  * Dieses Feld wird nur bei Import in das Rechnungseingangsbuch ausgewertet (siehe Beschreibung für das Feld Rechnungseingangsbuch)
  * Definiert, ob eine Rechnung oder wiederkehrende Zahlung importiert wird.
  * Rechnung oder leer => Es wird eine Rechnung wird in das Rechnungseingangsbuch importiert.
  * wiederkehrende Zahlung => Es wird eine wiederkehrende Zahlung in das Rechnungseingangsbuch importiert.
</WRAP>|
|''rechnungsinfo''|Nein|Text| |Rechnungsinfo im Rechnungseingangsbuch. Bei Aktualisierung einer Rechnung wird der Kommentar angehängt, so dass die bisherige Information erhalten bleibt.|
|''bukreis''|Nein|Ganzzahl| |Die Objektnummer des Hauptbuchungskreises. Falls nicht angegeben, wird automatisch die FiBu-Nummer des Objekts aus der ersten Kontierung ermittelt. Das Objekt muss als Hauptbuchungskreis in iX-Haus vorhanden sein.|
|''bukreisfremdsystem''|Nein|Text| |Die Fremdsystem Objektnummer des Hauptbuchungskreises. Falls nicht angegeben, wird automatisch die FiBu-Nummer des Objekts aus der ersten Kontierung ermittelt. Die Übersetzung der Objektnummer aus einem Fremdsystem ist im Abschnitt Mapping Optionen beschrieben.|
|''wirtschaftsjahr''|Nein|Ganzzahl| |Geschäftsjahr in iX-Haus. Falls nicht angegeben, wird das Geschäftsjahr aus dem eingegebenen Wertstellungsdatum ermittelt.|
|''kreditornr''|s. Beschreibung|Ganzzahl| |Kreditornummer in iX-Haus|
|''kreditornrfremdsystem''|s. Beschreibung|Text| |Kreditornummer Fremdsystem. Die Übersetzung der Kreditornummer aus einem Fremdsystem ist im Abschnitt Mapping Optionen beschrieben.|
|''kreditoriban''|Nein|Text| |IBAN der abweichenden Kreditor-Bank, die der Rechnung zugeordnet werden soll. Wenn der Kreditor/Debitor nicht in der Partnerverwaltung migriert ist, wird die Bankverbindung mit der Standard-Bank des Kreditors/Debitors abgeglichen und es wird keine Bankverbindung der Rechnung zugeordnet.\\ Wenn die Bankverbindung nicht existiert, wird die Rechnung abgelehnt.|
|''gegenkonto''|Nein|Text| |Nummer des abweichenden Gegenkontos (abweichendes Verbindlichkeits- oder Forderungskonto). Wenn leer wird das Standard-Verbindlichkeits- bzw. Forderungskonto als Gegenkonto gesetzt.|
|''auftrag\nummer''|Nein|Text| |Auftragsnummer in iX-Haus|
|''auftrag\rechnungstyp''|Nein|Text|''T\\ S''|Rechnungstyp für den Auftrag:\\ T – Teilrechnung, S – Schlussrechnung (Standard)|
|''rechnungsnummer''|Ja|Text| |Rechnungsnummer|
|''rechnungsdatum''|Ja|Datum| |Rechnungsdatum|
|''wertstellungsdatum''|Ja|Datum| |Wertstellungsdatum der Buchung|
|''wdatumhochsetzen''|Nein|Ja/Nein| |Damit kann das Wertstellungsdatum automatisch in den freigegebenen Zeitraum verschoben werden, falls der Zeitraum für das eingegebene Datum gesperrt ist.
|''faelligkeitsdatum''|Nein|Datum| |Fälligkeitsdatum. Falls nicht angegeben wird das Wertstellungsdatum übernommen.|
|''lzvon''|Nein|Datum| |Leistungszeitraum von. Falls nicht angegeben wird die Standardlogik von iX-Haus angewandt (Beginn des Wirtschaftsjahres, in welchem das Wertstellungsdatum liegt).|
|''lzbis''|Nein|Datum| |Leistungszeitraum bis. Falls nicht angegeben wird die Standardlogik von iX-Haus angewandt (Ende des Wirtschaftsjahres, in welchem das Wertstellungsdatum liegt).|
|''beleg''|Nein|Text| |Beleg|
|''belegeindeutigpruefen''|Nein|Ja/Nein|''Ja\\ Nein''|Hiermit kann die Prüfung, ob die Belegnummer eindeutig ist, ausgeschaltet werden. Standardmäßig wird je Rechnungstyp eine Belegnummer importiert, bei einem weiteren Import wird die Rechnung bzw. wiederkehrende Zahlung mit der entsprechenden Belegnummer aktualisiert. (s. Aktualisierung der Rechnungen anhand der Beleg-Nummer)| 
|''kundennummer''|Nein|Text| |Abweichende Kundennummer für die Rechnung bzw. wiederkehrende Zahlung. Wenn nicht eingegeben, wird die Kundennummer aus dem Kreditoren/Debitoren-Stamm und der Firmenzuordnung in der Objektauswahl ermittelt.|
|''buchungstext''|Nein|Text| |Buchungstext – Wenn nicht eingegeben, wird der Buchungstext je nach Systemeinstellung aus dem Text der ersten Kontierung oder aus der Rechnungsnummer übernommen. Es werden die ersten 80 Zeichen übernommen. |
|''gesamtbetrag''|Ja|Zahl| |Gesamtbetrag – Brutto|
|''sicherheitseinbehalt prozent''|Nein|Zahl| |Sicherheitseinbehalt in Prozent. Der Sicherheitseinbehalt wird aus dem Gesamtbetrag berechnet. Falls der Sicherheitseinbehaltbetrag eingegeben ist, wird die Eingabe ignoriert.|
|''sicherheitseinbehalt betrag''|Nein|Zahl| |Sicherheitseinbehalt. Wenn der Sicherheitseinbehalt nicht eingegeben ist, wird der aus dem Sicherheitseinbehaltprozent berechnet.|
|''sicherheitseinbehalt istversteuerung''|Nein|Ja/Nein|''Ja\\ Nein''|Hiermit kann definiert werden, ob der Sicherheitseinbehalt der Ist-Versteuerung unterliegt. Je nach Systemeinstellung ''SicherheitseinbehaltIstVersteuerung'' wird die Ist-Versteuerung standardmäßig ein- oder ausgeschaltet. Wenn die Systemeinstellung ''SicherheitseinbehaltIstVersteuerung'' auf ''Immer'' oder ''Nie'' eingestellt ist, wird der Wert aus der Import—Vorlage ignoriert.|
|''sicherheitseinbehalt faelligkeit''|Nein|Datum| |Fälligkeit des Sicherheitseinbehalt|
|''kuerzung\grund''|Nein|Text| | Grund für die Kürzung. Die Kürzungen verringern nicht den eingegebenen Gesamtbetrag.|
|''Kuerzunge\bruttobetrag''|Nein|Zahl| | Brutto-Betrag der Kürzung|
|''skonto\methode''|Nein|Ganzzahl|Leer,1 oder 2|Leer – kein Skontoabzug\\ 1 – Fester Skontobetrag \\ 2 – Automatischer Skontoabzug|
|''skonto\tage1''|Nein|Ganzzahl| |Bei Skontomethode 1 – die Anzahl der Tage, für die der feste Skonto-Prozentsatz gilt. \\ Bei Skontomethode 2. Anzahl Tage für die der Skontosatz 1 gilt.\\ Wenn leer, werden die Skonto 1-Tage aus den Zahlungszielen des Kreditors/Debitors geladen und wenn keine Zahlungsziele eingetragen sind, werden 100 Tage gesetzt.|
|''skonto\satz1''|Nein|Zahl| |Bei Skontomethode 1: der feste Skonto-Prozentsatz. \\ Bei Skontomethode 2: Skontosatz 1.\\ Wenn leer wird der Skonto 1-Satz aus den Zahlungszielen des Kreditors/Debitors geladen.|
|''skonto\tage2''|Nein|Ganzzahl| |Nur für Skontomethode 2. Anzahl Tage, für die der Skontosatz 2 gilt.\\ Wenn leer, werden die Skonto 2-Tage aus den Zahlungszielen des Kreditors/Debitors geladen.|
|''skonto\satz2''|Nein|Zahl| |Nur für Skontomethode 2. Skontosatz 2.\\ Wenn leer, wird der Skonto 2-Satz aus den Zahlungszielen des Kreditors/Debitors geladen.|
|''skonto\tage3''|Nein|Ganzzahl| |Nur für Skontomethode 2. Anzahl Tage, für die der Skontosatz 3 gilt.\\ Wenn leer werden die Skonto 3-Tage aus den Zahlungszielen des Kreditors/Debitors geladen.|
|''skonto\satz3''|Nein|Zahl| |Nur für Skontomethode 2. Skontosatz 3.\\ Wenn leer, wird der Skonto 3-Satz aus den Zahlungszielen des Kreditors/Debitors geladen.|
|''Dcl''|Nein|Ja/Nein|''Ja\\ Nein''|Dataclearing Flag (Standard: laut Systemeinstellung in iX-Haus für GVC 701:\\ Bereich: Kreditor\\ Abschnitt: Allgemein\\ Name: DCLFlag)|
|''flag15a''|Nein|Ja/Nein|''Ja\\ Nein''|§15a Rechnung (Standard: Nein)|
|''par13b''|Nein|Text|''13b\\ 13b1\\ 13b3\\ 13a2\\ 13bStLE''|Hiermit kann die §13b Option für die Rechnung definiert werden. Wenn die Option übergeben wird, wird automatisch ein passender MwSt.-Code aus der MwSt.-Tabelle geladen mit der passenden §13b-Option und mit dem gleichen MwSt.-Satz und Typ wie der in der entsprechenden Kontierung aktuell eingegeben MwSt.-Code. Die möglichen Optionen sind:\\ • 13b - Leistungen im Sinne des §13b UStG (§13b UStG) - UStVA Kz.84/67\\ • 13b1 - Sonstige Leistungen (§13b Nr.1 UStG) - UStVA Kz.46/67\\ • 13b3 - Grundstückskäufe (§13b Nr.3 UStG) - UStVA Kz.73/67\\ • 13a2 - Innergemeinschaftlicher Erwerb (§13a Nr.2 UStG) - UStVA Kz.89/67\\ • 13bStLE – Steuerschuld Leistungsempfänger (§13b Abs.5 UStG) - UStVA Kz. 60|
|''zre-id''|Nein|Text| |ZRE Rechnung-ID der XRechnung|
|''Wkzgueltigab''|Nein|Datum| |Wiederkehrende Zahlung gültig ab. Dieses Feld wird nur beim Import von wiederkehrenden Zahlungen ausgewertet (s. Beschreibung von Feld typ).|
|''Wkzgueltigbis''|Nein|Datum| |Wiederkehrende Zahlung gültig bis|
|''wiederholungsoptionen/ wiederholungsoption/ wdattagmonat''|Nein|Tag.Monat im Format TT.MM| |Wertstellungs-Monat und-Tag für die jeweilige wiederkehrende Rechnung. Dieses Feld wird nur beim Import von wiederkehrenden Zahlungen ausgewertet (s. Beschreibung von Feld typ).|
|''wiederholungsoptionen/ wiederholungsoption/ fdattagmonat''|Nein|Tag.Monat im Format TT.MM| |Fälligkeits-Monat und -Tag für die jeweilige wiederkehrende Rechnung. Dieses Feld wird nur beim Import von wiederkehrenden Zahlungen ausgewertet (s. Beschreibung von Feld typ).|
|''wiederholungsoptionen/ wiederholungsoption/ lzvontagmonat''|Nein|Tag.Monat im Format TT.MM| |Leistungszeitraum von Monat und Tag für die jeweilige wiederkehrende Rechnung. Dieses Feld wird nur beim Import von wiederkehrenden Zahlungen ausgewertet (s. Beschreibung von Feld typ).|
|''wiederholungsoptionen/ wiederholungsoption/ lzbistagmonat''|Nein|Tag.Monat im Format TT.MM| |Leistungszeitraum bis Monat und Tag für die jeweilige wiederkehrende Rechnung. Dieses Feld wird nur beim Import von wiederkehrenden Zahlungen ausgewertet (s. Beschreibung von Feld typ).|
|''ectexte\ecstdtext''|Nein|Text| |Standard Überweisungstext| 
|''ectexte\eczustext''|Nein| | | Zusatz Überweisungstext|

===XML-Elemente kontierung===
In der folgenden Tabelle werden die Kontierungs-XML-Tags beschrieben:

Die einzelnen XML-Elemente, die im XML-Element rechnung\kontierungen\kontierung enthalten sind.
^XML-Element^Pflicht^Datentyp^Werte^Beschreibung^
|''Objekt''|s. Beschreibung|Ganzzahl| |Kontierungsobjekt. Die Eingabe von Objektnummer kann entweder im Feld ''Objekt'' oder im Feld ''Objektfremdsystem'' erfolgen. |
|''Objektfremdsystem''|Nein|Text| |Kontierungsobjekt aus dem Fremdsystem. Die Übersetzung der Objektnummer aus einem Fremdsystem ist im Abschnitt Mapping Optionen beschrieben.|
|''Konto''|s. Beschreibung|Text| |Kontonummer des Sachkontos bzw. Anlagenkontos. Die Eingabe von Kontonummer ist nur dann Pflichtfeld, wenn die Rechnung direkt in die Dialogbuchhaltung importiert wird oder wenn der Rechnungseingangsbuch-Status nicht in der Systemeinstellung ''KontierungUnvollstaendigStatus'' ausgewählt ist.|
|''Kontotyp''|Nein|Text| |Hiermit kann der Kontotyp definiert werden, z. B. wenn die Rechnung direkt auf ein Anlagenkonto gebucht werden soll. Wenn der Kontotyp auf Anlagenkonto gesetzt wird, wird im Feld das Anlagenkonto eingegeben in Form Anlage.Kontotyp-Kurzbezeichnung (z. B. 123456.S).\\ Mögliche Werte: Sachkonto, Anlagenkonto\\ Standardmäßig (wenn leer) wird der Kontotyp aus der Kontonummer ermittelt; wenn die Kontonummer ein Punkt-Zeichen enthält, wird es als Anlagenkonto interpretiert, ansonsten als Sachkonto.|
|''Alleanlagenkonten''|Nein|Ja / Nein|''Ja\\ Nein''|Mit ''Nein'' wird nur das ausgewählte Anlagenkonto (z. B. Handelsrecht) gebucht. Mit ''Ja'' werden alle Anlagenkonten (z. B. Handelsrecht und Steuerrecht) gebucht.|
|''betrag\wert''|Ja|Zahl| |Kontierungsbetrag|
|''betrag\typ''|Ja|B / N|''B\\ N''|''B'' – Bruttoeingabe, ''N'' – Nettoeingabe|
|''Mwstcode''|Nein|Text| |Fremdsystem MwSt.-Code-Nummer aus der MwSt.-Tabelle in iX-Haus.|
|''Hndl''|Nein|Zahl| |Hndl-Betrag (Haushaltsnahe Dienstleistungen)|
|''Text''|Ja|Text| |Kontierungstext, max. 80 Zeichen|
|''Lzvon''|Nein|Datum| |Leistungszeitraum von (Falls nichts eingegeben, wird der Leistungszeitraum aus der Rechnung übernommen.)|
|''Lzbis''|Nein|Datum| |Leistungszeitraum bis (Falls nichts eingegeben, wird Leistungszeitraum aus der Rechnung übernommen.)|
|''Aposnr''|Nein|Text| |Auftragspositionsnummer|
|''Projekt''|Nein|Text| |Projektnummer aus iX-Haus|
|''Koststelle''|Nein|Text| |Kostenstellennummer|
|''Kosttraeger''|Nein|Text| |Kostenträgernummer (aktuell keine Verwendung)|
|''Ahkostenabgang''|Nein|Zahl| |Der Wert, um den die AH-Kosten der Anlage beim Buchen des Abgangs gemindert werden. Wenn keine AH-Kosten als Abgang eingegeben sind, wird ein Vollabgang bei der Anlage gebucht. Somit ist bei einem Vollabgang keine Eingabe der AH-Kosten Abgang notwendig.|
|''Flbelid''|Nein|Zahl| |iX-Haus HDR_ID der Flächenbelegung für die Mieterweiterbelastung. Die eingegebene Flächenbelegung muss dem Kontierungs-objekt gehören.\\ Wenn die HDR_ID der Flächenbelegung eingegeben ist, werden die Felder ignoriert.|
|''Mieternr''|Nein|Text| |Mieternummer der Flächenbelegung an dem die Rechnung weiterbelastet wird.|
|''Flaechenr''|Nein|Zahl| |Flächennummer der Flächenbelegung zu der die Rechnung weiterbelastet wird.|
|''Vertragsbeginn''|Nein|Datum| |Vertragsbeginn der Flächenbelegung an dem die Rechnung weiterbelastet wird.|
|''mieterweiterbelastungtext''|Nein|Text| |Text für die Mieterweiterbelastung.|
|''ihbartnr''|Nein|Zahl| |Die Nummer der IHB-Art für die Mieterweiterbelastung.| 
Beim Import von Rechnungen in das Rechnungseingangsbuch mit dem Status ''Vorerfasst'' können alle Kontierungsfelder analog zu der Neuerfassung im Rechnungseingangsbuch leer gelassen werden. Wenn die Benutzerprüfung eingeschaltet ist, muss allerdings das Feld ''Objekt'' angegeben werden.

Beim Import wird die Vollständigkeit der Daten und die Zusammenhänge zwischen den einzelnen Daten geprüft; je nach Systemeinrichtung, wie z. B. zwischen der eingestellten MwSt.-Behandlung des Sachkontos und des eingegebenen MwSt.-Codes. 

Nach dem Import wird das Ergebnis des Imports in den <import> XML-Tag geschrieben. <wrap important>Der <import> XML-Tag muss vor dem Import leer sein.</wrap>

=== XML-Elemente import===
Beschreibung der einzelnen XML-Elemente, die im XML-Element rechnung\import enthalten sind:

^XML-Element^Pflicht^Datentyp^Beschreibung^
|''status''|Ja|Text|Importstatus.\\ • Erfolg – Die Rechnung wurde erfolgreich importiert. \\ • Fehler beim Import – Die Rechnung konnte nicht importiert werden.\\ • Fehler beim Verbuchen – Die Rechnung wurde importiert, konnte aber nicht erfolgreich verbucht werden.|
|''fehlerbeschreibung''|Nein|Text|Im Fall, wenn die Rechnung nicht importiert werden kann oder nach dem Import nicht verbucht werden kann, wird hier der Fehler beschrieben. Bei mehreren Fehlern kann dieser Tag mehrmals vorkommen.|
|''hinweis''|Nein|Text|Hier werden Hinweismeldungen ausgegeben, die verhindern würden, dass die Rechnung verbucht werden kann, trotz erfolgreichem Import der Rechnung. Bei mehreren Fehlern kann dieser Tag mehrmals vorkommen.|
|''bukreis''|Nein|Ganzzahl|Die Objektnummer des Hauptbuchungskreises, zu dem die Buchung gehört.|
|''wirtschaftsjahr''|Nein|Ganzzahl|Das Wirtschaftsjahr in iX-Haus, in dem die Buchung importiert wurde.|
|''buchungsnummer''|Nein|Ganzzahl|Die Buchungsnummer der Buchung in iX-Haus. Falls nicht angegeben, wird das Wirtschaftsjahr aus dem eingegebenen Wertstellungsdatum ermittelt.|
|''wertstellungsdatum''|Nein|Datum|Das Wertstellungsdatum der importierten Buchung. Falls das Wertstellungsdatum automatisch in den freigegebenen Zeitraum verschoben werden soll, wird hier das neuermittelte Wertstellungsdatum eingetragen.|
++++

===== Beispiele =====
++++|
Die Beispiele finden Sie auch als Download: {{ :schnittstellen:rechnungsimport:rechnungsimport_beispiele.zip |Zip-Archiv mit Beispieldateien für Rechungsimport}}.
==== Beispiel 1: eine zu importierende Rechnung ====
<WRAP>
++++|
<code>
<rechnung>
  <gvc>701</gvc>
  <ixhaususerid></ixhaususerid>
  <rechnungseingangsbuch>ja</rechnungseingangsbuch>
  <internerechnungsnummer></internerechnungsnummer>
  <rebustatus>Vorerfasst</rebustatus>
  <rebustatusinfo></rebustatusinfo>  
  <typ>Rechnung</typ>
  <rechnungsinfo></rechnungsinfo>
  <bukreis>1100</bukreis>
  <wirtschaftsjahr>2012</wirtschaftsjahr>
  <kreditornr>70000</kreditornr>
  <gegenkonto></gegenkonto>
  <auftrag>
    <nummer>2012/10</nummer>
    <rechnungstyp>T</rechnungstyp>
  </auftrag>
  <rechnungsnummer>RE 2012/05003</rechnungsnummer>
  <rechnungsdatum></rechnungsdatum>
  <wertstellungsdatum>23.05.2012</wertstellungsdatum>
  <wdatumhochsetzen>Ja</wdatumhochsetzen>
  <faelligkeitsdatum></faelligkeitsdatum>
  <lzvon></lzvon>
  <lzbis></lzbis>
  <beleg></beleg>
  < belegeindeutigpruefen></ belegeindeutigpruefen>
  <kundennummer></kundennummer>
  <buchungstext></buchungstext>
  <gesamtbetrag>1130.43</gesamtbetrag>
  <sicherheitseinbehaltprozent>10</sicherheitseinbehaltprozent> 
  <sicherheitseinbehaltistversteuerung>ja</sicherheitseinbehaltistversteuerung> 
  <sicherheitseinbehaltfaelligkeit>31.12.2018</sicherheitseinbehaltfaelligkeit>
  <kuerzungen>
	<kuerzung>
		<Grund>Kürzungsgrund</Grund>
		<BruttoBetrag>30.62</BruttoBetrag>
	</kuerzung>
  </kuerzungen>
  <skonto>
  <methode>2</methode>
    <tage1>1</tage1>
    <satz1>10.5</satz1>
    <tage2>5</tage2>
    <satz2>5.0</satz2>
    <tage3>10</tage3>
    <satz3>1.3</satz3>
  </skonto>
  <dcl>Ja</dcl>
  <flag15a>Nein</flag15a>
  <par13b>13b1</par13b>
  <zre-id>123456</zre-id>
  <ectexte>
    <ecstdtext>RE 05003 vom 23.05.2012</ecstdtext>
    <ecstdtext></ecstdtext>
    <eczustext></eczustext>
    <eczustext></eczustext>
    <eczustext></eczustext>
    <eczustext></eczustext>
  </ectexte>
  <kontierungen>
    <kontierung>
      <objekt>1101</objekt>
      <konto>8010</konto>
      <betrag>
        <wert>1000.00</wert>
        <typ>B</typ>
      </betrag>
      <mwstcode>1</mwstcode>
      <hndl>50.00</hndl>
      <text>Wasserversorgung</text>
      <lzvon></lzvon>
      <lzbis></lzbis>
      <aposnr></aposnr>
      <projekt></projekt>
      <koststelle></koststelle>
      <kosttraeger></kosttraeger>
    </kontierung>
    <kontierung>
      <objekt>1101</objekt>
      <konto>8011</konto>
      <betrag>
        <wert>130.43</wert>
        <typ>B</typ>
      </betrag>
      <mwstcode>1</mwstcode>
      <hndl>130.43</hndl>
      <text>Abwasser & Kanal</text>
      <lzvon></lzvon>
      <lzbis></lzbis>
      <aposnr>1</aposnr>
      <projekt>1.2.3</projekt>
      <koststelle></koststelle>
      <kosttraeger></kosttraeger>
    </kontierung>
  </kontierungen>
  <import>
    <status></status>
    <fehlerbeschreibung></fehlerbeschreibung>
    <hinweis></hinweis>
    <bukreis></bukreis>
    <wirtschaftsjahr></wirtschaftsjahr>
    <buchungsnummer></buchungsnummer>
    <wertstellungsdatum></wertstellungsdatum>
  </import>
</rechnung>
</code>
++++
</WRAP>

==== Beispiel 2: eine zu importierende wiederkehrende Zahlung mit Übersetzung von Fremdsystem-Nummer für Objekt und Kreditor ====
<WRAP>
++++|
<code>
<?xml version="1.0" encoding="ISO-8859-1"?>
<rechnung>
  <gvc>701</gvc>
  <ixhaususerid></ixhaususerid>
  <rechnungseingangsbuch>ja</rechnungseingangsbuch>
  <internerechnungsnummer></internerechnungsnummer>
  <rebustatus>Vorerfasst</rebustatus>
  <rebustatusinfo></rebustatusinfo>  
  <typ>wiederkehrende Zahlung</typ>
  <rechnungsinfo></rechnungsinfo>
  <bukreis></bukreis>
  <bukreisfremdsystem>B1100</bukreisfremdsystem>
  <wirtschaftsjahr></wirtschaftsjahr>
  <kreditornr></kreditornr>
  <kreditornrfremdsystem>PM230</kreditornrfremdsystem>
  <gegenkonto></gegenkonto>
  <auftrag>
    <nummer></nummer>
    <rechnungstyp></rechnungstyp>
  </auftrag>
  <rechnungsnummer>WKZ 3011/05003</rechnungsnummer>
  <rechnungsdatum></rechnungsdatum>
  <wertstellungsdatum></wertstellungsdatum>
  <wdatumhochsetzen></wdatumhochsetzen>
  <faelligkeitsdatum></faelligkeitsdatum>
  <lzvon></lzvon>
  <lzbis></lzbis>
  <beleg></beleg>
  < belegeindeutigpruefen></ belegeindeutigpruefen>
  <kundennummer></kundennummer>
  <buchungstext></buchungstext>
  <gesamtbetrag>99.53</gesamtbetrag>
  <skonto>
    <methode></methode>
    <tage1>0</tage1>
    <satz1>0</satz1>
    <tage2>0</tage2>
    <satz2>0</satz2>
    <tage3></tage3>
    <satz3></satz3>
  </skonto>
  <wkzgueltigab>01.01.2014</wkzgueltigab>
  <wkzgueltigbis>31.01.2015</wkzgueltigbis>
  <wiederholungsoptionen>
	<wiederholungsoption>
		<wdattagmonat>04.01</wdattagmonat>
		<fdattagmonat>06.01</fdattagmonat>
		<lzvontagmonat>01.01</lzvontagmonat>
		<lzbistagmonat>31.01</lzbistagmonat>
	</wiederholungsoption>
	<wiederholungsoption>
		<wdattagmonat>04.11</wdattagmonat>
		<fdattagmonat>06.11</fdattagmonat>
		<lzvontagmonat>01.11</lzvontagmonat>
		<lzbistagmonat>30.11</lzbistagmonat>
	</wiederholungsoption>
  </wiederholungsoptionen>
  <dcl>Ja</dcl>
  <flag15a>Nein</flag15a>
  <par13b>13b1</par13b>
  <zre-id>123456</zre-id>
  <ectexte>
    <ecstdtext></ecstdtext>
  </ectexte>
  <kontierungen>
    <kontierung>
      <objekt></objekt>
      <objektfremdsystem>B1177</objektfremdsystem>
      <konto>500002</konto>
      <betrag>
        <wert>83.64</wert>
        <typ>NETTO</typ>
      </betrag>
      <mwstcode>24</mwstcode>
      <hndl></hndl>
      <text>Strom</text>
      <lzvon></lzvon>
      <lzbis></lzbis>
      <aposnr></aposnr>
      <projekt></projekt>
      <koststelle></koststelle>
      <kosttraeger></kosttraeger>
    </kontierung>
  </kontierungen>
  <import>
    <status></status>
    <fehlerbeschreibung></fehlerbeschreibung>
    <hinweis></hinweis>
    <bukreis></bukreis>
    <wirtschaftsjahr></wirtschaftsjahr>
    <buchungsnummer></buchungsnummer>
    <wertstellungsdatum></wertstellungsdatum>
  </import>
</rechnung>
</code>
++++
</WRAP>
++++