Beispiele & Variablen
In der Spaltenkonfiguration legst du fest, was in welche Spalte der DATEV Datei geschrieben wird. Hier findest du den Aufbau, Beispiele und alle Variablen, die das Plugin in Magento 2 füllt. Außerdem erklärt die Seite, wie du Erlöskonten genauer zuordnest.
Aufbau
Jede Zeile hat die Form Spalte:Inhalt. Die Spalte ist ein Buchstabe wie in einer Tabellenkalkulation, von A bis DZ. Als Inhalt trägst du einen festen Text, eine Variable oder beides zusammen ein.
K:{order_number}
U:Eigene Beschreibung
V:{billing_firstname} {billing_lastname}
AB:{customer_number} mein Text {billing_country_iso}- K: In Spalte K steht die Bestellnummer.
- U: In Spalte U steht immer derselbe Text.
- V: Mehrere Variablen lassen sich kombinieren, hier Vor- und Nachname.
- AB: Variablen und Text lassen sich mischen.
Beträge schreibt das Plugin mit Komma und zwei Nachkommastellen, zum Beispiel 16,80. Datumswerte stehen im Format TT.MM.JJJJ.
Bedingungen mit expr#
Beginnt ein Inhalt mit expr#, wertet das Plugin eine Bedingung aus. In der Bedingung schreibst du Variablen mit $ statt mit Klammern. Beträge sind dort Zahlen mit Punkt, zum Beispiel $total_price mit dem Wert 16.8. Dieses Beispiel aus der Vorgabe schreibt die USt-IdNr., wenn eine vorhanden ist, sonst das Lieferland:
AN:expr#{if $eu_vat != ""}{eu_vat}{else}{shipping_country_iso}{/if}Mehr dazu steht unter Expression.
Variablen
Bestellung und Beleg
| Variable | Inhalt |
|---|---|
| {order_number} | Bestellnummer |
| {order_date} | Bestelldatum |
| {document_number} | Nummer der Rechnung oder Gutschrift |
| {invoice_number} | Wie {document_number} |
| {document_date} | Datum der Rechnung oder Gutschrift |
| {invoice_date} | Wie {document_date} |
| {document_currency_code} | Währung des Belegs, zum Beispiel EUR |
| {payment_method} | Code der Zahlungsart in Magento, zum Beispiel checkmo |
| {order_coupon_code} | Gutscheincode der Bestellung |
| {store_id} | ID der Store View |
Kunde
| Variable | Inhalt |
|---|---|
| {customer_number} | Kunden-ID in Magento, bei Gastbestellungen leer |
| {customer_email} | E-Mail-Adresse aus der Bestellung |
Rechnungsadresse und Lieferadresse
Für die Lieferadresse gibt es dieselben Variablen mit shipping_ statt billing_, zum Beispiel {shipping_city}.
| Variable | Inhalt |
|---|---|
| {billing_company} | Firma |
| {billing_vat} | USt-IdNr. |
| {billing_firstname} | Vorname |
| {billing_lastname} | Nachname |
| {billing_address} | Straße und Hausnummer |
| {billing_additional_address_1} | Adresszusatz 1 |
| {billing_additional_address_2} | Adresszusatz 2 |
| {billing_postal_code} | PLZ |
| {billing_city} | Ort |
| {billing_country_iso} | Land als ISO-Code, zum Beispiel DE |
| {billing_country} | Land als Name, zum Beispiel Deutschland |
| {billing_phone} | Telefonnummer |
Position
| Variable | Inhalt |
|---|---|
| {position_name} | Name der Position |
| {position_number} | Artikelnummer (SKU) |
| {position_type} | Produkttyp wie simple oder configurable. Bei anderen Zeilen: shipping, discount, amasty_gift_cart, mirasvit_reward_points, adjustment_refund oder adjustment_fee |
| {position_quantity} | Menge |
| {position_unit_price} | Einzelpreis |
| {position_gross} | Bruttobetrag |
| {position_net} | Nettobetrag |
| {position_taxes} | Steuerbetrag |
| {position_tax_rate} | Steuersatz |
| {coupon_code} | Gutscheincode, nur in Rabattzeilen |
| {amasty_coupon_code} | Code der Amasty Geschenkkarte, nur in diesen Zeilen |
| {reward_points} | Eingesetzte Mirasvit Prämienpunkte, nur in diesen Zeilen |
Buchung
| Variable | Inhalt |
|---|---|
| {erloes} | Erlöskonto aus der Einstellung Erlöskonten |
| {erloes_konto} | Wie {erloes} |
| {datev_row_amount} | Betrag der Buchungszeile |
| {total_price} | Wie {datev_row_amount} |
| {soll_haben} | S oder H |
| {position_datev_type} | Art der Zeile: POSITION, SHIPPING oder COUPON |
EU-Lieferungen (OSS)
| Variable | Inhalt |
|---|---|
| {eu_country_iso} | Lieferland, wenn es in der EU liegt, sonst leer |
| {eu_vat} | USt-IdNr. der Lieferadresse bei einer EU-Lieferung, sonst leer |
| {eu_tax_rate} | Steuersatz der Position bei einer EU-Lieferung |
| {origin_country_iso} | Land deines Shops aus der Einstellung Land |
| {origin_tax_rate} | Passender Steuersatz im Land deines Shops |
Eigene Attribute
| Variable | Inhalt |
|---|---|
| {order_cf_CODE} | Wert des Bestellattributs mit dem Code CODE |
| {product_cf_CODE} | Wert des Produktattributs mit dem Code CODE |
Ersetze CODE durch den Attributcode aus Magento, zum Beispiel {product_cf_manufacturer}. Das Plugin liest das Attribut automatisch, sobald die Variable in der Spaltenkonfiguration oder in den Erlöskonten steht.
Erlöskonten im Detail
Jede Zeile in den Erlöskonten hat die Form Steuersatz:Konto. Mit einem Merkmal und einem Land kannst du genauer zuordnen: Steuersatz:Konto:Merkmal:Land.
- VAT: Die Zeile gilt nur, wenn die Lieferadresse eine USt-IdNr. hat.
- SHIPPING: Die Zeile gilt nur für Versandkosten.
- COUPON: Die Zeile gilt nur für Gutscheine und Rabatte.
- VAT-SHIPPING und VAT-COUPON verbinden beides.
- Land: ISO-Code des Lieferlands. Ohne Merkmal schreibst du zwei Doppelpunkte, zum Beispiel
19:4400::AT. - d als Steuersatz gilt für alle Steuersätze, die keine eigene Zeile haben.
| Zeile | Bedeutung |
|---|---|
| 19:4400 | Umsätze mit 19 % auf Konto 4400 |
| 19:4400:VAT | … nur, wenn die Lieferadresse eine USt-IdNr. hat |
| 19:4400::AT | … nur für Lieferungen nach Österreich ohne USt-IdNr. |
| 19:4400:VAT:AT | … nur mit USt-IdNr. und bei Lieferung nach Österreich |
| 19:4400:SHIPPING | … nur für Versandkosten |
| 19:4400:SHIPPING:AT | … nur für Versandkosten bei Lieferung nach Österreich ohne USt-IdNr. |
| 19:4400:VAT-SHIPPING | … nur für Versandkosten, wenn eine USt-IdNr. vorliegt |
| 19:4400:COUPON | … nur für Gutscheine und Rabatte |
| 19:4400:VAT-COUPON | … nur für Gutscheine, wenn eine USt-IdNr. vorliegt |
| d:4120 | Alle Steuersätze ohne eigene Zeile auf Konto 4120 |
Die Konten sind Beispiele für den Kontenrahmen SKR04. Welche Liste gilt, entscheidet das Lieferland, oder das Land der Rechnungsadresse, wenn keine Lieferadresse da ist. Ist es das Land deines Shops, gelten die Inlands-Erlöse. Liegt es in der EU, gelten die Umsatzerlöse aus EU-Lieferungen, sonst die für Drittländer.
Findet das Plugin für Versandkosten oder Gutscheine keine eigene Zeile, nimmt es die Zeile für normale Positionen. Fehlt eine passende Zeile mit VAT, gilt die allgemeine Zeile ohne Merkmal und ohne Land. Eine Zeile mit # am Anfang wird nicht verwendet.