Fordringsanmälan skuldsanering

Transkript

1 Verksamhetsomr. 1 ledning/kansli 1(13) Fordringsanmälan skuldsanering Teknisk beskrivning Utgåva E-postadress: kronofogdemyndigheten@kronofogden.se Postadress Besöksadress Telefon Telefax Box 1050 Esplanaden SUNDBYBERG SUNDBYBERG

2 2(13) Innehållsförteckning 1 VERSIONSHISTORIK INTRODUKTION Om dokumentet Om tjänsten FILENS STRUKTUR Översikt Format och typer för element FilinformationTYPE Ingivare FordringsanmalanTYPE BorgenarTYPE AdressTYPE SkuldTYPE FakturaUnderlagTYPE StalldSakerhetTYPE TidigareSkuldTYPE SkuldBorgensmanTYPE SkuldSolidarTYPE SkuldHuvudgaldenarTYPE PersonOrganisationsnummerTYPE KONTROLL OCH KVITTENS Kvittens av godkänd transaktionsfil Återrapportering av underkänd transaktionsfil Felmeddelanden NAMNSÄTTNING FILER... 12

3 3(13) 1 Versionshistorik Version Ändring Första utgåva Uppdaterat kap 4 och Publicerat dokument Uppdaterat ränteuppgift i Uppdaterat kontroll av obligatorisk uppgift skuldid kap 4 och 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 4(13) 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 5(13) De streckade linjerna i bilderna ovan anger vilka element som är icke obligatoriska. De heldragna linjerna anger att elementen är obligatoriska.

6 6(13) 3.2 Format och typer för element Här är en beskrivning av typer och element i XML filen FilinformationTYPE Lopnummer xs:string J Filens löpnummer för sökande/ombud Tidpunkt xs:datetime J och tid för när meddelandet skapades AntalHandlingar xs:int J Summering inlämnade fordringar i filen SummaBelopp xs:decimal J Summering av samtliga belopp i filen Filombud xs:string J Intressent-id för filombud som kommunicerar filer Ingivare IntressentId xs:string J Kod (ombudskod) PersonOrganisationsNummer PersonOrganisationsnummerTYPE J 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. Galdenar. PersonOrganisationsnummerTYPE J Typ för Person- PersonOrganisationsNummer /organisationsnummer Galdenar.NamnGaldenar xs:string J Namn på gäldenär Galdenar.Inledande xs:date N för beslut om inledande av skuldsanering BorgenarLista En lista med 1 * borgenärer av typen BorgenarTYPE J

7 7(13) BorgenarTYPE PersonOrganisationsNummer PersonOrganisationsnummerTYPE N Person- /organisationsnummer Namn xs:string N Namn på borgenär Adress AdressTYPE N Typ för adress SkuldLista En lista med 1 * skulder av typen SkuldTYPE J Varje borgenär i en fordringsanmälan kan ha en till många skulder avseende gäldenären AdressTYPE Postadress xs:string N Box/Gatuadress Postnummer xs:string N Postort xs:string N Land xs:string N Anges endast om annat land än Sverige SkuldTYPE SkuldId xs:string J Borgenärens skuldid/referensnummer Kapitalbelopp xs:decimal J BegartUndantagetBelopp xs:decimal N UpplupenRanta xs:decimal J Beräknad ränta fram till dagen för inledandebeslutet OvrigaKostnader xs:decimal N Administrativa kostnader, inkassokostnader, m.m. Avgifter xs:decimal N Kostnad för ansökan om betalningsförläggande, m.m. Totalskuld xs:decimal J Summa kapital,

8 8(13) upplupen ränta, övriga kostander och avgifter RantaEnligtRantelagen xs:string N Ränta enligt 6 räntelagen Referensränta + 8 % enligt 6 räntelagen. Giltiga värden är J eller N. AvtaladRanta xs:decimal N Avtalad ränta. Gällande räntesats/år för kapitalfordran. FordranUppkom xs:date N Dag då fordran uppkom. GrundForFordran xs:string N Fritext grunden för fordringen, vad avser skulden. SkuldBorgensman SkuldBorgensmanTYPE N SkuldSolidar SkuldSolidarTYPE N SkuldHuvudgaldenar SkuldHuvudgaldenarTYPE N Huvudgäldenär = Skuld där gäldenären är borgensman för annans skuld FakturaUnderlagLista En lista med 0 * skulder N av typen FakturaUnderlagTYPE StalldSakerhet StalldSakerhetTYPE N TidigareSkuld TidigareSkuldTYPE N FakturaUnderlagTYPE Fakturanummer xs:string J Fakturadatum xs:date N Forfallodag xs:date N StalldSakerhetTYPE Sakerhet xs:string N Uppgift om säkerheten, tex fastighetsbeteckning och kommun

9 9(13) TidigareSkuldTYPE TidigareSkuldId xs:string N Tidigare skuldid/referensnummer (t ex vid överlåten fordran). TidigareBorgenarensNamn xs:string N Om fordran överlåtits, ange uppgift om tidigare skuldid och/eller tidigare borgenärs namn SkuldBorgensmanTYPE PersOrgNummer PersonOrganisationsnummerTYPE J BorgenarensNamn xs:string N SkuldSolidarTYPE PersOrgNummer PersonOrganisationsnummerTYPE J SolidarNamn xs:string N SkuldHuvudgaldenarTYPE PersOrgNummer PersonOrganisationsnummerTYPE J HuvudgaldenarNamn xs:string N PersonOrganisationsnummerTYPE xs:string Regel: Ska vara 12 siffror och följa reguljära uttrycket: (1[6-9] 20)[0-9]{10} N

10 10(13) 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 o Löpnummer; Uppgiften Löpnummer i filen. Tidpunkt; Uppgiften Tidpunkt i filen Uppgifter om Person-/organisationsnummer enligt 10-modulmetoden. Summeringskontroll av fil: o o Antal fordringsanmälningar ska motsvara antal handlingar. 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-dcc b4- d1306c (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 " standalone="yes"?> <Aterkoppling xmlns=" <FilIdentitet>1ea99ef8-dcc b4-d1306c986349</FilIdentitet>

11 11(13) <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 " standalone="yes"?> <Aterkoppling xmlns=" <FilIdentitet>4b9ac94f-c b8b5-1acca5e9c2d3</FilIdentitet> <FilLopnummer>0</FilLopnummer> <Avvisad> <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> <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> </Avvisad> </Aterkoppling> Exempel med löpnummer schemavalideringsfel <?xml version="1.0" encoding="iso " standalone="yes"?> <Aterkoppling xmlns=" <FilIdentitet> c adfe-7455e92145fa</FilIdentitet> <FilLopnummer>0</FilLopnummer> <Avvisad>

12 12(13) <Text>cvc-datatype-valid.1.2.1: '0,44' is not a valid value for 'decimal'.</text> <Text>cvctype.3.1.3: The value '0,44' of element 'ReferensRantaPlusRantesats' is not valid.</text> <Text> </Text> <Text>cvc-datatype-valid.1.2.1: ' ' is not a valid value for 'date'.</text> <Text>cvc-type.3.1.3: The value ' ' of element 'Forfallodag' is not valid.</text> </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(13) 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_