Teknisk beskrivning fordringsanmälningar för

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”.