1(13) TEKNISK BESKRIVNING Verksamhetsomr. 1 ledning/kansli Datum 2015-05-11 Fordringsanmälan skuldsanering Teknisk beskrivning Utgåva 1.2 www.kronofogden.se E-postadress: [email protected] Postadress Besöksadress Telefon Telefax Box 1050 172 21 SUNDBYBERG Esplanaden 1 172 67 SUNDBYBERG 0771-73 73 00 08-29 26 14 2(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 Innehållsförteckning 1 VERSIONSHISTORIK ...................................................................... 3 2 2.1 2.2 INTRODUKTION .............................................................................. 3 Om dokumentet ................................................................................... 3 Om tjänsten ......................................................................................... 3 3 3.1 3.2 3.2.1 3.2.2 3.2.3 3.2.4 3.2.5 3.2.6 3.2.7 3.2.8 3.2.9 3.2.10 3.2.11 3.2.12 3.2.13 FILENS STRUKTUR ......................................................................... 4 Översikt ............................................................................................... 4 Format och typer för element .............................................................. 6 FilinformationTYPE ........................................................................... 6 Ingivare ............................................................................................... 6 FordringsanmalanTYPE...................................................................... 6 BorgenarTYPE .................................................................................... 7 AdressTYPE........................................................................................ 7 SkuldTYPE ......................................................................................... 7 FakturaUnderlagTYPE........................................................................ 8 StalldSakerhetTYPE ........................................................................... 8 TidigareSkuldTYPE ............................................................................ 9 SkuldBorgensmanTYPE ..................................................................... 9 SkuldSolidarTYPE .............................................................................. 9 SkuldHuvudgaldenarTYPE ................................................................. 9 PersonOrganisationsnummerTYPE .................................................... 9 4 4.1 4.2 4.3 KONTROLL OCH KVITTENS ....................................................... 10 Kvittens av godkänd transaktionsfil .................................................. 10 Återrapportering av underkänd transaktionsfil ................................. 11 Felmeddelanden ................................................................................ 12 5 NAMNSÄTTNING FILER .............................................................. 12 3(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 1 Version 0.5 0.9 1.0 1.1 1.2 Versionshistorik Datum 2015-01-22 2015-02-05 2015-02-18 2015-03 2015-05-11 Ändring Första utgåva Uppdaterat kap 4 och 5 Publicerat dokument Uppdaterat ränteuppgift i 3.2.6 Uppdaterat kontroll av obligatorisk uppgift – skuldid kap 4 och 4.3 2 Introduktion 2.1 Om dokumentet Dokumentet innehåller en beskrivning av filstruktur för elektronisk fordringsanmälan för skuldsanering, 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. Obs! Tjänsten är fortfarande under utveckling när detta publiceras – mindre justeringar av lösningen kan komma att göras. 2.2 Om tjänsten Fordringsanmälan skuldsanering är en tjänst som Kronofogdemyndigheten tillhandahåller ingivare för att skicka in fordringsanmälningar elektroniskt. Överföringen från kund till Kronofogdemyndigheten kan ske via elektronisk filöverföring till SHS. Elektronisk överföring används i syfte att effektivisera både ingivarnas och Kronofogdens egen verksamhet. Detta dokument beskriver den transaktionsfil som används för överföring av fordringsanmälningar från kund till Kronofogden. Dokumentet beskriver filstrukturen(xml schemat) samt de kontroller och kvittens/återrapporteringen som sker i samband med överföringen av filen. 4(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 3 Filens struktur 3.1 Översikt Nedan visas strukturen för den fil som används för fordringsanmälningar som skickas på fil. Formatet är XML och filen byggs upp enligt ett XML-schema framtaget av Kronofogden. Strukturen för XML-filen följer XML-schemat som beskrivs nedan: XML-filens rot element är UppgifterOmFordringsanmalan som innehåller filinformation samt en eller flera listor med fordringsanmälningar kopplat till en ingivare. Varje fordringsanmälan innehåller gäldenärsinformation samt en eller flera borgenärer. Varje borgenär i listan har en eller flera skulder med följande information: 5(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 De streckade linjerna i bilderna ovan anger vilka element som är ”icke obligatoriska”. De heldragna linjerna anger att elementen är obligatoriska. 6(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 3.2 Format och typer för element Här är en beskrivning av typer och element i XML filen. 3.2.1 FilinformationTYPE Elementnamn Lopnummer Typ xs:string Obligatorisk J Tidpunkt xs:dateTime J AntalHandlingar xs:int J SummaBelopp xs:decimal J Filombud xs:string J 3.2.2 Ingivare Elementnamn IntressentId PersonOrganisationsNummer 3.2.3 Beskrivning Filens löpnummer för sökande/ombud Datum och tid för när meddelandet skapades Summering inlämnade fordringar i filen Summering av samtliga belopp i filen Intressent-id för filombud som kommunicerar filer Typ xs:string PersonOrganisationsnummerTYPE Obligatorisk J J Beskrivning Kod (ombudskod) Typ för Person/organisationsnummer. FordringsanmalanTYPE En punktnotation har använts för att beskriva att det är ett element inuti ett annat. Till exempel betyder Galdenar.PersonOrganisationsNummer elementet Galdenar inuti elementet PersonOrganisationsNummer. Elementnamn Galdenar. PersonOrganisationsNummer Galdenar.NamnGaldenar Galdenar.InledandeDatum BorgenarLista Typ PersonOrganisationsnummerTYPE Obligatorisk J xs:string xs:date J N En lista med 1…* borgenärer av typen BorgenarTYPE J Beskrivning Typ för Person/organisationsnummer Namn på gäldenär Datum för beslut om inledande av skuldsanering 7(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 3.2.4 BorgenarTYPE Elementnamn PersonOrganisationsNummer Typ PersonOrganisationsnummerTYPE Obligatorisk N Namn Adress SkuldLista xs:string AdressTYPE En lista med 1…* skulder av typen SkuldTYPE N N J 3.2.5 3.2.6 Beskrivning Person/organisationsnummer Namn på borgenär Typ för adress Varje borgenär i en fordringsanmälan kan ha en till många skulder avseende gäldenären AdressTYPE Elementnamn Postadress Typ xs:string Obligatorisk N Postnummer Postort Land xs:string xs:string xs:string N N N Beskrivning Box/Gatuadress Anges endast om annat land än Sverige SkuldTYPE Elementnamn SkuldId Typ xs:string Obligatorisk J Kapitalbelopp BegartUndantagetBelopp UpplupenRanta xs:decimal xs:decimal xs:decimal J N J OvrigaKostnader xs:decimal N Avgifter xs:decimal N Totalskuld xs:decimal J Beskrivning Borgenärens skuldid/referensnummer Beräknad ränta fram till dagen för inledandebeslutet Administrativa kostnader, inkassokostnader, m.m. Kostnad för ansökan om betalningsförläggande, m.m. Summa kapital, 8(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 RantaEnligtRantelagen xs:string N AvtaladRanta xs:decimal N DatumFordranUppkom xs:date N GrundForFordran xs:string N SkuldBorgensman SkuldSolidar SkuldHuvudgaldenar SkuldBorgensmanTYPE SkuldSolidarTYPE SkuldHuvudgaldenarTYPE N N N FakturaUnderlagLista En lista med 0…* skulder av typen FakturaUnderlagTYPE StalldSakerhetTYPE TidigareSkuldTYPE N StalldSakerhet TidigareSkuld 3.2.7 3.2.8 upplupen ränta, övriga kostander och avgifter Ränta enligt 6 § räntelagen Referensränta + 8 % enligt 6 § räntelagen. Giltiga värden är ’J’ eller ’N’. Avtalad ränta. Gällande räntesats/år för kapitalfordran. Dag då fordran uppkom. Fritext grunden för fordringen, vad avser skulden. Huvudgäldenär = Skuld där gäldenären är borgensman för annans skuld N N FakturaUnderlagTYPE Elementnamn Fakturanummer Typ xs:string Obligatorisk J Fakturadatum Forfallodag xs:date xs:date N N Beskrivning StalldSakerhetTYPE Elementnamn Sakerhet Typ xs:string Obligatorisk N Beskrivning Uppgift om säkerheten, tex fastighetsbeteckning och kommun 9(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 3.2.9 TidigareSkuldTYPE Elementnamn TidigareSkuldId Typ xs:string Obligatorisk N Beskrivning Tidigare skuldid/referensnummer (t ex vid överlåten fordran). Om fordran överlåtits, ange uppgift om tidigare skuldid och/eller tidigare borgenärs namn TidigareBorgenarensNamn 3.2.10 Obligatorisk J N Beskrivning Typ PersonOrganisationsnummerTYPE xs:string Obligatorisk J N Beskrivning Obligatorisk J N Beskrivning Obligatorisk N Beskrivning SkuldHuvudgaldenarTYPE Elementnamn PersOrgNummer HuvudgaldenarNamn 3.2.13 Typ PersonOrganisationsnummerTYPE xs:string SkuldSolidarTYPE Elementnamn PersOrgNummer SolidarNamn 3.2.12 N SkuldBorgensmanTYPE Elementnamn PersOrgNummer BorgenarensNamn 3.2.11 xs:string Typ PersonOrganisationsnummerTYPE xs:string PersonOrganisationsnummerTYPE Elementnamn Typ xs:string Regel: Ska vara 12 siffror och följa reguljära uttrycket: (1[6-9]|20)[0-9]{10} 10(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 4 Kontroll och kvittens Innan XML-filen behandlas sker en kontroll av att filen har korrekt format. Detta görs genom en schemavalidering. Om valideringen inte går igenom så underkänns filen i sin helhet. Om schemavalderingen går igenom görs följande kontroller: Löpnummer och tidpunkt; o Löpnummer; Uppgiften ”Löpnummer” i filen. o Tidpunkt; Uppgiften ”Tidpunkt” i filen Uppgifter om ”Person-/organisationsnummer” enligt 10-modulmetoden. Summeringskontroll av fil: o ”Antal fordringsanmälningar” ska motsvara antal handlingar. o ”Summerat belopp” ska motsvara summan av samtliga fordringsanmälans summerade belopp. Kontroll av obligatorisk uppgift: o ”Skuldid” är obligatoriskt enligt xml-schema och måste också innehålla ett värde. Eftersom ingivare har olika format på sina referensnummer tillåts alla strängar som är minst ett tecken men max 40 tecken. Strängen ”null” accepteras inte.. Resultatet av kontrollen meddelas avsändaren genom att en kvittensfil/återrapporterings fil skapas. Kvittensfilen innehåller information om transaktionsfilen har godkänts eller underkänts samt orsaken till ett eventuellt underkännande. 4.1 Kvittens av godkänd transaktionsfil Om transaktionsfilen godkänns vid formell kontroll erhåller ingivaren en kvittens.”. Först kommer ingivarens FilIdentitet ” 1ea99ef8-dcc0-4137-98b4d1306c986349 (ex) ( unikt i shs och kg) ”, och löpnummer ”NNNN” från transaktionsfilen ”Kvittens av underkänd transaktionsfil”. Exempel: <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?> <Aterkoppling xmlns="http://www.kronofogden.se/mtd/V1"> <FilIdentitet>1ea99ef8-dcc0-4137-98b4-d1306c986349</FilIdentitet> 11(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 <FilLopnummer>1</FilLopnummer> </Aterkoppling> 4.2 Återrapportering av underkänd transaktionsfil Om transaktionsfilen innehåller felaktigheter vid den formella kontrollen erhåller ingivaren en kvittens med texten ”Avvisad”. 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. Transaktionsfilen underkänns alltid i sin helhet och bearbetningen avbryts om någon del av filen innehåller felaktigheter. Exempel med löpnummer valideringsfel <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?> <Aterkoppling xmlns="http://www.kronofogden.se/mtd/V1"> <FilIdentitet>4b9ac94f-c366-4840-b8b5-1acca5e9c2d3</FilIdentitet> <FilLopnummer>0</FilLopnummer> <Avvisad> <Fel> <Text>Fel vid löpnummerkontroll, löpnummer är inte större än det senaste löpnumr et. Senaste löpnummer = 1, löpnummer i filen = 1</Text> </Fel> <Fel> <Text>Fel vid löpnummervalidering. Tidpunkten för filen är ej senare än föregående fils tidpunkt Senaste tidpunkt för föregående fil = Mon Dec 17 10:30:47 CET 2001, tidpunk t för denna fil: Mon Dec 17 10:30:47 CET 2001</Text> </Fel> </Avvisad> </Aterkoppling> Exempel med löpnummer schemavalideringsfel <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?> <Aterkoppling xmlns="http://www.kronofogden.se/mtd/V1"> <FilIdentitet>28498578-c499-4219-adfe-7455e92145fa</FilIdentitet> <FilLopnummer>0</FilLopnummer> <Avvisad> 12(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 <Fel> <Text>cvc-datatype-valid.1.2.1: '0,44' is not a valid value for 'decimal'.</Text> </Fel> <Fel> <Text>cvctype.3.1.3: The value '0,44' of element 'ReferensRantaPlusRantesats' is not valid.</Text> </Fel> <Fel> <Text>1957-08-1</Text> </Fel> <Fel> <Text>cvc-datatype-valid.1.2.1: '1957-08-1' is not a valid value for 'date'.</Text> </Fel> <Fel> <Text>cvc-type.3.1.3: The value '1957-081' of element 'Forfallodag' is not valid.</Text> </Fel> </Avvisad> </Aterkoppling> 4.3 Felmeddelanden Felmeddelanden som kan skickas tillbaka är: Om schemavalideringen går fel så skickas ett felmeddelande med information om valideringsfelen. Felmeddelande om löpnummerkontrollen går fel. Felmeddelande om summeringskontrollen går fel. Felmeddelande om ”10-modulmetoden” går fel vid kontroller av värdet i Person/-organisationsnummer. Felmeddelande om obligatorisk uppgift i fältet Skuldid saknas, har fler än 40 tecken eller har värdet ”null”. Samt detaljerad felinfo om infilen inte följer schemat exakt. 5 Namnsättning filer Transaktionsfilens namn sätts enligt nedan i syfte att tydligt identifiera avsändande/mottagande ombud och vilket innehåll filen har. Fil Transaktionsfil Filnamn XXX.FORDRINGSANMALAN 13(13) TEKNISK BESKRIVNING Verksamhetsomr. 3 ledning/kansli Datum 2015-05-11 Kvittensfil kgmb007x1_<XXX>_<ÅÅÅMMDDTTMM> XXX ersätts med ombudskoden för det ombud som skapar filen. Ombudskoden ska anges med versaler. ÅÅÅMMDDTTMM ersätts av datum och tid då transaktionsfilen överfördes. Exempel: ” kgmb007x1_XXX_201502051212”.
© Copyright 2024