Class SepaStatementEntry

Namespace
Subsembly.Sepa
Assembly
Subsembly.Sepa.dll
public sealed class SepaStatementEntry : SepaObject
Inheritance
SepaStatementEntry
Inherited Members

Constructors

SepaStatementEntry() 

public SepaStatementEntry()

Properties

AccountServicerReference

Optional unique entry reference of this statement entry, provided by the bank.

public string AccountServicerReference { get; set; }

Property Value

string

An arbitrary text with a maximum length of MaxIdLen (35) characters. The character set must match CheckCharset(string).

Exceptions

ArgumentException

An attempt was made to set a string longer than 35 characters, or a string that contains invalid characters.

See Also

AdditionalEntryInformation

Additional information text pertaining to the statement.

public string AdditionalEntryInformation { get; set; }

Property Value

string

The additional information is optional and may be null. Usually the banks provide the narrative of the transaction code in this field.

AdditionalInformationMessageIdentification

Optional reference to a message identification that provides details about a batch booking.

public string AdditionalInformationMessageIdentification { get; set; }

Property Value

string

An arbitrary text with a maximum length of MaxIdLen (35) characters. The character set must match CheckCharset(string).

Remarks

This provides the message identification of a message that was prepared by the bank in order to supply detailed information about the batch booking summarized by this entry. The type of the supplementary message is provided in AdditionalInformationMessageNameIdentification.

AdditionalInformationMessageNameIdentification

Optional reference to message type that provides details about a batch booking.

public string AdditionalInformationMessageNameIdentification { get; set; }

Property Value

string

A message name such as "camt.054.001.02".

Remarks

This provides the message type of a message that was prepared by the bank in order to supply detailed information about the batch booking summarized by this entry. The actual message identification of the supplementary message is provided in AdditionalInformationMessageIdentification.

Amount

The monetary amount of the statement entry.

public SepaAmount Amount { get; }

Property Value

SepaAmount

Remarks

The currency of this amount must match the account currency.

BankTransactionCode

DEPRECATED. Use TransactionCode.ProprietaryCode instead.

public string BankTransactionCode { get; set; }

Property Value

string

Remarks

For compatibility: Settings this property also sets the BankTransactionCodeIssuer to "DK", unless it was already set to another non-empty value.

BankTransactionCodeIssuer

DEPRECATED. Use TransactionCode.ProprietaryIssuer instead.

public string BankTransactionCodeIssuer { get; set; }

Property Value

string

Batch

Indicates whether this is a batch entry, or a single transaction.

public bool Batch { get; set; }

Property Value

bool

Remarks

This flag must be set when generating a statement entry for a batch booking. The individual transactions may be included in the TransactionDetails collection, or be referenced by BatchMessageIdentification or BatchPaymentInformationIdentification.

If this is false, then the this is a statement entry for a single transaction and must contain one transaction only.

When reading the statement entry this flag is set whenever a Btch element was contained in the NtryDtls element. Also, whenever if this flag is set, then a Btch element will be written.

BatchMessageIdentification

Optional identification of the orginal batch message of a batch entry.

public string BatchMessageIdentification { get; set; }

Property Value

string

An arbitrary text with a maximum length of MaxIdLen (35) characters. By default this property is null.

Remarks

The character set must match CheckCharset(string). Setting this property with a nonempty value will implicitly set the Batch flag, too.

Exceptions

ArgumentException

An attempt was made to set a string longer than 35 characters, or a string that contains invalid characters.

BatchNumberOfTransactions

Optional number of transactions in batch entry.

public int BatchNumberOfTransactions { get; set; }

Property Value

int

Remarks

Setting this property with a nonzero value will implicitly set the Batch flag, too.

Exceptions

ArgumentException

An attempt was made to set a negative value.

BatchPaymentInformationIdentification

Optional identification of the original batch payment information.

public string BatchPaymentInformationIdentification { get; set; }

Property Value

string

An arbitrary text with a maximum length of MaxIdLen (35) characters.

Remarks

If this entry originated from a batch file, then the bank may provide the payment information identification of the original batch file in this property. For German DTAUS batch files this should be the content of field A10 of the batch file.

Setting this property with a nonempty value will implicitly set the Batch flag, too.

Exceptions

ArgumentException

An attempt was made to set a string longer than 35 characters, or a string that contains invalid characters.

BookingDate

The booking date of this entry.

public DateTime BookingDate { get; set; }

Property Value

DateTime

The value DateTime.MinValue indicates that no date has been set.

Remarks

When writing this entry only the date without the time is written. When reading the date, either the date, or a date and a time is read from the XML document.

Charges

Collection of SepaChargesRecords contained in this entry.

public SepaCharges Charges { get; }

Property Value

SepaCharges

EntryReference

Optional unique entry reference of this statement entry, provided by the bank.

public string EntryReference { get; set; }

Property Value

string

An arbitrary text with a maximum length of MaxIdLen (35) characters. The character set must match CheckCharset(string).

Exceptions

ArgumentException

An attempt was made to set a string longer than 35 characters, or a string that contains invalid characters.

See Also

IsEmpty 

public override bool IsEmpty { get; }

Property Value

bool

ReversalIndicator

Indicates whether this entry is a reversal of a previous entry.

public bool ReversalIndicator { get; set; }

Property Value

bool

Status

Status of this entry.

public string Status { get; set; }

Property Value

string

A four letter code that indicates the status of this entry. This is a required property and therefore must be set with a valid code before the entry can be written.

StatusCode

Status of this entry.

public SepaStatementEntryStatus StatusCode { get; set; }

Property Value

SepaStatementEntryStatus

TransactionCode

The bank transaction code set of elements.

public SepaBankTransactionCode TransactionCode { get; }

Property Value

SepaBankTransactionCode

TransactionDetails

Collection of individual transactions that make up this entry.

public SepaTransactionDetailsCollection TransactionDetails { get; }

Property Value

SepaTransactionDetailsCollection

Remarks

Usually this collection contains only a single entry. When this statement entry stems from a batch payment, then the bank may opt to provide the details of the individual transactions of the batch payment as multiple SepaTransactionDetails objects in this collection. In all cases, the total amount of all transactions must match the Amount of the entry.

ValueDate

The value date of this entry.

public DateTime ValueDate { get; set; }

Property Value

DateTime

The value DateTime.MinValue indicates that no date has been set.

Remarks

When writing this entry only the date without the time is written. When reading the date, either the date, or a date and a time is read from the XML document.

Methods

Clear() 

public override void Clear()

CreateEntry(SepaTransactionDetails)

Creates a simple default entry that contains the given single transaction.

public static SepaStatementEntry CreateEntry(SepaTransactionDetails aTxn)

Parameters

aTxn SepaTransactionDetails

Returns

SepaStatementEntry

OnReadXml(XmlReader, SepaMessageInfo) 

protected override void OnReadXml(XmlReader aXmlReader, SepaMessageInfo aMessageInfo)

Parameters

aXmlReader XmlReader
aMessageInfo SepaMessageInfo

OnValidate(ICollection<SepaException>, string) 

protected override void OnValidate(ICollection<SepaException> vErrors, string sPath)

Parameters

vErrors ICollection<SepaException>
sPath string

OnWriteXml(XmlWriter, SepaMessageInfo) 

protected override void OnWriteXml(XmlWriter aXmlWriter, SepaMessageInfo aMessageInfo)

Parameters

aXmlWriter XmlWriter
aMessageInfo SepaMessageInfo