Skilagreinar til innheimtuaðila
Hvar skilagreinarnar til lífeyrissjóða og stéttarfélaga eru á launakeyrslunni, hvað taflan sýnir, og hvernig þú sannreynir upphæðirnar með sundurliðun og XML áður en þú sendir.
Spjaldið Skilagreinar til innheimtuaðila er fyrir neðan bankaskilin og launaseðlana, og fyrir ofan staðgreiðsluna.
Skilagreinar til innheimtuaðila

Hvað er skilagrein?
Skilagrein er rafræn XML-yfirlýsing um iðgjöld og félagsgjöld starfsmanna sem send er til hvers innheimtuaðila (lífeyrissjóðs eða stéttarfélags) fyrir tiltekið launatímabil. Í henni kemur fram hver borgaði hvað: iðgjald/félagsgjald launþegans (Greiðendur) og mótframlag/sjóðagjöld launagreiðandans (Atvinnurekandi), sundurliðað niður á hvern starfsmann og hverja tegund gjalds.
Spjaldið sem sér um þetta heitir „Skilagreinar til innheimtuaðila" og er að finna á smáatriðasíðu hverrar launakeyrslu (Laun → Launakeyrslur → keyrsla), fyrir neðan bankaskil og launaseðla í tölvupósti og fyrir ofan staðgreiðslu til RSK. Spjaldið birtist þegar keyrslan er komin af drögastigi (reiknuð, samþykkt, bókuð, send eða lokuð) og hefur launaseðla.
Forsendur
Áður en hægt er að senda skilagrein þurfa tvær forsendur að vera til staðar:
Skilagrein er aðeins send eftir að keyrslan hefur verið bókuð í bókhald (launaseðlarnir tengdir bókhaldsfærslu keyrslunnar). Á óbókaðri keyrslu birtist viðvörunin „Bókaðu launakeyrsluna fyrst", sendingarhnapparnir eru faldir og þjónninn hafnar sendingu með „Bókaðu launakeyrsluna í bókhald áður en þú sendir hana út." Þegar keyrslunni hefur verið lokað hverfa sendingarhnapparnir líka — þá er aðeins hægt að skoða.
Starfsmenn þurfa að vera tengdir lífeyrissjóði, séreignarsjóði og/eða stéttarfélagi. Fyrir þá innheimtuaðila sem krefjast auðkenningar þarf að setja inn skilríki undir Launastillingar → „Innheimtuaðilar — skilríki". Án skilríkja er ekki hægt að senda til aðila sem krefst auðkenningar. Innheimtuaðilinn þarf líka að hafa skráða vefþjónustuslóð (miðlæg stilling).
Ein skilagrein á hvern aðila
Kerfið gengur í gegnum alla starfsmenn keyrslunnar og hópar iðgjöldin eftir innheimtuaðila (starfsmaður → sjóður/félag → innheimtuaðili). Fyrir hvern aðila er mynduð sérstök skilagrein. Hver lína í töflunni er þar með einn innheimtuaðili — ekki einn starfsmaður. Sjóður sem er ekki tengdur neinum innheimtuaðila kemst ekki í skilagrein.
Dálkar töflunnar
Í spjaldinu birtist tafla með einni línu á hvern innheimtuaðila sem keyrslan snertir.
| Dálkur | Lýsing |
|---|---|
| Innheimtuaðili | Nafn sjóðsins/félagsins. Ef skilríki eða uppsetningu vantar (aðili krefst auðkenningar en engin skilríki eru sett) birtist appelsínugulur merkimiði „Vantar skilríki" undir nafninu. |
| Starfsmenn | Fjöldi starfsmanna sem greiða til aðilans í þessari keyrslu (hægri-jafnað). |
| Greiðendur | Samtala launþegahlutans — iðgjöld og félagsgjöld starfsmanna (personAmountSum), t.d. 124.500 kr. |
| Atvinnurek. | Samtala launagreiðandahlutans — mótframlag og sjóðagjöld (employerAmountSum). Inniheldur einnig sjóðagjöld sem eru reiknuð til sýnis en ekki endilega send í XML-inu. |
| Staða | Staða síðustu sendingar til aðilans, eða „Ekki sent" ef aldrei hefur verið sent. |
| Aðgerðir | Hnappar: Sundurliðun, XML, Svar (ef sent hefur verið) og Senda / Senda aftur (aðeins á bókaðri keyrslu sem er ekki lokuð). |
Stöðumerkingar
Í Staða-dálkinum sýnir litakóðaður merkimiði stöðu síðustu sendingar. Ef engin sending hefur átt sér stað stendur einfaldlega „Ekki sent". Undir stöðumerkinu birtast (ef við á) villuboð frá aðilanum og tímastimpill þegar sendingu lauk.
| Staða | Litur | Þýðing |
|---|---|---|
| Ekki sent | Grátt | Engin sending hefur enn verið gerð til þessa aðila. |
| PENDING | Grátt | Sending í biðstöðu. |
| IN_PROGRESS | Blátt | Sending í vinnslu — skilagreinin hefur verið stofnuð og verið er að senda á vefþjónustuna. |
| SUCCESS | Grænt | Innheimtuaðili staðfesti móttöku (svar með stöðunni Success eða SuccessMessage). |
| PARTIAL_SUCCESS | Appelsínugult | Sameiginleg staða sendinga í launakerfinu. Sending skilagreinar endar alltaf í SUCCESS eða FAILED, svo þessi staða kemur ekki fram hér í venjulegri notkun. |
| FAILED | Rautt | Sending mistókst eða aðilinn hafnaði skilagreininni. |
| SUPERSEDED | Grátt | Keyrslan var opnuð aftur eftir sendinguna. Sendingin er geymd til sögu en telst ekki lengur gild — senda þarf skilagreinina á ný (og bakfæra þá fyrri hjá innheimtuaðilanum). |
Aðgerð — XML (forskoðun)
Hnappurinn XML (kóða-tákn) opnar glugga sem heitir „XML — {nafn aðila}" og sýnir nákvæmlega það XML-skjal sem sent yrði til aðilans, án þess að senda nokkuð. Notaðu þetta til að skoða skilagreinina áður en hún fer af stað. Neðst er hnappurinn Loka.
XML-skjalið fylgir skema skilagrein.is (namespace http://skilagrein.is/FundPayment) og inniheldur eitt <Payment> með upplýsingum um launagreiðandann (kennitala og nafn fyrirtækis), lista af <Entry> (einn á hvern starfsmann × sjóð) og samantekt <Summaries>.
| XML-reitur | Lýsing |
|---|---|
| EntityType | Tegund gjalds/iðgjalds (L/X/F/S/O/E/H — sjá tegundir hér að neðan). |
| EntityNo | Númer sjóðsins/félagsins hjá skilagrein.is. |
| PersonSSN | Kennitala starfsmanns (án bandstriks). |
| MonthYear | Uppgjörsmánuður á forminu YYYY-MM (dregið af upphafsdegi tímabilsins). |
| PersonAmount | Iðgjald/félagsgjald starfsmannsins. |
| EmployerAmount | Mótframlag/sjóðagjöld launagreiðandans. |
| EmploymentRatio | Starfshlutfall starfsmanns (t.d. 100,00). |
Aðgerð — Senda / Senda aftur
Blái aðal-hnappurinn (flugvéla-tákn) sendir skilagreinina til viðkomandi innheimtuaðila. Textinn er „Senda" ef aldrei hefur verið sent áður, en „Senda aftur" ef fyrri sending er til. Hnappurinn birtist aðeins þegar keyrslan er bókuð og ekki lokuð.
Þegar sending tekst birtist tilkynningin „Skilagrein send"; annars birtast villuboðin frá aðilanum eða „Mistókst". Fyrsta vel heppnaða sending (skilagrein, bankaskrá eða launaseðlar) færir stöðu keyrslunnar sjálfkrafa úr „Bókað" í „Sent".
Opnaðu Sundurliðun og/eða XML og staðfestu að Greiðendur og Atvinnurekandi stemmi.
Kerfið stofnar skilagrein, sendir XML-skjalið á vefþjónustu aðilans og bíður svars (allt að 30 sekúndur).
Staðan uppfærist í SUCCESS eða FAILED. Smelltu á Svar til að skoða hráa svarið frá aðilanum og staðfesta móttöku.
Aðgerð — Senda allar
Efst í spjaldinu, hægra megin, er hnappurinn „Senda allar" sem sendir allar skilagreinir tímabilsins í einni aðgerð. Sendingarnar fara fram hver á eftir annarri (ekki samtímis) til að ofbjóða ekki vefþjónustunum. Aðilum sem þegar hafa tekið við skilagreininni (SUCCESS) er sleppt — „Senda allar" endursendir aldrei; það er gert á einni línu í einu með staðfestingu. Að lokinni keyrslu birtist samantekt á forminu „{fjöldi} sendar, {fjöldi} mistókust", með viðbótinni „, {fjöldi} þegar sendar (sleppt)" ef einhverjum var sleppt.
Þegar engin skilagrein er til, eða keyrslan er óbókuð eða lokuð, birtist í staðinn „Endurnýja" hnappur sem sækir töfluna aftur. Sé enginn starfsmaður tengdur lífeyrissjóði eða stéttarfélagi stendur einfaldlega „Engin skilagrein í þessari keyrslu (engir lífeyrissjóðir eða stéttarfélög tengd)" í stað töflunnar — þá er ekkert að senda og uppsetningu starfsmanna vantar.
Sundurliðun gjalda
Hnappurinn Sundurliðun (auga-tákn) opnar glugga sem heitir „Sundurliðun gjalda — {nafn aðila}". Þar sést læsileg útlistun á öllu því sem aðilinn fær fyrir tímabilið, flokkað eftir færslutegund (EntityType) og sjóði/félagi, með einni línu á hvern starfsmann. Efst stendur „Innheimtuaðili nr. {númer} · {fjöldi} færslutegund(ir)".
| Dálkur | Lýsing |
|---|---|
| Starfsmaður | Nafn starfsmannsins. |
| Kennitala | Kennitala starfsmannsins, formuð 6-4 með bandstriki (t.d. 010190-1239). |
| Greiðandi | Iðgjald/félagsgjald starfsmannsins (personAmount). |
| Atvinnurek. | Mótframlag/sjóðagjöld launagreiðandans (employerAmount). |
Hver flokkur (færslutegund × sjóður) er merktur með litakóðuðum tegundamerki, heiti tegundar og sjóðsheiti, og er með samtölulínu „Samtals {tegund}". Neðst í glugganum er heildarreitur með þremur summum: Greiðendur (launþegahluti), Atvinnurekandi (launagreiðandahluti) og Samtals (bæði lögð saman). Notaðu sundurliðunina til að sannreyna upphæðir áður en þú sendir.
Færslutegundir (EntityType)
Hver lína/flokkur er merkt með litakóðuðu tegundamerki sem endurspeglar tegund iðgjalds eða gjalds í XML-inu, samkvæmt skema skilagrein.is (FundPayment.xsd).
| Kóði | Litur | Merking |
|---|---|---|
| L | Blátt | Lífeyrir (sameign) — almenn lífeyrisiðgjöld. |
| X | Dökkblátt | Séreign — viðbótarlífeyrissparnaður. |
| F | Fjólublátt | Félagsgjald — stéttarfélagsgjald starfsmanns (alltaf launþegahluti; atvinnurekandahluti er 0). |
| S | Grænt | Sjúkrasjóður (launagreiðandi). |
| O | Blágrænt | Orlofsheimilasjóður (launagreiðandi). |
| E | Gyllt | Starfsmenntasjóður (launagreiðandi). |
| H | Bleikt | Félagsheimilasjóður. |
Svar frá innheimtuaðila
Þegar sent hefur verið birtist hnappurinn Svar á línu aðilans. Hann opnar hliðarglugga (drawer) sem heitir „Svar frá innheimtuaðila". Þar sést:
| Reitur | Lýsing |
|---|---|
| Staða: | Litakóðaður stöðumerkimiði sendingarinnar, ásamt HTTP-kóða (t.d. „HTTP 200") ef til. |
| Villuboð | Rauð villuskilaboð frá aðilanum ef sending mistókst eða skjali var hafnað. |
| Sent / Klárað | Tímastimplar á íslensku fyrir upphaf og lok sendingar. |
| Raw response: | Hráa svarið frá móttakanda (JSON af responsePayload) til að staðfesta móttöku eða greina höfnun. |
Villumeðhöndlun
Ef ekki tekst að sækja töfluna, XML-ið eða sundurliðunina, eða þjónninn hafnar sendingu, birtist villugluggi með skilaboðunum frá þjóninum. Lokaðu honum, lagaðu orsökina og smelltu á „Endurnýja" eða reyndu aftur.
Algengar villur og hvernig á að bregðast við:
| Villuboð / staða | Orsök | Lausn |
|---|---|---|
| Vantar skilríki | Aðili krefst auðkenningar en engin skilríki eru sett upp. | Settu inn skilríki í Launastillingum og prófaðu tenginguna. |
| Skilríki röng (HTTP 401/403) | Notandanafn/lykilorð hafnað af vefþjónustunni. | Leiðréttu skilríkin og sendu aftur. |
| Þjónustan svarar með villu (HTTP 500+) | Vefþjónusta aðilans er niðri eða skilar innri villu. | Bíddu og sendu aftur síðar. |
| Innheimtuaðili hafnaði skilagrein | Skjalinu var hafnað (t.d. BADXML/BADDATA) þrátt fyrir HTTP 200. | Lestu villutextann í svarinu, lagaðu gögnin og sendu aftur. |
| Netvilla | Sending náði ekki á vefþjónustuna (tenging/tímamörk). | Athugaðu vefþjónustu-slóð aðilans og sendu aftur. |
| Skilagrein … hefur þegar verið send fyrir þessa launakeyrslu | Aðilinn hefur þegar tekið við skilagreininni og endursending var ekki staðfest. | Sendu aðeins aftur ef þess þarf — og staðfestu þá endursendinguna. |
| Verið er að senda skilagrein til … | Önnur sending til sama aðila er í gangi. | Bíddu þar til sendingunni lýkur og endurnýjaðu töfluna. |
| Fyrri sending … kláraðist ekki og óvíst er hvort hún barst | Fyrri sending rofnaði áður en svar var skráð. | Athugaðu stöðuna hjá innheimtuaðilanum og staðfestu endursendingu ef þarf. |
| Bókaðu launakeyrsluna í bókhald áður en þú sendir hana út. | Keyrslan er óbókuð. | Bókaðu keyrsluna fyrst. |
Uppsetning innheimtuaðila og skilríkja
Lífeyrissjóðir og innheimtuaðilar eru miðlægir í kerfinu og uppfærðir frá skilagrein.is — þú þarft ekki að stofna þá sjálf/ur. Það sem hvert fyrirtæki setur upp sjálft eru skilríkin (auðkenning fyrir móttöku) undir Launastillingar → „Innheimtuaðilar — skilríki". Listinn þar sýnir aðeins þá aðila sem starfsmenn fyrirtækisins greiða til.
| Dálkur í skilríkjaskjá | Lýsing |
|---|---|
| Nr. | Innheimtunúmer aðilans (collectorNo). |
| Innheimtuaðili | Nafn og kennitala sjóðsins/félagsins. |
| Starfsmenn | Fjöldi starfsmanna sem greiða til aðilans. |
| Notandanafn | Skráð notandanafn skilríkja, eða „—". |
| Staða | T.d. „Skilríki sett — óprófuð" eða „Tenging mistókst". |
| Aðgerðir | Setja inn / Breyta skilríki, Prófa tengingu og Eyða (aðeins fyrir aðila sem krefjast auðkenningar). |
Þar sést listi yfir þá innheimtuaðila sem starfsmenn þínir greiða til, með stöðu skilríkja.
Sláðu inn notandanafn og lykilorð sem aðilinn afhenti. Lykilorðið er dulkóðað í geymslu.
Þrumu-hnappurinn „Prófa tengingu" sendir prufuskjal og staðfestir hvort skilríkin séu samþykkt (fail-closed — aðeins jákvætt svar telst í lagi).
Heimildir
Að skoða skilagreinir, XML-forskoðun og sundurliðun krefst heimildarinnar payroll:read. Að senda skilagrein (ein eða allar) krefst payroll:write. Hnapparnir Senda / Senda aftur / Senda allar ráðast af stöðu keyrslunnar (bókuð og ekki lokuð), ekki af heimildum — notandi án payroll:write sér þá en fær villu ef hann smellir.
Lokun keyrslunnar
Lokaskrefið neðst á síðunni telur skilagreinarnar sem eitt af lögbundnu skilunum: „Skilagreinar til innheimtuaðila — {sent} af {total} sendar" (með „· {fjöldi} mistókust" ef við á), eða „Enginn innheimtuaðili á við". Skrefið telst klárað þegar allir aðilar standa í SUCCESS. Ef þú reynir að loka á meðan skilagreinar eru ósendar birtist viðvörunin „Ólokin skil — viltu virkilega loka launakeyrslunni?"; þú getur valið „Hætta við og klára skilin" eða „Loka samt". Eftir lokun er ekki hægt að senda skilagreinar úr keyrslunni nema hún sé opnuð aftur, en það bakfærir bókun hennar.
