Beslut om betalningsföreläggande

Transkript

1 1(11) Beslut om betalningsföreläggande Teknisk beskrivning av transaktionen Återkallelse Utgåva E-postadress: Postadress Besöksadress Telefon Telefax Box 1050 Esplanaden SUNDBYBERG SUNDBYBERG

2 2(11) 1 Innehåll 1 INNEHÅLL VERSIONSHISTORIK INTRODUKTION Om dokumentet Om tjänsten TRANSAKTIONSFILENS STRUKTUR Översikt Postformat Fältformat Postbeskrivning Startpost (100) Referensnummer (110) Slutpost (190) KONTROLL OCH KVITTENS Kvittensfiler Kvittens av godkänd transaktionsfil Kvittens av underkänd transaktionsfil Felmeddelanden Felmeddelanden vid formell kontroll Kontroll vid inläsning och bearbetning NAMNSÄTTNING... 11

3 3(11) 2 Versionshistorik Version Ändring 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.

4 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 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 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 Format Betydelse Blankt Fältet ska vara fyllt med blanktecken (Space) X Godkända tecken är: abcdefghijklmnopqrstuvwxyzåäöéabcdefghijklmnopqrstuvwxyzåäöé!" %&/()=? *<>;:_,.-üÜ 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 Fältet innehåller ett tal med två decimaler. Punkt eller kommatecken ska ej anges. Talet ska högerjusteras med inledande nollor Postbeskrivning 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 X POSTTYP Startpost = X SYSTEMKOD Mottagande system. = SUPRO X PROGRAMKOD Mottagande program = HELATK X OMBUDSKOD Kod för det ombud som lämnar filen BAND-DATUM Körningsdatum då filen framställdes, i formatet ÅÅÅÅMMDD 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 Blankt FILLER Reserv Referensnummer (110) Referens till ansökningar som ska återkallas. Position Antal Format Fält Beskrivning tecken X POSTTYP Referensnummerpost = 110

7 7(11) X OMB-KOD Kod för sökandens ombud i målet. Samma ombudskod som i Ansökan om betalningsföreläggande X OMB-REFNR Ombudets referensnummer. Ska vara unikt för varje ansökan Blankt FILLER Reserv, blankt 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 X POSTTYP Slutpost ANT-HELATK Antal hela återkallelser på filen. Antal poster med POSTTYP ANT-POSTER Totalt antal poster på filen inklusive startpost och slutpost Blankt FILLER Reserv, blank.

8 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 9(11) 5.1 Kvittensfiler Kvittens av godkänd transaktionsfil KVITTENS, MASKINELL HEL ÅTERKALLELSE I SUPRO OMBUDSKOD BANDDATUM LÖPNR KÖRNINGSDAG KLOCKAN XXX 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 XXX /30 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avvisning XXX /26 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /02 UTSLAG FINNS I MÅLET XXX /43 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /16 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /78 REFNR SAKNAS I SUPROS REGISTER XXX /50 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /49 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /21 UTSLAG FINNS I MÅLET XXX /26 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /69 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning XXX /02 MÅLET ÄR REDAN AVREGISTRERAT. Målet avregistrerat pga avskrivning 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 POSTNR POSTTYP OMBUD REFERENS MEDDELANDE LÄGRE ÄN FÖREGÅENDE BAND-DATUM LÖPNR EJ I SEKVENS. FÖRVÄNTAT LÖPNR: 1808 FILEN UNDERKÄND

10 10(11) 5.2 Felmeddelanden 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: FEL POSTTYP. FÖRVÄNTAD: XXX OMB-REFNR FÅR EJ VARA BLANKT OMBUDSKODEN FELAKTIG ANTAL ANSÖKN. FEL I SLUTPOST. RÄTT ANTAL: ANTAL POSTER FEL I SLUTPOST. RÄTT ANTAL: LÄGRE ÄN FÖREGÅENDE BAND-DATUM 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 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(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.