XML-kontoraportering

Tjänstebeskrivning
XML-kontorapportering
15.11.2012
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
2
Innehållsförteckning
1. XML-kontorapportering .......................................................................................................................................................................... 3
1.1 Allmänt .......................................................................................................................................................................................................... 3
1.2 XML -kontorapporteringstjänster ................................................................................................................................................ 3
1.2.1 XML -saldoförfrågan (camt.052) .............................................................................................................................................. 3
1.2.2 XML -transaktionsförfrågan (camt.052) ............................................................................................................................. 4
1.2.3 XML-kontoutdrag (camt.053) ..................................................................................................................................................... 5
1.2.4 XML-referenslista (camt.054) ................................................................................................................................................... 6
1.2.5 XML-betalningslista (camt.054) ............................................................................................................................................... 6
1.2.5 XML-respons på utlandsbetalningar (camt.054) ........................................................................................................... 7
1.3 Samlingsdebitering av utlandsbetalningar .............................................................................................................................. 8
2 Avtal ..................................................................................................................................................................................................................... 9
3. Användning av XML -kontorapportering ...................................................................................................................................... 9
3.1 Tidsscheman (Cut off-tider) .............................................................................................................................................................. 9
3.2 Tester ............................................................................................................................................................................................................. 9
4. Hjälp och support ....................................................................................................................................................................................... 9
5. Bilagor............................................................................................................................................................................................................. 10
Ändrats
1.11.2011
30.1.2012
18.6.2012
15.11.2012
Version
1.0
1.1
1.2
1.3
Motiv till ändringen
Links till bilägor
3.2 Ändring till text
Ändring till namn
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
3
1. XML-kontorapportering
1.1 Allmänt
I och med SEPA förändras kontorapporteringen till en XML -baserad
kontorapportering enligt filstandarden ISO 20022 XML. Förändringen gynnar
företagen eftersom uppgifterna i SEPA -betalningar (IBAN -kontonumret, bankens BIC/SWIFT-kod, den internationella referensen, den ursprungliga betalaren och den
slutliga mottagaren) förmedlas över landsgränser. Dessutom möjliggör de nya
uppgiftsfälten enligt ISO 20022 många slags användningsmöjligheter i företagets
interna datasystem.
Mer information om ISO 20022 finns på Internet på www.iso20022.org.
SEPA ställer inga krav på inom vilken tid företagen ska börja använda XMLkontorapporteringen, och därför förutsätter SEPA-betalningar inte att XMLkontorapporteringen ska införas.
I början erbjuds XML-kontorapporteringen parallellt med de nationella tjänsterna, men
senare kommer den att ersätta den nationella kontorapporteringen fullständigt.
Danske Bank erbjuder sina kunder XML-kontorapporteringen i Web Services,
webbanken för företag (Business Online) och SWIFT-kanalen.
1.2 XML -kontorapporteringstjänster
XML-kontorapporteringstjänster är
XML -saldoförfrågan (camt.052) − motsvarar saldoförfrågan (APSN)
XML -transaktionsförfrågan (camt.052) − motsvarar transaktionsförfrågan
(TAPN)
XML -kontoutdrag (camt.053) - motsvarar det maskinläsbara kontoutdraget
(KTON)
XML -referenslista (camt.054) − motsvarar referenslistan (VIPN)
XML -betalningslista (camt.054) − motsvarar betalningslistan (OLLN)
XML -respons på utlandsbetalningar (camt.054)- motsvarar den separata
responsen på utlandsbetalningar (VLU2)
1.2.1 XML -saldoförfrågan (camt.052)
Genom XML -saldoförfrågan (camt.052) rapporteras innevarande dags saldon.
Saldoförfrågan innehåller uppgifter om saldot på kontot vid tidpunkten för förfrågan,
det disponibla saldot och den eventuella limiten.
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
4
XML -saldoförfrågans struktur
XML -saldoförfrågan utgörs av följande delar:
1. Group Header (Rubrik på saldoförfrågan)
Obligatorisk uppgift
Visas endast en gång
Innehåller identifierande uppgifter om meddelandet och uppgiften om
tidpunkten då saldoförfrågan har gjorts
Motsvarar uppgifterna i satsposten i saldoförfrågan (APSN)
2. Report (Transaktionsuppgifter)
Obligatorisk uppgift
Visas endast en gång
Innehåller saldouppgifter
XML -saldoförfrågans struktur beskrivs närmare i postbeskrivningen för XML-saldooch transaktionsförfrågningarna.
1.2.2 XML -transaktionsförfrågan (camt.052)
Genom XML -transaktionsförfrågan (camt.052) rapporteras innevarande dags interna
transaktioner. Transaktionsförfrågan innehåller högst de 200 senaste
kontotransaktionerna på innevarande registreringsdag samt uppgifter om saldot och
det disponibla saldot vid tidpunkten för förfrågan.
På transaktionsförfrågan visas inkommande referensbetalningar som enskilda
transaktioner och utgående inrikesbetalningar i en samlingsdebitering.
Genom transaktionsförfrågan är det möjligt att hämta enbart uttag, enbart
insättningar eller alla transaktioner.
XML -transaktionsförfrågans struktur
XML -transaktionsförfrågan utgörs av följande delar:
1. Group Header (Rubrik på transaktionsförfrågan)
Obligatorisk uppgift
Visas endast en gång
Innehåller identifierande uppgifter om meddelandet och uppgift om den
tidpunkt då transaktionsförfrågan har gjorts
Motsvarar uppgifterna i satsposten på referenslistan (VIPN)
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
5
2. Report (Transaktionsuppgifter)
Obligatorisk uppgift
Visas endast en gång
Innehåller transaktionsuppgifter
XML -transaktionsförfrågans struktur beskrivs närmare i postbeskrivningen för XML saldo- och transaktionsförfrågningarna.
1.2.3 XML-kontoutdrag (camt.053)
XML -kontoutdraget (camt.053) är ett officiellt kontoutdrag som skickas av banken
och som har godkänts av bokföringsnämnden. XML -kontoutdraget kan hämtas för ett
konto i sänder. Kontoutdraget för en koncern kan hämtas för flera konton i sänder i
enlighet med koncernens kontostruktur.
XML -kontoutdraget kan vara ett kontoutdrag för en dag, dvs. utdraget innehåller
transaktioner för en registreringsdag, eller ett kontoutdrag för en period (en vecka
eller månad), dvs. utdraget innehåller transaktioner för alla registreringsdagar under
den önskade perioden.
På XML-kontoutdraget rapporteras
uppgifter om kontot och kontoinnehavaren
saldo (registrerat ingående och utgående saldo, disponibelt ingående och
utgående saldo, registrerat utgående saldo dagen innan)
registrerade kontotransaktioner sammanlagt (antal och belopp av uttag och
insättningar)
eventuella specifikationstransaktioner (specifikationer av
samlingsdebiteringen av inrikesbetalningar och av inkommande
referensbetalningar/utlandsbetalningar).
XML -kontoutdragets struktur
XML -kontoutdraget (camt.053) utgörs av följande delar:
1. Group Header (Rubrik i kontoutdraget)
Obligatorisk uppgift
Visas endast en gång
Innehåller identifierande uppgifter om meddelandet och uppgift om den
tidpunkt då kontoutdraget har sammanställts
Motsvarar uppgifterna i grundposten för maskinläsbara kontoutdrag (KTON)
2. Statement (Transaktions- och saldouppgifter)
Obligatorisk uppgift
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
6
Återkommer på koncernens kontoutdrag
Innehåller saldo- och transaktionsuppgifter
XML-kontoutdragets struktur beskrivs närmare i postbeskrivningen för XMLkontoutdraget.
1.2.4 XML-referenslista (camt.054)
XML-referenslistan (camt.054) innehåller specifikationstransaktioner av inkommande
referensbetalningar, men inga saldouppgifter. XML-referenslistan kan hämtas
dagligen, varje vecka eller varje månad antingen separat eller tillsammans med XMLbetalningslistan.
På referenslistan rapporteras
inkommande transaktioner med referens
korrigeringar av transaktioner med referens
lyckade och misslyckade direktdebiteringstransaktioner.
XML -referenslistans struktur
XML -referenslistan (camt.054) utgörs av följande delar:
1. Group Header (Rubrik på referenslistan)
Obligatorisk uppgift
Visas endast en gång
Innehåller identifierande uppgifter om meddelandet och uppgift om den
tidpunkt då referenslistan har sammanställts
Motsvarar uppgifterna i satsposten på referenslistan (VIPN)
2. Notifikation (Transaktionsuppgifter)
Obligatorisk uppgift
Visas endast en gång
Innehåller transaktionsuppgifter
XML-referenslistans struktur beskrivs närmare i postbeskrivningen för XML-referensoch betalningslistorna.
1.2.5 XML-betalningslista (camt.054)
XML-betalningslistan (camt.054) innehåller specifikationstransaktioner av utgående
betalningar, men inga saldouppgifter. XML-betalningslistan kan hämtas dagligen, varje
vecka eller varje månad antingen separat eller tillsammans med XML-referenslistan.
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
7
På betalningslistan rapporteras
specifikationstransaktioner av utgående inrikes- och utlandsbetalningar
referenstransaktioner av uttag.
XML-betalningslistans struktur
XML-betalningslistan (camt.054) utgörs av följande delar:
1. Group Header (Rubrik på betalningslistan)
Obligatorisk uppgift
Visas endast en gång
Innehåller identifierande uppgifter om meddelandet och uppgift om den
tidpunkt då betalningslistan har sammanställts
Motsvarar uppgifterna i satsposten på betalningslistan (OLLN)
2. Notifikation (Transaktionsuppgifter)
Obligatorisk uppgift
Visas endast en gång
Innehåller uppgifter om betalningstransaktioner
XML-betalningslistans struktur beskrivs närmare i postbeskrivningen för XMLreferens- och betalningslistorna.
1.2.5 XML-respons på utlandsbetalningar (camt.054)
XML-responsen på utlandsbetalningar innehåller gränsöverskridande eurobetalningar,
betalningar i annan valuta och betalningar där debiteringskontot är ett valutakonto.
Responsen sammanställs av alla typer av utlandsbetalningar och kan hämtas samma
dag som alla betalningar i betalningsposten har behandlats.
I XML-responsen på utlandsbetalningar rapporteras
lyckade utlandsbetalningar (betalningsuppgifter som kunden har lämnat och
uppgifter som banken har kompletterat, t.ex. motvärde, valutakurs och
arkivkod)
avvisade utlandsbetalningar (orsak till det).
XML-responsens struktur
XML-responsen på utlandsbetalningar (camt.054) utgörs av följande delar:
1. Group Header (Rubrik på responsen)
Obligatorisk uppgift
Visas endast en gång
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
8
Innehåller identifierande uppgifter om meddelandet och uppgift om den
tidpunkt då responsen har sammanställts
2. Notifikation (Transaktionsuppgifter)
Obligatorisk uppgift
Kan återkomma
Innehåller uppgifter om betalningstransaktioner
XML-responsens struktur beskrivs närmare i postbeskrivningen för XML-responsen
på utlandsbetalningar.
1.3 Samlingsdebitering av utlandsbetalningar
Samlingsdebitering av utgående utlandsbetalningar förutsätter ett kontoavtal med
banken. Ett särskilt avtal ska ingås om samlingsdebitering av serviceavgifter
(månatligt samlande av kostnader), annars debiteras serviceavgifterna en åt gången.
En samlingsdebitering skapas för en post där debiteringskontot omfattas av ett
gällande avtal och där värdet TRUE har angetts i fältet BatchBooking i Group Header i
XML-betalningsmeddelandet eller där fältet inte finns. Trots avtalet skapas den inte
om värdet FALSE har angetts i fältet.
Samlingsdebiteringen skapas utifrån uppgifterna i B-delen, Payment Information,
förutsatt att samtliga betalningar debiteras på samma bankdag. Om en del av
betalningarna debiteras på någon annan bankdag, skapas en separat
samlingsdebitering av dem.
Till samlingsdebiteringarna hör återkommande betalningar (identifiering med Category
Purpose-koden SALA) och övriga utlandsbetalningar exklusive checkar och SWIFTcheckar.
Specifikationsuppgifterna för samlingsdebiteringar visas beroende på avtal antingen
på XML-kontoutdraget (camt.053) eller på XML-betalningslistan (camt.054).
Specifikationsuppgifter visar inte för återkommande betalningar.
701
720
Förklaringarna och koderna för registrering av samlingsdebiteringar är följande:
UTL PERIODISKA BETAL
Återkommande betalningar
UTLANDSBETALNINGAR
Övriga utlandsbetalningar
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
9
2 Avtal
XML -kontorapporteringen förutsätter gällande serviceavtal om Web Services,
Business Online eller SWIFT -kanalen. I serviceavtalen fastställs företagets konton,
användare och dispositionsrätter.
För hämtning av material för XML -kontorapporteringen görs materialbeställningar.
Kunden kan beställa material genom självbetjäning via Business Online. Vid behov kan
banken göra beställningen på kundens vägnar.
3. Användning av XML -kontorapportering
3.1 Tidsscheman (Cut off-tider)
Web Services, Business Online och SWIFT-kanalen kan användas dygnet runt, även på
helger.
Behandlingstider för maskinläsbart material
3.2 Tester
Kunderna och programleverantörerna kan testa sina egna XMLkontorapporteringsmaterial gemensamt med Danske Bank. Testerna kan utföras på
kundens eller programleverantörens egna konton och med dennes egna
kontotransaktioner i Danske Banks produktionsmiljö.
XML-kontorapporteringsmaterialet kan användas parallellt med det traditionella
kontorapporteringsmaterialet. På så sätt är det möjligt att till exempel testa XMLkontoutdrag eller -referenslistor på samma konto och med hjälp av samma
transaktioner parallellt med maskinläsbara kontoutdrag eller KTL-referenslistor.
Olika skeden i produktionstesterna för XML-kontorapporteringsmaterialet
1. Du ska ha ett gällande avtal om Web Services, Business Online eller SwiftNet
med Danske Bank. Om du inte har ett sådant avtal, ska du kontakta Danske
Banks Företagstjänst (se kapitel 4).
2. Du ska ingå ett avtal om de XML-kontorapporteringstjänster som ska testas
via Danske Banks Företagstjänst (se kapitel 4) eller med din egen
kontaktperson. Kontrollera samtidigt vilken dag tjänsterna börjar gälla och när
testerna kan inledas.
3. För att XML-kontorapporteringsmaterialet ska kunna bildas ska det finnas
kontotransaktioner på det konto som är föremål för tester. Skapa vid behov
kontotransaktioner till exempel genom att skicka betalningsmaterial via
bankförbindelseprogrammet.
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7
10
4. Hämta XML-kontorapporteringsmaterialet via bankförbindelseprogrammet,
Business Online eller SwiftNet.
5. Om du har frågor om bildandet av XML-kontorapporteringsmaterial eller
datainnehållet i materialet, kan du kontakta Danske Banks stöd för programoch materialöverföringstjänsterna (se kapitel 4).
4. Hjälp och support
Kontaktinformationen för Danske Banks Företagstjänst finns här
5. Bilagor
(endast på finska sidor)
Postbeskrivning för XML-saldo- och transaktionsförfrågningarna (camt.052)
Modellmeddelande för XML-saldoförfrågningar (camt.052)
Modellmeddelande för XML-transaktionsförfrågningar (camt.052)
Postbeskrivning för XML-kontoutdrag (camt.053)
Modellmeddelande för XML-kontoutdrag (camt.053)
Postbeskrivning för XML-referens- och betalningslistor (camt.054)
Modellmeddelande för XML-referenslista (camt.054)
Modellmeddelande för XML-betalningslista (camt.054)
Postbeskrivning för XML-respons på utlandsbetalningar (camt.054)
Danske Bank Abp
Registrerad hemort och adress Helsingfors, Kolkajsgränden
2, 00075 DANSKE BANK
FO-nummer 1730744-7