Datum Verkställighet. Teknisk beskrivning av transaktionen Ansökan om verkställighet Utgåva 1.1

Transkript

1 1(14) Verkställighet Teknisk beskrivning av transaktionen Ansökan om verkställighet Utgåva E-postadress: Postadress Besöksadress Telefon Telefax Box 1050 Esplanaden SUNDBYBERG SUNDBYBERG

2 2(14) 1 Innehåll 1 INNEHÅLL VERSIONSHISTORIK INTRODUKTION Om dokumentet Om tjänsten TRANSAKTIONSFILENS STRUKTUR Översikt Postformat Fältformat Postbeskrivning Startpost (00) Typ av skuld (01) Kapitalskuld (02) Grund för fordran (03) Grund för fordran, alternativ (05) Slutpost (99) KONTROLL OCH KVITTENS Kvittens av godkänd transaktionsfil Kvittens av underkänd transaktionsfil Felmeddelanden Felaktigheter i startpost Felaktigheter i posttyp Felaktigheter i posttyp (enbart Försäkringskassan) NAMNSÄTTNING... 14

3 3(14) 2 Versionshistorik Version Ändring Första utgåva 1.1 Förtydligande av godkända tecken 4.3 Ändrat beskrivning för TOT-BEL Introduktion 3.1 Om dokumentet Dokumentet innehåller en beskrivning av fil och poststruktur för elektronisk ansökan om verkställighet, namnsättning av filer samt kontroll av filens struktur och innehåll. Dokumentet vänder sig till utvecklare av system för kommunikation med Kronofogdemyndighetens verksamhetssystem via elektroniskt gränssnitt. 3.2 Om tjänsten Verkställighet är en tjänst som Kronofogdemyndigheten tillhandahåller ingivare för exekution av ett utslag eller en dom. Överföringen från kund till Kronofogdemyndigheten av Ansökan om verkställighet kan ske via elektronisk filöverföring eller skriftligt. 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 ansökningar om verkställighet från kund till Kronofogden. Dokumentet beskriver postsamband, poststruktur samt den kontroll och kvittens som sker i samband med överföringen av transaktionsfilen.

4 4(14) XXX.EMALIN.DÅÅMMDD (Ansökan om verkställighet) Missiv (sammanfattning av innehållet i XXX.EMALIN.DÅÅMMDD) REX.XXX.KVITTENS (Kvittens på filen XXX.EMALIN.DÅÅMDD) REX.XXX.EMALUT (Bekräftelse ansökan om verkställighet) Ingivare XXX.ANDRING (Ändring av belopp, återkallelse, uppskov) inbb001x1_xxx_ååååmmddttmm (Kvittens på Ändring) ÅÅÅÅ-MM-DD_XXX_LUB_01.xml (Löneutmätningsbeslut) ÅÅÅÅ-MM-DD_XXX_DELRED_01.xml (Utredningsrapporter och delredovisning) Beslut om verkställighet ÅÅÅÅ-MM-DD_XXX_NYTTAVGAR_01.xml (Meddelande om ny grundavgift) ints001x1_xxx.xml (Slutredovisning) Figur 1 - Transaktionen Ansökan om verkställighet i sitt sammanhang Transaktionsfilen XXX. IN.DÅÅMMDD och kvittensen av den formella kontrollen REX.XXX.KVITTENS inleder ett ärende i tjänsten Verkställighet. Samverkan mellan transaktionerna beskrivs ytterligare i dokumentet Funktionell beskrivning av tjänsten Verkställighet.

5 5(14) 4 Transaktionsfilens struktur 4.1 Översikt Nedan visas postsambandet för den transaktionsfil som används för Ansökan om verkställighet. För att överföra en eller flera Ansökan om verkställighet skapas en transaktionsfil. Exakt 1 st Ansökan om verkställighet Exakt 1 st 00 Startpost Minst 1 st Ansökan Exakt 1 st 99 Slutpost 01 Typ av skuld Exakt 1 st 02 Kapitalskuld 0 eller 1 st 03 Grund för fordran* 0 eller 1 st 05 Grund för fordran, alt.* *) Posttyp 03 och 05 utesluter varandra och får inte finns i samma ansökan 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 300 tecken.

6 6(14) 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 (00) 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 PTYP Posttyp = X FILOMB Kod för sökanden eller sökandens juridiska ombud X SYSTEM Mottagande system. Ska vara REX X FILNAMN Namn på filen = NYMÅLSREGISTRERING RESTDAT då filen upprättades, restföringsdatum = ÅÅÅÅMMDD FILNUMMER Filens löpnummer. Räknas upp med 1 för varje ny fil som skickas X RESERV Reserv, blank Typ av skuld (01) Posten innehåller uppgifter om sökande och sökandens ombud, referens till ärendet, ombudets handläggare, vad ansökan avser och uppgifter om borgenären. Posten ska alltid efterföljas av en post med PTYP = 02. Position Antal Format Fält Beskrivning tecken X PTYP Posttyp = X SOKOMB Sökandens juridiska ombud om detta

7 7(14) finns X REFERENS Sökanden eller ombudets referensnummer X UTSLAGSNR- SUPRO Ärendets eventuella utslagsnummer i SUPRO. Obs ej mål/ärendenumret i REX X SÖKANDE Sökandens namn då ombud finns X URKUND Typ av underlag enligt följande: B = betalningsföreläggande eller utslag från SUPRO D = dom L = lagsökningsutslag T = tredskodom DOMDAT för slutbevis/dom = ÅÅÅÅMMD X DOMKOD Kod för domstol (ej vid Supro-ärenden) Blankt Reserv, blank X VERKST Ska innehålla F X FAST Fastighetsutmätning: F = Begär fastighetsutmätning A = Avstår från fastighetsutmätning blank = varken begär eller avstår Blankt Reserv, blank X SKADESTÅND '1' = Fordran avser skadeståndsanspråk som grundar sig på brott, och sökanden ska därmed befrias från att betala grundavgift blank = ej skadestånd Blankt Reserv, blank X KFM Kod för det kronofogdekontor som exekutionstiteln skickats till. Ifylls endast när exekutionstiteln har skickats till Kronofogden, dvs. om den utfärdats av domstol GALDUPPG Gäldenärens person- eller organisationsnummer = ÅÅÅÅMMDDNNNK X NAMN Gäldenärens namn: Efternamn och förnamn, eller namn på den juridiska personen (VERSALER) X ADRESS1 C/O-namn (VERSALER) Ex. svensk adress: C/O C. PERSSON. Ex. utländsk adress: UNGARDSGADE X ADRESS2 Gäldenärens gatuadress (VERSALER). Ex. svensk adress: VÄSTRA GATAN 123. Ex. utländsk adress: DK-2670 GREVE DANMARK PONR Svenskt postnummer, annars nollor X PANST Svensk postanstalt, annars blankt

8 8(14) Blankt Reserv, blank Kapitalskuld (02) Posten innehåller uppgifter om skulden och upplupen ränta. Posten ska alltid följa efter en post med PTYP = 01. Position Antal Format Fält Beskrivning tecken X PTYP Posttyp = X SOKOMB Sökandens juridiska ombud, om sådant finns X REFERENS Sökanden eller ombudets referensnummer KAP Kapitalskuld i SEK KAPRENT Sammanlagd obetald ränta som upplupit på kapitalskulden fram till KAPDAT, se nedan KAPDAT till vilket ränta på kapitalskulden beräknats = ÅÅÅÅMMDD KAPRENTE-TYP Räntetyp för kapitalräntan: 0 = inget ränteyrkande 1 = fast årlig ränta enl. angiven räntesats 2 = årlig ränta enl. diskontot + angiven räntesats 3 = Angiven räntesats avser ränta per påbörjad månad 4 = För närvarande-ränta 5 = Referensränta KAPRENTE-SATS Räntesats för kapitalränta INKASSO Inkassokostnad i SEK INKRENT Sammanlagd obetald ränta som upplupit på inkassokostnad fram till INKDAT INKDAT till vilket ränta på inkassokostnad beräknats = ÅÅÅÅMMDD INKRENTE-TYP Räntetyp för inkassokostnad. Se KAPTENTE-TYP INKRENTE-SATS Räntesats för inkassoränta KOSTNAD Rättegångs- och lagsökningskostnader i SEK KOSRENT Sammanlagd obetald ränta som upplupit på rättegångs- och lagsökningskostnad fram till KOSDAT KOSDAT till vilket ränta på rättegångsoch lagsökningskostnader beräknats = ÅÅÅÅMMDD KOSRENTE-TYP Räntetyp för rättegångs- och

9 9(14) lagsökningskostnader. Se KAPRENTE- TYP KOSRENTE-SATS Räntesats för rättegångs- och lagsökningskostnadsränta Blankt Reserv, blank Grund för fordran (03) Posten innehåller uppgifter om grund till fordran samt eventuellt meddelande till Kronofogden. Denna post alternativt post med PTYP 05 ska alltid följa efter en post med posttyp = 02. Position Längd Format Fält Beskrivning X PTYP Posttyp = X SOKOMB Sökandens juridiska ombud X REFERENS Ombudets referensnummer X GRUND Grund för fordran. Meddelas gäldenären X TEXT-SYNS Uppgifter om sökandens tidigare namn, c/o-adress, med uppgiven firma. Meddelas gäldenären X TEXT-DOLD Meddelande till KFM (exempelvis kända tillgångar) som ej ska meddelas gäldenären Blankt Reserv, blank Grund för fordran, alternativ (05) Posten innehåller uppgift om grund för fordran och information om eventuell överlåtelsekedja. Posten är ett alternativ till post med PTYP = 03. Post med PTYP = 03 eller 05 ska alltid följa efter post med PTYP = 02 Position Längd Format Fält Beskrivning X PTYP Posttyp = X SOKOMB Kod för sökandens juridiska ombud, eller sökanden om ombud saknas X REFERENS Ombudets referensnummer X GRUND Grund för fordran. Denna meddelas gäldenären. Text som inte ska meddelas gäldenären ska anges efter ett större äntecken (>). Text som följer > (inklusive tecknet självt) till fältets slut skrivs inte ut på betalningsavier etc. till gäldenären. Detta ger en möjlighet att skicka meddelande till KFM, exempelvis kända tillgångar X ÖVK-NUMMER Nummer för överlåtelsekedja. Detta

10 10(14) nummer har format enligt ÅÅNNNN, där ÅÅ är de två sista siffrorna i ett årtal och där NNNN är ett nummer med inledande nollor. Ex: Nummer 1 för 2011 blir Detta nummer tilldelas av INREG vid KFM Kalmar. Ingår målet inte i en överlåtelsekedja ska detta fält vara blankt Blankt Reserv, blank Slutpost (99) Posten anger slutet på filen och innehåller antalet ansökningar respektive totala antalet poster i filen, som kontroll att filen är intakt. Position Längd Format Fält Beskrivning X PTYP Posttyp = X FILOMB Kod för sökandens juridiska ombud, eller sökanden om ombud saknas ANT-ANSOK Antal ansökningar ANT-POST Antal poster inklusive start- och slutpost TOT-BEL Totalt belopp i filen Blankt Reserv, blank.

11 11(14) 5 Kontroll och kvittens Innan transaktionsfilen behandlas sker en kontroll av att filen har korrekt form och att posternas fält har ett format som är korrekt och rimligt. Kontrollen leder till att transaktionsfilen godkänns eller underkänns i sin helhet. Resultatet av kontrollen meddelas avsändaren genom att en kvittensfil skapas. Kvittensfilen innehåller information om transaktionsfilen har godkänts eller underkänts samt orsaken till ett eventuellt underkännande. 5.1 Kvittens av godkänd transaktionsfil FELLISTA - NYMÅLSREGISTRERING XXX (ÅÅMMDD,NNNN) FILEN HAR GODKÄNTS Om transaktionsfilen godkänns vid formell kontroll erhåller ingivaren en kvittens. Kvittensen innehåller alltid texterna FELLISTA - NYMÅLSREGISTRERING. Därefter kommer ingivarens ombudskod XXX, fildatum ÅÅMMDD och löpnummer NNNN från transaktionsfilen Ansökan om verkställighet samt datum då kvittens skapades. Därefter följer texten FILEN HAR GODKÄNTS. 5.2 Kvittens av underkänd transaktionsfil FELLISTA - NYMÅLSREGISTRERING XXX (ÅÅMMDD,NNNN) FILEN HAR UNDERKÄNTS Information om orsaken till att filen underkänts Om transaktionsfilen innehåller felaktigheter vid den formella kontrollen erhåller ingivaren en kvittens med texten FILEN HAR UNDERKÄNTS. Kvittensfilen inleds på samma sätt som kvittensen på en godkänd fil. Efter informationen att filen har underkänts följer ett förtydligande av var felet hittades i filen och orsaken till underkännandet. Efter 100 felaktigheter avbryts kontrollen och skickas till avsändaren. Transaktionsfilen underkänns alltid i sin helhet och bearbetningen avbryts om någon del av filen innehåller felaktigheter.

12 12(14) 5.3 Felmeddelanden Felmeddelanden grupperas per posttyp. Felmeddelandet inleds med information om var i filen felaktigheten finns. Informationen innehåller posttyp, ombudskod, filnamn, fildatum och filnummer Felaktigheter i startpost Meddelande FEL SYSTEM/FILOMBUD - KÖRNINGEN AVBRUTEN! FELAKTIGT FILNAMN - KÖRNINGEN AVBRUTEN! PONR SAKNAS= X LÄSFEL FRÅN XPORT - KÖRNINGEN AVBRUTEN! OMBUD ENL. MISSIV = X OMBUD ENL. INFIL = X RESTDAT ENL. MISSIV = X RESTDAT ENL. INFIL = X FILNUMMER ENL. MISSIV = X FILNUMMER ENL. INFIL = X ANT ANSÖKN ENL MISSIV = X ANT ANSÖKN ENL INFIL = X ANT POSTER ENL MISSIV = X ANT POSTER ENL INFIL = X TOT BEL ENL MISSIV = X TOT BEL ENL INFIL = X ANT ANSÖKN ENL. INFIL = X ANT. ANSÖKN ENL. PGM = X OMBUDET HAR INTE FÅTT TILLSTÅND ATT SKICKA FILER. KÖRNINGEN AVBRUTEN!!! LÄST POST NUMMER = X POSTTYP = X POSTLÄNGDERNA FÖR FILKOLLI/FILKOLLU MÅSTE ÄNDRAS - KÖRNINGEN AVBRUTEN! FEL FILDATUM, SKA VARA STÖRRE ÄN X - KÖRNINGEN AVBRUTEN! Felaktigheter i posttyp Meddelande RESTDAT-EMAL FELKOD-WS X FILOMB-EMAL X STATUS-XOMB X PNR-EMAL = X FELKOD-WS = X FEL VID XKOLLPN2 KFM-EMAL = (SAKNAS) KFM-EMAL = X (EJ NUMERISK) KFM-EMAL = X (FELAKTIGT) FSEKNR-WS = X FELKOD-WS X VERKST-EMAL = X VERKST-EMAL = SAKNAS URKUND-EMAL = SAKNAS URKUND-EMAL = X DOMKOD-EMAL = X (EJ NUMERISK) DOMKOD-EMAL = (SAKNAS) DOMKOD-EMAL = X (EJ > 0) DOMKOD-EMAL = X TFF( > 110) DOMKOD-EMAL = X ( FELAKTIGT ) DOMDAT-EMAL = X FELKOD-WS = X SKULDUPPGIFT-EMAL EJ NUMERISKT

13 13(14) GRUNDAVGIFT EJ ÅSATT PGA FEL I VERKST, SKALL VARA F FEL I KAPITALRÄNTAN X X FEL I INKASSORÄNTAN X X FEL I KOSTNADSRÄNTAN X X KAPDAT-EMAL = X FELKOD-WS = X INKDAT-EMAL = X FELKOD-WS = X KOSDAT-EMAL = X FELKOD-WS = X KAPDAT-EMAL = ( X ) < RESTDAT-EMAL ( X ) INKDAT-EMAL ( X ) > RESTDAT-EMAL ( X ) KOSDAT-EMAL ( X ) > RESTDAT-EMAL ( X ) PTYP FEL / OMBUD FEL /REFERENSNUMMER FEL. KÖRNINGEN AVBRUTEN FAST-EMAL = X FAST-EMAL = SAKNAS DOMDAT-EMAL > DAGENS DATUM. DOMDAT-EMAL = X FELAKTIGT BGIRONR X UTSLAGSNR-SUPRO-EMAL = X LÄNSKOD FEL/FORMAT FEL/EJ>0/ÅR FEL ETC UTSLAGSNR-SUPRO-IN, KFMDOM-IN, DOMKOD-IN, DOMDAT-IN, URKUND-IN UTESLUTER EJ VARANDRA! SLUTPOSTEN EJ PTYP X PTYP4 SAKNAS ELLER OMBUDSKOD EJ IFYLLT ANTAL FELAKTIGHETER > 100 ST UTSLAGSNR-EMAL= ( SAKNAS TROTS ATT KFM-DOM FINNS ) KAPDAT-EMAL (X) > MAX. MÅNADSRÄNTEDATUM (X) KOSDAT-EMAL (X) > MAX. MÅNADSRÄNTEDATUM (X) HANDLING-EMAL = X ENBART KAPITAL-EMAL SKALL HA BELOPP SKADESTÅND = X UHS-UPPHÖR-IN= X FELKOD-WS = X PRESK-DATUM-IN= X FELKO-WS = X PRESKDAT-IN =< DAGENS DATUM. PRESK-DAT-IN = X LÖPANDE-BIDRAG-IN EJ NUMERISKT FELAKTIG PERIOD. PERIOD-IN = X PERIODEN FINNS REDAN. BELOPP = X FELAKTIG UHB-PERSONNUMMER. UHB-PNR = X FELAKTIG PERIOD. UHB-PNR = X PERIOD X OMBUDSUPPGIFTERNA FELAKTIGA. GÄLDENÄRENS POSTNUMMER FELAKTIGT-X PERIODEN ÄR MINDRE ÄN DEN HÖGSTA PERIODEN I REX. FELAKTIGT ÖVK-NUMMER (X) I POSTTYP 5.= X Felaktigheter i posttyp (enbart Försäkringskassan) Meddelande SYSTEMFEL. VID LÄSNING AV E- MÅL (D227). STATUS = X PNR-EMAL X SYSTEMFEL. AVBROTT. FEL VID XSTATUS. FELKOD = X UHBPNR-PNR= X

14 14(14) 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.EMALIN.DÅÅMMDD REX.XXX.KVITTENS XXX ersätts med ombudskoden för det ombud som skapar filen. Ombudskoden ska anges med versaler. ÅÅMMDD ersätts av datum då transaktionsfilen överfördes. Exempel: ABC.EMALIN.D