Slóðin á vefþjónustuna er: https://vefur.rsk.is/ws/stadgreidslafts/skilagrein.svc
Slóð á prófunarvefþjónustu er: https://vefurp.rsk.is/ws/stadgreidslafts/skilagrein.svc

Þegar kallað er á vefþjónustuaðgerð skal ýmist hafa auðkenningu í haus skeytisins (Soap Header) eða í færibreytu (parameter).  Auðkenningin samanstendur af kennitölu greiðanda, veflykli og útgáfustreng kerfis. Sendingu er strax hafnað ef veflykill á ekki við kennitölu sendanda eða ef útgáfustrengur forrits finnst ekki.

Til þess að geta notað vefþjónustuna þarf hlutaðeigandi hugbúnaðarhús/hugbúnaðardeild að hafa kerfisheiti sem búið er til í samráði við hlutaðeigandi hugbúnaðarhús.

Ríkisskattstjóri hefur sett upp prófunarumhverfi fyrir þá sem vilja nýta sér það.  Þá þarf hlutaðeigandi hugbúnaðarhús/hugbúnaðardeild að hafa veflykil og kerfisheiti. RSK sér um að búa til og úthluta veflyklum en kerfisheiti er búið til í samráði við hlutaðeigandi hugbúnaðarhús. Til þess að fá veflykil og kerfisheiti skal hafa samband við hugbunadur@skatturinn.is.

Boðið er upp á eftirtaldar aðgerðir í vefþjónustunni:

Almennar villuprófanir eru í sérstöku sniði:

Lýsing villuprófana í mæltu máli.
XML snið fyrir villuprófanir.

Send er auðkenning ásamt  XML skjali samkvæmt sniði FtsSkilagrein sem inniheldur skilagrein með fjármagnstekjum sundurliðuðum á móttakendur, tegund og númer.

 Ef auðkenning er í lagi er XML skjalið vistað og vefþjónustan skilar svari samkvæmt sniði FtsSkilagreinSvar.  Skilað er stuttu svari sem inniheldur meðal annars númer og stöðu sendingar. Þá er aðgerðin FaStodu notuð til að sækja upplýsingar um nýja stöðu ásamt niðurstöðu. Ef sendingin stenst villuprófun fer fram úrvinnsla á upplýsingunum og þær vistaðar í gagnagrunni. Að því loknu er stofnuð krafa hjá RB og búin til kvittun fyrir móttöku.

Staða sendingar getur innihaldið eftirtalin gildi:

Móttekið:           Sending hefur verið móttekin.
Í vinnslu.             Sending er í vinnslu.
Lokið.                  Vinnslu lokið.
Hafnað.               Sendingu hafnað.

 XML skjalið sem er sent í vefþjónustuna inniheldur yfirkaflann Greiðandi, hann inniheldur undirkaflana Vidtakandi og Samtolur. Undirkaflinn Vidtakandi inniheldur stakið Kennitala og undirkaflann Fjarmagnstekjur.

XML snið fyrir skilagrein:                FtsSkilagrein
XML snið fyrir svar:                        FtsSkilagreinSvar

Dæmi um XML fyrir skilagrein.
Dæmi um stutt svar.
Dæmi um langt svar.

 Þegar kallað er á aðgerðina skal tilgreina eftirtaldar færibreytur:

Yfirkafli: Greiðandi

Undirkafli: Fjarmagnstekjur

  Eftirtaldar samsetningar á tegund og undirtegund eru leyfðar:

Undirkafli: Samtolur

 Lýsing á svarinu frá vefþjónustuaðgerðinni er í kaflanum Svar frá SendaSkilagrein og FaStodu.

Dæmi um kall á vefþjónustuaðgerðina:

string KennitalaGreidanda = kennitolur[numer];
string Veflykill = "xxxx";
string ForritUtgafa = "RskKerfi V.1";
string Tekjuar = "2013";
int Timabil = 2;

string Adgerd = "nýskrá";
long NumerSendingar = 0;

Stream result = proxy.SendaSkilagrein(Adgerd, ForritUtgafa, KennitalaGreidanda, null, NumerSendingar,
                                                             Tekjuar,Timabil ,Veflykill, inputStream);

Þessi aðgerð er notuð til að fá upplýsingar um stöðu sendingarinnar. Hún skilar svari sem er ýmist stutt eða langt. Ef engar villur eru í vinnslunni og henni hefur lokið eðlilega eru upplýsingar um kröfu til RB ásamt kvittun fyrir móttöku í svarinu.

XML snið fyrir svar:                        FtsSkilagreinSvar

Dæmi um stutt svar.
Dæmi um langt svar.

 Í haus (Soap Header) sendingarinnar skal tilgreina eftirtalin atriði:

Lýsing á svarinu frá vefþjónustuaðgerðinni er í kaflanum Svar frá SendaSkilagrein og FaStodu.

Vefþjónustuaðgerðin SendaSkilagrein skilar alltaf stuttu svari sem inniheldur einungis kaflann Svar með stöðunni Móttekið. Aðgerðin FaStodu skilar löngu svari ef vinnslan er villulaus og hefur lokið eðlilega. XML skjalið með langa svarinu svari inniheldur undirkaflana Svar og Nidurstada. Ef villur eru í sendingunni kemur listi með þeim í stakinu Villubod í svarkaflanum.

XML snið fyrir svar:                        FtsSkilagreinSvar

Dæmi um stutt svar.
Dæmi um langt svar.

 Undirkafli: Svar

Undirkafli: Nidurstada

Kaflinn inniheldur þrjá undirkafla Samtolur, Krafa og PdfKvittun. 

 Kaflinn Samtölur inniheldur undirkaflann Samtals sem inniheldur samtölur sendingarinnar sundurliðaðar eftir tegund.

Kaflinn krafa inniheldur villuboð vegna stofnunar kröfu ásamt bool svæðinu KrafaStofnud. Þegar svæðið KrafaStofnud er false innihalda villuboðin skýringu sem segir til um ástæðuna. Önnur svæði skýra sig sjálf og eru til staðar hvort sem tekist hefur að stofna kröfuna eða ekki.

 Að lokum kemur stakið PdfKvittun en það inniheldur kvittun fyrir móttöku í PDF formi.

Aðgerðin tekur auðkenningu og tekjuári og skilar svari samkvæm XML sniði FtsYfirlitSvar.

XML snið fyrir svar:                        FtsYfirlitSvar

 Í haus (Soap Header) sendingarinnar skal tilgreina eftirtalin atriði:

Aðgerðin tekur auðkenningu og skilar svari samkvæm XML sniði FtsTegundirSvar.

XML snið fyrir svar:                        FtsTegundirSvar

Í haus (Soap Header) sendingarinnar skal tilgreina eftirtalin atriði:

Aðgerðin tekur auðkenningu og ártali og skilar svari samkvæm XML sniði FtsTimabilSvar.

XML snið fyrir svar:                        FtsTimabilSvar

Í haus (Soap Header) sendingarinnar skal tilgreina eftirtalin atriði:

Kallað er á aðgerðina með kennitölu og veflykli. Skilað er villuboðum ef veflykill er rangur eða ef aðili er ekki skilaskyldur í fjármagnstekjuskatti.

Annars skilar vefþjónustan XML skjali með lista með kennitölum og nöfnum þeirra aðila sem eru undanþegnir fjármagnstekjuskatti samkvæmt lögum nr. 94/1996. Í wsdl vefþjónustunnar má finna svæðisheitin og hvernig viðföng hennar eru uppbyggð.

Þessari fyrirspurn var breytt 3.6.2022 þannig að nú þarf að tilgreina það tímabil sem verið er að vinna með. Þetta skal vera sama tímabil og verið er að skila. Tilgreina þarf tvö svæði:
Tekjuar
Timabil (ársfjórðungur 1 til 4)