Dragningssystemet. Filbeskrivning för osigillerad resultatfil från premieobligationsdragning. Version 1.2

Storlek: px

Starta visningen från sidan:

Download "Dragningssystemet. Filbeskrivning för osigillerad resultatfil från premieobligationsdragning. Version 1.2"

Gunilla Sundström
för 8 år sedan
Visningar:

1 Dragningssystemet Filbeskrivning för osigillerad resultatfil från Version 1.2 Datum Ändrat av Version Kommentar uljo 1.0 Första version uljo 1.1 Lagt till information om filnamnsregler på FTP-servern uljo 1.2 Rättat fel i stycke Låneår anges med 4 siffror inte 2.

2 Innehåll 1 INLEDNING ÄNDRINGSSKYDD NAMNGIVNING AV FIL - INTERNT NAMNGIVNING AV FIL EXTERNT FTP-SERVER FILFORMAT LÅN- OCH DRAGNINGSPOST KOLLEKTIV VINSTPOST INDIVIDUELL VINSTPOST AVSTÄMNINGSPOST KOLLEKTIVVINSTER AVSTÄMNINGSPOST INDIVIDUELLA VINSTER AVSTÄMNINGSPOST TOTALT EXEMPEL... 8

1 LÅN- OCH DRAGNINGSPOST... 5 5.2 KOLLEKTIV VINSTPOST... 6 5.

3 3 (8) 1 Inledning Vid varje skapar Riksgälden en fil med information om premieobligationslån, dragning samt utfallna vinster. Filen distribueras till flera motparter. Resultatfilen läggs även upp på Riksgäldens egen publika FTP-server för att intressenter själva skall kunna hämta filen. Filen på FTP-servern är till skillnad mot filer som skickas till mottagare aldrig sigillerad. Detta dokument beskriver filformatet för resultatfilen på Riksgäldens FTP-server (utan sigillering). 2 Ändringsskydd Filen har inget ändringsskydd, till skillnad mot resultatfilerna som skickas till vissa mottagare (sigilleras med HMAC). 3 Namngivning av fil - internt Innan filen distribueras till externa motparter har den ett internt namn som kan skilja sig från det filnamn som används när filen skickas till en extern mottagare, t.ex. när det distribueras via Riksgäldens FTP-server. Det interna filnamnet genereras enligt följande mönster: dr[låneår 1 ][emissionsnr 2 ][filtypkod 3 ][dragningsnr 4 ].dat 1) Låneår anges med två siffror (sekelsiffror skippas). 2) Emissionsnummer anges med två siffror (första siffran 0 om nr < 10). 3) Filtypskod är rg om Sorteringsordning 1, annars tt. 4) Dragningsnummer anges med två siffror (första siffran 0 om nr < 10). Filen kan vara sorterad enligt följande två sorteringsordningar: Sorteringsordning 1: vinstposter (posttyp 2 och 3) sorteras stigande efter serieoch ordningsnummer. Sorteringsordning 2: vinstposter (posttyp 2 och 3) sorteras fallande efter vinstbelopp och därefter stigande efter serieoch ordningsnummer.

Filen på FTP-servern är till skillnad mot filer som skickas till mottagare aldrig sigillerad. Detta dokument beskriver filformatet för resultatfilen på Riksgäldens FTP-server (utan sigillering).

4 4 (8) En resultatfil för premieobligationslånet 2001, emission 3 med dragningsnummer 4 sorterad enligt Sorteringsordning 1 skulle således representeras av en fil men namnet: 0103rg04.dat. 4 Namngivning av fil externt När resultatfilen distribueras till externa mottagare kan filen döpas om utifrån önskemål från mottagande part. Namngivningen av resultatfilen för olika externa mottagare specificeras inte i detta dokument. För filer som läggs upp på Riksgäldens FTP-server används en namnstandard som funnits sedan flera år. 4.1 FTP-server En resultatfil som läggs upp på FTP-servern namnges enligt följande mönster: [låneår 1 ][emissionsnr 2 ][dragningsnr 3 ].dat 1) Låneår anges med fyra siffror. 2) Emissionsnummer anges med två siffror (första siffran 0 om nr < 10). 3) Dragningsnummer anges med två siffror (första siffran 0 om nr < 10). En resultatfil för premieobligationslånet 2001, emission 3 med dragningsnummer 4 skulle således representeras av en fil men namnet: dat. När resultatfiler läggs upp på FTP-servern så läggs de i kataloger efter vilken dragningsdag (aktuell dag då dragning på lånet genomfördes) de hör till enligt följande mönster: dr[aktuellt år 1 ][aktuell månad 2 ][aktuell dag 3 ] 1) Aktuellt år för dragningsdagen (4 siffror). 2) Aktuell månad för dragningen (två siffror, nollutfyllt) 3) Aktuell dag för dragningen (två siffror, nollutfyllt). Dvs. alla resultatfiler som skapats den 12 december 2011 läggs i en katalog med namnet: dr Om dragningar har gjorts för flera olika lån på samma dag så hamnar deras resultatfiler i samma katalog.

Namngivningen av resultatfilen för olika externa mottagare specificeras inte i detta dokument. För filer som läggs upp på Riksgäldens FTP-server används en namnstandard som funnits sedan flera år. 4.

5 5 (8) 5 Filformat Filen är en textfil som enbart använder teckenkodningen ASCII inom intervallet hex 20 till hex 3F. Filen är uppbyggd av 8 olika posttyper: 1. Lån- och dragningspost 2. Kollektiv vinstpost 3. Individuell vinstpost 4. Avstämningspost kollektivvinster 5. Avstämningspost individuella vinster 6. Avstämningspost totalt Samtliga posttyper har längden 18 tecken. Internt är posterna uppdelade i olika fält som definieras av deras teckenlängd och start i posten. Se postbeskrivningar nedan. Filformatet är baserat på ett äldre format. Det äldre formatets benämningar för fälten har bevarats. Fält som inte längre fyller någon funktion har även de bevarats, däremot så innehåller fälten då enbart blanktecken. Särskilda regler gäller för vilka typer av värden som kan finnas i ett fält beroende på dess fälttyp. Följande tabell definierar de giltiga fälttyperna för filformatet: N Numeriskt Kan enbart innehålla siffror. Fältet fylls från vänster med tecknet 0 om numret inte upptar hela fältlängden. A Alfa Kan enbart innehålla bokstäver och aldrig siffror. AN Alfanumeriskt Kan enbart innehålla bokstäver, siffror och blanktecken. H Hexadecimalt Kan enbart innehålla hexadecimala tecken. Fälttyp anges ej för fält som alltid har samma värde. 5.1 Lån- och dragningspost Är alltid den andra posten i filen. Förekommer alltid en gång i varje fil. Start Längd Typ Notering

Internt är posterna uppdelade i olika fält som definieras av deras teckenlängd och start i posten. Se postbeskrivningar nedan. Filformatet är baserat på ett äldre format.

6 6 (8) Posttyp 1 1 Alltid 1 Obligationssår N Emission 4 1 N Dragningsnummer 5 2 N Första serienummer 7 5 N Sista serienummer 12 5 N Utfyllnad 17 2 Alltid 2 SPACE-tecken 1) Anger två sista siffrorna för premieobligationslånets låneår, t.ex. 01 för år Kollektiv vinstpost Förekommer endast om garantivinster utfallit i dragningen. Antalet poster motsvarar antalet utfallna garantivinster inom en serie. En garantivinst anger endast ordningsnummer eftersom den alltid gäller för samtliga serier. Posttypen kommer alltid efter posttypen Lån- och dragningspost och alltid före poster av typ Individuell vinstpost. Posterna är sorterade efter fältet ordningsnummer i stigande ordning. Start- Längd Typ Notering Posttyp 1 1 Alltid 2 Utfyllnad 2 5 Alltid 5 SPACE-tecken Ordningsnummer 7 4 N Belopp N Checksiffra Alltid 1 SPACE-tecken Utfyllnad 18 1 Alltid 1 SPACE-tecken 1) Belopp anges i heltal kronor. 2) Fältet används inte längre. 5.3 Individuell vinstpost Förekommer endast om individvinster utfallit i dragningen. Antalet poster motsvarar antalet utfallna individvinster. Posttypen kommer alltid efter eventuella poster av typ Kollektiv vinstpost och alltid före Avstämningspost kollektivvinster. Posterna är sorterade efter fälten serienummer och ordningsnummer i stigande ordning. Start- Längd Typ Notering

Antalet poster motsvarar antalet utfallna garantivinster inom en serie. En garantivinst anger endast ordningsnummer eftersom den alltid gäller för samtliga serier.

7 7 (8) Posttyp 1 1 Alltid 3 Serienummer 2 5 N Ordningsnummer 7 4 N Belopp N Checksiffra Alltid 1 SPACE-tecken 1) Belopp anges i heltal kronor. 2) Fältet används inte längre. 5.4 Avstämningspost kollektivvinster Är alltid post 4 från slutet i filen. Förekommer alltid en gång i varje fil, oavsett om filen innehåller kollektivvinster eller ej. Start- Längd Typ Notering Posttyp 1 1 Alltid 4 Antal kollektiva vinster N Summa belopp kollektiva vinster N 1) Totalt antal poster av typen Kollektiv vinstpost 2) Summan av fält Belopp för alla poster av typen Kollektiv vinstpost 5.5 Avstämningspost individuella vinster Är alltid post 3 från slutet i filen. Förekommer alltid en gång i varje fil, oavsett om filen innehåller individuella vinster eller ej. Start- Längd Typ Notering Posttyp 1 1 Alltid 5 Antal individuella vinster N Summa belopp individuella vinster N 1) Totalt antal poster av typen Individuell vinstpost 2) Summan av fält Belopp för alla poster av typen Individuell vinstpost

Start- Längd Typ Notering Posttyp 1 1 Alltid 4 Antal kollektiva vinster 1 2 7 N Summa belopp kollektiva vinster 2 9 10 N 1) Totalt antal poster av typen Kollektiv vinstpost 2) Summan av fält Belopp

8 8 (8) 5.6 Avstämningspost totalt Är alltid post 2 från slutet i filen. Förekommer alltid en gång i varje fil. Start- Längd Typ Notering Posttyp 1 1 Alltid 6 Totalt antal poster N Totalt belopp N 1) Totalt antal poster av typen Kollektiv vinstpost och Individuell vinstpost i filen. 2) Summan av samtliga belopp i posttyperna: Kollektiv vinstpost och Individuell vinstpost. 6 Exempel Ett fiktivt exempel på innehållet i en fil för premieobligationslånet 2001:1. Filen skapades Filen innehåller 2 st. garanti vinstposter på vinstbeloppet 500 kronor, samt 2 st. individuella vinstposter på vinstbeloppet kronor * * * * * * * * *) Radbrytning enbart för presentationens skull. I filen följer alla posterna direkt efter varandra utan radbrytning.

2) Summan av samtliga belopp i posttyperna: Kollektiv vinstpost och Individuell vinstpost. 6 Exempel Ett fiktivt exempel på innehållet i en fil för premieobligationslånet 2001:1.

Relevanta dokument

Utdrag i kreditupplysningssyfte

1(8) Utdrag i kreditupplysningssyfte Teknisk beskrivning av transaktionen Utdrag skuldsaldo Utgåva 1.0 www.kronofogden.se E-postadress: kronofogdemyndigheten@kronofogden.se Postadress Besöksadress Telefon