Webservice-metodi costunits mahdollistaa kustannuspaikkojen (Kustannuspaikka-taulun) käsittelyn ePalkoissa. Metodilla voidaan hakea, lisätä, muokata ja poistaa kustannuspaikkoja. Käyttö tapahtuu HTTP-rajapinnan kautta, ja se vaatii kirjautumisen käyttäjätunnuksella ja salasanalla.
Tuetut toiminnot:
Haku (GET)
Lisäys (POST)
Päivitys (PUT)
Poisto (DELETE)
Kentät, joita käsitellään:
yritys: Yrityksen tunniste
id: Yksilöllinen tunniste
koodi: Kustannuspaikan koodi
selite: Selite suomeksi
selitese: Selite ruotsiksi
seliteen: Selite englanniksi
selitede: Selite saksaksi
selitemu: Muu selite
closed: 1 true, 0 false
teksti: Vapaamuotoinen kuvausteksti
Valinnaiset parametrit:
PRKP_Action: Toiminto (esim. get, insert, update, delete)
maxrecords: Kuinka monta tietuetta palautetaan (esim. 1000)
skiprecords: Kuinka monta tietuetta ohitetaan alusta
includeclosed: Palautetaanko suljetut kustannuspaikat (true/false)
Userid: Käyttäjän tunniste (kirjautumistietoa tai lokitusta varten)
Esimerkkejä käytöstä:
GET-metodi:
Hakee kustannuspaikat
Esimerkiksi:
GET /costunits?yritys=100&PRKP_Action=get
POST-metodi:
Lisää uuden kustannuspaikan, syötetään JSON-muotoisena
Kentät kuten
koodi,selite,seliteenyms. määritetään JSON:ssa
Vastaus sisältää:
Lista kustannuspaikoista (costunits)
Palautuksen tila: resultcomplete (1 = täydellinen)
skippedrecords: Kuinka monta ohitettu
includeclosed: Sisältyvätkö suljetut kustannuspaikat
Huomioitavaa:
Jokaisella kutsulla pitää olla oikeat tunnistautumistiedot (Basic Auth)
POST, PUT ja DELETE vaativat JSON-datan mukana
GET-kutsulla voidaan hakea kaikki kustannuspaikat ilman parametreja
Jos haluat tarkemman teknisen ohjeen esimerkkikoodeineen tai JSON-malleineen, kysy tukiportaalista tai tutustu tekniseen API-dokumentaatioon.