XML NL Guidelines Sepa

XML message for
SEPA Credit
Transfer Initiation

Implementation Guidelines
for the Netherlands
Disclaimer
These guidelines may be subject to changes. Utmost care has been taken to ensure the information in this publication is accurate. However, the
Netherlands Bankers' Association shall not be liable for any errors, inaccuracies or omissions in the contents of this publication.

Version 1.1 – December 2008

2 XML message for SEPA Credit Transfer Initiation

Table of Contents

1 Introduction ..............................................................................................................................................4
1.1 Coverage .......................................................................................................................................5
1.2 Use of these Guidelines ................................................................................................................6
1.3 Character Set.................................................................................................................................7
1.4 Message Structure ........................................................................................................................7

2 SEPA Credit Transfers ..........................................................................................................................10
Message structure .................................................................................................................................11

Message items description ............................................................................................................................14
1.0 GroupHeader ...............................................................................................................................14
1.1 MessageIdentification ..................................................................................................................15
1.2 CreationDateTime .......................................................................................................................15
1.4 BatchBooking...............................................................................................................................16
1.5 NumberOfTransactions ...............................................................................................................16
1.6 ControlSum..................................................................................................................................16
1.7 Grouping ......................................................................................................................................17
1.8 InitiatingParty...............................................................................................................................18
2.0 PaymentInformation ....................................................................................................................19
2.1 PaymentInformationIdentification ................................................................................................20
2.2 PaymentMethod ..........................................................................................................................20
2.3 PaymentTypeInformation ............................................................................................................21
2.4 InstructionPriority.........................................................................................................................22
2.5 ServiceLevel ................................................................................................................................22
2.6 Code ............................................................................................................................................23
2.12 CategoryPurpose.........................................................................................................................24
2.13 RequestedExecutionDate............................................................................................................24
2.15 Debtor ..........................................................................................................................................25
2.16 DebtorAccount .............................................................................................................................26
2.17 DebtorAgent.................................................................................................................................27
2.19 UltimateDebtor.............................................................................................................................28
2.20 ChargeBearer ..............................................................................................................................29
2.23 CreditTransferTransactionInformation.........................................................................................30
2.24 PaymentIdentification ..................................................................................................................31
2.25 Instruction Identification...............................................................................................................31
2.26 EndToEndIdentification ...............................................................................................................31
2.27 PaymentTypeInformation ............................................................................................................32
2.37 Amount ........................................................................................................................................33

2

XML messages for Customer Credit Transfer Initiation 3

2.38 InstructedAmount........................................................................................................................ 33
2.46 ChargeBearer ............................................................................................................................. 34
2.48 UltimateDebtor ............................................................................................................................ 35
2.55 CreditorAgent.............................................................................................................................. 36
2.57 Creditor ....................................................................................................................................... 37
2.58 CreditorAccount .......................................................................................................................... 38
2.59 UltimateCreditor .......................................................................................................................... 39
2.64 Purpose....................................................................................................................................... 40
2.65 Code ........................................................................................................................................... 40
2.84 RemittanceInformation................................................................................................................ 41
2.85 Unstructured ............................................................................................................................... 41
2.86 Structured ................................................................................................................................... 42
2.100 CreditorReferenceInformation .................................................................................................... 43

Appendix A – Clieop03 equivalent................................................................................................................ 45

Appendix B – Party Identifiers ...................................................................................................................... 48

3

1 Introduction
This document sets out the Implementation Guidelines for the XML Customer Credit Transfer Initiation
message UNIFI (ISO20022) - “pain.001.001.02” in the Netherlands.

The purpose of these Implementation Guidelines is to provide guidance on the use of the SEPA Credit
Transfer Initiation Message sent to banks, residing in The Netherlands. These guidelines for European
Credit Transfers are compliant with the Implementation Guidelines for Customer to Bank messages for
SEPA Credit Transfers, published by the European Payments council.

This version 1.1 should be used as of 02-02-2009 replacing all previous versions.

More information on the SEPA migration in the Netherlands can be found in the SEPA migration plan,
published on the website www.sepanl.nl.

These Implementation Guidelines have been developed by the Dutch banks together with the
Netherlands’ Bankers Association (NVB). This version 1.1 is published in December 2008.

The utmost has been done to make sure the information in this publication is correct. However, the NVB
can by no means be held responsible for any loss or damage incurred to any incorrect or incomplete
information as described in this publication.

Please contact your bank for any further information.

4

1.1 Coverage
The Customer SEPA Credit Transfer Initiation message is sent by the initiating party to the debtor bank. It
is used to request movement of funds from the debtor account to a creditor account.

The Customer SEPA Credit Transfer Initiation message is used to exchange:
- One or more Credit Transfer instructions;
- Payment transactions that result in a single entry on the debtor account per individual transaction or a
batch entry for all transactions in a payment;

The message can be used in a direct or a relay scenario:
- In a direct scenario, the message is sent directly to the debtor bank. The debtor bank is the
account servicer of the debtor.
- In a relay scenario, the message is sent to a forwarding party. The forwarding party acts as a
concentrating financial institution. It will forward the Customer SEPA CreditTransferInitiation
message to the debtor bank.

The message can also be used by an initiating party that has been mandated to send a payment
instruction on behalf of the debtor. This caters for example for the scenario of a payments factory initiating
all payments on behalf of a large corporate, or an entity administering the salary payments of a company's
employees.

5

1.2 Use of these Guidelines
Each item of the CreditTransferInitiation message is referred to the corresponding index of the item in the
UNIFI (ISO 20022) Message Definition Report for Payment Standards – Initiation. This Report can be
found on www.iso20022.org, under “Catalogue of UNIFI messages”, with “pain.001.001.02” as reference.

Any gaps in the index numbering are due to the fact that certain message elements of the UNIFI message
are not supported. The occurrences of a message element (mandatory/optional) can also differ between
these guidelines and the UNIFI (ISO20022) Message Definition.

Message elements not described in these guidelines may not be used, and usage rules must be
adhered to, to avoid possible reject of the message or payment, or data being ignored.

The description of each message item contains:

Index Number that refers to the corresponding description in the UNIFI (ISO 20022)
Message Definition Report for Payment Standards – Initiation
Definition This contains the definition of the message block or element
Usage Additional info how this element must be used
XML Tag Short name that identifies an element within an XML message, that is put between
brackets, e.g. <Amount>
Occurrences This indicates whether an element is optional or mandatory and how many times the
element can be repeated. The number of occurrences is shown in square brackets

For example:
[0..1] shows that the element can be present 0 times or 1 time.
The element is optional
[1..1] shows that the element can only be present 1 time.
The element is mandatory
[1..n] shows that the element is mandatory and can be present
1 to n times

An element, that is part of a block of elements, is mandatory as far as the block it is
part of, is present in the message.

If only one of several elements may be present, this is indicated by {OR … OR}
before the elements concerned.
Format This specifies the permitted values and format
Rules Any specific rules that could impact the presence or the values of an element

6

1.3 Character Set
The UTF8 character encoding standard must be used in the UNIFI messages.

The Latin character set, commonly used in international communication, must be used.

It contains the following characters:
abcdefghijklmnopqrstuvwxyz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789
/-?:().,'+
Space

1.4 Message Structure
The description of the UNIFI document models can be found in a number of schemes. A specific
description language (XSD) is used in those schemes. The schemes make it possible to give a description
of the tags in the document, the structure and sequence of those beacons (hierarchy of tags) as well as
the codes which are allowed for some specific data, the number of possible cases, the obligatory or
optional character of some of the data, etc.

The general XSD for pain.001.001.02 can be downloaded from www.iso20022.org > Catalogue of UNIFI
Messages > Payments > Payment Initiation > CustomerCreditTransferInitiationV02

A file containing an XML- pain.001.001.02 message has the following structure :
<?xml version=1.0 encoding=UTF-8?>
<Document xmlns=urn:swift:xsd:$pain.001.001.02 xmlns:xsi=http://www.w3.org/2001/XMLSchemainstance>
<pain.001.001.02>
message content …
</pain.001.001.02>
</Document>

A file must contain one single Document (envelope), which contains one single XML-message. The
support of multiple documents per file must be agreed bilaterally with your bank.

7

8 XML messages for Customer Credit Transfer Initiation

The message is composed of 3 building blocks:

A. Group Header: This building block is mandatory and present once. It contains elements such as
Message Identification, Creation Date and Time, Grouping Indicator.
B. Payment Information: This building block is mandatory and repetitive. It contains besides elements
related to the debit side of the transaction, such as Debtor and Payment Type Information, also one or
several Transaction Information Blocks.
C. Transaction Information: This building block is mandatory and repetitive. It contains, amongst others,
elements related to the credit side of the transaction, such as Creditor and Remittance Information.
The number of occurrences of Payment Information Block and Transaction Information Block within a
message is indicated by the Grouping field in the Group Header. Only the following combination can be
used :

Mixed Indicates that there are one or several occurrences of the Payment Information Block
where each of the occurrences might contain one or several occurrences of the
Transaction Information Block.

Group Header

Payment Information 1

Transaction
Information 1

Transaction
Information 2

Transaction
Information 3

Transaction
Information 4

Transaction
Information 5

Transaction
Information 6

A detailed view on the structure of a Credit Transfer Initiation Message is presented below.

Legend:

Box with full-line is a mandatory Message Element

Box with dotted line is an optional Message Element

The Child Elements must appear in the sequence mentioned

Only one of the possible Child Elements may be present (choice)

9

2 SEPA Credit Transfers
A SEPA Credit Transfer is a credit transfer in euro between accounts, both located in countries of the
Single Euro Payments Area (SEPA).

The amount of a transaction is not limited
(only a technical limit of 999.999.999,99 EUR).

Debtor’s and Creditor’s account and their banks, are identified respectively by their IBAN and their BIC.

Charges applied by Debtor and Creditor Bank are born respectively by Debtor and Creditor.

No special instructions may be given for Debtor or Creditor Bank.

These implementation Guidelines for European Transfers are based on the Implementation Guidelines for
SEPA Credit Transfer Scheme version 3.2, published by the European Payments Council (EPC).

10


Message structure
The following table provides a summary of the message items to be used for a European Credit Transfer.

A more detailed description of each message item is given in chapter 4 “Message items description”.
Complete description of Identification is given in appendix B.

Index Occ. Message Item <XML Tag> Length

1.0 [1..1] GroupHeader <GrpHdr>
1.1 [1..1] MessageIdentification <MsgId> 35
1.2 [1..1] CreationDateTime <CreDtTm> 19
1.4 [0..1] BatchBooking <BtchBookg> 5
1.5 [1..1] NumberOfTransactions <NbOfTxs> 15
1.6 [0..1] ControlSum <CtrlSum> 4
1.7 [1..1] Grouping <Grpg> 4
1.8 [1..1] InitiatingParty <InitgPty>
[0..1] Name <Nm> 70
[0..1] Identification <Id>
see app.B for sub-fields
2.0 [1..n] PaymentInformation <PmtInf>
2.1 [0..1] PaymentInformationIdentification <PmtInfId> 35
2.2 [1..1] PaymentMethod <PmtMtd> 3
2.3 [0..1] PaymentTypeInformation <PmtTpInf>
2.4 [0..1] InstructionPriority <InstrPrty> 4
2.5 [0..1] ServiceLevel <SvcLvl>
[1..1] Code <Cd> 4
2.12 [0..1] CategoryPurpose <CtgyPurp> 4
2.13 [1..1] RequestedExecutionDate <ReqdExctnDt> 10
2.15 [1..1] Debtor <Dbtr>
[1..1] Name <Nm> 70
[0..1] PostalAddress <PstlAdr>
[0..2] AddressLine <AdrLine> 70
[1..1] Country <Ctry> 2
[0..1] Identification <PstlAdr>
2.16 [1..1] DebtorAccount <DbtrAcct>
[1..1] IBAN <IBAN> 34


[0..1] Currency <Ccy> 3
2.17 [1..1] DebtorAgent <DbtrAgt>
[1..1] FinancialInsitutionIdentification <FinInstnId>
[1..1] BIC <BIC> 11
2.19 [0..1] UltimateDebtor <UltmtDbtr>
[0..1] Name <Nm> 70
2.20 [0..1] ChargeBearer <ChrgBr> 4
2.23 [1..n] CreditTransferTransactionInformation <CdtTrfTxInf>
2.24 [1..1] PaymentIdentification <PmtId>
2.25 [0..1] InstructionIdentification <InstrId> 35
2.26 [1..1] EndToEndIdentification <EndToEndId> 35
2.27 [1..1] PaymentTypeInformation < PmtTpInf >
2.30 [1..1] Code <Cd> 4
2.36 [0..1] CategoryPurpose <CtgyPurp> 4
2.37 [1..1] Amount <Amt>
2.38 [1..1] InstructedAmount <InstdAmt> 21

2.46 [0..1] ChargeBearer <ChrgBr>
2.48 [0..1] UltimateDebtor <UltmtDbtr>
[0..1] Name <Nm> 70
2.55 [0..1] CreditorAgent <CdtrAgt>
[1..1] FinancialInstitutionIdentification <FinInstnId>
[1..1] BIC <BIC> 11
2.57 [1..1] Creditor <Cdtr>
[1..1] Name <Nm> 70
[0..2] AddressLine <AdrLine> 70
[1..1] Country <Ctry> 2
2.58 [1..1] CreditorAccount <CdtrAcct>
[1..1] IBAN <IBAN> 34
2.59 [0..1] UltimateCreditor <UltmtCdtr>
[0..1] Name <Nm> 70

12


2.64 [0..1] Purpose <Purp>
2.65 [1..1] Code <Cd> 35
2.84 [0..1] RemittanceInformation <RmtInf>
2.85 [1..1] {Or Unstructured <Unstrd> 140

2.86 [1..1] Or} Structured <Strd>

2.100 [1..1] CreditorReferenceInformation <CdtrRefInf>
2.101 [1..1] CreditorReferenceType <CdtrRefTp>
2.102 [1..1] Code <Cd> 4
2.104 [1..1] Issuer <Issr> 35
2.105 [1..1] CreditorReference <CdtrRef> 35

13


Message items description

1.0 GroupHeader

Definition : --- Set of characteristics shared by all transactions included in the message.
XML Tag : <GrpHdr>
Occurrences : [1..1]

1.1 MessageIdentification

Definition : Point to point reference assigned by the instructing party and sent to the next party in the
chain to unambiguously identify the message.
Usage : The instructing party has to make sure that “MessageIdentification” is unique per
instructed party for a pre-agreed period.
XML Tag : <MsgId>
Format : Max35Text

1.2 CreationDateTime

Definition : Date and Time at which a (group of) payment instruction(s) was created by the instructing
party.
XML Tag : <CreDtTm>
Format : YYYY-MM-DDThh:mm:ss
Example : <CreDtTm>2008-01-28T08:35:30</CreDtTm>

15

1.4 BatchBooking

Definition : Identifies whether a single entry per individual transaction or a batch entry for the sum of
the amounts of all transactions in a payment is requested
XML Tag : <BtchBookg>
Format : One of the following “BatchBooking” values must be used :

Code Name Definition
TRUE True Identifies that a batch entry for the sum of the amounts of all transactions in a
Payment Information Block is requested (one debit for all transactions in a
Payment Information Block)
FALSE False Identifies that a single entry for each of the transactions in a message is
requested

Rules : Usage possible following bilateral bank-customer (if absent and no bilateral agreement
present, then batch booking is considered to be <TRUE>).
Remark : A batch entry is created per payment, and not across payments within the same
message.

1.5 NumberOfTransactions

Definition : Number of individual transactions contained in a message.
XML Tag : <NbOfTxs>
Format : Max15NumericText

1.6 ControlSum

Definition: Total of all individual amounts included in the message, irrespective of currencies.
Occurences: [0..1]
XML Tag : <CtrlSum >
Format: Max. 35 digits
Decimal separator is “.”

16

1.7 Grouping

Definition : Indicates whether common accounting information in the message is included once for all
transactions or repeated for each single transaction.
Usage : See chapter Message Structure
XML Tag : <Grpg>
Format : The following grouping code must be used :

MIXD Mixed Indicates that there are one or several occurrences of the Payment
Information Block where each of the occurrences might contain one or
several occurrences of the Transaction Information Block.

17

1.8 InitiatingParty

Definition : Party initiating the payment. This can either be the debtor or a party that initiates the
payment on behalf of the debtor.
XML Tag : <InitgPty>
Format : This message item is composed of the following elements :

Name XML Tag Occurrenc Format
es
Name <Nm> [0..1] Max70Text
Identification <Id> [0..1] See App. B

Rules : either Name or Identification or both must be used. Please contact your bank for usage of
Identification tag.

Example :
<InitgPty>
<Nm>Service Bureau XXX</Nm>
</InitPty>

18

2.0 PaymentInformation

Definition : Set of characteristics that applies to the debit side of the payment transactions as well as
one or several Transaction Information Blocks.
XML Tag : <PmtInf>
Occurrences : [1..n]

19

2.1 PaymentInformationIdentification

Definition : Reference assigned by a sending party to unambiguously identify the payment
information block within the message.
XML Tag : <PmtInfId>
Format : Max35Text

Rule : If is recommended to provide Payment Information Identification.

2.2 PaymentMethod

Definition : Specifies the means of payment that will be used to move the amount of money.
XML Tag : <PmtMtd>
Format : Code
The following PaymentMethod Code must be used :

TRF Transfer Transfer of an amount of money from Debtor account to Creditor account.

Rules : Per definition, only TRF is allowed for SEPA Credit Transfers.

20

2.3 PaymentTypeInformation

Definition : Set of elements that further specifies the type of transaction.
XML Tag : <PmtTpInf>

Name XML Tag Index Occurrences Format

InstructionPriority <InstrPrty> 2.4 [0..1] Code
ServiceLevel <SvcLvl> 2.5 [0..1]
CategoryPurpose <CtgyPurp> 2.12 [0..1] Code

Rules :
- If used, it is recommended to be used only at ‘Payment Information’ level and not
at Credit transfer Transaction Information’ level.
- When Instruction Priority is to be used, ‘Payment Type Information’ must be
present at ‘Payment Information’ level.

21

2.4 InstructionPriority

This Messsage item is part of PaymentTypeInformation (2.3)
Definition : Indicator of the urgency that the initiating party would like the Debtor’s Bank to apply to
the processing of the instruction.
XML Tag : <InstrPrty>
Format : Code
When this message item is present, one of the following values must be used:

NORM Normal Priority level is normal
HIGH High Priority level is high

Rules : if InstructionPriority is absent, its value is considered to be “NORM”.
For usage of “HIGH”, please contact your bank.

2.5 ServiceLevel

This Message item is part of PaymentTypeInformation (2.3)
Definition : Agreement under which or rules under which the transaction should be processed
XML Tag : <SvcLvl>

Code <Cd> 2.6 [1..1] Code

Rule : For SEPA Credit Transfer, Service Level is recommended.

22

2.6 Code

This Message item is part of ServiceLevel (2.5).
Definition : Identification of a pre-agreed level of service under a coded form.
XML Tag : <Cd>
Format : Code
The following Code value must be used:

SEPA Single Euro Payments Payment must be executed following the Single Euro
Area Payments Area scheme

Rules : For SEPA Credit Transfer, only “SEPA” code is allowed.

23

2.12 CategoryPurpose

This Messsage item is part of PaymentTypeInformation (2.3)
Definition : Specifies the purpose of the payment based on a set of pre-defined categories
XML Tag : <CtgyPurp>
Format : Code
For a complete list of all possible codes, see Message Definition Report (MDR) of pain.001.001.02 at
http://www.iso20022.org/UNIFI_payments_messages.page (element 2.12 CategoryPurpose).

Rule :

- Depending on the agreement between the Originator and the Originator Bank,
‘Category Purpose’ may be forwarded to the Beneficiary Bank

- The usage and impact of possible codes is to be agreed with your bank.

2.13 RequestedExecutionDate

Definition : Date at which the initiating party requests the Debtor’s Bank to process the payment. This
is the date on which the debtor’s account is to be debited.
XML Tag : <ReqdExctnDt>
Format : YYYY-MM-DD
Rule : For maximum time frame of future execution date, please contact your bank.

24

2.15 Debtor

Definition : Party that owes an amount of money to the creditor.
XML Tag : <Dbtr>

PostalAddress <PstlAdr> [0..1]
AddressLine <AdrLine> [0..2] Max70Text
Country <Ctry> [1..1] ISO Country Code

Rules :

- Only two occurrences of ‘Address Line’ are allowed.

- Identification (see Appendix B) :

Only one sub-element of ‘Organisation Identification’ may be present.
o

Only one occurrence of ‘Private Identification’ may be present.
o

Example :
<Dbtr>
<Nm>Cobelfac</Nm>
<PstlAdr>
<AdrLine>StreetName 16 </AdrLine>
<AdrLine>9999 AB Amsterdam</AdrLine>
<Ctry>NL</Ctry>
</PstlAdr>
</Dbtr>

25

2.16 DebtorAccount

Definition : Unambiguous identification of the account of the debtor to which a debit entry will be
made as a result of the transaction.
XML Tag : <DbtrAcct>

Identification <Id> [1..1]
IBAN <IBAN> [1..1] IBAN-format
(International Bank
Account Number)
Currency <Ccy> [0..1]

Rules : - IBAN must be used for Dutch accounts, as well as for accounts in another SEPA country
Example :
<DbtrAcct>
<Id>
<IBAN>NL68XXXX0123456789</IBAN>
</Id>
</DbtrAcct>

Rule : Check with your bank if debtor’s account with another currency than EUR can be used.

26

2.17 DebtorAgent

Definition : Financial institution servicing an account for the debtor.
XML Tag : <DbtrAgt>

FinancialInstitutionIdentification <FinInstnId> [1..1]
BIC <BIC> [1..1] BIC-format

The Bank Identifier Code (BIC) is composed of 8 or 11 characters.

Example :
<DbtrAgt>
<FinInstnId>
<BIC>AAAANL33</BIC>
</FinInstnId>
</DbtrAgt>

27

2.19 UltimateDebtor

Definition : Ultimate party that owes an amount of money to the (ultimate) creditor.

XML Tag : <UltmtDbtr>


Format : This message item consists of the following elements :

Name XML Tag Occurrences Format
Rules : Ultimate Debtor may be present either at ‘Payment Information’ or at ‘Credit Transfer Transaction
Information’ level
Please contact your bank for usage of Identification tag.

Example :

<UltmtDbtr>

<Id>

<OrgId>
<PrtryId>
<Id>1234567</Id>
<Issr>Ins. Companyl</Issr>
</PrtryId>
</OrgId>
</Id>

</UltmtDbtr>

28

2.20 ChargeBearer

Definition : Specifies which party/parties will bear the charges associated with the processing of the
payment transaction.
XML Tag : <ChrgBr>
Format : Code

If present, the following value must be used :

SLEV Following Service Level Charges are to be applied following the rules agreed in the
sercie level and/or scheme. For SEPA, charges applied by
Debtor and Creditor Bank are charged resp. to Debtor and
Creditor.

Rules :

- Only “SLEV” is allowed.
- If ChargeBearer is absent, “SLEV” is used as default value for SEPA Credit
Transfers.

- If used, it is recommended that this element be specified at ‘Payment Information’
level (2.20).
Example :
<ChrgBr>SLEV</ChrgBr>

29

2.23 CreditTransferTransactionInformation

Definition : Set of elements providing information specific to the individual transaction(s) included in
the message.
XML Tag : <CdTrfTxInf>
Occurrences : [1..n]

30

2.24 PaymentIdentification

Definition : Set of elements to reference a payment instruction.
XML Tag : <PmtId>

Index Name
2.25 InstructionIdentification
2.26 EndToEndIdentification

2.25 Instruction Identification

Definition : Unique identification as assigned by an instructing party for an instructed party to
unambiguously identify the instruction.
XML Tag : <InstrId>
Format : max35Text

Rule : The instruction identification is a point to point reference that can be used between
the instructing party and the debtor’s bank to refer to the individual instruction. It can be
included in several messages related to the instruction.

2.26 EndToEndIdentification

This Message item is part of PaymentIdentification (2.24)

Definition : Unique identification assigned by the initiating party to unambiguously identify the
transaction. This identification is passed on, unchanged, throughout the entire end-to-end
chain.
XML Tag : <EndToEndId>

31

Format : max35Text

2.27 PaymentTypeInformation

Definition : Set of elements that further specifies the type of transaction.
XML Tag : <PmtTpInf>


ServiceLevel <SvcLvl> 2.5 [0..1]
CategoryPurpose <CtgyPurp> 2.12 [0..1] Code

Rules :
- If used, it is recommended to be used only at ‘Payment Information’ level and not
at Credit transfer Transaction Information’ level.

32

2.37 Amount

Definition : Amount of money to be moved between the debtor and creditor.
XML Tag : <Amt>

InstructedAmount <InstdAmt> 2.38 [1..1]

2.38 InstructedAmount

This Message item is part of Amount (2.37)

Definition : Amount of the Credit Transfer, expressed in EUR.
XML Tag : <InstdAmt>
Format : max. 11 digits
Decimal separator is “.”
Currency is explicit, and included in the XML-tag.
Rules :
Currency must be “EUR”
o

Amount must be 0.01 or more and 999999999.99 or less
o

The fractional part has a maximum of 2 digits
o

Example :
<InstdAmt Ccy=”EUR”>4723.34</InstdAmt>

33

2.46 ChargeBearer

Definition : Specifies which party/parties will bear the charges associated with the processing of the
payment transaction.
XML Tag : <ChrgBr>
Format : Code

If present, the following value must be used :

SLEV Following Service Level Charges are to be applied following the rules agreed in the
sercie level and/or scheme. For SEPA, charges applied by
Debtor and Creditor Bank are charged resp. to Debtor and
Creditor.

Rules :

- Only “SLEV” is allowed.
- If ChargeBearer is absent, “SLEV” is used as default value for SEPA Credit
Transfers.

- If used, it is recommended that this element be specified at ‘Payment Information’
level (2.20).
Example :
<ChrgBr>SLEV</ChrgBr>

34

2.48 UltimateDebtor

Definition : Ultimate party that owes an amount of money to the (ultimate) creditor. It should only be
specified in case it is different from the Debtor.

XML Tag : <UltmtDbtr>



Rules : Ultimate Debtor may be present either at ‘Payment Information’ or at ‘Credit Transfer Transaction
Information’ level
Please contact your bank for usage of Identification tag.

Example :

<UltmtDbtr>

<Id>

<OrgId>
<PrtryId>
<Id>12345678</Id>
<Issr>lambda</Issr>
</PrtryId>
</OrgId>
</Id>

</UltmtDbtr>

35

2.55 CreditorAgent

Definition : Financial institution servicing the account of the creditor.
XML Tag : <CdtrAgt>


FinancialInstitutionIdentification <FinInstnId> [1..1]
BIC <BIC> [1..1] BIC-format
The Bank Identifier Code (BIC) is composed of 8 or 11 characters.

Example: in this example the CreditorAgent is identified by his BIC
<CdtrAgt>
<FinInstnId>
<BIC>CRBANL22</BIC>
</FinInstnId>
</CdtrAgt>

36

2.57 Creditor

Definition : Party to which an amount of money is due.
XML Tag : <Cdtr>

PostalAddress <PstlAdr> [0..1]
AddressLine <AdrLine> [0..2] Max70Text
Country <Ctry> [1..1] ISO Country Code
Identification <Id> [0..1] See app. B

Rules :

- Only two occurrences of ‘Address Line’ are allowed.

- Identification (see Appendix B) :

Only one sub-element of ‘Organisation Identification’ may be present.
o

Only one occurrence of ‘Private Identification’ may be present.
o

Example :
<Cdtr>
<Nm>SocMetal</Nm>
<PstlAdr>
<AdrLine> StreetName XXX </AdrLine>
<AdrLine>9999 AD Amsterdam </AdrLine>
<Ctry>NL</Ctry>
</PstlAdr>
</Cdtr>

37

2.58 CreditorAccount

Definition : Unambiguous identification of the account of the creditor to which a credit entry will be
posted as a result of the payment transaction.
XML Tag : <CdtrAcct>
Identification <Id> [1..1]
IBAN <IBAN> [1..1] IBAN-format
(International Bank
Account Number)

Example :
<CdtrAcct>
<Id>
<IBAN>NL43XXXX0123456789</IBAN>
</Id>
</CdtrAcct>

38

2.59 UltimateCreditor

Definition : Ultimate party to which an amount of money is due. This element should only be specified
in case it is different from the Creditor.

XML Tag : <UltmtCdtr>



Rules : Please contact your bank for usage of Identification tag.

Example :

<UltmtCDtr>

<Id>

<OrgId>
<PrtryId>
<Id>123456AB</Id>
<Issr>Company </Issr>
</PrtryId>
</OrgId>
</Id>

</UltmtCdtr>

39

2.64 Purpose

Definition : Underlying reason for the payment transaction.
Purpose is used by the Debtor to provide information to the Creditor, concerning the
nature of the payment transaction. It is not used for processing by any of the banks
involved.

XML Tag : <Purp>


Format : This message item contains the following element :

Index Name

2.65 Code

2.65 Code

This Message item is part of PaymentIdentification (2.64)

Definition : Specifies the underlyijng reason of the payment transaction

XML Tag : <Cd>


Format : Code
For list of possible codes for Purpose,
see http://www.iso20022.org/Payments_External_Code_Lists.page

40

2.84 RemittanceInformation

Definition : Information that enables the matching of a payment with the items that the payment is
intended to settle, e.g., commercial invoices in an account receivable system.
This information can be structured or unstructured.
XML Tag : <RmtInf>

Index Occurences Name
[1..1] {Or
2.85 Unstructured
[1..1] Or}
2.86 Structured

Rules : Either Structured or Unstructured , but not both, may be present.

2.85 Unstructured

This Message item is part of RemittanceInformation (2.84)

Definition : Information supplied to enable the matching of an entry with the items that the transfer is
intended to settle, e.g., a commercial invoice, in an unstructured form.
XML Tag : <Ustrd>
Format : max140Text

41

2.86 Structured

This Message item is part of RemittanceInformation (2.84)

Definition : Information that enables the matching of a payment with the items that the payment is
intended to settle, in a structured form.
XML Tag : <Strd>
Format : This message item is composed of the following element :

Index Name
2.100 CreditorReferenceInformation

42

2.100 CreditorReferenceInformation

This Message item is part of Structured (2.86)

Definition : Information provided by the creditor in a structured form, to enable automatic
reconciliation of an entry with the items that the transfer is intended to settle, e.g. a
commercial invoice in an accounts' receivable system.
This item is to be used for the Structured Communication, supported by the Dutch Banks.
XML Tag : <CdtrRefInf>

Name XML Tag Index Occurences Format
CreditorReferenceType <CdtrRefTp> 2.101 [1..1] Tag
Code <Cd> 2.102 [1..1] Code
Issuer <Issr> 2.104 [1..1] max35Text
CreditorReference <CdtrRef> 2.105 [1..1] Structured Number

If the Dutch Structured Communication is used the following value must be used as Code for
CreditorReferenceType :

SCOR StructuredCommunication Document is a structured communication
Reference reference provided by the creditor to identify the
referred transaction.

and the following value must be used as Issuer for CreditorReferenceType :

CUR Currence Product owner of Acceptgiro

43

Example :
<CdtrRefinf>
<CdtrRefTp>
<Cd>SCOR</Cd>
<Issr>CUR</Issr>
</CdtrRefTp>
<CdtrRef>ABCDEFGH012345678</CdtrRef>
</CdtrRefInf

44

45

Appendix A – Clieop03 equivalent
The following table is provided for information only and contents the relation between the XML message
items and the ClieOp03 fields, when applicable. This gives an indication of the content but is not a 1 to 1
mapping from one message type to the other, as internal field formats are not detailed.

Index Occ. Message Item <XML Tag> CLIEOP03 field

1.0 [1..1] GroupHeader <GrpHdr>

1.1 [1..1] MessageIdentification <MsgId> 0001-04
1.2 [1..1] CreationDateTime <CreDtTm> 0001-03

1.4 [0..1] BatchBooking <BtchBookg>

1.5 [1..1] NumberOfTransactions <NbOfTxs> 9990-05

1.7 [1..1] Grouping <Grpg>

1.8 [1..1] InitiatingParty <InitgPty>

[0..1] Name <Nm> 0030-05


2.0 [1..n] PaymentInformation <PmtInf>

2.1 [0..1] PaymentInformationIdentification <PmtInfId> 0150-03

2.2 [1..1] PaymentMethod <PmtMtd>

2.3 [0..1] PaymentTypeInformation <PmtTpInf>

2.4 [0..1] InstructionPriority <InstrPrty>


[1..1] Code <Cd>

2.12 [0..1] CategoryPurpose <CtgyPurp>

2.13 [1..1] RequestedExecutionDate <ReqdExctnDt> 0030-04

2.15 [1..1] Debtor <Dbtr>

[0..1] Name <Nm> 0110-03

[0..2] AddressLine <AdrLine> 0113-03

[1..1] Country <Ctry>

2.16 [1..1] DebtorAccount <DbtrAcct>


[1..1] IBAN <IBAN> 0010-05

[0..1] Currency <Ccy>

2.17 [1..1] DebtorAgent <DbtrAgt>

[1..1] FinancialInsitutionIdentification <FinInstnId>

45


[1..1] BIC <BIC>

2.19 [0..1] Ultimate Debtor <UltmtDbtr>

[0..1] Name <Nm>


[0..2] AddressLine <AdrLine>


2.20 [0..1] ChargeBearer <ChrgBr>

2.23 [1..n] CreditTransferTransactionInformation <CdtTrfTxInf>

2.24 [1..1] PaymentIdentification <PmtId>

2.25 [0..1] InstructionIdentification <InstrId>

2.26 [1..1] EndToEndIdentification <EndToEndId>

2.37 [1..1] Amount <Amt>

2.38 [1..1] InstructedAmount <InstdAmt> 0100-04

2.48 [0..1] Ultimate Debtor <UltmtDbtr>

[0..1] Name <Nm>



2.55 [0..1] CreditorAgent <CdtrAgt>

[1..1] FinancialInstitutionIdentification <FinInstnId>

[1..1] BIC <BIC>

2.57 [1..1] Creditor <Cdtr>

[1..1] Name <Nm> 0170-03


[0..2] AddressLine <AdrLine> 0173-03


2.58 [1..1] CreditorAccount <CdtrAcct>


[1..1] IBAN <IBAN> 0100-06

2.59 [0..1] Ultimate Creditor <UltmtCdtr>

[0..1] Name <Nm>



46

47


2.84 [0..1] RemittanceInformation <RmtInf>

2.85 [1..1] {Or Unstructured <Unstrd> 0160-03

2.86 [1..1] Or} Structured <Strd>

2.100 [1..1] CreditorReferenceInformation <CdtrRefInf>

2.101 [1..1] CreditorReferenceType <CdtrRefTp>

2.102 [1..1] Code <Cd>
2.104 [1..1] Issuer <Issr>

2.105 [1..1] CreditorReference <CdtrRef> 0150-03

47

Appendix B – Party Identifiers
This structure is used in 1.8, 2.15, 2.19, 2.48, 2.57 and 2.59. Only one sub-element of Organisation
Identification or one sub-element of Private Identification can be used.

Occ. Message Item <XMLTag> Format
{OR [1..1] OrganisationIdentification <OrgId>
[0..1]{{ Or BICIdentifier (BIC) <BIC> BIC-code
[0..1] Or IBEI <IBEI> IBEI-Identifier
[0..1] Or BusinessEntityIdentifier (BEI) <BEI> BEI-Identifier
[0..1] Or EANGLN <EANGLN> EANGLN-Identifier
[0..1] Or CHIPSUniversalIdentification <USCHU> CHIPS-Identifier
[0..1] Or DUNS <DUNS> DUNS-Identifier
[0..1] Or BankPartyIdentification <BkPtyId> Max35Text
[0..1] Or TaxIdentificationNumber <TaxIdNb> Max35Text
[0..1] Or}} ProprietaryIdentification <PrtryId>
[1..1] Identification <Id> Max35Text
[1..1] Issuer <Issr> Max35Text
[1..1]OR} PrivateIdentification <PrvtId>
[0..1] {{Or DriversLicenseNumber <DrvrsLicNb> Max35Text
[0..1] Or CustomerNumber <CstmrNb> Max35Text
[0..1] Or SocialSecurityNumber <SclSctyNb> Max35Text
[0..1] Or AlienRegistrationNumber <AlnRegnNb> Max35Text
[0..1] Or PassportNumber <PsptNb> Max35Text
[0..1] Or TaxIdentificationNumber <TaxIdNb> Max35Text
[0..1] Or IdentityCardNumber <IdntyCardNb> Max35Text
[0..1] Or EmployerIdentificationNumber <MplyrIdNb> Max35Text
[0..1] Or DateAndPlaceOfBirth <DtAndPlcOfBirth>
[1..1] BirthDate <BirthDt> YYYY-MM-DD
[0..1] ProvinceOfBirth <PrvcOfBirth> Max35Text
[1..1] CityOfBirth <CityOfBirth> Max35Text
[1..1] CountryOfBirth <CtryOfBirth> ISO Country code
[0..1] Or}} OtherIdentification <OthrId>
[1..1] Identification <Id> Max35Text
[1..1] Identification Type <IdTp> Max35Text
[0..1] Issuer <Issr> Max35Text

48

49

Nederlandse Vereniging van Banken

Visiting address: Singel 236, 1016 AB Amsterdam

Post address: Postbus 3543, 1001 AH Amsterdam

Telephone: +31 (20) 550 28 88

www.sepanl.nl Fax: +31 (20) 623 97 48 49

info@nvb.nl | www.nvb.nl

XML NL Guidelines Sepa

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (18)

Ähnlich wie XML NL Guidelines Sepa

Ähnlich wie XML NL Guidelines Sepa (20)

Mehr von Friso de Jong

Mehr von Friso de Jong (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

XML NL Guidelines Sepa