Accantum.Wms.ActivityContracts.Models.Invoice.V01
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.
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 |
---|---|---|
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). | Boolean |
DatasourceName | Name der Datenquelle (z.B. ZUGFeRD, XRechnung, Capture, Manuell, etc.) | 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)
| 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) | String |
BillingSpecifiedPeriod | Optionale Angabe zur Rechnungsperiode (BG-14) | 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, …) | String |
Currency | Währung (BT-5) Eine angegebene Währung bezieht sich immer auf das gesamte Dokument. | String |
ConversionRate | Umrechnungskurs bei ausländischer Währung (muss 6 Nachkommastellen haben) | 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> |
WmsPrecedingDocumentReferences | 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-5 | Zusatzinfo 1-5 | String |
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 |
---|---|---|
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)
| 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) | String |
CityName | Ort (Verkäufer: BT-37, Käufer: BT-52, Lieferanschrift: BT-77) | 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) | 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 |
---|---|---|
PersonName | Name (Verkäufer: BT-41, Käufer: BT-56, Lieferant: -) | 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: -) | String |
E-Mail- bzw. De-Mail-Adresse (Verkäufer: BT-43, Käufer: BT-58, Lieferant: -) | 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 |
---|---|---|
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 |
---|---|---|
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 | |
---|---|---|---|
DueDate | Fälligkeitsdatum (BT-9) | DateTime | |
Description | Beschreibung der Zahlungsbedingungen (BT-20) |
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 |
---|---|---|
TypeCode | Code für Zahlungsart (BT-81)
| String |
TypeDescription | Beschreibung der Zahlungsart (BT-82) | 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) | 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). | 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 |
---|---|---|
ChargeIndicator | Kennzeichen ob es sich um einen Zu- oder Abschlag handelt | Bool |
BasisAmount | 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 | Decimal (15.3) |
ReasonCode | Code für den Grund des Zu- oder Abschlags nach Codeliste UNTDID 5189 | String |
Reason | Grund für den Zu- oder Abschlag als Text | String |
TaxCategoryCode | Code für die Umsatzsteuerkategorie des Zu- oder Abschlags auf Dokumentebene (BT-95, BT-102)
| 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 |
---|---|---|
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) | 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) | Decimal (15.3) |
DuePayableAmount | Fälliger Zahlungsbetrag (BT-115) | 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 |
---|---|---|
TaxRate | Steuersatz (BT-119) | Decimal |
BasisAmount | Steuerbasisbetrag (BT-116) | Decimal (15.3) |
TaxAmount | Kategoriespezifischer Steuerbetrag (BT-117) | Decimal (15.3) |
TaxCategoryCode | Code der Umsatzsteuerkategorie (BT-118)
| 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 |
---|---|---|
ContentCode | Bilateral vereinbarte Textbausteine, die hier als Code übertragen werden.
| String |
Content | Freitext einer Notiz (Rechnung: BT-22, Rechnungsposition: BT-127) | String |
SubjectCode | Die Qualifizierung des Freitextes zur Rechnung (Rechnung: BT-21, Rechnungsposition: -)
| String |
Referenziertes Dokument (WmsReferencedDocument)
Das Objekt des Typs WmsReferencedDocument enthält einen Verweis auf rechnungsrelevante Dokumente (z.B. Auftragsbestätigung, Bestellung)
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 |
---|---|---|
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)
| 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)
| 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 |
---|---|---|
InternalLineId | Interne eindeutige ID der Rechnungsposition | Integer |
ProcessingStatus | Status der Bearbeitung
Wertzuweisung = EInvoiceProcessingState.Failed, EInvoiceProcessingState.Incomplete, …. | Enum |
LineId | Positionsnummer (BT-126) | String |
GlobalId | Globaler Identifier des Produktes, GTIN, ... (BT-157) | String |
GlobalSchemeId | Kennung des Schemas für die GlobalId (BT-157-1)
| 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 |
UnitCode | Einheit (BT-130) | String |
NetPrice | Einzelpreis (BT-146) | Decimal (15.3) |
LineTotalNetAmount | Gesamtpreis Netto (BT-131) | Decimal (15.3) |
LineTotalGrossAmount | Gesamtpreis Brutto | Decimal (15.3) |
TaxRate | Steuersatz (BT-152) | Decimal |
TaxCategoryCode | Code der Umsatzsteuerkategorie des in Rechnung gestellten Artikels (BT-151)
| 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) | WmsInvoicePeriod |
AdditionalInfo1-5 | Zusatzinfo 1-5 | String |
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 |
---|---|---|
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 |
---|---|---|
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. | 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 |
---|---|---|
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:
| 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 Zeile | String |
LastModifyDate | Datum der letzten Bearbeitung | DateTime |
AdditionalInfo1-5 | Zusatzinfo 1-5 | String |
Glossar
Abkürzung | Beschreibung |
---|---|
BG | Business Group bzw. Gruppe von Informationselementen |
BT | Business Term bzw. Informationselement |
ERechV |