DATEV
Allgemeine Beschreibung
Ist die Option für den DATEV-Export (DatevOnlineActive) aktiviert, steht im Modul Rechnungen die Funktion zum Erstellen der Export-Datei im Menü und in der Toolbar zur Verfügung. Die Option kann nur von Mitarbeitern der dialogEDV aktiviert werden. Über die Funktion zum Erstellen der Export-Datei kann für eine oder mehrere Rechnungen eine zip-Datei erstellt werden, welche anschließend online bei der DATEV eingelesen werden kann. Der Import dort erfolgt nicht durch das diaLIMS.
Für den erfolgreichen Export müssen diverse Felder gesetzt sein. Diese können in der Tabelle weiter unten entnommen werden. Wichtig hierbei ist, dass am Benutzer Ansprechpartner und Kunde gesetzt sind.
Während des Vorganges wird das Protokoll in einem Dialog angezeigt. Dieses Protokoll wird nach Abschluss des Vorganges in ein Log-Eintrag-Datensatz geschrieben und ist dann im entsprechenden Modul einsehbar.
Zunächst werden alle Pflichtfelder von Kunde und Ansprechpartner des Benutzers geprüft. Sind diese nicht gesetzt, wird der Export abgebrochen. Anschließend wird geprüft, ob auf den Export-Pfad zugegriffen werden kann, welcher in den DATEV-Optionen eingetragen ist. Ist dies nicht möglich, wird der Vorgang abgebrochen.
Die nun folgenden Punkte erfolgen pro Rechnung. Zunächst werden die Pflichtfelder von Rechnung und Rechnungposition geprüft, anschließend wird das Rechnungsdokument in den Export-Pfad kopiert und in ein PDF umgewandelt. Ist ein Pflichtfeld nicht gesetzt oder kann auf das Dokument nicht zugegriffen werden, wird der Export der aktuellen Rechnung abgebrochen. Ist Prüfung und PDF-Erzeugung erfolgreich, werden die Werte für die Rechnungsdatei ermittelt. Kommt es hierbei zu einem Fehler, zum Beispiel, weil die Daten der Pflichtfelder nicht dem richtigen Format entsprechen, wird der Export der aktuellen Rechnung abgebrochen. Nicht gesetzte Werte für nicht pflichtige Felder werden ignoriert und nicht exportiert. Für erfolgreich ermittelte Daten wird eine XML-Datei erstellt. Diese wird mit der Kurzbezeichnung der Rechnung benannt und im Export-Pfad abgelegt. An der Rechnung wird der Schalter "DATEV exportiert" gesetzt.
Wurde dieser Vorgang für alle Rechnungen durchgeführt, wird zunächst geprüft, ob mindestens eine Rechnung exportiert werden konnte. Konnte keine Rechnung exportiert werden, wird der Export-Prozess abgebrochen und alle bisher erstellten Dateien werden gelöscht.
Wurde für mindestens eine Rechnung eine Datei erstellt, wird diese in der Dokumentenverwaltungsdatei vermerkt. Anschließend werden die Dokumente und XML-Dateien aller erfolgreich verarbeiteten Rechnungen, zusammen mit der Dokumentenverwaltungsdatei in einen Zip-Ordner verpackt.
Nach dem Abschluss des Vorgangs wird eine Datei erstellt, die "Rechnungen vom [aktuelles Datum].zip" heißt. Sie wird im Unterordner mit dem Namen [aktueller Benutzer], welcher sich in dem in den Optionen eingetragenen Ordner befindet, abgelegt. Die Zip-Datei enthält die Dokumentenverwaltungsdatei, welche zwingend mit document.xml benannt sein muss. Neben dieser Datei liegen pro exportierter Rechnung das Rechnungsdokument und die Rechnungsdaten-xml-Datei.
Schemabeschreibung
| Feldname | Feld im diaLIMS | Häufigkeit | Kommentar |
|---|---|---|---|
| archive | -- | Root-Element | |
| archive@version | -- | Attribut | Fester Text: "3.0" |
| header | -- | Unterpunkt. Häufigkeit: 1x | Unterpunkt unter archive |
| header@date | DateUtil.ServerDate | Attribut | |
| content | -- | Unterpunkt. Häufigkeit: 1x | Unterpunkt unter archive |
| document | -- | Unterpunkt. Häufigkeit: Mehrfach | Unterpunkt unter content. Anzahl: Anzahl exportierter Rechnungen |
| extension | -- | Unterpunkt. Häufigkeit: Mehrfach möglich standardmäßig wird ein Datensatz erstellt | Unterpunkt unter document. |
| property | -- | Unterpunkt. Häufigkeit: 1x | Unterpunkt unter extension. |
| property@key | -- | Attribut | Fester Text: "InvoiceType" |
| property@value | -- | Attribut | Fester Text: "Outgoing" |
| Feldname | Feld im diaLIMS | Häufigkeit | Kommentar |
|---|---|---|---|
| archive@header@description | Rechnung.Kurzbezeichnung | Attribut | |
| content@document@description | -- | Attribut | Fester Text: "Ausgangsrechnungen vom [aktuelles Datum]" |
| content@documentr@type | -- | Attribut | Fester Wert: (byte) 2 |
| content@documentr@extention@Datafile | -- | Attribut | Name des aktuellen Rechnungsdokumentes |
| Feldname | Feld im diaLIMS | Typ | Kommentar |
|---|---|---|---|
| invoice | -- | Root-Element | |
| invoice@generator_info | Benutzer.Ansprechpartner.Firma | Attribut | |
| invoice@description | -- | Attribut | Fester Text: "DATEV Import invoices" |
| invoice@version | -- | Attribut | Fester Text: "3.0" |
| invoice@xml_data | -- | Attribut | Fester Text: "Kopie nur zur Verbuchung berechtigt nicht zum Vorsteuerabzug" |
| invoice_info | -- | Unterpunkt, Häufigkeit: 1x | Neuer Unterpunkt unter invoice |
| invoice_info@invoice_type | Rechnung.businesstyp bzw. Rechnung.typ | Attribut | Wenn der Typ einem zugelassenen Wert entspricht, wir dieser Verwendet, ansonsten wird nach Businesstyp "Rechnung" (Bei Rechnung) bzw. "Gutschrift/Rechnungskorrektur" (alles andere) gesetzt. |
| invoice_info@invoice_date | Rechnung.Rechnungsdatum | Attribut | |
| invoice_info@delivery_date | Rechnung.Lieferdatum | Attribut | |
| invoice_info@invoice_id | Rechnung.Kurzbezeichnung | Attribut | |
| invoice_info@drawee_no | Rechnung.Originalrechnung.Kurzbezeichnung | Attribut | |
| invoice_party | -- | Unterpunkt, Häufigkeit: 1x | Neuer Unterpunkt unter invoice. Beschreibt den Rechnungsempfänger |
| adress | -- | Unterpunkt, Häufigkeit: 1x | Neuer Unterpunkt unter invoice_party |
| address@name | Rechnung.AgAfirma | Attribut | |
| address@zip | Rechnung.AgApostleitzahl | Attribut | |
| address@city | Rechnung.AgAort | Attribut | |
| supplier_party | -- | Unterpunkt, Häufigkeit: 1x | Neuer Unterpunkt unter invoice. Beschreibt den Rechnungsersteller |
| supplier_party@tax_no | Benutzer.Kunde.Steuernummer | Attribut | Steuernummer oder Umsatzsteuernummer müssen vorhanden sein. |
| supplier_party@vat_id | Benutzer.Kunde.UmsatzSteuerID | Attribut | Steuernummer oder Umsatzsteuernummer müssen vorhanden sein. |
| adress | -- | Unterpunkt, Häufigkeit: 1x | Neuer Unterpunkt unter supplier_party. Dieser Unterpunkt kann auch unter allen anderen Rechnungsteilnehmern erscheinen. Dort jedoch nur, wenn die nachfolgend genannten Pflichtfelder vorhanden sind. |
| address@name | Benutzer.Ansprechpartner.Firma | Attribut | |
| address@zip | Benutzer.Ansprechpartner.Postleitzahl | Attribut | |
| address@city | Benutzer.Ansprechpartner.Ort | Attribut | |
| invoice_item_list | -- | Unterpunkt, Häufigkeit: Mehrfach | Neuer Unterpunkt unter invoice, jedes beschreibt eine Rechnungsposition |
| invoice_item_list@description_short | RechnungPosition.Aname | Attribut | |
| price_line_amount | -- | Unterpunkt, Häufigkeit: Mehrfach möglich standardmäßig wird ein Datensatz erstellt | Neuer Unterpunkt unter invoice_item_list |
| price_line_amount@tax | RechnungPosition.Umsatzsteuersatz | Attribut | Als Steuer (zB 19.00%) nicht als Satz |
| total_amount | -- | Unterpunkt, Häufigkeit: Mehrfach möglich standardmäßig wird ein Datensatz erstellt | Neuer Unterpunkt unter invoice |
| total_amount@currency | -- | Attribut | Währung, wie sie in den Optionen eingetragen ist. |
| total_amount@total_gross_amount_excluding_third-party_collection | Rechnung.Endsummebrutto | Attribut | |
| tax_line | -- | Unterpunkt, Häufigkeit: Mehrfach | Neuer Unterpunkt unter total_amount. Pro in den Rechnungspositionen enthaltenen Steuersatz. |
| tax_line@tax | -- | Attribut | Aktueller Steuersatz (RechnungPosition.Umsatzsteuersatz) |
| Feldname | Feld im diaLIMS | Häufigkeit | Kommentar |
|---|---|---|---|
| invoice@generating_system | -- | Attribut | Fester Text: "diaLIMS" |
| invoice_party@tax_no | Rechnung.AgKunde.Steuernummer | Attribut | |
| invoice_party@tax_no | Rechnung.AgKunde.UmsatzsteuerID | Attribut | |
| invoice_party@address@street | Rechnung.AgAstrasse | Attribut | |
| invoice_party@address@boxno | Rechnung.AgApostfach | Attribut | |
| invoice_party@address@party_id | Rechnung.AgKnummer | Attribut | |
| invoice_party@address@country | Rechnung.AgAland | Attribut | |
| invoice_party@address@email | Rechnung.AgAnsprechpart.EMail | Attribut | |
| invoice_party@address@fax | Rechnung.AgAnsprechpart.Fax | Attribut | |
| invoice_party@address@phone | Rechnung.AgAnsprechpart.Telefon | Attribut | |
| account | -- | Unterpunkt, Häufigkeit: Mehrfach möglich standardmäßig wird ein Datensatz erstellt | Unterpunkt unter allen Rechnungsparteien möglich. Muss mindestens ein Attribut enthalten. |
| account@bank_account | [Kunde].KontoNummer | Attribut | |
| account@bank_code | [Kunde].Bankleitzahl | Attribut | |
| account@bank_country | -- | Attribut | Erste 2 Buchstaben der IBAN |
| account@bank_name | [Kunde].Bank | Attribut | |
| account@iban | [Kunde].Iban | Attribut | |
| account@swiftcode | [Kunde].SwiftCode | Attribut | |
| supplier_party@address@street | Benutzer.Ansprechpartner.Strasse | Attribut | |
| supplier_party@address@boxno | Benutzer@Ansprechpartner.Postfach | Attribut | |
| supplier_party@address@party_id | Benutzer.Kunde.Nummer | Attribut | |
| supplier_party@address@country | Benutzer@Ansprechpartner.Land | Attribut | |
| supplier_party@address@email | Benutzer@Ansprechpartner.EMail | Attribut | |
| supplier_party@address@fax | Benutzer@Ansprechpartner.Fax | Attribut | |
| supplier_party@address@phone | Benutzer@Ansprechpartner.Telefon | Attribut | |
| invoice_recipient | -- | Unterpunkt, Häufigkeit: 1x | Unterpunkt unter invoice möglich. Muss mindestens den Adress-Unterpunkt mit seinen Pflichtfeldern enthalten. Enthälte den abweichenden Rechnungsempfänger. |
| invoice_recipient@tax_no | Rechnung.RaKunde.Steuernummer | Attribut | |
| invoice_recipient@tax_no | Rechnung.RaKunde.UmsatzsteuerID | Attribut | |
| invoice_recipient@address@name | Rechnung.RaAFirma | Attribut | |
| invoice_recipient@address@zip | Rechnung.RaAPostleitzahl | Attribut | |
| invoice_recipient@address@city | Rechnung.RaAOrt | Attribut | |
| invoice_recipient@address@street | Rechnung.RaAstrasse | Attribut | |
| invoice_recipient@address@boxno | Rechnung.RaApostfach | Attribut | |
| invoice_recipient@address@party_id | Rechnung.RaKnummer | Attribut | |
| invoice_recipient@address@country | Rechnung.RaAland | Attribut | |
| invoice_recipient@address@email | Rechnung.RaAnsprechpart.EMail | Attribut | |
| invoice_recipient@address@fax | Rechnung.RaAnsprechpart.Fax | Attribut | |
| invoice_recipient@address@phone | Rechnung.RaAnsprechpart.Telefon | Attribut | |
| delivery_party | -- | Unterpunkt, Häufigkeit: 1x | Unterpunkt unter invoice möglich. Muss mindestens den Adress-Unterpunkt mit seinen Pflichtfeldern enthalten. Enthälte den abweichenden Rechnungsempfänger. |
| delivery_party@tax_no | Rechnung.LaKunde.Steuernummer | Attribut | |
| delivery_party@tax_no | Rechnung.LaKunde.UmsatzsteuerID | Attribut | |
| delivery_party@address@name | Rechnung.LaAFirma | Attribut | |
| delivery_party@address@zip | Rechnung.LaAPostleitzahl | Attribut | |
| delivery_party@address@city | Rechnung.LaAOrt | Attribut | |
| delivery_party@address@street | Rechnung.LaAstrasse | Attribut | |
| delivery_party@address@boxno | Rechnung.LaApostfach | Attribut | |
| delivery_party@address@party_id | Rechnung.LaKnummer | Attribut | |
| delivery_party@address@country | Rechnung.LaAland | Attribut | |
| delivery_party@address@email | Rechnung.LaAnsprechpart.EMail | Attribut | |
| delivery_party@address@fax | Rechnung.LaAnsprechpart.Fax | Attribut | |
| delivery_party@address@phone | Rechnung.LaAnsprechpart.Telefon | Attribut | |
| payment_conditions | -- | Unterpunkt, Häufigkeit: Mehrfach möglich standardmäßig wird ein Datensatz erstellt | Unterpunkt, unter invoice möglich. Muss mindestens payment_conditions_text gefüllt enthalten. |
| payment_conditions@payment_conditions_text | Rechnung.Zahlungskonditionen | Attribut | |
| payment_conditions@currency | -- | Attribut | Text, wie er in den Optionen eingetragen ist |
| payment_conditions@due_date | Rechnung.Faelligkeitsdatum | Attribut | |
| payment_conditions@time_of_part_payment | Zahlung.Buchdatum | Attribut | Die Zahlung ist hier die zuletzt getätigte Zahlung mit der Art "Teilzahlung" |
| payment_conditions@amount_of_part_payment | Zahlung.Betrag | Attribut | Die Zahlung ist hier die zuletzt getätigte Zahlung mit der Art "Teilzahlung" |
| payment_conditions@time_of_payment | Zahlung.Buchdatum | Attribut | Die Zahlung ist hier die zuletzt getätigte Zahlung mit der Art "Anzahlung" |
| payment_conditions@amount_of_payment | Zahlung.Buchdatum | Attribut | Die Zahlung ist hier die zuletzt getätigte Zahlung mit der Art "Anzahlung" |
| payment_conditions@time_of_payment | Zahlung.Buchdatum | Attribut | Die Zahlung ist hier die zuletzt getätigte Zahlung mit der Art "Teilzahlung" |
| bonus, discount, rebate | -- | Unterpunkt, Häufigkeit: Mehrfach | Unterpunkt unter payment_conditions möglich. Pro enthaltenem Steuersatz. Mit dem diaLIMS derzeit nur rebate möglich. Wenn enthalten muss es mindestens den Steuersatz gefüllt enthalten. |
| payment_conditions@rebate@rebate_tax | -- | Attribut | Aktueller Steuersatz |
| payment_conditions@rebate@payment_date | Rechnung.Faelligkeitsdatum | Attribut | |
| payment_conditions@rebate@currency | -- | Attribut | Text, wie er in den Optionen eingetragen ist |
| payment_conditions@rebate@rebate_percentage | Rechnung.Rabattsatz | Attribut | |
| payment_conditions@rebate@rebate_base_amount | -- | Attribut | Die Summe aller Nettoendsummen der Positionen mit diesem Steuersatz |
| payment_conditions@rebate@rebate_amount | -- | Attribut | Den Rabattbetrag berechnet aus den rebate_base_amount |
| payment_conditions@rebate@rebate_tax_amount | -- | Attribut | Den Steuerbetrag berechnet aus dem rebate_base_amount |
| invoice_item_list@quantity | RechnungPosition.Menge | Attribut | |
| invoice_item_list@product_id | RechnungPosition.Artikelnummer | Attribut | |
| invoice_item_list@order_unit | RechnungPosition.Mengeneinheit | Attribut | |
| invoice_item_list@net_product_price | RechnungPosition.PreisnettoRabattiert | Attribut | |
| invoice_item_list@gross_product_price | RechnungPosition.EndpreisbruttoBerechnet | Attribut | |
| invoice_item_list@deliverynote_id | RechnungPosition.Lieferscheinnummer | Attribut | |
| invoice_item_list@delivery_date | RechnungPosition.Lieferdatum | Attribut | |
| InvoiceItemList@PriceLineAmount@Currency | -- | Attribut | Text, wie er in den Optionen eingetragen ist |
| InvoiceItemList@PriceLineAmount@tax_amount | RechnungPosition.UmsatzsteuerBerechnet | Attribut | |
| InvoiceItemList@PriceLineAmount@gross_price_line_amount | RechnungPosition.EndpreisbruttoBerechnet | Attribut | |
| InvoiceItemList@PriceLineAmount@net_price_line_amount | RechnungPosition.Endpreisnetto | Attribut | |
| invoice_item_list@deliverynote_id | RechnungPosition.Lieferscheinnummer | Attribut | |
| total_amount@tax_line@currency | -- | Attribut | Text, wie er in den Optionen eingetragen ist |
| total_amount@tax_line@gross_price_line_amount | -- | Attribut | Bruttobetrag für den aktuellen Steuersatz |
| total_amount@tax_line@net_price_line_amount | -- | Attribut | Nettobetrag für den aktuellen Steuersatz |
| total_amount@tax_line@tax_amount | -- | Attribut | Steuerbetrag für den aktuellen Steuersatz |
| total_amount@tax_line@net_total_amount | Rechnung.Endsummenetto | Attribut | |
| total_amount@tax_line@total_amount_deductions | Rechnung.rabatt | Attribut | Wenn positiv |
| total_amount@tax_line@total_amount_additions | Rechnung.rabatt | Attribut | Wenn negativ |