WmsInvoice

Accantum.Wms.ActivityContracts.Models.Invoice.V01

 

Beinhaltet Daten zu einer Rechnung. Dieser Typ wird u.a. dazu verwendet Aufgaben zur Bearbeitung und Kontierung einer Rechnung zu starten.

Inhalt

Spezifikation

  • Die in Klammern angegebene BT-Spezifikation bezieht sich auf die Business Terms der europäischen Norm für elektronische Rechnungen (EN 16931-1)

  • Die Namen der Objekteigenschaften sind an die Feld-Bezeichnungen der Spezifikation ZUGFeRD 2.0 angelehnt.

Muster einer E-Rechnung

Ein Muster einer elektronischen Rechnung, in dem Sie sehen, welche Felder mit welcher  BT-Spezifikation zu finden sind finden Sie auf der Seite der Arbeitsagentur:
https://www.arbeitsagentur.de/datei/muster-e-rechnung-inklusive-feldinhalte_ba146727.pdf

Hauptdatensatz einer Rechnung (WmsInvoice)

Die Klasse WmsInvoice enthält die wichtigsten Daten einer Rechnung.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Version

Interne Versionsnummer für das Rechnungsobjekt (für eine spätere Migration bei Änderungen)

Version

QualifiedDatasource

Kennzeichen, ob die Daten von einer qualifizierten Datenquelle stammen (z.B. ZUGFeRD, XRechnung, ebInvoice).
Wenn true, dann kann davon ausgegangen werden, dass die enthaltenen Daten korrekt sind.

Boolean

DatasourceName

Name der Datenquelle (z.B. ZUGFeRD, XRechnung, Capture, Manuell, etc.)

Wird das WmsInvoice-Objekt von einer ZUGFeRD-Rechnung konvertiert, ist hier das Profil (Basic, Comfort, Extended) hinterlegt.

String

DocumentId

ID des Dokuments (z.B. die interne ID des DMS-Dokuments) zwecks eindeutiger Zuordnung zum zugrundeliegenden Beleg.

String

ExternalId

Externe ID des Dokuments aus einem Drittsystem

String

InvoiceNumber

Rechnungsnummer (BT-1)

String

InvoiceIssueDate

Rechnungsdatum (BT-2)

DateTime

InvoiceTypeCode

Typ-Code der Rechnung (BT-3)
Es sind nur Werte aus der Codeliste UNTDID 1001 erlaubt. Folgende Codes werden empfohlen:

  • 325: Proforma-Rechnung

  • 326: Teilrechnung

  • 380: Handelsrechnung

  • 381: Gutschriftanzeige

  • 384: Rechnungskorrektur

  • 389: Selbst ausgestellte Rechnung - Gutschrift im Gutschriftsverfahren (eine Rechnung, die der Zahlungsverpflichtete selbst ausstellt anstelle des Verkäufers.)
    Für die XRechnung sollen nur einer der folgenden Codes übermittelt werden: 326, 380, 381, 384, 389

String

Seller

Verkäufer-Informationen (siehe Tabelle Adressdetails)

WmsAddressDetails

Buyer

Käufer-Informationen (siehe Tabelle Adressdetails)

WmsAddressDetails

SellerOrderReferenceId

Veraltet - verwenden Sie stattdessen die Eigenschaft SellerOrderReference vom Typ WmsReferencedDocument

String

SellerOrderReference

Referenz auf die Auftragsbestätigung

Die Eigenschaft IssuerAssignedId enthält die Nummer der Auftragsbestätigung bzw. eine vom Verkäufer ausgegebene Kennung für einen referenzierten Verkaufsauftrag (BT-14) 

WmsReferencedDocument

BuyerOrderReferenceId

Veraltet - verwenden Sie stattdessen die Eigenschaft BuyerOrderReference vom Typ WmsReferencedDocument

String

BuyerOrderReference

Referenz auf die Bestellung

Die Eigenschaft IssuerAssignedId enthält die Bestellnummer bzw.  eine vom Käufer ausgegebene Kennung für eine referenzierte Bestellung (BT-13)

WmsReferencedDocument

ContractReference

Referenz auf den zugehörigen Vertrag

Die Eigenschaft IssuerAssignedId enthält die Vertragsnummer (BT-12)

WmsReferencedDocument

BuyerReference

Referenz des Käufers (BT-10)
Eine vom Käufer zugewiesene und für internes Routing benutzte Kennung. Die Referenz wird vom Käufer festgelegt (z. B. Kontaktdaten, Abteilung, Bürokennung, Projektcode), vom Verkäufer aber in der Rechnung angegeben.
Bei einer XRechnung muss hier die Leitwegs-ID eingetragen werden (Pflicht gem. ERechV des Bundes)
z.B. für die Auftragsreferenz des Bundes (Österreich) (https://www.erechnung.gv.at/erb?p= einvoice_info_fedgov_orderref)

String

BillingSpecifiedPeriod

Optionale Angabe zur Rechnungsperiode (BG-14)
Null, wenn keine Rechnungsperiode angegeben ist

WmsInvoicePeriod

DeliveryInformation

Informationen zur Lieferung

WmsDeliveryInformation

PaymentTerms

Zahlungsbedingungen (siehe Tabelle Zahlungsbedingungen)

WmsPaymentTerms

PaymentMeans

Zahlungsanweisung (siehe Tabelle Zahlungsanweisung)

WmsPaymentMeans

IncludedNotes

Freitext zur Rechnung (BG-1)

Liste<WmsInvoiceNote>

AdditionalReferenced-Documents

Zusätzlich referenzierte Dokumente (BG-24)

Liste<WmsAdditionalReferencedDocument>

LanguageId

Sprache (de, en, es, it, fr, …)
Es werden Ländercodes nach ISO 3166-1 verwendet

String

Currency

Währung (BT-5)
Es werden Währungscodes nach ISO 4217 verwendet.

Eine angegebene Währung bezieht sich immer auf das gesamte Dokument.
Ist keine Währung angegeben, dann wird immer EUR angenommen.
Bei einer angegebenen Fremdwährung muss auch ein Umrechnungskurs angegeben werden (ExchangeRate)

String

ConversionRate

Umrechnungskurs bei ausländischer Währung (muss 6 Nachkommastellen haben)
Wertebereich (lt. Datev): 0.000001 – 9999.999999

RegEx-Pattern: \[\+\-\]?(\[1-9\]\d\{0,3\}|0)(\.\d\{6\})

 

WMS 1.1.4 Aufgrund einer Änderung der ZUGFeRD-Library wird der Umrechnungskurs nicht mehr automatisch aus dem XML der elektronischen Rechnung ausgelesen.

String

AllowanceChargeList

Liste mit Zu- bzw. Abschläge auf Dokumentebene (BG-20, BG-21)

Liste<WmsAllowanceCharge>

MonetarySummation

Gesamtbeträge der Rechnung (siehe Tabelle Gesamtbeträge der Rechnung)

WmsMonetarySummation

TaxDetails

Liste mit Steuer-Informationen(siehe Tabelle Steuer-Informationen)

Liste<WmsTaxDetail>

LineItems

Tabelle mit Rechnungspositionen (siehe Tabelle Positionstabelle)

Liste<WmsInvoiceLineItem>

PrecedingDocumentReferences

Liste mit Informationen zu referenzierten Dokumenten, welche für die Rechnungsstellung relevant sind (z.B. Bestellung, Lieferschein, etc.)

Liste<WmsPrecedingDocumentReference>

AccountingInformation

Informationen zu Kontierungs- und Buchhaltungs-daten

WmsAccountingInformation

AdditionalInfo1-10

Zusatzinfo 1-10

String

AdditionalInteger1-2

Zusatzinformationen mit einer Ganzzahl

Integer

AdditionalDateTime1-2

Zusatzinformationen mit Datum

DateTime

AdditionalBool1-2

Zusätzlichinformationen mit Ja oder nein

bool

Methoden WMS 2020 (1.1.1)

Methode

Beschreibung

Methode

Beschreibung

bool SetValue (string propertyName, object value)

Setzt den Wert einer Eigenschaft über den Namen.

Gibt true zurück, wenn der Wert gesetzt wurde und false, wenn es die angegebene Eigenschaft nicht gibt. Sollte der angegebene Wert nicht zu der Eigenschaft passen (wird z.B. einer Zahl ein Datum zugewiesen), dann wirft die Methode eine "TargetException".

  • propertyName:  Name einer Eigenschaft aus dem Rechnungsobjekt (siehe Liste oben)
    Wenn es eine "Unter-Eigenschaft" betrifft (z.B. die "AdressDetails" des "Buyer"), dann muss der komplette Pfad mit "." getrennt angegeben werden.

  • value: Wert, der gesetzt werden soll.

Der Typ des Wertes den sie setzen sollte zu der Eigenschaft passen. Für eine Decimal-Eigenschaft (wie TotalAmount) setzen Sie als als Wert eine Zahl, und keinen String. Wenn Sei versuchen einen String zu setzen, müssren Sie die Sprache (Culture) beachten, da sich Trennzeichen je nach Sprache unterscheiden.

object GetValue (string propertyName)

Ermittelt einen Wert zu einer Eigenschaft aus dem WmsInvoice. Wenn Sie den Wert aus einem "Unter-Objekt" ermitteln wollen, treffen Sie die Eigenschaftsnamen mit einem ".".

  • Die GetValue-Methode liefer den Typ “object” zurück, da sie nicht weiß, welche Eigenschaft sie angegeben haben. Um typsiert mit dem Wert weiter zu arbeiten müssen Sie ihn umwandeln. Bei string einfach mit ToString, bei anderen Typen z.B. mit Convert.ToDecimal. Details finden Sie hier: Visual Basic - Typen

  • Werte von AccountingRecords und LineItems rufen Sie mit der entsprechenden Methode in WmsAccountingRecord bzw. WmsLineItem ab: z.B.
    wmsInvoice.LineItems(0).GetValue(“Description“).

Adressdetails (WmsAddressDetails)

Die Klasse WmsAddressDetails enthält die wichtigsten Adressdaten und die Umsatzsteuer-ID und wird sowohl für den Verkäufer (BG-5) als auch für den Käufer (BG-7) und der Lieferadresse (BG-15) verwendet.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

ReferenceId

Nummer (Verkäufer: BT-29, Käufer: BT-46, Lieferanschrift: BT-71)

String

GlobalId

Globale ID (Verkäufer: BT-29-0, Käufer: BT-46-0, Lieferanschrift: BT-71-0)

String

GlobalSchemeId

Kennung des Schemas für die GlobalId (Verkäufer: BT-29-1, Käufer: BT-46-1, Lieferanschrift: BT-71-1)
Wird die Kennung für das Identifikationsschema verwendet, muss sie aus den Einträgen der von der ISO/IEC 6523 Maintenance Agency veröffentlichten Liste ausgewählt werden.
Insbesondere können folgende Codes genutzt werden:

  • 0021 : SWIFT

  • 0088 : EAN

  • 0060 : DUNS

  • 0177 : ODETTE

String

Name

Name (Verkäufer: BT-27, Käufer: BT-44, Lieferanschrift: BT-70)

String

Postcode

Postleitzahl (Verkäufer: BT-38, Käufer: BT-53, Lieferanschrift: BT-78)
XRechnung: Pflichtangabe für Verkäufer und Käufer

String

CityName

Ort (Verkäufer: BT-37, Käufer: BT-52, Lieferanschrift: BT-77)
XRechnung: Pflichtangabe für Verkäufer und Käufer

String

AddressLine1

Adresszeile 1 (Verkäufer: BT-35, Käufer: BT-50, Lieferanschrift: BT-75)

String

AddressLine2

Adresszeile 2 (Verkäufer: BT-36, Käufer: BT-51, Lieferanschrift: BT-76)

String

AddressLine3

Adresszeile 3 (Verkäufer: BT-162, Käufer: BT-163, Lieferanschrift: BT-165)

String

CountryId

Ländercode (Verkäufer: BT-40, Käufer: BT-55, Lieferanschrift: BT-79)
Es werden Ländercodes nach ISO 3166-1 verwendet

String

CountrySubdivision-Name

Bundesland (Verkäufer: BT-39, Käufer: BT-54, Lieferanschrift: BT-79)

String

TaxId

Steuer- bzw. Umsatzsteuer-ID (Verkäufer: BT-31/32, Käufer: BT-48, Lieferanschrift: -)
RegEx-Pattern (lt. Datev): \[0-9a-zA-Z\. _\]\{1,15\}

String

Contact

Kontaktdaten (Verkäufer: BG-6, Käufer: BG-9, Lieferanschrift: ---)

WmsAddressContact


Kontaktdaten (WmsAddressContact)

Die Klasse WmsAddressContact enthält die Kontaktdaten zur Adresse und wird sowohl für den Verkäufer (BG-6) als auch für den Käufer (BG-9) und der Lieferadresse verwendet. Bei einer XRechnung muss eine Kontaktadresse des Verkäufers (BG-6) angegeben werden.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

PersonName

Name (Verkäufer: BT-41, Käufer: BT-56, Lieferant: -)
XRechnung: Pflichtangabe für Verkäufer (BT-41)

String

DepartmentName

Abteilung (Verkäufer: BT-41-0, Käufer: BT-56-0, Lieferant: -)

String

Phone

Telefon (Verkäufer: BT-42, Käufer: BT-57, Lieferant: -)
XRechnung: Pflichtangabe für Verkäufer (BT-42)

String

Email

E-Mail- bzw. De-Mail-Adresse (Verkäufer: BT-43, Käufer: BT-58, Lieferant: -)
XRechnung: Pflichtangabe für Verkäufer (BT-43)

String

Abrechnungsperiode (WmsInvoicePeriod)

Die Klasse WmsInvoicePeriod enthält Informationen zur Bestimmung einer Abrechnungsperiode (Rechnung: BG-14; Rechnungsposition: BG-26)

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

StartDate

Beginn der Rechnungsperiode (Rechnung: BT-73; Rechnungsposition: BT-134)

DateTime

EndDate

Ende der Rechnungsperiode (Rechnung: BT-74; Rechnungsposition: BT-135)

DateTime

Lieferinformationen (WmsDeliveryInformation)

Die Klasse WmsDeliveryInformation enthält Informationen zur Lieferung.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

OccurenceDate

Tatsächlicher Lieferungszeitpunkt bzw. Datum der Leistungserbringung (BT-72)

DateTime

DeliveryAddress

Informationen zur abweichenden Lieferanschrift (BG-15)

WmsAddressDetails

Zahlungsbedingungen (WmsPaymentTerms)

Die Klasse WmsPaymentTerms enthält Informationen zu den Zahlungsbedingungen der Rechnung.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

DueDate

Fälligkeitsdatum (BT-9)

DateTime

Description

Beschreibung der Zahlungsbedingungen (BT-20)
Die Textbeschreibung der Zahlungsbedingungen, die für den fälligen Zahlungsbetrag gelten (einschließlich Beschreibung möglicher Skonto- und Verzugsbedingungen). Dieses Informationselement kann mehrere Zeilen und mehrere Angaben zu Zahlungsbedingungen beinhalten und sowohl unstrukturierten als strukturierten Text enthalten. Der unstrukturierte Text darf dabei keine # enthalten.

Besonderheit der XRechnung (Geschäftsregel: BR-DE-18):
Informationen zur Gewährung von Skonto oder zur Berechnung von Verzugszinsen müssen wie folgt im Element „Payment terms" (BT-20) jeweils in einer eigenen Zeile übermittelt werden:
Anzugeben ist im ersten Segment „SKONTO" oder „VERZUG", im zweiten „TAGE=n", im dritten „PROZENT=n", wobei die Segmente jeweils von einer „#" umfasst sind. Prozentzahlen sind mit Punkt getrennt von zwei Nachkommastellen anzugeben. Liegt dem zu berechnenden Betrag nicht „fälliger Betrag" (BT-115) zugrunde, sondern nur ein Teil des fälligen Betrags der Rechnung, ist der Grundwert zur Berechnung von Skonto oder Verzugszins als viertes Segment „BASISBETRAG=n" mit dem semantischen Datentyp Amount anzugeben.
Formatanweisung z.B. #SKONTO#TAGE=14#PROZENT=2.25# oder #SKONTO#TAGE=14#PROZENT=2.25#BASISBETRAG=357.93#

Alle Angaben zur Gewährung von Skonto oder zur Berechnung von Verzugszinsen müssen in Großbuchstaben gemacht werden. Zusätzliches Whitespace (Leerzeichen, Tabulatoren oder Zeilenumbrüche) ist nicht zulässig. Andere Zeichen oder Texte als in den oberen Beispielen genannt sind nicht zulässig.



Zahlungsanweisung (WmsPaymentMeans)

Die Klasse WmsPaymentMeans enthält Informationen zur Zahlungsanweisung einer Rechnung. Eine XRechnung muss Angaben zu „PAYMENT INSTRUCTIONS" (BG-16) enthalten.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

TypeCode

Code für Zahlungsart (BT-81)
Der angegebene Wert muss einem Wert aus der Codeliste UNTDID 4461 entsprechen. Insbesondere können folgende Codes verwendet werden:

  • 0: Gegenseitig zwischen Handelspartnern vereinbart, bis ein genauer Code zugeordnet werden kann (entspricht UNTDID 4461: ZZZ)

  • 10: Bargeld

  • 20: Scheck

  • 30: Überweisung

  • 42: Payment to bank account

  • 48: Kartenzahlung

  • 49: Lastschrift

  • 54: Kreditkarte

  • 55: Debitkarte

  • 57: Dauerauftrag

  • 58: SEPA Credit Transfer

  • 59: SEPA Direct Debit

  • 68: Online payment service (z.B. Paypal, AmazonPay, GooglePay)

  • 97: Zwischen Partnern verrechnen

  • ZZZ: Wenn kein passender Code existiert
    https://www.xrepository.de/details/urn:xoev-de:xrechnung:codeliste:untdid.4461_1

String

TypeDescription

Beschreibung der Zahlungsart (BT-82)
z.B. bar, per Überweisung, Lastschrift, Kreditkarte, PayPal, etc.

String

PayeeBic

BIC des Zahlungsempfängers (BT-86)

RegEx-Pattern (lt. Datev): (\[A-Z\]\{4\}\[A-Z\]\{2\}(\[A-Z0-9\])\{2\}(\[A-Z0-9\])\{0,3\})

String

PayeeIban

IBAN des Zahlungsempfängers (BT-84)
Bei Lastschrift wird hier die IBAN des zu belastenden Kontos angegeben.

RegEx-Pattern (lt. Datev): (\[A-Z\]\{2\}\d\d(\[A-Za-z0-9\])\{11,30\})

String

PayeeAccountName

Name des Bankkontos des Zahlungsempfängers (Überweisung: BT-85)

String

PayerIban

IBAN des Zahlungspflichtigen bei Lastschrift (BT-91)

RegEx-Pattern (lt. Datev): (\[A-Z\]\{2\}\d\d(\[A-Za-z0-9\])\{11,30\})

String

CardNumber

Die Hauptkontonummer (en: Primary Account Number, PAN), zu der die für die Zahlung genutzte Karte gehört (BT-87).
Falls in der Rechnung Informationen zur verwendeten Zahlungskarte (BG-18) angegeben sind, müssen die letzten 4 bis 6 Ziffern der Zahlungskartennummer angezeigt werden.

String

CardholderName

Name des Zahlungskarteninhabers (BT-88)

String

PaymentReference

Verwendungszweck (BT-83)

String

DirectDebitMandateId

Eindeutige Kennung, die vom Zahlungsempfänger zur Referenzierung der Einzugsermächtigung zugewiesen wird (Mandatsreferenznummer, BT-89, bei SEPA Lastschrift)

String

CreditorReferenceId

Eindeutige Bankverbindungskennung des Zahlungsempfängers oder des Verkäufers (Gläubiger), die von der Bank des Zahlungsempfängers oder des Verkäufers zugewiesen wird (BT-90, bei SEPA Lastschrift)

String


Zu- bzw. Abschläge (WmsAllowanceCharge)

Die Klasse WmsAllowanceCharge enthält Informationen über Zu- bzw. Abschläge

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

ChargeIndicator

Kennzeichen ob es sich um einen Zu- oder Abschlag handelt
Auf Dokumentebene: BG-20-00, BG-21-00
Auf Positionsebene: BG-27-00, BG-28-00
Abschlag: false
Zuschlag: true

Bool

BasisAmount
ab WMS 2020 (1.1.1)

Grundbetrag des Zu- oder Abschlags (ab EXTENDED)

Auf Dokumentebene: BT-93, BT-100

Auf Positionsebene: BG-137, BG-142

Decimal (15.3)

ActualAmount

Nettobetrag des Zu- oder Abschlags
Auf Dokumentebene: BT-92, BT-99
Auf Positionsebene: BG-136, BG-141

Decimal (15.3)

ReasonCode

Code für den Grund des Zu- oder Abschlags nach Codeliste UNTDID 5189 (Abschlag) oder UNTDID 7161 (Zuschlag).
Auf Dokumentebene: BT-98, BT-105
Auf Positionsebene: BG-140, BG-145

WMS 1.1.4 Aufgrund einer Änderung der ZUGFeRD-Library wird der ReasonCode nicht mehr automatisch aus dem XML der elektronischen Rechnung ausgelesen.

String

Reason

Grund für den Zu- oder Abschlag als Text
Auf Dokumentebene: BT-97, BT-104
Auf Positionsebene: BG-139, BG-144

Der Grund für den Zu- bzw. Abschlag muss derselben Art entsprechen, wie bei ReasonCode angegeben.

String

TaxCategoryCode

Code für die Umsatzsteuerkategorie des Zu- oder Abschlags auf Dokumentebene (BT-95, BT-102)

Folgende Einträge aus der Codeliste UNTDID 5305 werden verwendet:

  • S = Umsatzsteuer fällt mit Normalsatz an

  • Z = nach dem Nullsatz zu versteuernde Waren

  • E = Steuerbefreit (USt./IGIC/IPSI)

  • AE = Umkehrung der Steuerschuldnerschaft(es gelten die Regeln zur Umkehrung der Steuerschuldnerschaft bei USt./IGIC/IPSI)

  • K = Umsatzsteuerbefreit für innergemeinschaftliche Warenlieferungen (USt./IGIC/IPSI nicht erhoben aufgrund von Regeln zu innergemeinschaftlichen Lieferungen)

  • G = Steuer (USt./IGIC/IPSI) nicht erhoben aufgrund von Export außerhalb der EU (freier Ausfuhrartikel)

  • O = Dienstleistungen außerhalb des Steueranwendungsbereichs (Verkauf unterliegt nicht der USt./IGIC/IPSI)

  • L = Allgemeine indirekte Steuer der Kanarischen Inseln (IGIC-Steuer fällt an)

  • M = IPSI (Steuer für Ceuta/Melilla) fällt an

String

TaxRate

Umsatzsteuersatz für den Zu- oder Abschlag auf Dokumentebene (BT-96, BT-103)

Decimal


Gesamtbeträge der Rechnung (WmsMonetarySummation)

Die Klasse WmsMonetarySummation enthält die Gesamtbeträge der Rechnung.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

LineTotalAmount

Summe der Nettobeträge aller Rechnungspositionen(BT-106)

Decimal (15.3)

ChargeTotalAmount

Summe der Zuschläge (BT-108)

Decimal (15.3)

AllowanceTotalAmount

Summe der Abschläge (BT-107)

Decimal (15.3)

TaxBasisTotalAmount

Die Gesamtsumme der Rechnung ohne Umsatzsteuer und ohne Zu-/Abschläge (BT-109)
Der Rechnungsgesamtbetrag ohne Umsatzsteuer ist die Summe der Rechnungspositions-Nettobeträge abzüglich der Summe der Zuschläge auf Dokumentenebene zuzüglich der Summe der Abschläge der Dokumentenebene.

Decimal (15.3)

TaxTotalAmount

Der Gesamtbetrag der Umsatzsteuer für die Rechnung(BT-110, BT-111)

Decimal (15.3)

GrantTotalAmount

Rechnungsgesamtbetrag einschl. Umsatzsteuer (BT-112)
Der Rechnungsgesamtbetrag einschließlich Umsatzsteuer ist der Rechnungsgesamtbetrag ohne Umsatzsteuer zuzüglich des Gesamtbetrages der Rechnungsumsatzsteuer.

Decimal (15.3)

DuePayableAmount

Fälliger Zahlungsbetrag (BT-115)
Dieser Betrag ist der Rechnungsgesamtbetrag einschließlich Umsatzsteuer abzüglich des im Voraus gezahlten Betrages. Im Falle einer vollständig beglichenen Rechnung ist dieser Betrag gleich null. Der Betrag kann negativ sein; in diesem Fall schuldet der Verkäufer dem Käufer den Betrag.

Decimal (15.3)


Steuer-Informationen (WmsTaxDetail)

Die Tabelle des Typs WmsTaxDetail enthält die Auflistung der Steuersätze und -beträge für das gesamte Dokument.

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

Feldbezeichnung

Beschreibung(inkl. der ID des Business Terms der Norm EN 16931-1)

Datentyp

TaxRate

Steuersatz (BT-119)

Decimal

BasisAmount

Steuerbasisbetrag (BT-116)

Decimal (15.3)

TaxAmount

Kategoriespezifischer Steuerbetrag (BT-117)
Der für die betreffende Umsatzsteuerkategorie zu entrichtende Gesamtbetrag

Decimal (15.3)

TaxCategoryCode

Code der Umsatzsteuerkategorie (BT-118)
Folgende Einträge aus der Codeliste UNTDID 5305 werden verwendet:

  • S = Umsatzsteuer fällt mit Normalsatz an

  • Z = nach dem Nullsatz zu versteuernde Waren

  • E = Steuerbefreit (USt./IGIC/IPSI)

  • AE = Umkehrung der Steuerschuldnerschaft(es gelten die Regeln zur Umkehrung der Steuerschuldnerschaft bei USt./IGIC/IPSI)

  • K = Umsatzsteuerbefreit für innergemeinschaftliche Warenlieferungen (USt./IGIC/IPSI nicht erhoben aufgrund von Regeln zu innergemeinschaftlichen Lieferungen)

  • G = Steuer (USt./IGIC/IPSI) nicht erhoben aufgrund von Export außerhalb der EU (freier Ausfuhrartikel)

  • O = Dienstleistungen außerhalb des Steueranwendungsbereichs (Verkauf unterliegt nicht der USt./IGIC/IPSI)

  • L = Allgemeine indirekte Steuer der Kanarischen Inseln (IGIC-Steuer fällt an)

  • M = IPSI (Steuer für Ceuta/Melilla) fällt an

String


Freie Notiz (WmsInvoiceNote)

Die Klasse WmsNote enthält freien Text zur Rechnung bzw. zu einer Rechnungsposition. Es können ein oder mehrere Notizen angegeben werden.

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

ContentCode

Bilateral vereinbarte Textbausteine, die hier als Code übertragen werden.
Beispiele:

  • Betreff

  • Bemerkung

  • Einleitungstext

  • Schlusstext

  • Steuertext

  • Zusatz1..4

  • Belegstatus

  • Mahnstufe

  • EmpfängerEmail

  • BelegtypAlias

String

Content

Freitext einer Notiz (Rechnung: BT-22, Rechnungsposition: BT-127)

String

SubjectCode

Die Qualifizierung des Freitextes zur Rechnung (Rechnung: BT-21, Rechnungsposition: -)
Der angegebene Wert muss einem Wert aus der Codeliste UNTDID 4451 entsprechen. Folgende Codes werden empfohlen:

  • AAI : Allgemeine Informationen

  • SUR : Anmerkungen des Verkäufers

  • REG : Regulatorische Informationen

  • ABL : Rechtliche Informationen

  • TXD : Informationen zur Steuer

  • CUS : Zollinformationen

String


Referenziertes Dokument (WmsReferencedDocument)

Das Objekt des Typs WmsReferencedDocument enthält einen Verweis auf rechnungsrelevante Dokumente (z.B. Auftragsbestätigung, Bestellung)

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

IssuerAssignedId

Kennung der rechnungsbegründeten Unterlage (z.B. Bestellnummer; BT-12, BT-13, BT-14, BT-17, BT-18, BT-122)

String

IssueDate

Ausstelldatum des Dokuments

DateTime


Zusätzlich referenziertes Dokument (WmsAdditionalReferencedDocument)

Die Tabelle des Typs WmsAdditionalReferencedDocument enthält Daten zu referenzierten Dokumenten.

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

IssuerAssignedId

Kennung der rechnungsbegründeten Unterlage (BT-17, BT-18, BT-122)

String

IssueDate

Ausstelldatum des Dokuments

DateTime

Description

Beschreibung der rechnungsbegründeten Unterlage (BT-123)

String

TypeCode

Typ des referenzierten Dokuments (BT-17-0, BT-18-0, BT-122-0)

  • Der Code 916 "Referenzpapier" wird benutzt, um die Kennung der rechnungsbegründenden Unterlage zu referenzieren (BT-122).

  • Der Code 50 "Price/sales catalogue response" wird benutzt, um die Ausschreibung oder das Los zu referenzieren (BT-17).

  • Der Code 130 "Rechnungsdatenblatt" wird benutzt, um eine vom Verkäufer angegebene Kennung für ein Objekt zu referenzieren (BT-18).

String

Uri

Die URL (Uniform Resource Locator), unter der das externe Dokument verfügbar ist (BT-124)

String

MimeCode

Der MIME-Code des Anhangsdokuments (BT-125-1)
Zulässige MIME-Codes:

  • application/pdf

  • image/png

  • image/jpeg

  • text/csv

  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

  • application/vnd.oasis.opendocument.spreadsheet

String

Filename

Dateiname des eingebetteten Dokuments (BT-125-2)

String

BinaryData

Binärdaten des eingebetteten Dokuments (BT-125)

Byte-Array


Positionstabelle (WmsInvoiceLineItem)

Die Tabelle des Typs WmsInvoiceLineItem enthält die Daten der Rechnungspositionen.

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

InternalLineId

Interne eindeutige ID der Rechnungsposition

Integer

ProcessingStatus

Status der Bearbeitung

  • Undefined (nicht bearbeitet)

  • Failed (fehlerhaft - rot)

  • Incomplete (unvollständig - gelb)

  • Complete (vollständig - grün)

Wertzuweisung = EInvoiceProcessingState.Failed, EInvoiceProcessingState.Incomplete, ….

Enum

LineId

Positionsnummer (BT-126)
Wenn Positionen gruppiert werden, kann die Positionsnummer z.B. auch „04.01“ sein (Position 01 innerhalb der Gruppe 04)

String

GlobalId

Globaler Identifier des Produktes, GTIN, ... (BT-157)
Eine auf einem registrierten Schema basierende Artikelkennung

String

GlobalSchemeId

Kennung des Schemas für die GlobalId (BT-157-1)
Wird die Kennung für das Identifikationsschema verwendet, muss sie aus den Einträgen der von der ISO/IEC 6523 Maintenance Agency veröffentlichten Liste ausgewählt werden.
Insbesondere können folgende Codes genutzt werden:

  • 0021 : SWIFT

  • 0088 : EAN

  • 0060 : DUNS

  • 0177 : ODETTE

String

SellerAssignedId

Artikelnummer des Verkäufers (BT-155)

String

BuyerAssignedId

Artikelnummer des Käufers (BT-156)

String

ProductName

Artikelname (BT-153)

String

ProductDescription

Artikelbeschreibung (BT-154)

String

Quantity

Berechnete Menge (BT-129)

Decimal

UnitQuantity

Basismenge zum Artikelpreis (BT-149 / BT-149-0)

Decimal

UnitCode

Einheit (BT-130)
Die Maßeinheit muss aus den Listen aus UN/ECE Recommendation No. 20 „Codes for Units of Measure Used in International Trade" und UN/ECE Recommendation No. 21 „Codes for Passengers, Types of Cargo, Packages and Packaging Materials (with Complementary Codes for Package Names)" unter Anwendung des in UN/ECE Rec No. 20 Intro 2.a) beschriebenen Verfahrens ausgewählt werden

String

NetPrice

Einzelpreis (BT-146)
Im Nettopreis sind alle Zu- und Abschläge enthalten, jedoch nicht die Umsatzsteuer.

Decimal (15.3)

LineTotalNetAmount

Gesamtpreis Netto (BT-131)
Dies ist der „Netto"Betrag d. h. ohne die Umsatzsteuer, aber einschließlich aller für die Positionsebene geltenden Zu und Abschläge sowie sonstiger anfallender Steuern.

Decimal (15.3)

LineTotalGrossAmount

Gesamtpreis Brutto
Bruttobetrag inklusive Umsatzsteuer und aller für die Positionsebene geltenden Zu- und Abschläge sowie sonstiger anfallender Steuern.

Decimal (15.3)

TaxRate

Steuersatz (BT-152)
Der für den in Rechnung gestellten Artikel geltende und als Prozentsatz angegebene Umsatzsteuersatz

Decimal

TaxCategoryCode

Code der Umsatzsteuerkategorie des in Rechnung gestellten Artikels (BT-151)

Folgende Einträge aus der Codeliste UNTDID 5305 werden verwendet:

  • S = Umsatzsteuer fällt mit Normalsatz an

  • Z = nach dem Nullsatz zu versteuernde Waren

  • E = Steuerbefreit

  • AE = Umkehrung der Steuerschuldnerschaft

  • K = Kein Ausweis der Umsatzsteuer bei innergemeinschaftlichen Lieferungen

  • G = Steuer nicht erhoben aufgrund von Export außerhalb der EU

  • O = Außerhalb des Steueranwendungsbereichs

  • L = IGIC (Kanarische Inseln)

  • M = IPSI (Ceuta/Melilla)

String

TaxAmount

Der berechnete Steuerbetrag (aus LineTotalAmount und TaxRate)

Decimal (15.3)

AllowanceChargeList

Liste mit Zu- bzw. Abschläge auf Dokumentebene (BG-20, BG-21)

Liste<WmsAllowanceCharge>

IncludedNote

Detailinformationen zum Freitext zur Position

Liste<WmsInvoiceNote>

BillingSpecifiedPeriod

Optionale Angabe zur Rechnungsperiode (BG-26)
Null, wenn keine Rechnungsperiode angegeben ist

WmsInvoicePeriod

LastModifyUser

Letzter Bearbeiter der Buchung. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt.

String

LastModifyDate

Datum der letzten Bearbeitung. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt.

DateTime

CreationUser

Benutzer, der die Buchung erstellt hat. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt. WMS 2020 (1.1.3)

String

CreationDate

Datum, an dem die Buchung erstellt wurde. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt. WMS 2020 (1.1.3)

DateTime

AdditionalInfo1-10

Zusatzinfo 1-10WMS 2020 (1.1.3)

String

AdditionalInteger1-2

Zusatzinformationen mit einer GanzzahlWMS 2020 (1.1.3)

Integer

AdditionalDateTime1-2

Zusatzinformationen mit DatumWMS 2020 (1.1.3)

DateTime

AdditionalBool1-2

Zusatzinformationen mit ja oder neinWMS 2020 (1.1.3)

bool

AdditionalDecimal1-2

Zusatzinformationen mit einer KommazahlWMS 2020 (1.1.3)

decimal

Methoden WMS 2020 (1.1.1)

Methode

Beschreibung

Methode

Beschreibung

bool SetValue (string propertyName, object value)

Setzt den Wert einer Eigenschaft über den Namen.

Gibt true zurück, wenn der Wert gesetzt wurde und false, wenn es die angegebene Eigenschaft nicht gibt. Sollte der angegebene Wert nicht zu der Eigenschaft passen (wird z.B. einer Zahl ein Datum zugewiesen), dann wirft die Methode eine "TargetException".

  • propertyName:  Name einer Eigenschaft aus dem Rechnungsobjekt (siehe Liste oben)

  • value: Wert, der gesetzt werden soll.

object GetValue (string propertyName)

Ermittelt einen Wert zu einer Eigenschaft aus dem WmsInvoiceLine. Wenn Sie den Wert aus einem "Unter-Objekt" ermitteln wollen, treffen Sie die Eigenschaftsnamen mit einem ".".

Referenzen auf vorausgehende Dokumente (WmsPrecedingDocumentReference)

Die Klasse WmsPrecedingDocumentReference enthält interne Informationen zu vorausgehenden Dokumenten, welche für die Rechnungsstellung relevant sind (z.B. Bestellung, Lieferschein, etc.)

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

DocumentId

ID des Dokuments

String

Name

Bezeichnung des Dokuments

String

IssueDate

Belegdatum

DateTime

Kontierungs- und Buchhaltungsinformationen (WmsAccountingInformation)

Die Klasse WmsAccountingInformation enthält Kontierungs- und Buchungsinformationen.

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

PostingGrossAmount

Kennzeichen, ob Bruttobeträge (true) oder Nettobeträge (false) gebucht werden

Boolean

TotalAmount

Der zu kontierende Gesamtbetrag; muss der Summe der Einzelbeträge entsprechen.

Dieser Betrag wird für das Portal zur Validierung verwendet. Bei Öffnen einer Rechnungsaufgabe wird der TotalAmount (wenn er 0 ist) mit "MonetarySummation.GrantTotalAmount" vorbelegt (bzw. mit "MonetarySummation.LineTotalAmount" wenn Nettobeträge gebucht werden).

Decimal

AccountingRecords

Liste mit Kontierungsdaten von Rechnungspositionen(siehe auch Tabelle Buchungstabelle)

Liste<WmsAccountingRecord>

Kontierungstabelle (WmsAccountingRecord)

Die Tabelle des Typs WmsAccountingRecord dient der Vorkontierung von Buchungssätzen und zur Aufteilung von Rechnungspositionen auf Kostenstellen.

Feldbezeichnung

Beschreibung

Datentyp

Feldbezeichnung

Beschreibung

Datentyp

InternalId

Interne eindeutige ID des Datensatzes

Integer

LineItemInternalId

Referenz zur Rechnungsposition; Wenn die Buchung unabhängig von einer Position ist, ist die LineItemInternalId nicht belegt (=null)

Integer

SplitType

Der SplitType gibt an, nach welchem Kriterium der Gesamtbetrag aufgesplittet wird. Alle Splittbuchungen zu einer Position müssen denselben SplitType haben. Es stehen folgende Splitt-Typen zur Verfügung:

  • Menge (Quantity)

  • Prozent (Percentage)

  • Betrag (Amount) > Default

Enum

AccountNo

Buchungskonto-Nr. (z.B. Wareneingang)

String

CostCenterId

Kostenstelle

String

CostTypeId

Kostenart (Sub-)Code falls feiner gegliedert

String

CostUnitId

Kostenträger

String

TaxKey

Steuerschlüssel

String

Amount

Buchungsbetrag

Decimal (15.3)

Percentage

Prozentualer Anteil (daraus wird dann die Menge berechnet)

Decimal

Quantity

Menge

Decimal

Text

(Buchungs-)Text

String (60)

LastModifyUser

Letzter Bearbeiter der Buchung. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt.

String

LastModifyDate

Datum der letzten Bearbeitung. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt.

DateTime

CreationUser

Benutzer, der die Buchung erstellt hat. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt. WMS 2020 (1.1.3)

String

CreationDate

Datum, an dem die Buchung erstellt wurde. Wird beim Speichern über eine Portalaufgabe automatisch gesetzt. WMS 2020 (1.1.3)

DateTime

AdditionalInfo1-10

Zusatzinfo 1-10WMS 2020 (1.1.3)

String

AdditionalInteger1-2

Zusatzinformationen mit einer GanzzahlWMS 2020 (1.1.3)

Integer

AdditionalDateTime1-2

Zusatzinformationen mit DatumWMS 2020 (1.1.3)

DateTime

AdditionalBool1-2

Zusatzinformationen mit ja oder neinWMS 2020 (1.1.3)

bool

AdditionalDecimal1-2

Zusatzinformationen mit einer KommazahlWMS 2020 (1.1.3)

decimal

Methoden WMS 2020 (1.1.1)

Methode

Beschreibung

Methode

Beschreibung

bool SetValue (string propertyName, object value)

Setzt den Wert einer Eigenschaft über den Namen.

Gibt true zurück, wenn der Wert gesetzt wurde und false, wenn es die angegebene Eigenschaft nicht gibt. Sollte der angegebene Wert nicht zu der Eigenschaft passen (wird z.B. einer Zahl ein Datum zugewiesen), dann wirft die Methode eine "TargetException".

  • propertyName:  Name einer Eigenschaft aus dem Rechnungsobjekt (siehe Liste oben)

  • value: Wert, der gesetzt werden soll.

object GetValue (string propertyName)

Ermittelt einen Wert zu einer Eigenschaft aus dem WmsAccountingRecord. Wenn Sie den Wert aus einem "Unter-Objekt" ermitteln wollen, treffen Sie die Eigenschaftsnamen mit einem ".".

Glossar

Abkürzung

Beschreibung

Abkürzung

Beschreibung

BG

Business Group bzw. Gruppe von Informationselementen

BT

Business Term bzw. Informationselement

ERechV

E-Rechnungsverordnung
https://www.bmi.bund.de/SharedDocs/downloads/DE/gesetztestexte/e-rechnungsverordnung.html