Arbeiten mit XRechnung

Events

Wir bieten Ihnen die Möglichkeit sich mit Events in unsere Programmierlogik einzuklinken, hier beschreiben wir Ihnen wie dies geht.

Um ein Event fĂĽr Verkaufsrechnungen bzw. Servicerechnungen zu subscriben, muss der XML-Port BEL365 S. Inv. XRechnung 2.0 in einem EventSubscriber angegeben werden.

Beispiel:

1
[EventSubscriber(ObjectType::XmlPort, XmlPort::"BEL365 S. Inv. XRechnung 2.0", 'OnAfterGetLineInvoicePeriodInfo', "", true, true)]

FĂĽr Verkaufsgutschriften bzw. Servicegutschriften ist als folgender XML-Port einzutragen: BEL365 S. Cr. M. XRechnung 2.0.

Beispiel:

1
[EventSubscriber(ObjectType::XmlPort, XmlPort::"BEL365 S. Cr. M. XRechnung 2.0", 'OnAfterGetLineInvoicePeriodInfo', "", true, true)]

Einige der Business Terms, welche im folgenden aufgelistet werden, können nicht über die beiden oben genannten XML-Ports verändert werden.
Connector 365 XRechnung bedient sich teilweise aus Funktionen der Microsoft Standard-Codeunit: PEPPOL Management (1605).
Die betroffenden Events werden in dieser Dokumentation mit einer Hinweis-Box versehen.



Die XRechnung-Events bieten die Möglichkeit, Business Terms zu „füllen“ nachdem Sie standardmäßig gesetzt werden und noch bevor Sie weiterverarbeitet, also in die resultierende XML-Datei eingefügt werden. Die Business Terms werden dabei jeweils als Text-Variable übergeben. Vorangestellt an diesen Variablen steht das Schlüsselwort VAR, welches angibt, dass die Variablen Referenzen auf die ursprünglichen Variablen sind.

Nachdem Sie eine Funktion als Subscriber definiert haben, so können Sie die übergebenen Variablen beliebig und nach eigener Logik füllen.

Beispiel

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[EventSubscriber(ObjectType::XmlPort, XmlPort::"BEL365 S. Inv. XRechnung 2.0", 'OnAfterGetLineInvoicePeriodInfo', "", true, true)]
local procedure SubAfterGetLineInvoicePeriodInfo (
    var Sender: XmlPort "BEL365 S. Inv. XRechnung 2.0"; 
    SalesLine: Record "Sales Line";
    var InvLineInvoicePeriodStartDate: Text;
    var InvLineInvoicePeriodEndDate: Text);
begin
    InvLineInvoicePeriodStartDate := format(SalesLine."Posting Date");
    InvLineInvoicePeriodEndDate := '2021-04-15';
end;

Die Funktion SubAfterGetLineInvoicePeriod ist hier ein Subscriber fĂĽr das Event OnAfterGetLineInvoicePeriodInfo.

Unabhängig von der Standardmäßigen Logik der Füllung der Variablen, enthält InvLineInvoicePeriodEndDate nach Erzeugung der XRechnung nun den Wert „2021-04-15“ und erscheint so in der resultierenden XML-Datei. Gleiche Vorgehensweise gilt für alle weiteren Events.

Im Folgenden eine Auflistung der verfügbaren Events und die damit zu verändernden Variablen.

Zu Beginn des XML-Ports wird überprüft, ob es sich um einen Verkaufsbeleg bzw. um einen Servicebeleg handelt. Anschließend werden die zugehörigen Record-Variablen in die Variablen „Sales Header“ und „Sales Line“ transferiert, welche von dort an über den gesamten XML-Port verwendet werden. Beispiel für Verkaufsrechnungen:

„Sales Invoice Header“ -> „Sales Header“,
„Sales Invoice Line“ -> „Sales Line“.

Dies ist der Grund, weshalb alle folgenden Events mit „Sales Header“ oder mit „Sales Line“ arbeiten.

GetGeneralInfoBIS

Dieses Event stammt aus der Codeunit: PEPPOL Management (1605).
1
2
3
4
5
6
7
8
. SalesHeader: Record "Sales Header"
. var ID: Text                   (BT-1)
. var IssueDate: Text            (BT-2)
. var InvoiceTypeCode: Text      (BT-3)
. var Note: Text                 (BT-22)
. var TaxPointDate: Text         (BT-7)
. var DocumentCurrencyCode: Text (BT-5)
. var AccountingCost: Text       (BT-19)
Name Business Term Semantischer Datentyp
Invoice number BT-1 Identifier
Eine eindeutige Kennung der Rechnung, die diese im System des Verkäufers identifiziert.
Invoice issue date BT-2 Date
Das Datum, an dem die Rechnung ausgestellt wurde.
Invoice type code BT-3 Code
Ein Code, der den Funktionstyp der Rechnung angibt. Anmerkung: Der Rechnungstyp muss gemäß UNTDID 1001 spezifiert werden.
Invoice currency code BT-5 Code
Die Währung, in der alle Rechnungsbeträge angegeben werden, ausgenommen ist der Umsatzsteuer-Gesamtbetrag, der in der Abrechnungswährung anzugeben ist.
Value added tax point date BT-7 Date
Das Datum, zu dem die Umsatzsteuer für den Verkäufer und für den Erwerber abrechnungsrelevant wird. Die Anwednung von BT-7 und 8 schließen sich gegenseitig aus.
Buyer accounting reference BT-19 Text
Ein Textwert, der angibt, an welcher Stelle die betreffenden Daten in den Finanzkosten des Erwerbers zu buchen sind.
Invoice note BT-22 Text
Ein Textvermerk, der unstrukturierte Informationen enthält, die für die Rechnung als Ganzes maßgeblich sind.

OnGetInvoicePeriod

1
2
3
. SalesHeader: Record "Sales Header"
. VAR InvoicePeriodStartDate : Text (BT-73)
. VAR InvoicePeriodEndDate : Text (BT-74)
Name Business Term Semantischer Datentyp
Invoicing period start date BT-73 Date
Das Datum, an dem der Abrechnungszeitraum beginnt.
Invoicing period end date BT-74 Date
Das Datum, an dem der Abrechnungszeitraum endet.

Das Event OnGetInvoicePeriod kann genutzt werden, um das Leistungsdatum bzw. ein Leistungszeitraum für eine Rechnung festzulegen. Dabei wird ein Zeitraum durch einen Start- und einen Endzeitpunkt definiert, die jeweils folgendes Format erhalten sollen: „YYYY-MM-DD“. Beispiel: 2017-10-01

OnAfterGetLineInvoicePeriodInfo

1
2
3
. SalesLine : Record „Sales Line“
. VAR InvLineInvoicePeriodStartDate : Text 
. VAR InvLineInvoicePeriodEndDate : Text

Dieses Event setzt das Leistungsdatum ähnlich wie bei OnGetInvoicePeriod fest, jedoch auf Zeilenebene.

OnAfterGetAccountingSupplierPartyContact (BG-6)

1
2
3
4
5
. SalesHeader : Record “Sales Header”
. VAR ContactName : Text  (BT-41)
. VAR Telephone : Text  (BT-42)
. VAR Telefax : Text
. VAR ElectronicMail : Text  (BT-43)
Name Business Term Semantischer Datentyp
Seller Contact Point BT-41 Text
Angaben zu Ansprechpartner oder Kontaktstelle (wie z.B. Name einer Person, Abteilungs- oder BĂĽrobezeichnung
Seller contact telephone number BT-42 Text
Telefonnummer des Ansprechpartners oder der Kontaktstelle
Seller contact email address BT-43 Text
Eine E-Mail-Adresse des Ansprechpartners oder der Kontaktstelle

Business Rules:

BR-DE-2: Die Gruppe „SELLER CONTACT“ (BG-6) ist zwingend zu übermitteln.

BR-DE-5: Das Element „SELLER CONTACT POINT“ (BT-41) ist zwingend zu übermitteln.

BR-DE-6: Das Element „SELLER CONTACT TELEPHONE NUMBER“ (BT-42) ist zwingend zu übermitteln.

BR-DE-7: Das Element „SELLER CONTACT EMAIL ADDRESS“ (BT-43) ist zwingend zu übermitteln.

OnAfterGetPaymentTermsInfo

1
2
. SalesHeader : Record „Sales Header“
. VAR PaymentTermsNote : Text (BT-20)

Eine 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.

Spezifikation XRechnung Standard und Extension
Version XRechnung 2.0.0 | Fassung vom 16.12.2020

OnGetOrderLineReference

1
2
. SalesLine : Record „Sales Line“
. VAR OrderLineReferenceLineID : Text (BT-132)

Referenced purchase oder line reference

Eine vom Erwerber ausgegebene Kennung fĂĽr eine referenzierte Position einer Bestellung / eines Auftrags.

Anmerkung: Auf den Auftrag wird auf Rechnungsebene Bezug genommen.

Spezifikation XRechnung Standard und Extension
Version XRechnung 2.0.0 | Fassung vom 16.12.2020

OnAfterGetPaymentMeansInfo (BG-16)

1
2
3
4
5
6
. Sales Header : Record „Sales Header“
. VAR PaymentMeansCode : Text  (BT-81)
. VAR PaymentChannelCode : Text  (BT-82)
. VAR PaymentID : Text  (BT-83)
. VAR PrimaryAccountNumberID : Text  (BT-87)
. VAR NetworkID : Text
Name Business Term Semantischer Datentyp
Payment means type code BT-81 Code
Das als Code ausgedrĂĽckte erwartete oder genutzte Zahlungsmittel. Hierzu wird auf die Codeliste UN/ECE 4461 verwiesen
Payment means text BT-82 Text
Das in Textform ausgedrĂĽckte erwartete oder genutzte Zahlungsmittel
Remittance information BT-83 Text
Ein Textwert, der zur Verknüpfung der Zahlung mit der vom Verkäufer ausgestellten Rechnung verwendet wird
Payment card primary account number BT-87 Text
Die Nummer der Kreditkarte, die fĂĽr die Zahlung genutzt wurde

Business Rules:

BR-DE-1: Eine Rechnung (INVOICE) muss Angaben zu „PAYMENT INSTRUCTIONS“ (BG-16) enthalten.

BR-DE-13: In der Rechnung müssen Angaben zu einer der drei Gruppen „CREDIT TRANSFER“ (BG-17), „PAYMENT CARD INFORMATION“ (BG-18) oder „DIRECT DEBIT“ (BG-19) gemacht werden.

OnAfterGetContractDocRefInfo

1
2
3
4
5
. SalesHeader : Record „Sales Header“
. VAR ContractDocumentReferenceID : Text (BT-12)
. VAR DocumentTypeCode : Text
. VAR ContractRefDocTypeCodeListID : Text
. VAR DocumentType : Text
Name Business Term Semantischer Datentyp
Contract reference BT-12 Document Reference
Eine eindeutige Bezeichnung des Vertrages (z.B: Vertragsnummer).

OnAfterGetAccountingCustomerPartyInfoBIS

1
2
3
4
5
6
. SalesHeader: Record "Sales Header"
. VAR CustomerEndpointID: Text (BT-49)
. VAR CustomerSchemeID: Text (BT-49-1)
. VAR CustomerPartyIdentificationID: Text (BT-46)
. VAR CustomerPartyIDSchemeID: Text (BT-46-1)
. VAR CustomerName: Text (BT-45)
Name Business Term Semantischer Datentyp
Buyer electronic address BT-49 Identifier
Gibt eine elektronische Adresse des Erwerbers an, an die eine Rechnung gesendet werden sollte.
Buyer electronic address/Scheme identifier
Das Bildungsmuster fĂĽr Buyer electronic address.

Es ist die Codeliste Electronic Address Scheme code list (EAS) zu verwenden. Die Codeliste wird von der Connecing Eruope Facility gepflegt und herausgegeben.
Buyer identifier BT-46 Identifier
Eine (i.d.R. vom Verkäufer vergebene) Kennung des Erwerbers, wie z.b. die Debitorennummer für die Buchhaltung oder die Kundennummer für die Auftragsverwaltung.

Anmerkung: FĂĽr die Bildung des Buyer Identifier ist kein einheitliches Schema erforderlich
Die Kennungs des Bildungsschemas fĂĽr den "Buyer identifier".

Anmerkung: Wenn das Element verwendet wird, ist der Eintrag aus der von der ISO/IEC 6523 maintenance agency veröffentlichten Liste zu wählen.
Buyer trading name BT-45 Text
Ein Name, unter dem der Erwerber bekannt ist, sofern abweichend vom Namen des Erwerbers.

OnAfterGetPaymentMeansPayeeFinancialAccBIS (BG-17)

1
2
3
. VAR PayeeFinancialAccountID : Text (BT-84)
. VAR FinancialInstitutionBranchID : Text (BT-86)
. VAR PayeeFinancialAccountName : Text (BT-85)
Name Business Term Semantischer Datentyp
Payment account identifier BT-84 Identifier
Die Kennung des Kontos, auf das die Zahlung erfolgen soll: IBAN fĂĽr Zahlungen im SEPA-Raum, Kontonummer oder IBAN im Fall von Auslandszahlungen
Payment account name BT-85 Text
Name des Kontos bei einem Zahlungsdienstleister, auf das die Zahlunge erfolgeng soll. (z.B. Kontoinhaber)

OnAfterGetLineGeneralInfo

1
2
3
4
5
6
7
8
. SalesLine : Record „Sales Line“
. SalesHeader : Record „Sales Header“
. VAR InvoiceLineID : Text
. VAR InvoiceLineNote : Text
. VAR InvoicedQuantity : Text
. VAR InvoiceLineExtensionAmount : Text
. VAR LineExtensionAmountCurrencyID : Text
. VAR InvoiceLineAccountingCost : Text

OnAfterGetLineItemInfo

1
2
3
4
5
6
7
8
 . SalesLine: Record "Sales Line"
 . VAR Description: Text
 . VAR Name: Text
 . VAR SellersItemIdentificationID: Text
 . VAR StandardItemIdentificationID: Text
 . VAR StdItemIdIDSchemeID: Text
 . VAR OriginCountryIdCode: Text
 . VAR OriginCountryIdCodeListID: Text

OnAfterGetAccountingSupplierPartyLegalEntityBIS

1
2
3
4
5
6
7
 . SalesHeader: record "Sales Header"
 . var PartyLegalEntityRegName: Text
 . var PartyLegalEntityCompanyID: Text
 . var PartyLegalEntitySchemeID: Text
 . var SupplierRegAddrCityName: Text
 . var SupplierRegAddrCountryIdCode: Text
 . var SupplRegAddrCountryIdListId: Text

OnAfterGetAccountingSupplierPartyTaxSchemeBIS

1
2
3
4
5
 . SalesHeader: record "Sales Header"
 . var TempVATAmountLine: record "VAT Amount Line"
 . var CompanyID: text
 . var CompanyIDSchemeID: text
 . var TaxSchemeID: text

OnAfterGetAccountingSupplierPartyPostalAddr

1
2
3
4
5
6
7
 . SalesHeader: record "Sales Header"
 . var StreetName: text
 . var SupplierAdditionalStreetName: text
 . var CityName: text
 . var PostalZone: text
 . var CountrySubentity: text
 . var IdentificationCoder: text

OnAfterGetAccountingSupplierPartyInfoBIS

1
2
3
 . SalesHeader: record "Sales Header"
 . var SupplierEndpointID: text (BT-34)
 . var SupplierName: text (BT-28)
Name Business Term Semantischer Datentyp
Seller electronic address BT-34 Identifier
Gibt die elektronische Adresse des Verkäufers an, an die die Antwort der Anwendungsebene auf eine Rechnung gesendet werden kann.
Seller trading name BT-28 Text
Ein Name, unter dem der Verkäufer bekannst ist, sofern abweichend vom Namen des Verkäufers.

OnAfterGetAccountingCustomerPartyPostalAddr

1
2
3
4
5
6
7
 . SalesHeader: record "Sales Header"
 . var CustomerStreetName: text (BT-35)
 . var CustomerAdditionalStreetName: text (BT-36)
 . var CustomerCityName: text (BT-37)
 . var CustomerPostalZone: text (BT-38)
 . var CustomerCountrySubentity: text (BT-39)
 . var CustomerIdentificationCode: text (BT-40)

OnAfterGetAccountingCustomerPartyTaxSchemeBIS(

1
2
3
4
 . SalesHeader: record "Sales Header"
 . var CustPartyTaxSchemeCompanyID: text
 . var CustPartyTaxSchemeCompIDSchID: text
 . var CustTaxSchemeID: text

OnAfterGetAccountingCustomerPartyLegalEntityBIS

1
2
3
4
 . SalesHeader: record "Sales Header"
 . var CustPartyLegalEntityRegName: text
 . var CustPartyLegalEntityCompanyID: text
 . var CustPartyLegalEntityIDSchemeID: text

OnAfterGetAccountingCustomerPartyContact

1
2
3
4
5
 . var SalesHeader: record "Sales Header"
 . var CustContactName: text
 . var CustContactTelephone: text
 . var CustContactTelefax: text
 . var CustContactElectronicMail: text

OnAfterGetGLNDeliveryInfo

1
2
3
4
 . SalesHeader: record "Sales Header"
 . var ActualDeliveryDate: text
 . var DeliveryID: text
 . var DeliveryIDSchemeID: text

OnAfterGetDeliveryAddress

1
2
3
4
5
6
7
 . SalesHeader: record "Sales Header"
 . var DeliveryStreetName: text
 . var DeliveryAdditionalStreetName: text
 . var DeliveryCityName: text
 . var DeliveryPostalZone: text
 . var DeliveryCountrySubentity: text
 . var DeliveryCountryIdCode: text

OnAfterGetLineItemClassfiedTaxCategoryBIS

1
2
3
4
5
 . SalesLine: record "Sales Line"
 . var ClassifiedTaxCategoryID: text
 . var ItemSchemeID: text
 . var InvoiceLineTaxPercent: Text
 . var ClassifiedTaxCategorySchemeID: text

OnAfterGetLineAllowanceChargeInfo

1
2
3
4
5
6
 . SalesLine: record "Sales Line"
 . SalesHeader: record "Sales Header"
 . var InvLnAllowanceChargeIndicator: text
 . var InvLnAllowanceChargeReason: text
 . var InvLnAllowanceChargeAmount: text
 . var InvLnAllowanceChargeAmtCurrID: text

OnAterGetLineDeliveryInfo

1
2
3
4
5
 . SalesLine: record "Sales Line"
 . SalesHeader: record "Sales Header"
 . var InvoiceLineActualDeliveryDate: text
 . var InvoiceLineDeliveryID: text
 . var InvoiceLineDeliveryIDSchemeID: text

OnAfterGetLineDeliveryPostalAddr

1
2
3
4
5
6
7
8
9
 . SalesLine: record "Sales Line"
 . SalesHeader: record "Sales Header"
 . var InvoiceLineDeliveryStreetName: text
 . var InvLineDeliveryAddStreetName: text
 . var InvoiceLineDeliveryCityName: text
 . var InvoiceLineDeliveryPostalZone: text
 . var InvLnDeliveryCountrySubentity: text
 . var InvLnDeliveryCountryIdCode: text
 . var InvLineDeliveryCountryListID: text

OnAfterGetTaxRepresentativePartyInfo

1
2
3
4
5
 . SalesHeader: record "Sales Header"
 . var TaxRepPartyNameName: text
 . var PayeePartyTaxSchemeCompanyID: text
 . var PayeePartyTaxSchCompIDSchemeID: text
 . var PayeePartyTaxSchemeTaxSchemeID: text

OnAfterGetAllowanceChargeInfo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 . TempVATAmountLine: record "VAT Amount Line"
 . SalesHeader: record "Sales Header"
 . var ChargeIndicator: text
 . var AllowanceChargeReasonCode: text
 . var AllowanceChargeReason: text
 . var Amount: text
 . var AllowanceChargeCurrencyID: text
 . var TaxCategoryID: text
 . var TaxCategorySchemeID: text
 . var Percent: text
 . var AllowanceChargeTaxSchemeID: text

OnAfterGetTaxExemptionReason

1
2
3
4
 . SalesHeader: record "Sales Header"
 . TempVATProductPostingGroup: record "VAT Product Posting Group"
 . var TaxExemptionReason: text
 . var TaxTotalTaxCategoryID: text

OnAfterGetLineAdditionalItemPropertyInfo

1
2
3
4
 . SalesLine: record "Sales Line"
 . SalesHeader: record "Sales Header"
 . var AdditionalItemPropertyName: Text
 . var AdditionalItemPropertyValue: Text

OnAfterGetLinePriceAllowanceChargeInfo

1
2
3
4
5
6
 . SalesHeader: record "Sales Header"
 . var PriceChargeIndicator: text
 . var PriceAllowanceChargeAmount: text
 . var PriceAllowanceAmountCurrencyID: text
 . var PriceAllowanceChargeBaseAmount: text
 . var PriceAllowChargeBaseAmtCurrID: text