UNIFI Formatenboek Rabo Cash Management
Colofon Titel Versie, datum Onze referentie Namens Contact adres
UNIFI Formatenboek 1.03, januari 2015 UNIFI Formatenboek COS Corporates, Operations & Services Rabobank International, UCR 191 Croeselaan 18, Postbus 2626 3500 HG Utrecht
Inhoud 1
UNIFI ISO20022 Importformaat
3
1.1 UNIFI ISO20022 Beschrijving 1.1.1 Beschrijving 1.1.2 Algemene kenmerken
3 3 3
1.2 UNIFI Structuur 1.2.1 Inleiding 1.2.2 Technische indeling 1.2.3 Tekenset 1.2.4 Geschiktheid 1.2.5 Berichtenstructuur
3 3 4 5 5 6
2
Segment beschrijving
8
Generieke segmenten
8
2.1
2.2 Segmenten voor UNIFI-CT (Credit Transfer) 2.2.1 Payment Information Segment 2.2.2 Transaction Information Segment
3 4
Eurobetaling vanaf een Rabo rekening
13
Buitenland betaling vanaf een Raborekening
14
4.1.1 4.1.2
5
8 9 11
Payment information Segment Transaction Information Segment
Betaling vanaf een Multibank rekening
14 15
16
5.1
Payment Information Segment
16
5.2
Transaction Information Segment
17
UNIFI Formatenboek
2
1 UNIFI ISO20022 Importformaat Bestanden in het UNIFI ISO20022 formaat kunnen gebruikt worden om betaalopdrachten te importeren in Rabo Cash Management
1.1 UNIFI ISO20022 Beschrijving 1.1.1
Beschrijving
De meest recente versie van de UNIFI indeling is de ISO20022. De ISO20022 indeling is medium onafhankelijk opgesteld. De indeling is hierdoor geschikt voor het aanleveren van betalingsopdrachten via datacommunicatie. De indeling is single-file, multibatch en modulair van opbouw. De informatie die functioneel bij elkaar hoort is telkens in een record geplaatst.
1.1.2
Algemene kenmerken
Het UNIFI ISO20022 formaat welke Rabobank ondersteunt is gebaseerd op de definities zoals gepubliceerd op de website van de International Organisation for Standardization (XML ISO20022). In dit document is het gebruik van deze standaard beschreven voor RCM, omdat in RCM niet alle facetten worden ondersteund. De algemene kenmerken van UNIFI zijn: • Diverse betaalsoorten in een bestand o Eurobetalingen en buitenlandse betalingen vanaf een Raborekening o Binnenlandse en buitenlandse betalingen vanaf een Multibank rekening De volgende indelingen worden gebruikt om door middel van het UNIFI formaat te communiceren met de bank: • PAIN.001.001.02 voor betaalopdrachten
1.2 UNIFI Structuur 1.2.1
Inleiding
De modellen van het UNIFI-document in XML worden beschreven in schema's. Er wordt gebruik gemaakt van een specifieke beschrijvingstaal (XSD) in het schema. Aan de hand van de schema's kan een beschrijving worden gegeven van de tags in het document, de structuur en de aaneenschakeling van die bakens (rangorde van de tags) alsmede de voor bepaalde gegevens toegestane codes, het aantal mogelijke gevallen, het verplicht of facultatief karakter van bepaalde gegevens. De algemene XSD voor pain.001.001.02 is beschikbaar hier 1.
1
http://www.iso20022.org/message_archive.page?#PaymentsInitiation
UNIFI Formatenboek
3
1.2.2
Technische indeling
De gebruiksregels moeten worden nageleefd om te vermijden dat het bericht of de betaling eventueel worden geweigerd of dat gegevens niet in aanmerking worden genomen. Enkel berichtelementen die worden beschreven in deze richtlijnen mogen worden gebruikt. De beschrijving van elk bericht item bevat: Naam XML-tag Niveau
Aanwezigheid
Naam van het element binnen het UNIFI bericht Verkorte naam die een element identificeert in een XML-bericht, staat tussen haakjes, bijv.
Niveau van het element binnen het UNIFI bericht <Enz.> Dit geeft aan of een element optioneel is of verplicht en hoeveel keer het element kan worden herhaald. Het aantal keer dat een element voorkomt, staat tussen vierkante haakjes. Bijvoorbeeld: [0..1] Toont dat het element 0 keer of 1 keer aanwezig kan zijn. Het element is optioneel. [0..n] Toont dat het element 0 tot n keer aanwezig kan zijn. Het element is optioneel. [1..1] Toont dat het element verplicht is en een keer aanwezig moet zijn. [1..n] Toont dat het element verplicht is en minimaal 1 keer aanwezig moet zijn. Het element kan tot n keer aanwezig zijn.
Type
Lengte
Omschrijving
UNIFI Formatenboek
Pas wanneer een optioneel element aanwezig is, waarvoor op onderliggend niveau een verplicht element bestaat, dient dit verplichte element voor te komen. Typeaanduiding van het veld: Numeriek: mag alleen cijfers bevatten Alfanumeriek: mag cijfers en toegestane letters (zie 1.2.3 Tekenset) bevatten Datum: YYYY-MM-DD Bedrag: cijfers, met een punt of komma als scheidingsteken Maximaal aantal karakters van het veld. Bij het type Bedrag staat een code weergegeven: maximaal aantal karakters, maximaal aantal decimalen (bijvoorbeeld 18,5) Bevat de definitie van het berichtsegment of -element Aanvullende informatie over het gebruik van dit element
4
1.2.3
Tekenset
In de UNIFI-berichten moet de tekencodering standaard UTF8 worden gebruikt. De Latijnse tekenset, die gebruikelijk is voor internationale communicatie, moet worden gebruikt. Rabobank accepteert de volgende tekens: abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 / - ? : ( ) . , ' + spatie
1.2.4
Geschiktheid
UNIFI berichten zijn geschikt voor de volgende opdrachttypen: • Eurobetalingen en buitenlandse betalingen vanaf een Rabobankrekening • Binnenlandse en buitenlandse betalingen vanaf een Multibank 2 rekening • •
Enkele betalingen met een opdrachtgever en een begunstigde Betalingen in batch-vorm, met een opdrachtgever en meerdere begunstigden met individuele opdrachtgegevens
UNIFI berichten zijn niet geschikt voor de volgende opdrachttypen: • Betalingen in batch-vorm, met een opdrachtgever en meerdere begunstigden zonder individuele opdrachtgegevens
2
Dit is een rekening welke niet bij de Rabobank wordt aangehouden en waamee boekingen worden gedaan naar een
begunstigde rekening met dezelfde muntsoort in hetzelfde land.
UNIFI Formatenboek
5
1.2.5
Berichtenstructuur
UNIFI wordt aangeleverd via datacommunicatie. De berichten kunnen bestaan uit meerdere opdrachten voor een opdrachtgever. De berichten moeten per stuk afgesloten worden, de opdrachten per opdrachtgever. Het totale bestand moet bestaan uit een groupheader en kan uit meerdere opdrachten bestaan. Het totale bestand moet afgesloten worden. Onderstaand ziet u hoe het modulaire UNIFI-bestand is opgebouwd. Meer algemene informatie over de berichtenstructuur is beschikbaar via het internet op de webpagina http://www.iso20022.org
UNIFI Bericht
GroupHeader
Debtor (Payment) Creditor (Transaction) Creditor (Transaction) Debtor (Payment) Creditor (Transaction) Een UNIFI bericht bevat 3 segmenten: 1. Group Header Dit segment is verplicht en een maal aanwezig in het bericht. Onder andere de elementen Message Identification, Creation Date and Time en Grouping Indicator zijn aanwezig in dit segment. 2. Payment Information Dit segment is verplicht en kan meerdere keren voorkomen. Ze bevat naast elementen die verband houden met de debetkant van de opdracht zoals Debtor en Payment Type Information, ook een of meerdere Transaction Information segmenten. 3. Transaction Information Dit segment is verplicht en kan meerdere keren voorkomen. Ze bevat onder andere elementen in verband met de creditkant van de opdracht, zoals Creditor en Remittance Information. Ieder segment binnen het UNIFI bestand moet geopend en afgesloten worden conform de XSD standaard. Binnen de openingstag en de sluitingstag staat de informatie over dat deel.
UNIFI Formatenboek
6
<pain.001.001.02> Information regarding the Group header Information regarding the payment Information regarding the order Het aantal Payment Information segmenten en Transaction Information segmenten in een bericht wordt aangeduid door het Grouping veld in de Group Header De volgede optie kan gebruikt worden: Single
Geef aan dat voor elk Payment Information segment er precies een Transaction information segement aanwezig is.
UNIFI Formatenboek
7
2 Segment beschrijving 2.1 Generieke segmenten De volgende segmenten zijn beschikbaar voor UNIFI-CT (Credit transfer) berichten. Naam XML-tag Niveau Aanwezig Type Document Top [1..1] <pain.001.001.02> Top [1..1]
Group Header Message Identification Creation Date Time Number of Transactions Grouping Initiating Party Name
<MsgId>
Top 1
[1..1] [1..1]
Alphanumeric
1
[1..1]
Date + Time
1
[1..1]
1
1 2
Lengte
Omschrijving Pain.001.001.02 voor credit transfers.
35
Unieke bestandsidentificatie
Numeric
15
Aanmaakdatum en tijdstip van het bestand. Voorbeeld: 2011-02-03 T11:20:45 Het aantal opdrachten in het bestand.
[1..1]
Alphanumeric
4
Aanduiding van de inhoud van het bestand: “SNGL”: 1 opdracht per betaling
[1..1] [1..1]
Alphanumeric
70
Naam van de opdrachtgevende partij
2.2 Segmenten voor UNIFI-CT (Credit Transfer) Onderstaande bestandsbeschrijving bevat de ISO20022 standaard elementen welke ondersteund worden door Rabobank. Alle overige standaard elementen welke ISO20022 bevat worden niet ondersteund door Rabobank.
UNIFI Formatenboek
8
2.2.1
Payment Information Segment
Naam Payment Information Payment Method
XML-tag
Type
Lengte
Omschrijving
Alfanumeriek
3
Vaste waarde ‘TRF’ voor elektronische betalingen
Payment Type Information Service Level Priority
<SvcLvl>
1 2 3
[0..1] [0..1] [1..1]
Alfanumeriek
35
Mogelijke waarde ‘URGENT’ voor spoedbetalingen
Local Instrument Proprietary Category Purpose
2 3 2
[0..1] [1..1] [0..1]
Alfanumeriek Alfanumeriek
35 4
1 1 2
[1..1] [1..1] [1..1]
Datum
10
Waarde afhankelijk van het land Waarde “SALA” indien het salarisbetalingen betreft De gewenste uitvoerdatum
Requested Execution Date Debtor Name
Alfanumeriek
70
Naam van de debiteur. Wanneer deze naam gelijk is aan de naam in RCM dan zullen de adresgegevens verrijkt worden.
Postal Address Address line
2 3
[0..1] [0..2]
Alfanumeriek
70
Country Identification Organization Identification Proprietary Identification Identification Debtor Account Identification IBAN
3 2 3 4 5 1 2 3
[1..1] [0..1] [1..1] [1..1] [1..1] [1..1] [1..1] [0..1]
Alfanumeriek
2
Adres van de debiteur. 1e regel: Straat en huisnummer 2e regel: Postcode en plaats Landcode van de debiteur
Alfanumeriek
35
Kamer van Koophandel nummer
Alfanumeriek
34
Rekeningnummer in IBAN formaat.
UNIFI Formatenboek
Niveau Top 1
Aanwezig [1..n] [1..1]
9
Naam Currency Debtor Agent Financial Institution Identification BIC
XML-tag
Charge Bearer
UNIFI Formatenboek
Niveau 2 1 2 3 1
Aanwezig [0..1] [1..1] [1..1] [1..1] [0..1]
Type Alfanumeriek
Lengte 3
Omschrijving ISO muntsoort code van de boeking
Alfanumeriek
11
Alfanumeriek
4
SWIFT BIC code van de bank opdrachtgever Kostenverdeling: “DEBT” (opdrachtgever) of “SHAR” (gedeeld) of “CRED” (Begunstigde). Afhankelijk van de betaling kunnen er keuzes zijn die niet zijn toegestaan.
10
2.2.2
Transaction Information Segment
Naam Credit Transfer Transaction Information Payment Identification End to End Identification Amount Instructed Amount
XML-tag <EndToEndId>
Niveau 1 2 3 2 3
Aanwezig [1..n] [1..1] [1..1] [1..1] [1..1]
Creditor Agent Financial Institution Identification BIC Creditor Name Postal Address Address Line
2 3 4 2 3 3 4
[1..1] [1..1] [1..1] [1..1] [1..1] [0..1] [0..2]
Country Creditor Account
4 2
[1..1] [1..1]
Identification BBAN
3 4
IBAN
Proprietary
UNIFI Formatenboek
Type
Lengte
Omschrijving
Alfanumeriek
16
Bedrag
18, 5
Transactie identificatie Instructed Amount Bedrag in een andere muntsoort dan de muntsoort van de rekening van de opdrachtgever
Alfanumeriek
11
SWIFT van de bank van de begunstigde
Alfanumeriek
70
Naam van de begunstigde
Alfanumeriek
70
Adres van de begunstigde. 1e regel: Straat en huisnummer 2e regel: Postcode en plaats
Alfanumeriek
2
Land van de begunstigde De BBAN of de IBAN zijn verplicht in de onderstaande tags
[1..1] [0..1]
Numeriek
30
4
[1..1]
Alfanumeriek
34
Rekeningnummer binnenland Of deze, of de IBAN moet gevuld worden. IBAN nummer Of deze, of de BBAN moet gevuld worden.
3
[0..1]
Alfanumeriek
35
11
Gebruik deze als het rekeningnummer niet voldoet aan de opmaak {a-zA-Z0-9}
Naam Instruction for Creditor Agent Code
XML-tag
Niveau 2 3
Aanwezig [0..1] [0..1]
Type
Lengte
Omschrijving
Alfanumeriek
4
Instruction Information
3
[0..1]
Alfanumeriek
140
Regulatory Reporting
2
[0..1]
Instructie code PHOB en TELB kunnen hier gekozen worden Telefoonnummer of ander kanaal -> Bank neemt contact op met de begunstigde over de betaling Alleen van toepassing op landen die de CBR toepassen
Regulatory Details Code Amount
3 4 4
[1..1] [1..1] [1..1]
Alfanumeriek Bedrag
3 18, 5
Information Remittance Information Unstructured
<Ustrd>
4 2 3
[1..1] [0..1] [0..1]
Alfanumeriek
35
Transactie code Bedrag waarbij de muntsoort in de XMLtag opgenomen moet worden. Bijvoorbeeld: Amount Verplichte informatie
Alfanumeriek
140
Omschrijvingregel
UNIFI Formatenboek
12
3 Eurobetaling vanaf een Rabo rekening U kunt de generieke beschrijving uit hoofdstuk gebruiken voor Eurobetalingen met de volgende restricties: 1. Veld ChargeBearer mag alleen waarde “SHAR” bevatten 2. Veld InstructedAmount mag alleen muntsoort “EUR” bevatten 3. Veld CreditorAccount bevat een IBAN
UNIFI Formatenboek
13
4 Buitenland betaling vanaf een Raborekening De volgende producten worden ondersteund: • Buitenland (spoed) De standard buitenlandse overboeking kan onder de volgende condities worden gebruikt: • Rekening identificatie van de opdrachtgever doormiddel van de BBAN of de IBAN • Gebruik van IBAN en BIC van de (bank van de) begunstigde voor EUR binnen de EU/EEC is verplicht • Voor identificatie van de bank van de begunstigde is gebruik van het BIC adres verplicht • De naam van de begunstigde is verplicht. • Voor betalingen in een andere muntsoort dan de Euro binnen Nederland is het niet verplicht hiervan opgave te doen aan De Nederlandse Bank (via ‘regulatory reporting’) De specifieke betalings- en transactieinformatie welke van toepassing zijn op een buitenlandse creditering zijn toegevoegd.
4.1.1
Payment information Segment
Naam PaymentInformation PaymentMethod Charge Bearer
XML-Tag
Niveau Top 1 1
Aanwezig [1..n] [1..1] [0..1]
Type
Lengte
Omschrijving
Alfanumeriek Alfanumeriek
3 4
Vaste waarde: “TRF” voor elektronische betalingen Kostenverdeling: “DEBT” (opdrachtgever) of “SHAR” (gedeeld) of “CRED” (Begunstigde). Afhankelijk van de betaling kunnen er keuzes zijn die niet zijn toegestaan. Om aan de PSD regelgeving te voldoen moet hier “SHAR” gebruikt worden.
UNIFI Formatenboek
14
4.1.2
Transaction Information Segment
Naam Credit Trf Transaction Information Creditor Account
XML-Tag
Niveau 1 2
Aanwezig [1..n] [1..1]
Identification BBAN
3 4
[1..1] [0..1]
Numeriek
30
IBAN
4
[0..1]
Alfanumeriek
34
Proprietary
3
[0..1]
Alfanumeriek
35
Instruction for Creditor Agent Code
2 3
[0..1] [0..1]
Alfanumeriek
4
Instruction Information Remittance Information Unstructured
<Ustrd>
3 2 3
[0..1] [0..1] [0..1]
Alfanumeriek
140
Instructie code PHOB en TELB kunnen hier gekozen worden Vrij tekstveld
Alfanumeriek
140
Omschrijvingregel
UNIFI Formatenboek
Type
Lengte
Omschrijving 1 van de Account Identifications moet gekozen worden (BBAN of IBAN)
15
Rekeningnummer binnenland Of deze, of de IBAN moet gevuld worden. IBAN nummer Of deze, of de BBAN moet gevuld worden. Gebruik deze als het rekeningnummer niet voldoet aan de opmaak {a-zA-Z0-9}
5 Betaling vanaf een Multibank rekening De volgende producten worden ondersteund: • Multibank overboeking (spoed) De standaard overboeking is van toepassing onder de volgende voorwaarden: • Bankcheques worden niet ondersteund • Lokale producten worden niet ondersteund • Rekening identificatie via de BBAN of de IBAN • De optie “Charge bearer” wordt ondersteund • Voor identificatie van de bank van de begunstigde is gebruik van het BIC adres verplicht • De naam van de begunstigde is verplicht. • Rapportage over de aard van de betaling aan de centrale bank in het land van de begunstigde wordt ondersteund. De standaard voor de electronische overboeking is van toepassing onder de hierboven beschreven voorwaarden.
5.1 Payment Information Segment Naam Payment Information Debtor Account Identification
XML-Tag
Niveau Top 1 2
Aanwezig [1..n] [1..1] [1..1]
Type
BBAN
3
[0..1]
Numeriek
30
IBAN
3
[0..1]
Alfanumeriek
34
Proprietary
3
[1..1]
Alfanumeriek
35
UNIFI Formatenboek
16
Lengte
Omschrijving
1 van de Account Identifications moet gekozen worden (BBAN of IBAN) Rekeningnummer binnenland Of deze, of de IBAN moet gevuld worden. IBAN nummer Of deze, of de BBAN moet gevuld worden.
Gebruik deze als het rekeningnummer niet voldoet aan de opmaak {a-zA-Z0-9}
5.2 Transaction Information Segment Naam Credit Trf Transaction Information Regulatory Reporting Regulatory Details Code Amount
XML-Tag
Niveau 1 2 3 4 4
Aanwezig [1..n] [0..1] [1..1] [1..1] [1..1]
Type
Lengte
Omschrijving
Alfanumeriek Bedrag
3 18, 5
Information
4
[1..1]
Alfanumeriek
35
Transactie code Bedrag waarbij de muntsoort in de XML-tag opgenomen moet worden. Bijvoorbeeld: Amount Verplichte informatie
UNIFI Formatenboek
17
