13 Schnittstellen

ZUGFeRD <-> v.Soft Feldzuordnung

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

 

War dieser Beitrag hilfreich?