{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"de40e0a3-b510-4ff0-a770-a8d2e9709937","name":"PayPremium AlgosWebServiceWcf - pilna integracijos dokumentacija","description":"# PayPremium AlgosWebServiceWcf integracijos vadovas\n\nŠi viena Postman kolekcija yra ir vykdomų užklausų rinkinys, ir pilna integracijos dokumentacija. Ji parengta pagal aktyvią WCF serviso sutartį bei realizaciją ir apima visus 86 metodus. API galimybių versija – 13. Atskiro environment ar PDF failo nereikia.\n\n## 22 versijos papildymas\n- Atsakyme greta `registruota` ir `registras` grąžinamas ir `irasai` (API 22): kiekvienam įrašui `id`, `metodas`, `veiksmas` (`sukurti`, `keisti`, `trinti`), `santrauka`, `busena` (`laukia`) ir `duomenys` – užregistruota užklausa kaip JSON objektas.\n- Kas nutiko su įrašu, matyti per `GetApiRegistras` (API 22): filtrai `id` (vienas ar keli, per kablelį) arba `dataNuo`/`dataIki` (registravimo data, imtinai), neprivalomas `busena` (`laukia`, `ikelta`, `klaida`, `atmesta`, `vykdoma`). Grąžina tuos pačius laukus ir `gauta` (užregistruota), `busena`, `klaida`, `ikele` (PayPremium naudotojas), `ikelta` (data ir laikas), `rezultatas` (sukurto įrašo kodas, pvz. naujų atostogų). Taikoma naudotojo leidžiamų metodų patikra.\n\n## 21 versijos papildymas\n- Ilgesnė nei 20 simbolių `Grafikas`, `SIST_GRAF` ar `Rezimas` reikšmė (API 21) laikoma grafiko pavadinimu: grafikas ieškomas pagal pavadinimą (nepaisant raidžių dydžio ir išorinių tarpų) tarp to paties tipo grafikų. Rastas vienas – naudojamas jo kodas; keli – klaida „Grafikų su pavadinimu … yra keli (kodai …) – nurodykite kodą“; rastas tik kito tipo – klaida „netinkamo tipo“. Nerastas sukuriamas kodu `WDG0000001`, `WDG0000002`…, pavadinimu – atsiųstas tekstas (iki 200 simbolių, ilgesnis – klaida); `SIST_GRAF` savaitės valandos imamos iš teksto pradžios `xxxVAL_`, kaip ir kodo. Pakartotinai siunčiant tą patį tekstą randamas jau sukurtas grafikas, dublikatas nekuriamas. Reikšmės iki 20 simbolių veikia kaip anksčiau.\n\n## 20 versijos papildymas\n- Naudotojui galima nurodyti leidžiamų API metodų sąrašą (programoje: „Programos vartotojai“ → vartotojo kortelė → „API metodai...“). Neleistinas metodas grąžina klaidą `Metodas 'X' naudotojui 'Y' neleidžiamas` (HTTP 400) ir nieko nevykdo, taip pat neįrašo į API įvykių registrą. Tuščias sąrašas – leidžiami visi metodai, kaip iki šiol. `GetVersion` leidžiamas visada.\n- Sugriežtintas API prisijungimo tikrinimas.\n\n## 19 versijos papildymas\n- Nauja neprivaloma antraštė `AutoCreateKlasifikatoriai` (`true`/`1`, `false`/`0`; nepateikta – `false`) įjungia trūkstamų struktūrinių vienetų ir pareigų kūrimą `InsertDarbuotojas` ir `UpdateSutartis` metoduose. Ankstesnė antraštė `AutoCreateStrukturinisVienetas` priimama kaip sinonimas; abi su skirtingomis reikšmėmis – klaida.\n- `UpdateSutartis` su šia antrašte sukuria nerastas `Prg_Kod` ir `Str_Vnt_Prg_Kod` pareigas (kodas `WD…`, pastaba „Workday“) ir nerastą `sStrVnt` vienetą; be jos – klaida, kaip anksčiau.\n- `InsertDarbuotojas`: `Prg_Kod` pareigos kuriamos visada, kaip iki šiol; nerastos `Str_Vnt_Prg_Kod` pareigos su antrašte sukuriamos, be jos grąžinama klaida (anksčiau sutartis tyliai įrašoma be pareigų).\n\n## 18 versijos papildymas\n- Darbuotoją galima nurodyti tabelio nr., kai jo kodas nepateiktas: `UpdateDarbuotojas` (`TAB_NR`), `InsertKintamiejiValues`, `UpdateKintamiejiValues`, `DeleteKintamiejiValues`, `AddKintamiejiValuesAmount` (`tabelioNr`) ir nedarbingumo bei komandiruočių `Insert…`, `Update…`, `Delete…` (`tabelioNr`). Taip pat `PridetiDarbuotojaIGrupe`, `PasalintiDarbuotojaIsGrupes` ir vaikų metodai (`tabelioNr` vietoj `ZMN_KOD`). Sutarties metodai `UpdateSutartis`, `EndSutartis`, `UpdateNPD`, `UpdateDisabilityPercent`, `InsertAvansas` ir atostogų, neapmokamų laikotarpių bei veiklų `Insert…`, `Update…`, `Delete…` priima `tabelioNr` vietoj sutarties kodo, kai darbuotojas turi vienintelę sutartį. Pateiktas kodas visada pirmesnis; turi būti lygiai vienas darbuotojas su tuo tabelio nr. Esamos užklausos su kodu veikia kaip anksčiau.\n\n## 16 versijos papildymas\n- Pridėtas `AddKintamiejiValuesAmount`: suma pridedama prie kintamojo mėnesio reikšmės pagal integracijos `unikalusId`, tas pats ID - tik vieną kartą. Negavus atsakymo kartokite tą pačią užklausą su tais pačiais ID. `GetKintamiejiValues` grąžina `pridetaSuma` ir `pridetuKiekis`.\n\n## 15 versijos papildymas\n- Pridėti įvykių metodai: `InsertAtostogos`, `UpdateAtostogos`, `DeleteAtostogos`, `InsertLigonlapis`, `UpdateLigonlapis`, `DeleteLigonlapis`, `InsertNeapmokamasLaikotarpis`, `UpdateNeapmokamasLaikotarpis`, `DeleteNeapmokamasLaikotarpis`, `InsertKomandiruote`, `UpdateKomandiruote`, `DeleteKomandiruote`, `InsertVeikla`, `UpdateVeikla`, `DeleteVeikla`. Laukai tokie pat kaip atitinkamų `Get…` metodų atsakymuose; įvykiai įrašomi programos logika ir perskaičiuoja tabelį. Kai vyksta skaičiavimas, jie, kaip ir kiti rašymo metodai, eina per API įvykių registrą.\n\n## 14 versijos papildymas\n- Pridėtas `GetDuomenuBazes`: duomenų bazės (įmonės), su kuriomis integracinis vartotojas gali dirbti, ir jų `DatabaseName` reikšmės.\n\n## 13 versijos papildymas\n- Pridėti `GetKintamiejiValues`, `UpdateKintamiejiValues` ir `DeleteKintamiejiValues`: kintamųjų reikšmių skaitymas, keitimas ir trynimas pagal įrašo `id` (su `priskirta`) arba raktą kintamasis + `dataNuo` + savininkas (darbuotojas, sutartis, struktūrinis vienetas). `InsertKintamiejiValues` atsakyme grąžina `id`.\n\n## 12 versijos papildymas\n- Pridėtas `InsertKintamiejiValues`: naujų skaitinių kintamųjų reikšmių įrašymas pagal darbuotojo kodą. Reikšmė priskiriama pradžios dieną galiojančiai sutarčiai (jei ji viena) arba darbuotojui; uždaryti mėnesiai ir užimti laikotarpiai nekeičiami, visa užklausa įrašoma vienoje transakcijoje.\n\n## 11 versijos papildymas\n- Pridėtas `GetSuminesApskaitosInformacija`, grąžinantis konkrečios sutarties suminės darbo laiko apskaitos mėnesių išklotinę ir iki pateikto mėnesio sukauptą viršvalandžių bei prastovų rezultatą.\n- Rezultate atskirai parodoma būklė prieš ir po pravaikštų įtakos, o `palyginimoKodas` tiksliai nurodo, kurie dydžiai buvo lyginami.\n\n## 10 versijos integraciniai papildymai\n- `InsertDarbuotojas` papildytas `SWIFT`, `GRUPE`, `SIST_GRAF` ir `USE_NPD` laukais bei naujo darbuotojo banko, rezidavimo, pareigų ir grafikų automatika.\n- Pridėti `InsertStrukturiniaiVienetai` ir `UpdateStrukturiniaiVienetai`.\n- Pridėti `PridetiDarbuotojaIGrupe` ir `PasalintiDarbuotojaIsGrupes`.\n- `GetStrukturiniaiVienetai` atsakymas papildytas `strLygTip`, `openFrom` ir `papInfo`.\n\n## API įvykių registras skaičiavimo metu\nKai įmonė naudoja API įvykių registrą ir PayPremium pažymėta „Vyksta skaičiavimas“, šie metodai duomenų iškart nekeičia: `InsertKintamiejiValues`, `UpdateKintamiejiValues`, `DeleteKintamiejiValues`, `InsertPrasymas`, `DeletePrasymas`, `InsertIsakymas`, `DeleteIsakymas`, `InsertAvansas`, `UpdateSutartis`, `UpdateNPD`, `UpdateDisabilityPercent` ir 15 versijos įvykių metodai.\n- Kiekviena užklausos eilutė įrašoma į registrą. Atsakymas: `{\"code\": 200, \"data\": {\"registruota\": true, \"registras\": [15, 16]}, \"message\": \"...\"}`, kur `registras` – registro įrašų numeriai.\n- Tokiame atsakyme sukurtų įrašų `id` negrąžinami. Įrašus įkelia PayPremium naudotojas; jų `id` gaunami vėliau per atitinkamus `Get…` metodus.\n- Kol vyksta skaičiavimas, `EndSutartis` su atleidimo data skaičiuojamame ar ankstesniame mėnesyje atmetamas su klaida; vėlesnė data leidžiama.\n- Naudojant registrą, `UpdateSutartis` neleidžia priskirti kito struktūrinio vieneto nuo datos, ankstesnės už einamojo mėnesio pradžią.\n- Kiti metodai, tarp jų `InsertTabeliai` ir `InsertGrafikai`, veikia kaip anksčiau.\n\n## Greita pradžia\n1. Importuokite šį JSON į Postman.\n2. Kolekcijos **Variables** užpildykite: domain, username, password ir databasename. domain nurodykite be paskutinio pasvirojo brūkšnio, pvz. http://serveris:7878/AlgosWebService.svc.\n3. Paleiskite **GetVersion**. Šis metodas nereikalauja autentifikacijos ir 13 versijos serveryje turi grąžinti `13`.\n4. Paleiskite mažos rizikos skaitymo užklausą, pvz. **GetDarbuotojai**, su sampleEmployeeCode filtru.\n5. Tik testinėje aplinkoje, sąmoningai leisdami pakeitimus, nustatykite allowWrites=true. Pagal nutylėjimą visi duomenis keičiantys metodai sustabdomi prieš išsiunčiant užklausą.\n\n## Esamos bendrinamos Postman kolekcijos atnaujinimas\nJei kolekcija jau bendrinama komandai, jos netrinkite ir neimportuokite šio failo vietoje jos. Saugiausias komandinis kelias: sukurkite esamos kolekcijos fork, pakeitimus atlikite fork kopijoje ir sujunkite juos per Postman pull request. Paprastesnis vieno metodo atnaujinimas: importuokite šį JSON kaip laikiną atskirą kolekciją, į esamą bendrinamą kolekciją nukopijuokite tik GetSuminesApskaitosInformacija, o esamame GetVersion ir kolekcijos Overview pakeiskite versiją į 11. Taip išlieka bendrinamos kolekcijos ID, nuoroda ir anksčiau įkelta dokumentacija.\n\n## Autentifikacija\nServisas naudoja nestandartines HTTP antraštes UserName, Password ir DatabaseName. Antraščių vardai neskiria didžiųjų ir mažųjų raidžių. Serveris gali turėti numatytąją duomenų bazę ar techninį vartotoją, tačiau integracijai rekomenduojama visada aiškiai perduoti visas tris reikšmes. Naudokite HTTPS arba kitą apsaugotą tinklo kanalą, nes slaptažodis siunčiamas antraštėje. Šiame faile realių paslapčių nelaikykite.\n\n## Atsakymų formatas\nSąrašų metodai paprastai grąžina code, page, totalItems, nextPage, prevPage ir items. Jei page neteisingas, naudojamas 1; jei limit neteisingas ar <=0, naudojamas 1000. Rašymo metodų sėkmė paprastai yra {\"code\":200,\"data\":...}. Validavimo ar autentifikacijos klaida paprastai yra HTTP 400 ir {\"code\":400,\"message\":\"...\"}. Kai kurie istoriniai metodai grąžina verslo code 204 ar 403 nekeisdami HTTP 200 - prie jų tai pažymėta atskirai. Sąrašų atsakymo Content-Type kai kuriuose WCF diegimuose gali būti application/octet-stream; kūnas vis tiek yra UTF-8 JSON.\n\n## Datos ir laikai\nVisose API datose naudokite yyyy-MM-dd; senasis yyyy.MM.dd irgi priimamas. Visos įvedamos datos (InsertAvansas, InsertPrasymas, InsertIsakymas, vaikų, kintamųjų ir struktūrinių vienetų metodai) priimamos yyyy-MM-dd arba yyyy.MM.dd. GetAtostoguLikutis, GetAtostoguNorma, GetAtsiskaitymoLapelis, GetMamadieniai ir GetSuminesApskaitosInformacija priima yyyy.MM.dd arba yyyy-MM-dd. Tabelių ir grafikų laikas perduodamas minutėmis: laikasDiena + laikasNakti sudaro bendrą laiką.\n\n## Failai\nPDF ir kiti failai perduodami Base64 eilute be data URI prefikso. Kolekcijoje nėra realių dokumentų; BASE64_* reikšmės atsakymų pavyzdžiuose yra sutrumpintos iliustracijos. Vykdant failo įkėlimo metodą užpildykite samplePdfBase64 savo testinio PDF Base64 turiniu.\n\n## Saugus naudojimas\nVisi pavyzdžiai sintetiniai. Rašymo, būsenos keitimo ir trynimo užklausas vykdykite tik testinėje duomenų bazėje, kol integracija patikrinta. GetPavedimasInfo yra išimtis tarp GET: sėkmingas kvietimas pakeičia pavedimo būseną, todėl jam taip pat taikomas allowWrites saugiklis. Postman testai tikrina transporto ir atsakymo struktūrą, bet nepakeičia verslo rezultato patikrinimo jūsų integracijos kode.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"4173253","team":102011,"collectionId":"de40e0a3-b510-4ff0-a770-a8d2e9709937","publishedId":"2sBYAuRqvK","public":true,"publicUrl":"https://documenter-api.postman.tech/view/4173253/2sBYAuRqvK","privateUrl":"https://go.postman.co/documentation/4173253-de40e0a3-b510-4ff0-a770-a8d2e9709937","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"This Postman collection provides a complete, executable integration reference for the PayPremium AlgosWebServiceWcf API."},{"name":"title","value":"PayPremium"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-08-28T07:25:17.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"PayPremium","description":"This Postman collection provides a complete, executable integration reference for the PayPremium AlgosWebServiceWcf API."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/1dcf8166243be6437938c31937d3e50afc8baa8bd2f81f7b094db94dae141707","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBYAuRqvK"}