Formatbeskrivning CashPool - Notional Group Account Ränteinformation på fil Handelsbankens CSV & SKV format Version 1.0.0 Publiceringsdatum 2011-09-30
Innehållsförteckning INLEDNING... 3 Historik... 3 INFORMATION OM TJÄNSTEN... 4 FORMATBESKRIVNING... 5 SYMBOLFÖRKLARING: FÄLTSTATUS... 5 SYMBOLFÖRKLARING: DATATYPER... 5 Filformatregler: CSV... 5 Filformatregler: SKV... 5 Detaljerad formatbeskrivning... 5 Filexempel... 8 Handelsbankens CSV & SKV-format Sid 2 (8)
Inledning Handelsbankens formatbeskrivning för CSV/SKV beskriver exakt vilken information ränteinformation på fil i Handelsbankens CSV/SKV-format innehåller. Beskrivningen är specifik för Handelsbankens tjänster och rutiner och ska enbart användas i samarbete med Handelsbanken. Handelsbankens CSV/SKV-format har anpassats till Handelsbankens tjänster och rutiner. Historik I Handelsbanken görs ändringar i versionsnummer i enlighet med nedanstående riktlinjer. Ursprungsversion är 1.0.0. Äldre versioner som saknar versionsnummer benämns med datum. Sista siffran räknas upp ett steg om revideringar i formatbeskrivningen gjorts, exempelvis förtydligande text och exempel. Andra siffran räknas upp ett steg om mindre förändringar i formatet gjorts, exempelvis tillägg av land eller förändringar i betalningstyp. Första siffran räknas upp ett steg och lyfts till ny hel version om formatförändringen medför anpassningar av kund för fortsatt användning av tjänsten. I detta fall informeras samtliga berörda kunder om ny version och vad ändringarna innebär. Version Datum Beskrivning 1.0.0 2011-09-30 Publicerad Handelsbankens CSV & SKV-format Sid 3 (8)
Information om tjänsten Det här dokumentet beskriver innehållet i den ränteinformation på fil, som kan fås för Handelsbankens globala CashPool tjänst Notional Group Account. I dokumentet beskrivs ränteinformationen för ränta (mellan bank och kund). Se särskilt dokument för beskrivning av ränteinformation för kundintern ränta i Notional Group Account. Vid abonnemang på information om både ränta och kundintern ränta, ges informationen i en och samma fil. Filen skickas månadsvis och avser då information för en hel kalendermånad. Filen framställs den första kalenderdagen i nästkommande månad. Handelsbankens CSV & SKV-format Sid 4 (8)
Formatbeskrivning Detta avsnitt innehåller en beskrivning av Handelsbankens ränteinformation på fil för CashPool Notional Group Account i CSV/SKV-format SYMBOLFÖRKLARING: FÄLTSTATUS M = Mandatory (Obligatorisk) O = Optional (Valfri) N = Not used (Används ej) SYMBOLFÖRKLARING: DATATYPER Num(n,d) Fältet är numeriskt med n heltal och d decimaler. Om värdet är negativt anges talet med inledande minustecken. T ex -100.50 X(n) - Alphanumeriskt fält där n anger antal tecken Date(n) Datumfält där n anger antal tecken. Formatet som används är CCYY-MM-DD Filformatregler: CSV [1] Filen är komma (, ) separerad [2] Beloppsfälten: decimaltecken är alltid punkt (. ) Belopp anges utan tecken om det är positivt och med minustecken om det är negativt Filformatregler: SKV [1] Filen är semikolon ( ; ) separerad [2] Beloppsfälten: decimaltecken är alltid komma (, ) Belopp anges utan tecken om det är positivt och med minustecken om det är negativt Detaljerad formatbeskrivning Post 01 Startpost (Iteration 1:1) Posttyp X(2) M 01 Alltid 01 för startpost Typ av ränta X(2) M 02 02 = Ränta Fildatum Date(10) M 2010-04-01 Datum då filen skapades Fr o m datum (aktuell månad) T o m datum (aktuell månad) Date(10) M 2010-03-01 Från och med datum för ränteinformation Date(10) M 2010-03-31 Till och med datum för ränteinformation Landkod X(2) M SE Avtalsland Handelsbankens CSV & SKV-format Sid 5 (8)
Avtalsnr CashPool X(15) M 12345678910 Avtalsnummer för CashPool Avtalsägare X(11) M 556677-1234 Ägaren till CashPool avtalet (organisationsnummer) Utsökning X(1) N Används ej BIC X(11) N Används ej Avtalsnr/Nivånr/ Kontonr X(35) N Används ej Post 02 Transaktionspost (Iteration 1:*) Posttyp X(2) M 02 Alltid 02 för transaktionspost BIC X(11) N Används ej Avtalsnr/Nivånr/ Kontonr X(35) M 12345678910 Avtalsnummer Avtalsägare X(11) M 556677-1234 Ägaren till CashPool avtalet (organisationsnummer) Typ av ränteberäkning X(1) M 4 4 = Ränteberäkning per valuta 5 = Viktad ränteberäkning Avslutsdatum Date(10) O 2010-03-22 Skickas om valuta/avtalet avslutats under perioden BIC X(11) M HANDSESS BIC för kapitaliseringskonto Kapitaliseringskonto X(35) M 123456789 Det konto som används vid bokning av ränta BIC X(11) N Används ej Transaktionskonto X(35) N Används ej Ränteslag X(2) M 02 01=Inlåningsränta Valutakod X(3) M SEK ISO 02=Utlåningsränta 06=Övertrasseringsränta Basränta X(50) O STIBOR Basränta i klartext. Skickas ej vid fast ränta. Anges på engelska Räntesats 1 Num(4,4) M 0001.7000 Totalräntesats Trappa 1 Räntesats 2 Num(4,4) M 0001.8000 Totalräntesats - Trappa 2. Om bara trappa 1 finns, anges 0 Räntesats 3 Num(4,4) M 0001.9000 Totalräntesats - Trappa 3. Om bara trappa 1 och 2 finns, anges 0 Handelsbankens CSV & SKV-format Sid 6 (8)
Fr o m belopp 1 Num(15) M 000000000000000 Från och med belopp för räntesats 1 Fr o m belopp 2 Num(15) M 000000000002501 Från och med belopp för räntesats 2. Om bara totalräntesats 1 finns, anges 0 Fr o m belopp 3 Num(15) M 000000000005001 Från och med belopp för räntesats 3. Om bara totalräntesats 1 och 2 finns, anges 0 Perdatum Date(10) M 2010-03-31 Till och med datum för perioden Upplupen ränta Num(15,2) M -000000000000500.00 Beräknad upplupen ränta sedan senaste kapitaliseringstillfället Senaste kapitaliseringsdatum Kapitaliseringsperiod Kapitaliserad ränta under perioden (totalpost för alla händelser under perioden) Kapitaliserad ränta från årets början Periodens beräknade ränta Date(10) O 2010-03-30 Datum för senaste kapitalisering X(3) M 01M 01M, 03M, 06M, 12M Num(15,2) M 000000000000100.00 Den ränta som har kapitaliserats under perioden, inklusive kapitaliserad ränta på grund av justering eller avslut Num(15,2) M 000000000000200.00 Kapitaliserad ränta från årets början Num(15,2) M 000000000000300.00 Periodens beräknade ränta Handelsbankens CSV & SKV-format Sid 7 (8)
Post 03 Slutpost (Iteration 1:1) Posttyp X(2) M 03 Alltid 03 för slutpost Antal poster inklusive start och slutpost Num(9) M 000000009 Filexempel Observera att i en verklig fil finns endast en radbrytning per post. Exemplen nedan består alltså i själva verket av endast 4 rader per fil. Här presenteras ett exempel på en räntefil i CSV format: 01,02,2010-11-05,2027-11-01,2027-11-30,SE,1200170385,556744-2313,,, 02,,1200170385,556744-2313,4,,HANDSESS,93311869,,,01,EUR,Euribor 12m,0011.0220,0009.9220,0000.0000,000000000000000,000000000000100,0000000000000 00,2027-11- 30,000000000000000.00,,12M,000000000000000.00,000000000000000.00,00000000000000 0.00 02,,1200170385,556744-2313,4,,HANDSESS,93311869,,,02,EUR,Euribor 12m,0013.1210,0000.0000,0000.0000,000000000000000,000000000000000,0000000000000 00,2027-11- 30,000000000000000.00,,03M,000000000000000.00,000000000000000.00,00000000000000 0.00 03,000000004 Här presenteras ett exempel på en räntefil i SKV format: 01;02;2010-11-05;2027-11-01;2027-11-30;SE;1200170385;556744-2313;;; 02;;1200170385;556744-2313;4;;HANDSESS;93311869;;;01;EUR;Euribor 12m;0011,0220;0009,9220;0000,0000;000000000000000;000000000000100;0000000000000 00;2027-11- 30;000000000000000,00;;12M;000000000000000,00;000000000000000,00;00000000000000 0,00 02;;1200170385;556744-2313;4;;HANDSESS;93311869;;;02;EUR;Euribor 12m;0013,1210;0000,0000;0000,0000;000000000000000;000000000000000;0000000000000 00;2027-11- 30;000000000000000,00;;03M;000000000000000,00;000000000000000,00;00000000000000 0,00 03;000000004 Handelsbankens CSV & SKV-format Sid 8 (8)