Export-SepaCreditTransferXml #

ÜBERSICHT #

Erzeugt eine SEPA-Überweisungs-XML-Datei im Format pain.001.001.03.

SYNTAX #

Export-SepaCreditTransferXml [[-Payments] <PSCustomObject[]>] [[-DebtorName] <string>]
    [[-DebtorIBAN] <string>] [[-DebtorBIC] <string>] [[-BankIndex] <int>] [[-ExecutionDate]
    <datetime>] [-OutputPath] <string> [[-BatchBooking] <bool>] [-BookPayment] [[-Conn]
    <__ComObject>] [[-Udl] <string>] [[-ConnStr] <string>]

BESCHREIBUNG #

Diese Funktion erzeugt eine XML-Datei für SEPA-Überweisungen gemäß dem ISO-20022-Standard pain.001.001.03 – das Pendant zu Export-SepaDirectDebitXml (Lastschrift) für die Auszahlungs-Seite, z.B. Provisions-Gutschriften an Reseller/Vertreter.

Rollentausch gegenüber der Lastschrift: wir sind Dbtr (Zahlungspflichtiger), der Empfänger ist Cdtr. Es gibt kein Mandat und keinen SequenceType – eine SEPA-Überweisung braucht keine Einzugsermächtigung, daher ein einziger PmtInf-Block je Lauf.

Die Zahlungsdaten können entweder als Array von PSCustomObjects (z.B. von Get-OpenCreditNotesForSepaTransfer) übergeben oder automatisch aus der Datenbank geladen werden. Die Schuldner-Daten (Name, IBAN, BIC) können als Parameter angegeben oder automatisch aus dem Firmenstamm geladen werden.

Optional (-BookPayment) wird pro Transaktion ein ausgleichender RechnungZe-Eintrag gebucht, der die offene Gutschrift auf 0 zurückführt – analog zum Verrechnungsmuster der EULANDA-Kernprozeduren (INSERT dbo.RechnungZe (KopfId, ZeDatum, Betrag, Bemerkung, Waehrung)).

PARAMETER #

-Payments #

Type: PSCustomObject[]

Array von PSCustomObjects mit Empfänger- und Betragsdaten. Wird automatisch über Get-OpenCreditNotesForSepaTransfer geladen, wenn nicht angegeben.

-DebtorName #

Type: string

Name des Zahlungspflichtigen (unsere Firma). Standard: aus Get-CompanyMasterData (Ident).

-DebtorIBAN #

Type: string

IBAN des Zahlungspflichtigen. Standard: aus Get-CompanyMasterData, Bankverbindung -BankIndex.

-DebtorBIC #

Type: string

BIC des Zahlungspflichtigen. Standard: aus Get-CompanyMasterData, Bankverbindung -BankIndex.

-BankIndex #

Type: int
Default: 1

Welche der bis zu 3 im Firmenstamm hinterlegten Bankverbindungen verwendet wird, wenn -DebtorIBAN/-DebtorBIC nicht angegeben sind (Get-CompanyMasterData, Feld Bank[].Id). Standard: 1 (Hausbank).

-ExecutionDate #

Type: datetime

Ausführungsdatum der Überweisung. Standard: nächster Werktag.

-OutputPath #

Type: string

Pfad für die XML-Ausgabedatei.

-BatchBooking #

Type: bool
Default: $true

Steuert BtchBookg im PmtInf-Block. $true (Standard) = Sammelbuchung, die Bank verbucht alle Transaktionen des Laufs als eine Sammelposition. $false = Einzelbuchung, jede Transaktion erscheint einzeln auf dem Kontoauszug.

-BookPayment #

Type: switch

Wenn angegeben, wird pro Transaktion ein ausgleichender RechnungZe-Eintrag gebucht (SQL-Transaktion, SNAPSHOT-Isolation). Erfordert eine SQL-Verbindung (-Conn/-Udl/-ConnStr), auch wenn -Payments direkt übergeben wurde.

-Conn #

Type: __ComObject

Bestehende ADODB-Verbindung.

-Udl #

Type: string

Pfad zu einer UDL-Datei.

-ConnStr #

Type: string

ADODB-Connection-String.

AUSGABEN #

PSCustomObject

Objekt mit OutputPath, MessageId, TotalAmount, TransactionCount und Errors.

BEISPIELE #

Export-SepaCreditTransferXml -OutputPath 'C:\Temp\sepa-überweisung.xml' -Conn $conn

Export-SepaCreditTransferXml -OutputPath 'C:\Temp\sepa-überweisung.xml' -Conn $conn -BookPayment