Class SepaPartyIdentification

Namespace
Subsembly.Sepa
Assembly
Subsembly.Sepa.dll

A generic SEPA party identification (initiator, debtor, creditor, etc.).

public sealed class SepaPartyIdentification : SepaObject, ISepaNameAndAddress
Inheritance
SepaPartyIdentification
Implements
Inherited Members

Remarks

Currently this class primarily consists of a Name and a BIC property. However, it is likely that this class will be extended with postal address and other properties in the future.

Other SEPA object embed instances of the SepaPartyIdentification as needed. Please refer to the documentation of these other SEPA objects to learn which properties of the SepaPartyIdentification shall be set.

Constructors

SepaPartyIdentification(string, Fields, Fields)

Constructor.

public SepaPartyIdentification(string sTagName, SepaPartyIdentification.Fields nSupportedFields, SepaPartyIdentification.Fields nRequiredFields = Fields.None)

Parameters

sTagName string

The local name of the XML element tag to be used when reading or writing this object in XML format.

nSupportedFields SepaPartyIdentification.Fields

Fields that may occur in an instance of this party identfication.

nRequiredFields SepaPartyIdentification.Fields

Fields that must occur in an instance of this party identfication. If this is None, then the entire element is considered to be optional.

Remarks

An application usually does not need to create its own SepaPartyIdentification instances, but just uses the instances provided by other SEPA objects.

Properties

BIC

BIC of the party.

public SepaBIC BIC { get; set; }

Property Value

SepaBIC

Initial value is NullBIC.

Remarks

The value of this property may be used in different XML child elements, depending on context.

CreditorSchemeIdentification

Identifier of the creditor (CI).

public string CreditorSchemeIdentification { get; set; }

Property Value

string

Remarks

Optional creditor identifier (Gläubiger ID), if the party is a creditor. Must only occur in a related agent Creditor in a SepaTransactionDetails instance. Must be null in all other instances.

EBICSPartnerId

EBICS partner (customer) ID of this party.

public string EBICSPartnerId { get; set; }

Property Value

string

Remarks

This property is only used when this party identification is used for a "MsgRcpt" element. See MessageRecipient.

IsEmpty

Indicates if any supported property of this instance has been set at all.

public override bool IsEmpty { get; }

Property Value

bool

Name

Name of the party.

public string Name { get; set; }

Property Value

string

The initial value of this property is null. Must not be longer than MaxNmLen characters.

Remarks

Only latin characters should be used. It is up to the caller to ensure that the provided string contains only characters accepted by the recipient of the SEPA document.

Exceptions

ArgumentException

An attempt was made to set a string longer than 70 characters.

OtherIdentification

Shortcut to the first entry of OtherIdentifications.

public SepaOtherId OtherIdentification { get; }

Property Value

SepaOtherId

Remarks

If the OtherIdentifications collection is empty, then accessing this property will add an empty SepaOtherId instance to it and return it.

OtherIdentifications

Some other party identifications.

public SepaOtherIds OtherIdentifications { get; }

Property Value

SepaOtherIds

PostalAddress

Postal address.

public SepaPostalAddress PostalAddress { get; }

Property Value

SepaPostalAddress

Methods

Clear()

public override void Clear()

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

See Also