Dragningssystemet Filbeskrivning för osigillerad resultatfil från Version 1.2 Datum Ändrat av Version Kommentar 2011-04-05 uljo 1.0 Första version 2011-11-15 uljo 1.1 Lagt till information om filnamnsregler på FTP-servern 2012-05-21 uljo 1.2 Rättat fel i stycke 4.1 - Låneår anges med 4 siffror inte 2.
Innehåll 1 INLEDNING... 3 2 ÄNDRINGSSKYDD... 3 3 NAMNGIVNING AV FIL - INTERNT... 3 4 NAMNGIVNING AV FIL EXTERNT... 4 4.1 FTP-SERVER... 4 5 FILFORMAT... 5 5.1 LÅN- OCH DRAGNINGSPOST... 5 5.2 KOLLEKTIV VINSTPOST... 6 5.3 INDIVIDUELL VINSTPOST... 6 5.4 AVSTÄMNINGSPOST KOLLEKTIVVINSTER... 7 5.5 AVSTÄMNINGSPOST INDIVIDUELLA VINSTER... 7 5.6 AVSTÄMNINGSPOST TOTALT... 8 6 EXEMPEL... 8
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 serie- och ordningsnummer.
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: 20010304.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: dr111212. Om dragningar har gjorts för flera olika lån på samma dag så hamnar deras resultatfiler i samma katalog.
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
6 (8) Posttyp 1 1 Alltid 1 Obligationssår 1 2 2 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 2001. 5.2 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 1 11 6 N Checksiffra 2 17 1 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
7 (8) Posttyp 1 1 Alltid 3 Serienummer 2 5 N Ordningsnummer 7 4 N Belopp 1 11 7 N Checksiffra 2 18 1 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 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 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 1 2 7 N Summa belopp individuella vinster 2 9 10 N 1) Totalt antal poster av typen Individuell vinstpost 2) Summan av fält Belopp för alla poster av typen Individuell vinstpost
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 1 2 7 N Totalt belopp 2 9 10 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 2002-11-25. Filen innehåller 2 st. garanti vinstposter på vinstbeloppet 500 kronor, samt 2 st. individuella vinstposter på vinstbeloppet 1 000 kronor. 1011070000102000 * 2 1234000500 * 2 2345000500 * 30000101230001000 * 30001212340001000 * 400000020000001000* 500000020000002000* 600000040000003000* *) Radbrytning enbart för presentationens skull. I filen följer alla posterna direkt efter varandra utan radbrytning.