1(11) Beslut om betalningsföreläggande Teknisk beskrivning av transaktionen Återkallelse Utgåva 1.1 www.kronofogden.se E-postadress: kronofogdemyndigheten@kronofogden.se Postadress Besöksadress Telefon Telefax Box 1050 Esplanaden 1 0771-73 73 00 08-29 26 14 172 21 SUNDBYBERG 172 67 SUNDBYBERG
2(11) 1 Innehåll 1 INNEHÅLL... 2 2 VERSIONSHISTORIK... 3 3 INTRODUKTION... 3 3.1 Om dokumentet... 3 3.2 Om tjänsten... 3 4 TRANSAKTIONSFILENS STRUKTUR... 5 4.1 Översikt... 5 4.2 Postformat... 5 4.3 Fältformat... 6 4.4 Postbeskrivning... 6 4.4.1 Startpost (100)... 6 4.4.2 Referensnummer (110)... 6 4.4.3 Slutpost (190)... 7 5 KONTROLL OCH KVITTENS... 8 5.1 Kvittensfiler... 9 5.1.1 Kvittens av godkänd transaktionsfil... 9 5.1.2 Kvittens av underkänd transaktionsfil... 9 5.2 Felmeddelanden... 10 5.2.1 Felmeddelanden vid formell kontroll... 10 5.2.2 Kontroll vid inläsning och bearbetning... 10 6 NAMNSÄTTNING... 11
3(11) 2 Versionshistorik Version Ändring 1.0 2012-11-16 Första utgåva 1.1 Förtydligande godkända tecken 3 Introduktion 3.1 Om dokumentet Dokumentet innehåller en beskrivning av fil och poststruktur för elektroniskt meddelande om Återkallelse, namnsättning av filer samt kontroll av filens struktur och innehåll. Dokumentet vänder sig till utvecklare av system för kommunikation med Kronofogdens verksamhetssystem via elektroniskt gränssnitt. 3.2 Om tjänsten Beslut om betalningsföreläggande är en tjänst som Kronofogden tillhandahåller ingivare med behov av att få ett myndighetsbeslut om en fordran. Återkallelse överförs från ingivaren till Kronofogden med elektronisk filöverföring. Elektronisk överföring används i syfte att öka kvalitén i överföringen och hanteringen av ärenden. Detta dokument beskriver den transaktionsfil som används för överföring av meddelande om Återkallelse från kund till Kronofogden. Dokumentet beskriver postsamband, poststruktur samt den kontroll och kvittens som sker i samband med överföringen av transaktionsfilen.
Ingivare Beslut om betalningsföreläggande Verksamhetsomr. 3 ledning/kansli 4(11) XXX.ANSOKAN (Ansökan om betalningsföreläggande) SUPRO.XXX.KVITTENS (Kvittens på filen XXX.ANSOKAN) SUPRO.XXX.ANSBEKR (Bekräftelse ansökan om betalningsföreläggande) XXX.NEDS (Nedsättning) SUPRO.XXX.NEDKVITT (Kvittens på filen XXX.NEDS) XXX.ATK.HELATK (Återkallelse) SUPRO.XXX.ATK.KVITTENS (Kvittens på filen XXX.ATK.HELATK) SUPRO.XXX.RAPPORT (Utslag) Figur 1 - Transaktionen Återkallelse i sitt sammanhang Transaktionsfilen XXX.ATK.HELATK och kvittensen av den formella kontrollen SUPRO.XXX.ATK.KVITTENS innehåller meddelanden om att återkalla ärende/mål om betalningsföreläggande. Samverkan mellan transaktionerna beskrivs ytterligare i dokumentet Funktionell beskrivning av tjänsten Beslut om betalningsföreläggande.
5(11) 4 Transaktionsfilens struktur 4.1 Översikt Nedan visas postsambandet för den transaktionsfil som används för Ansökan om återkallelse. För att överföra en eller flera Återkallelser skapas en transaktionsfil. Exakt 1 st 100 Startpost Transaktionsfil Återkallelse Minst 1 st Återkallelse av ansökan Exakt 1 st 110 Referensnummer Exakt 1 st 190 Slutpost Figur 2 - Filstruktur 4.2 Postformat En transaktionsfil består av ett antal efter varandra följande poster uppbyggda på samma sätt. Varje post inleds med ett fält som anger vilken typ av post det är frågan om. Efter posttypen följer ett antal fält bestående av ett bestämt antal tecken och med ett fast fältformat. Respektive posttyp beskrivs nedan. Varje post består av 100 tecken.
6(11) 4.3 Fältformat Posterna beskrivs nedan som ett antal fält som ska följa ett specifikt format. Innehållet i fälten ska följa teckenformatet ISO 8859-1. Format Betydelse Blankt Fältet ska vara fyllt med blanktecken (Space) X Godkända tecken är: abcdefghijklmnopqrstuvwxyzåäöéabcdefghijklmnopqrstuvwxyzåäöé!" %&/()=?1234567890+*<>;:_,.-üÜ Alla andra tecken gör att filen underkänns. Fel på fil medför att hela filen avvisas. 9 Fältet innehåller numeriska tecken och ska högerjusteras med inledande nollor 0. 9.99 Fältet innehåller ett tal med två decimaler. Punkt eller kommatecken ska ej anges. Talet ska högerjusteras med inledande nollor 0. 4.4 Postbeskrivning 4.4.1 Startpost (100) Startpost används för att unikt identifiera användaren och säkerställa att alla filer har mottagits utan dubbletter. Position Antal Format Fält Beskrivning tecken 1-3 3 X POSTTYP Startpost = 100 4-8 5 X SYSTEMKOD Mottagande system. = SUPRO 9-14 6 X PROGRAMKOD Mottagande program = HELATK 15-17 3 X OMBUDSKOD Kod för det ombud som lämnar filen. 18-25 8 9 BAND-DATUM Körningsdatum då filen framställdes, i formatet ÅÅÅÅMMDD. 26-29 4 9 BAND-LOPNR Stigande löpnummer som tillsammans med ombudskod och BAND-DATUM unikt identifierar filen. Åsätts av ingivaren. Används för kontroll av att rätt fil körs. Ökas med +1 för varje godkänd fil. Om en fil underkänns ska den rättas och skickas in igen med samma BAND-LOPNR 30-100 71 Blankt FILLER Reserv. 4.4.2 Referensnummer (110) Referens till ansökningar som ska återkallas. Position Antal Format Fält Beskrivning tecken 1-3 3 X POSTTYP Referensnummerpost = 110
7(11) 4-6 3 X OMB-KOD Kod för sökandens ombud i målet. Samma ombudskod som i Ansökan om betalningsföreläggande. 7-36 30 X OMB-REFNR Ombudets referensnummer. Ska vara unikt för varje ansökan. 37-100 64 Blankt FILLER Reserv, blankt. 4.4.3 Slutpost (190) Posten anger slutet på filen och innehåller antalet ansökningar respektive totala antalet poster i filen som kontroll att filen är intakt. Position Antal Format Fält Beskrivning tecken 1-3 3 X POSTTYP Slutpost. 4-11 8 9 ANT-HELATK Antal hela återkallelser på filen. Antal poster med POSTTYP 110. 12-21 10 9 ANT-POSTER Totalt antal poster på filen inklusive startpost och slutpost. 22-100 79 Blankt FILLER Reserv, blank.
8(11) 5 Kontroll och kvittens Kontroll av transaktionsfilen sker i två steg: 1. Formell kontroll av filen. 2. Kontroll av filen mot aktuella register. En transaktionsfil som innehåller formella fel kommer att underkännas i sin helhet utan att någon bearbetning sker. En transaktionsfil som uppfyller de formella kraven läses in och behandlas. I samband med inläsning och bearbetning sker en kontroll av riktigheten i de data som filens poster innehåller. Skulle någon av posterna innehålla något fel så sker ingen bearbetning av den aktuella posten. Filen godkänns dock. Resultatet av kontrollen meddelas avsändaren genom att en kvittensfil skapas. Kvittensfilen innehåller information om transaktionsfilen har godkänts helt eller delvis eller om den har underkänts, samt orsaken till ett eventuellt underkännande.
9(11) 5.1 Kvittensfiler 5.1.1 Kvittens av godkänd transaktionsfil KVITTENS, MASKINELL HEL ÅTERKALLELSE I SUPRO OMBUDSKOD BANDDATUM LÖPNR KÖRNINGSDAG KLOCKAN --------- ---------- ----- ----------- -------- XXX 2012-10-05 1391 2012-10-05 12.10.39 ANTAL LÄSTA POSTER...: 433 ANTAL LÄSTA ÅTERKALLELSER...: 431 ANTAL GODKÄNDA ÅTERKALLELSER..: 419 ANTAL UNDERKÄNDA ÅTERKALLELSER: 12 POSTNR POSTTYP OMBUD REFERENS MEDDELANDE ------ ------- ----- ------------------------------ ----------------------------------------------- 4 110 XXX 5675775/30 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120111 pga avvisning 34 110 XXX 7189244/26 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 121004 pga avskrivning 71 110 XXX 7192132/02 UTSLAG FINNS I MÅLET. 255 110 XXX 7202422/43 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120927 pga avskrivning 272 110 XXX 4889772/16 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120328 pga avskrivning 273 110 XXX 5703374/78 REFNR SAKNAS I SUPROS REGISTER. 281 110 XXX 6620445/50 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120717 pga avskrivning 282 110 XXX 6624152/49 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120613 pga avskrivning 290 110 XXX 6826793/21 UTSLAG FINNS I MÅLET. 292 110 XXX 6860146/26 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120703 pga avskrivning 293 110 XXX 6877398/69 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120906 pga avskrivning 394 110 XXX 7167884/02 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat 120913 pga avskrivning 5.1.2 Kvittens av underkänd transaktionsfil Kvittensen för en underkänd fil innehåller maximalt 20 stycken fel. Därefter bryts kontrollen. KVITTENS, MASKINELL HEL ÅTERKALLELSE I SUPRO OMBUDSKOD BANDDATUM LÖPNR KÖRNINGSDAG KLOCKAN --------- ---------- ----- ----------- -------- XXX 2011-11-25 1807 2011-11-28 07.33.07 POSTNR POSTTYP OMBUD REFERENS MEDDELANDE ------ ------- ----- ------------------------------ --------------------------- 1 100 LÄGRE ÄN FÖREGÅENDE BAND-DATUM 111128 1 100 LÖPNR EJ I SEKVENS. FÖRVÄNTAT LÖPNR: 1808 FILEN UNDERKÄND
10(11) 5.2 Felmeddelanden 5.2.1 Felmeddelanden vid formell kontroll Följande lista visar de möjliga felmeddelanden som kan uppstå vid en formell kontroll av en transaktionsfil. Felmeddelandet meddelas avsändaren genom filen Kvittens av underkänd transaktionsfil. OMBUDSKODEN OKÄND HOS RSV OMBUDSKODEN HAR AVREGISTRERATS HOS RSV ORIMLIGT DATUM LÖPNR EJ NUMERISKT LÖPNR EJ I SEKVENS. FÖRVÄNTAT LÖPNR: 99999 FEL POSTTYP. FÖRVÄNTAD: XXX OMB-REFNR FÅR EJ VARA BLANKT OMBUDSKODEN FELAKTIG ANTAL ANSÖKN. FEL I SLUTPOST. RÄTT ANTAL: 99999 ANTAL POSTER FEL I SLUTPOST. RÄTT ANTAL: 99999 LÄGRE ÄN FÖREGÅENDE BAND-DATUM 999999 ANTAL ANSÖKNINGAR EJ NUMERISKT ANTAL POSTER EJ NUMERISKT SYSTEMKOD FELAKTIG SUPRO F N EJ TILLGÄNGLIGT. FÖRSÖK IGEN SENARE ANSÖKNINGSFILEN ÄR TOM POSTTYP 190 SAKNAS POSTTYP 190 ÄR INTE SISTA POSTEN PÅ ANSÖKN.FIL 5.2.2 Kontroll vid inläsning och bearbetning Följande lista visar de möjliga felmeddelanden som kan uppstå vid en kontroll av transaktionsfilen mot aktuella register. Felmeddelandet meddelas avsändaren genom filen Kvittens av godkänd transaktionsfil. REFNR SAKNAS I SUPROS REGISTER REFNR ÄR EJ UNIKT I SUPROS REGISTER MÅLET ÄR REDAN AVREGISTRERAT MÅLET ÄR INTE REGISTRERAT MED OMBUDSKOD UTSLAG FINNS I MÅLET ANSÖKAN ÄR REDAN HELT ÅTERKALLAD
11(11) 6 Namnsättning Transaktionsfilens namn sätts enligt nedan, i syfte att tydligt identifiera avsändande/mottagande ombud och vilket innehåll filen har. Fil Transaktionsfil Kvittensfil Filnamn XXX.ATK.HELATK SUPRO.XXX.ATK.KVITTENS XXX ersätts med ombudskoden för det ombud som skapar filen. Ombudskoden ska anges med versaler. Exempel: ABC.ANSOKAN.