Class FinSepaOrderBuilder

Abstract base class for single and multiple, postdated and direct SEPA credit transfer and/or SEPA direct debit orders.

Inheritance

object

FinOrderBuilder

FinSepaOrderBuilder

FinSepaCancelPostdatedOrderBuilder

FinSepaInstPaymtBuilder

FinSepaInstPaymtReclassBuilder

FinSepaIntRemittBuilder

FinSepaModifyPostdatedInstPaymtBuilder

FinSepaModifyPostdatedSingRemittBuilder

FinSepaMultInstPaymtBuilder

FinSepaMultRemittBuilder

FinSepaMultUrgntPaymtBuilder

FinSepaReclassBuilder

FinSepaSingRemittBuilder

FinSepaStoBuilder

FinSepaSubmitPostdatedDirDebBuilder

FinSepaSubmitPostdatedInstPaymtBuilder

FinSepaSubmitPostdatedMultInstPaymtBuilder

FinSepaSubmitPostdatedMultRemittBuilder

FinSepaSubmitPostdatedSingRemittBuilder

FinSepaUrgntPaymtBuilder

Inherited Members

FinOrderBuilder.Contact

FinOrderBuilder.IsSupported

FinOrderBuilder.SepaDomesticAcctAllowed

FinOrderBuilder.SepaOrderCustAcct

FinOrderBuilder.FinTSVersion

FinOrderBuilder.OrderSegmentType

FinOrderBuilder.ParamSegmentType

FinOrderBuilder.SegmentVersion

FinOrderBuilder.ParameterDEG

FinOrderBuilder.ParameterCount

FinOrderBuilder.BuildOrderSegment(FinAcct)

FinOrderBuilder.BuildOrderSegment()

FinOrderBuilder.GetStringParameter(int)

FinOrderBuilder.GetIntegerParameter(int)

FinOrderBuilder.GetBoolParameter(int)

FinOrderBuilder.GetAmountParameter(int)

FinOrderBuilder.OrderSegmentInfo

FinOrderBuilder.BankParamSegment

FinOrderBuilder.MaxOrders

FinOrderBuilder.MinSignatures

FinOrderBuilder.SecurityLevel

FinOrderBuilder.TanSecuritySupported

FinOrderBuilder.TanRequired

FinOrderBuilder.Init(FinOrderSegmentInfo[])

FinOrderBuilder.Init(FinOrderSegmentInfo, FinSegment)

FinOrderBuilder.FindParameterSegment(FinOrderSegmentInfo)

FinOrderBuilder.AugmentSubAcctCharacteristic(FinAcct)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Subsembly.FinTS

Assembly: Subsembly.FinTS.Core.dll

Syntax

public abstract class FinSepaOrderBuilder : FinOrderBuilder

Constructors

FinSepaOrderBuilder(FinContact, SepaMessageType, bool)

Creates a new SEPA order builder with the preferred account type class FinAcctTypeClass.Giro.

Declaration

protected FinSepaOrderBuilder(FinContact aContact, SepaMessageType nMessageType, bool fIsMultOrderBuilder = false)

Parameters

Type	Name	Description
FinContact	aContact	The contact for which the order builder shall create orders. This is used to get the FinTS version, the bank parameter data and the user parameter data that are in effect. This parameter must not be null.
SepaMessageType	nMessageType	The type of the SEPA message which can be embedded within this FinTS order. Messages of this type are expected in the SEPA documents which are processed by Build. Currently SepaMessageType.CreditTransferPaymentInitiation and SepaMessageType.DirectDebitPaymentInitiation are supported.
bool	fIsMultOrderBuilder	Must be true for multiple SEPA order builders.

Exceptions

Type	Condition
ArgumentNullException	Parameter aContact was null.
ArgumentException	The parameter nMessageType is neither SepaMessageType.CreditTransferPaymentInitiation nor SepaMessageType.DirectDebitPaymentInitiation.

Properties

DataElementPosition

Must return the data element position where the actual binary SEPA message is inserted into the order segment.

Declaration

protected virtual int DataElementPosition { get; }

Property Value

Type	Description
int

Remarks

If BuildSepaSegment(FinSepaRemitt) is overridden, then this getter must be overridden, too.

IsMultipleOrderBuilder

Is true if this is a builder for a multiple SEPA order.

Declaration

protected bool IsMultipleOrderBuilder { get; }

Property Value

Type	Description
bool

MaxLeadTime

Maximum number of days that a postdated order can be scheduled in advance according to the bank parameter data (BPD). The value zero means that an order cannot be scheduled at all..

Declaration

public virtual int MaxLeadTime { get; }

Property Value

Type	Description
int

Remarks

The default implementation returns zero.

MaxNumberOfTransactions

Maximum number of allowed transaction information items in the SEPA order.

Declaration

public int MaxNumberOfTransactions { get; }

Property Value

Type	Description
int

Remarks

If this parameter does not exist, then this implementation always returns 1.

MessageType

Messages of this type can be embedded into the generated order segment.

Declaration

public SepaMessageType MessageType { get; }

Property Value

Type	Description
SepaMessageType

MinLeadDateTimeUtc

Provides the earliest date and time when the order can be scheduled according to the bank parameter data (BPD).

Declaration

public virtual DateTime MinLeadDateTimeUtc { get; }

Property Value

Type	Description
DateTime

Remarks

The returned DateTime is an UTC timestamp. It can be converted into local time.

For instant payments the minimum lead time may be given in minutes, thus the property MinLeadTime, which provides a number of days, is not good enough.

See Also

MinLeadTime

MinLeadTime

Minimum number of days that a postdated order can be scheduled in advance according to the bank parameter data (BPD). The value zero means an order can be scheduled for today.

Declaration

public virtual int MinLeadTime { get; }

Property Value

Type	Description
int

See Also

MinLeadDateTimeUtc

RequestFallbackAllowed

Declaration

public bool RequestFallbackAllowed { get; }

Property Value

Type	Description
bool

RequestedExecutionDateOptions

Declaration

public FinDateOptions RequestedExecutionDateOptions { get; }

Property Value

Type	Description
FinDateOptions

SingleBookgAllowed

Is single booking of batches allowed?

Declaration

public bool SingleBookgAllowed { get; }

Property Value

Type	Description
bool

Remarks

The default implementation always returns false. Hence, builders for batch order types must override this property accordingly.

SupportedPainFormats

Returns an array of simple pain identifiers of the supported SEPA pain XML formats.

Declaration

public string[] SupportedPainFormats { get; }

Property Value

Type	Description
string[]	The returned array may be empty, but is never null.

SupportedPurposeCodes

Optional array of SEPA PurposeCodes supported by this order builder.

Declaration

public string[] SupportedPurposeCodes { get; }

Property Value

Type	Description
string[]	The returned array may be empty, but is never null.

Remarks

The default implementation in this FinSepaOrderBuilder base class always returns an empty array. Only a few derived specialized builder classes override this property and provide a list of purpose codes from the actual BPD segment.

SupportedSepaFormats

Returns an array with the descriptors (URN) of the SEPA XML formats supported by this builder.

Declaration

public string[] SupportedSepaFormats { get; }

Property Value

Type	Description
string[]

Remarks

The data provided by actual banks is widely different and inconclusive. Thus this information is rather worthless and should be ignored. Use the processed SupportedPainFormats instead.

TotalAmountRequired

Must the total amount be specified in a batch order.

Declaration

public bool TotalAmountRequired { get; }

Property Value

Type	Description
bool

Remarks

The default implementation always returns false. Hence, builders for batch order types must override this property accordingly.

Methods

Build(FinAcct, SepaDocument)

Build a SEPA order from a SepaDocument.

Declaration

public virtual FinSepaOrder Build(FinAcct aAcct, SepaDocument aSepaDoc)

Parameters

Type	Name	Description
FinAcct	aAcct	The ordering customer account of the order to be built. The given instance must be initialized with a valid IBAN and BIC.
SepaDocument	aSepaDoc	A completely initialized SEPA payment initiation message document. This must have only a single payment information block. The number of transaction information blocks depends on the order type (single order type or multiple order type).

Returns

Type	Description
FinSepaOrder

Remarks

This method should be used if an external SEPA document was loaded and shall be submitted to the bank. In order to create a SEPA payment in code, it is better and easier to create a SepaPaymentInitiation message and use the method Build(FinAcct, SepaPaymentInitiation) instead.

Exceptions

Type	Condition
ArgumentNullException	At least one of the parameters was null.
ArgumentException	The given account did not contain a valid IBAN, or did not contain a valid BIC. Or the given SEPA document was not valid. Or the BIC and IBAN of the given account does not match the BIC and IBAN of the initiator in the SEPA document.

See Also

Build(FinAcct, SepaPaymentInitiation)

Build(FinAcct, SepaPaymentInitiation)

Build a SEPA order from a SepaPaymentInitiation that contains payments.

Declaration

public FinOrder Build(FinAcct aAcct, SepaPaymentInitiation aPainMsg)

Parameters

Type	Name	Description
FinAcct	aAcct	The ordering customer account of the order to be built. The given instance must be initialized with a valid IBAN and BIC.
SepaPaymentInitiation	aPainMsg	A completely initialized SEPA payment initiation message. This must have only a single payment information block. The number of transaction information blocks depends on the order type (single order type or multiple order type).

Returns

Type	Description
FinOrder

Remarks

This method automatically finds the highest PAIN version supported by the bank and creates a corresponding SepaDocument.

Exceptions

Type	Condition
ArgumentNullException	At least one of the parameters was null.
ArgumentException	The given account did not contain a valid IBAN, or did not contain a valid BIC. Or the given SEPA document was not valid. Or the BIC and IBAN of the given account does not match the BIC and IBAN of the initiator in the SEPA document.
NotSupportedException	No supported PAIN format could be found. Please check with SupportedPainFormats whether a PAIN format is supported by the bank.

See Also

Build(FinAcct, SepaDocument)

BuildSepaOrder(FinSegment, FinSepaRemitt)

Declaration

protected FinSepaOrder BuildSepaOrder(FinSegment aSegment, FinSepaRemitt aSepaRemitt)

Parameters

Type	Name	Description
FinSegment	aSegment
FinSepaRemitt	aSepaRemitt

Returns

Type	Description
FinSepaOrder

BuildSepaSegment(FinSepaRemitt)

Declaration

protected virtual FinSegment BuildSepaSegment(FinSepaRemitt aSepaRemitt)

Parameters

Type	Name	Description
FinSepaRemitt	aSepaRemitt

Returns

Type	Description
FinSegment

Exceptions

Type	Condition
ArgumentException	The PAIN format of the given SEPA remittance document is not supported by the bank.

Create(FinContact, string)

Creates a new FinSepaOrderBuilder derived instance that is suitable for submitting orders with the given HBCI segment type.

Declaration

public static FinSepaOrderBuilder Create(FinContact aContact, string sSegmentType)

Parameters

Type	Name	Description
FinContact	aContact	The contact for which to submit an order.
string	sSegmentType	The segment type of the requested order.

Returns

Type	Description
FinSepaOrderBuilder	If a suitable builder for the given segment type is available, then it is created and returned. If the segment type is not supported, then null is returned.

FindSepaFormat(string)

Finds the SEPA format descriptor for a given SEPA Pain identifier or a SEPA message XML namespace that contains a Pain identifier.

Declaration

public string FindSepaFormat(string sSepaFormat)

Parameters

Type	Name	Description
string	sSepaFormat	A SEPA Pain identifier in the format pain.000.000.00, or a SEPA message XML namespace that contains a Pain identifier, or any other string that contains a Pain identifier.

Returns

Type	Description
string	If found, then the first matching SEPA format descriptor from the parameter segment is returned. If no match was found, then null is returned.

Exceptions

Type	Condition
ArgumentNullException	The parameter sSepaFormat was null.
ArgumentException	The parameter sSepaFormat was an empty string, or it did not contain a valid Pain identifier.

GetRequestedExecutionTimeConstraints()

Declaration

public FinTimeConstraints GetRequestedExecutionTimeConstraints()

Returns

Type	Description
FinTimeConstraints

OnPreparePaymentInformation(FinAcct, SepaPaymentInformation)

Can be reimplemented by derived classes to do further checks/preparations on the given payment information item.

Declaration

protected virtual void OnPreparePaymentInformation(FinAcct aAcct, SepaPaymentInformation aPmtInf)

Parameters

Type	Name	Description
FinAcct	aAcct
SepaPaymentInformation	aPmtInf