ZUGFeRD-Feldzuordnung – v.Soft
Vollständige Zuordnung aller in der ZUGFeRD/XRechnung-Schnittstelle abgebildeten Felder: Bezeichnung aus der ZUGFeRD Spezifikation, ZUGFeRD Business Term (BT), Feld in v.Soft-Maske, und Datenbankfeld.
Gruppierung nach Themenblock inkl. der Angabe der ZUGFeRD Business Group (BG)
Allgemeine Rechnungsangaben (BG-1, BG-2)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Rechnungsnummer | BT‑1 | Rechnung (gebucht) → Belegnummer (nur Anzeige in der Kopfleiste, kein eigenes Formularfeld mit Label) |
tbl_sale_booked_InvoiceHeads.BookedInvoiceNumber |
| Rechnungsdatum | BT‑2 | Rechnung → Belegdatum | tbl_sale_booked_InvoiceHeads.InvoiceDate |
| Rechnungsart | BT‑3 | (kein Eingabefeld – technisch bestimmt: Rechnung oder Gutschrift, je nachdem aus welcher Maske heraus erzeugt wird) | Kein DB-Feld – Parameter isInvoice der Aufrufmethode. Zahlencode nach UNTDID 1001: Rechnung → 380, Gutschrift → 381 |
| Währung | BT‑5 | Rechnung → Währung | tbl_sale_booked_InvoiceHeads.FK_CurrencyId |
| Fälligkeitsdatum | BT‑9 | Rechnung buchen (Buchungsdialog) → Zahlungsziel | tbl_sale_booked_InvoiceHeads.TimeOfPayment |
| Referenz des Käufers | BT‑10 | Rechnung → Bestellung (Fallback-Kette: zuerst Leitweg-ID aus den Kunden-EDocument-Parametern, sonst Feld „Bestellung“, sonst Auftragsnummer, sonst Rechnungsnummer) |
tbl_sale_booked_InvoiceHeads.CustomerOrderNumber bzw. .FK_OrderNumber bzw. .BookedInvoiceNumber (+ Leitweg-ID aus Kundenparametern, andere Tabelle) |
| Bestellreferenz | BT‑13 | Rechnung → Bestellung (+ „Bestellung vom“) | tbl_sale_booked_InvoiceHeads.CustomerOrderNumber (+ .CustomerOrderFrom) |
| Freitext zur Rechnung | BT‑22 | Rechnung → mehrere Quellen: Freitext-Positionszeilen; Zusatzfelder 1–10; Lieferbedingung; Bar-/Kartenzahlung; Freitext | tbl_sale_booked_InvoiceHeads.AddOnField1-10, .DeliveryCondition, .CashDeskCash, .CashDeskCard, .AddOnText (+ Positionstext) |
| Geschäftsprozess | BT‑23 | Rechnung → Überschrift | tbl_sale_booked_InvoiceHeads.Headline |
| Spezifikationskennung | BT‑24 | keine Beleg-Maske – Konfiguration der ZUGFeRD-Schnittstelle beim Kunden (EDocument-Parameter) | kein Datenbankfeld auf dem Beleg (Konfigurationsparameter) |
| Tatsächliches Lieferdatum | BT‑72 | Rechnung (Leistungsdatum) | tbl_sale_booked_InvoiceHeads.DayOfService |
| Anfangsdatum Rechnungszeitraum | BT‑73 | Rechnung (Leistungszeitraum von) | berechnet aus tbl_sale_booked_InvoiceHeads.TimeOfService |
| Enddatum Rechnungszeitraum | BT‑74 | Rechnung (Leistungszeitraum bis) | berechnet aus tbl_sale_booked_InvoiceHeads.TimeOfService |
| Code für die Zahlungsart | BT‑81 | Rechnung, Tab Zahlung & Lieferung → Zahlungsbedingung (abgeleitet) | tbl_sale_booked_InvoiceHeads.FK_PaymentPracticeId |
| Text zur Zahlungsart | BT‑82 | Bezeichnung der Zahlungsbedingung (Stammdaten) | tbl_common_PaymentPractices (Bezeichnung) |
| Summe Nettobeträge | BT‑106 | Rechnung → Positionen (berechnet) | berechnet: Summe tbl_sale_booked_InvoiceRows.TotalPriceNet |
| Gesamtbetrag ohne USt | BT‑109 | wie BT-106 | wie BT-106 |
| Steuergesamtbetrag (Buchungswährung) | BT‑111 | Rechnung → Positionen (berechnet, Brutto – Netto) | berechnet: Summe (tbl_sale_booked_InvoiceRows.TotalPriceGross – .TotalPriceNet) |
| Gesamtbetrag inkl. USt | BT‑112 | Rechnung → Positionen (berechnet) | berechnet: Summe tbl_sale_booked_InvoiceRows.TotalPriceGross |
| Fälliger Zahlungsbetrag | BT‑115 | wie BT-112 | wie BT-112 |
Verkäufer (BG-4, BG-5, BG-6)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Name des Verkäufers | BT‑27 | Unternehmensdaten → Firmenname 1 + Firmenname 2 (zusammengesetzt) | tbl_common_company_Infos.CompanyName1 + .CompanyName2 |
| USt-IdNr. des Verkäufers | BT‑31 | Unternehmensdaten → USt-ID (Attribut schemeID = VA) |
tbl_common_company_Infos.PurchaseTaxId |
| Steuernummer des Verkäufers | BT‑32 | Unternehmensdaten → Steuernummer (Attribut schemeID = FC) |
tbl_common_company_Infos.TaxNumber |
| Elektronische Adresse des Verkäufers | BT‑34 | Unternehmensdaten → Steuernummer (wiederverwendet) (Attribut schemeID = 9930) |
tbl_common_company_Infos.TaxNumber |
| Verkäuferanschrift – Straße | BT‑35 | Unternehmensdaten → Straße | tbl_common_company_Infos.Address |
| Verkäuferanschrift – Ort | BT‑37 | Unternehmensdaten → PLZ / Ort | tbl_common_company_Infos.City |
| Verkäuferanschrift – PLZ | BT‑38 | Unternehmensdaten → PLZ / Ort | tbl_common_company_Infos.PostCode |
| Verkäuferanschrift – Land | BT‑40 | Unternehmensdaten → Land | tbl_common_company_Infos.FK_CountryId |
| Kontaktstelle des Verkäufers | BT‑41 | Rechnung → Bearbeiter (Fallback: Firmenname) | tbl_sale_booked_InvoiceHeads.FK_EmployeeName_Editor |
| Telefonnummer Kontaktstelle Verkäufer | BT‑42 | kein eigenes Feld – automatisch aus dem Mitarbeiterstamm des Bearbeiters (Fallback: Firmentelefon) | tbl_sale_booked_InvoiceHeads.FK_EmployeeFon_Editor (bzw. tbl_common_company_Infos.Fon1) |
| E-Mail Kontaktstelle Verkäufer | BT‑43 | kein eigenes Feld – automatisch aus dem Mitarbeiterstamm des Bearbeiters (Fallback: Firmen-E-Mail) | tbl_sale_booked_InvoiceHeads.FK_EmployeeEmail_Editor (bzw. tbl_common_company_Infos.EMail) |
| Verkäuferanschrift – Zeile 3 | BT‑162 | Rechnung → Kundenbetreuer | tbl_sale_booked_InvoiceHeads.FK_EmployeeName_KeyAccountManager |
Käufer (BG-7, BG-8, BG-9)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Name des Käufers | BT‑44 | Rechnung, Tab Kunde → Anrede + Vorname + Nachname/Firma + Zusatzname (zusammengesetzt) | tbl_sale_booked_InvoiceHeads.FK_Title + .Name1 + .Name2 + .Name3 |
| Handelsname des Käufers | BT‑45 | wie BT-44 (wiederverwendet) | wie BT-44 |
| Globale Kennung des Käufers | BT‑46 | Rechnung, Tab Kunde → [Kunde] (Label konfigurierbar, Standard „Kunde“) (Attribut schemeID = 0208) |
tbl_sale_booked_InvoiceHeads.FK_CustomerNumber |
| Kennung rechtliche Registrierung Käufer | BT‑47 | wie BT-46 (Kundennummer wiederverwendet) (Attribut schemeID = 0208) |
wie BT-46 |
| USt-IdNr. des Käufers | BT‑48 | Rechnung, Tab Kunde → USt. Id (Attribut schemeID = VA) |
tbl_sale_booked_InvoiceHeads.PurchaseTaxId |
| Elektronische Adresse des Käufers | BT‑49 | Rechnung, Tab Kunde → St.Nr. (Fallback: E-Mail) | tbl_sale_booked_InvoiceHeads.TaxNumber bzw. .EMail |
| Käuferanschrift – Straße | BT‑50 | Rechnung, Tab Kunde → Straße | tbl_sale_booked_InvoiceHeads.Address |
| Käuferanschrift – Ort | BT‑52 | Rechnung, Tab Kunde → PLZ / Ort | tbl_sale_booked_InvoiceHeads.City |
| Käuferanschrift – PLZ | BT‑53 | Rechnung, Tab Kunde → PLZ / Ort | tbl_sale_booked_InvoiceHeads.Postcode |
| Käuferanschrift – Land | BT‑55 | Rechnung, Tab Kunde → Land | tbl_sale_booked_InvoiceHeads.FK_CountryId |
| Kontaktstelle des Käufers | BT‑56 | Rechnung, Tab Kunde → Kontaktperson | tbl_sale_booked_InvoiceHeads.Contact |
| E-Mail Kontaktstelle Käufer | BT‑58 | Rechnung, Tab Kunde → E-Mail | tbl_sale_booked_InvoiceHeads.EMail |
Lieferanschrift (BG-15)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Name des Warenempfängers | BT‑70 | Rechnung, Tab Zahlung & Lieferung → Lieferadresse: Anrede + Vorname + Nachname/Firma + Zusatzname (zusammengesetzt) | tbl_sale_booked_InvoiceHeads.FK_Title_Delivery + .Name1_Delivery + .Name2_Delivery + .Name3_Delivery |
| Globale Kennung Lieferort | BT‑71 | wie BT-46 (Kundennummer wiederverwendet) (Attribut schemeID = 0208) |
tbl_sale_booked_InvoiceHeads.FK_CustomerNumber |
| Lieferanschrift – Straße | BT‑75 | Tab Zahlung & Lieferung → Lieferadresse → Straße | tbl_sale_booked_InvoiceHeads.Address_Delivery |
| Lieferanschrift – Ort | BT‑77 | Tab Zahlung & Lieferung → Lieferadresse → PLZ / Ort | tbl_sale_booked_InvoiceHeads.City_Delivery |
| Lieferanschrift – PLZ | BT‑78 | Tab Zahlung & Lieferung → Lieferadresse → PLZ / Ort | tbl_sale_booked_InvoiceHeads.Postcode_Delivery |
| Lieferanschrift – Land | BT‑80 | Tab Zahlung & Lieferung → Lieferadresse → Land | tbl_sale_booked_InvoiceHeads.FK_CountryId_Delivery |
Zahlungsanweisungen (BG-16, BG-17, BG-18, BG-19)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Kennung des Zahlungskontos | BT‑84 | Unternehmensdaten → Bankkonten → IBAN / Kreditkarte | tbl_common_company_BankAccounts.IBAN |
| Name des Zahlungskontos | BT‑85 | Unternehmensdaten → Bankkonten → Kontoname | tbl_common_company_BankAccounts.BankAccountName |
| Kennung des Zahlungsdienstleisters | BT‑86 | Unternehmensdaten → Bankkonten → BIC | tbl_common_company_BankAccounts.BIC |
| Kennung der Mandatsreferenz | BT‑89 | Rechnung → Belegnummer (wiederverwendet als Mandatsreferenz) | tbl_sale_booked_InvoiceHeads.BookedInvoiceNumber |
| Kennung des Gläubigers | BT‑90 | Unternehmensdaten → Bankkonten → IBAN / Kreditkarte im Code wird hier die IBAN statt einer separaten Gläubiger-ID übergeben |
tbl_common_company_BankAccounts.IBAN |
| Bankinstitut des Käufers (Lastschrift) | BT‑91 | Kunde → Bankkonten → IBAN (SEPA-Konto) | tbl_sale_CustomerBankAccounts.IBAN |
Zahlungsbedingungen (BG-21)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Zahlungsbedingungen (Text) | BT‑20 | Rechnung → berechnet aus Skontotexten der Zahlungsbedingung + skontierbarem Betrag | tbl_common_PaymentPracticeDiscounts.DocumentText / .Days / .Percentage (+ berechnet) |
Referenzen & Anzahlung (BG-3)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Projektreferenz | BT‑11 | Rechnung, Tab Projekt & Service → [Projekt-Label, Standard „Projekt“] | tbl_sale_booked_InvoiceHeads.FK_ProjectNumber |
| Projektname | BT‑11-0 | wie BT-11, Feld [Projekt-Label] Name | tbl_sale_booked_InvoiceHeads.ProjectName |
| Vertragsreferenz | BT‑12 | Rechnung, Tab Projekt & Service → [Vertrags-Label, konfigurierbar] | tbl_sale_booked_InvoiceHeads.FK_ContractNumber |
| Verkaufsauftragsreferenz | BT‑14 | Rechnung → Auftragnr. | tbl_sale_booked_InvoiceHeads.FK_OrderNumber |
| Referenz vorausgegangene Rechnung | BT‑25 | nur bei Anzahlungspositionen – aus dem Positionstext ermittelt | abgeleitet aus tbl_sale_booked_InvoiceRows.Name1 der Anzahlungsposition |
| Rechnungsdatum vorausgeg. Rechnung | BT‑26 | wie BT-25 | wie BT-25 |
| Objektkennung (Anlage / Lieferschein) | BT‑128 | Rechnung, Tab Projekt & Service → [Anlage-Label] bzw. Buchungsassistent → Lieferbeleg (zwei Instanzen; TypeCode InvoiceDataSheet bzw. ReferenceDocument) |
tbl_sale_booked_InvoiceHeads.FK_FacilityNumber bzw. .DeliveryDocument |
Positionen (BG-25, BG-26, BG-27, BG-32)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Kennung der Rechnungsposition | BT‑126 | Positionen-Grid → Positionsnummer (automatisch vergeben) | tbl_sale_booked_InvoiceRows.PositionNumber |
| Freitext zur Position | BT‑127 | Positionen-Grid → [Anlage-Label] / [Vertrags-Label] auf Zeilenebene (zusammengesetzt) | tbl_sale_booked_InvoiceRows.FK_FacilityNumber + .FK_ContractNumber |
| In Rechnung gestellte Menge | BT‑129 | Positionen-Grid → Menge | tbl_sale_booked_InvoiceRows.Amount |
| Code der Maßeinheit | BT‑130 | Positionen-Grid → Einheit (Attribut unitCode) |
tbl_sale_booked_InvoiceRows.FK_PackagingUnitId |
| Nettobetrag der Rechnungsposition | BT‑131 | Positionen-Grid → berechnet (Menge – mal Nettopreis, abzüglich Rabatt) | tbl_sale_booked_InvoiceRows.TotalPriceNet |
| Nettopreis des Artikels | BT‑146 | Positionen-Grid → Nettopreis | tbl_sale_booked_InvoiceRows.PriceNet |
| Code Umsatzsteuerkategorie (Position) | BT‑151 | Positionen-Grid → MWSt-Satz (abgeleitet über das Steuerkennzeichen) | tbl_sale_booked_InvoiceRows.PurchaseTaxRate (+ tbl_sale_booked_InvoiceHeads.FK_PurchaseTaxFlagId) |
| Umsatzsteuersatz für den Artikel | BT‑152 | Positionen-Grid → MWSt-Satz | tbl_sale_booked_InvoiceRows.PurchaseTaxRate |
| Artikelname | BT‑153 | Positionen-Grid → Bezeichnung 1 + Bezeichnung 2 (zusammengesetzt) | tbl_sale_booked_InvoiceRows.Name1 + .Name2 |
| Artikelbeschreibung | BT‑154 | Positionen-Grid → Beschreibung üffnen (Popover) | tbl_sale_booked_InvoiceRows.Description |
| Artikelkennung des Verkäufers | BT‑155 | Positionen-Grid → Nummer | tbl_sale_booked_InvoiceRows.Number |
| Artikelkennung des Käufers | BT‑156 | Positionen-Grid → Kunden-Preis-Kennzeichen (Standard ausgeblendet) | tbl_sale_booked_InvoiceRows.CustomerArticleNumber |
| Kennung Artikel nach Schema | BT‑157 | Positionen-Grid → Externe Artikelnummer (Standard ausgeblendet) (Attribut schemeID = 0208) |
tbl_sale_booked_InvoiceRows.Matchcode |
| Artikelattributname | BT‑160 | mehrere Quellen: Typ; Artikelmerkmal 1–3; Zusatzfelder Position 1–5; Chargennummer; Seriennummer; Stücklisten-/Setkomponenten | tbl_sale_booked_InvoiceRows.FK_RowTypeId / .FK_ArticleAttribute1-3 / .AddOnField1-5 / .BatchNumber u.a. |
| Artikelattributwert | BT‑161 | wie BT-160 (zugehöriger Wert) | wie BT-160 |
| Betrag des Abschlags (Position) | BT‑136 | Positionen-Grid → Nettorabattbetrag (Standard ausgeblendet) | tbl_sale_booked_InvoiceRows.TotalRebateAmountNet |
| Grundbetrag des Abschlags (Position) | BT‑137 | Positionen-Grid → berechnet (Nettopreis mal Menge) | berechnet: tbl_sale_booked_InvoiceRows.PriceNet mal .Amount |
| Prozentualer Abschlag (Position) | BT‑138 | Positionen-Grid → Rabattsatz | tbl_sale_booked_InvoiceRows.RebatePercentage |
| Grund des Abschlags (Position) | BT‑139 | fester, sprachabhängig übersetzter Text „Rabatt“ | kein DB-Feld (fester übersetzter Text) |
Steueraufschlüsselung (BG-23)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Steuerbasisbetrag (Kategorie) | BT‑116 | Rechnung → Positionen (berechnet je Steuerkategorie) | berechnet: Summe tbl_sale_booked_InvoiceRows.TotalPriceNet, gruppiert nach Steuerkategorie |
| Steuerbetrag (Kategorie) | BT‑117 | wie BT-116 (Brutto – Netto Differenz) | berechnet: Summe (tbl_sale_booked_InvoiceRows.TotalPriceGross – .TotalPriceNet), gruppiert |
| Code der Umsatzsteuerkategorie | BT‑118 | wie BT-151 (Positionsebene, aggregiert) | tbl_sale_booked_InvoiceRows.PurchaseTaxRate (+ .FK_PurchaseTaxFlagId) |
| Umsatzsteuersatz (Kategorie) | BT‑119 | wie BT-152 (Durchschnitt je Kategorie) | Durchschnitt aus tbl_sale_booked_InvoiceRows.PurchaseTaxRate |
| Grund Steuerbefreiung (Text) | BT‑120 | kein v.Soft-Feld – wird von der ZUGFeRD-Bibliothek automatisch anhand des Kategorie-Codes erzeugt | kein DB-Feld |
| Code Steuerbefreiungsgrund | BT‑121 | automatisch aus der Steuerkategorie abgeleitet (E/AE, G, K) | abgeleitet aus tbl_sale_booked_InvoiceRows.PurchaseTaxRate (+ .FK_PurchaseTaxFlagId) |
Rechnungsbegründende Unterlagen (BG-24)
| Feldname (ZUGFeRD) | BT‑ID | v.Soft-Feld | Datenbankfeld |
|---|---|---|---|
| Kennung rechnungsbegründende Unterlage | BT‑122 | Rechnung → angehängte Dateien (Dateiname) | Dateiname der hochgeladenen Anlage (kein DB-Feld) |
| Beschreibung rechnungsbegründende Unterlage | BT‑123 | wie BT-122 (Dateiname als Beschreibung) | wie BT-122 |
| Anhangsdokument | BT‑125 | Rechnung → angehängte Dateien (Dateiinhalt) | Dateiinhalt der hochgeladenen Anlage (kein DB-Feld) |
| Dateiname Anhangsdokument | BT‑125-2 | wie BT-122 (Attribut filename) |
wie BT-122 |