JARS API

JARS Apskaita turi viešą REST API, leidžiantį integruoti sistemą su išorinėmis programomis — el. parduotuvėmis, atsargų valdymo įrankiais, banko jungtimis, klientų portalais, BI ataskaitomis ir t.t.

Autentifikacija

Visos API užklausos autentifikuojamos per API raktus — kiekvienas raktas susietas su konkrečia įmone ir suteikia tokias pat teises kaip jį sukūręs naudotojas.

Raktas perduodamas Authorization antraštėje:

Authorization: Bearer jars_sk_xxxxxxxx...

Sėkmingo iškvietimo metu atnaujinamas rakto „Paskutinį kartą naudotas" laikas — galima stebėti, ar raktas dar naudojamas.

Raktų valdymas

Atidarykite Nustatymai → API raktai:

• „Generuoti raktą" — sukurkite naują raktą su žmogui suprantamu pavadinimu (pvz., „El. parduotuvės sinchronizacija"). Pilnas raktas rodomas tik vieną kartą — nukopijuokite jį iškart, vėliau matosi tik prefiksas.
• „Atšaukti" — nedelsiant panaikina raktą. Užklausos su atšauktu raktu grąžins 401 Unauthorized.

Vienas raktas suteikia prieigą tik prie tos įmonės, kurioje jis sukurtas. Keliems klientams ar aplinkoms naudokite atskirus raktus.

Galimybės

API apima beveik visą JARS Apskaita funkcionalumą:

• Katalogai — partneriai, prekės ir paslaugos, matavimo vienetai, PVM kodai, sąskaitų planas, operacijų šablonai, projektai, kainoraščiai.
• Dokumentai — pirkimo ir pardavimo sąskaitos faktūros (įskaitant PDF importą), rankiniai žurnalo įrašai.
• Bankas — operacijų sąrašas, išrašų importas (ISO 20022, SEB CSV), automatinis partnerių susiejimas.
• Kasa — kasos registrai, KPO / KIO / čekiai, fiskalinė i.EKA integracija.
• Ilgalaikis turtas — turto kortelės, nusidėvėjimo skaičiavimas, nurašymas.
• Darbo užmokestis — darbuotojai, neatvykimai, mėnesinis DU skaičiavimas.
• Ataskaitos — didžioji knyga, apyvartos žiniaraštis, partnerių saldai, kasos knyga, audito žurnalas.
• Administravimas — įmonės nustatymai, dokumentų numeracija, naudotojai ir rolės.

Techninės detalės

• Protokolas — HTTPS, JSON užklausos ir atsakymai.
• Operacijų patvirtinimas (post / unpost) ir audito žurnalas veikia taip pat, kaip ir per žiniatinklio sąsają.
• Pinigai grąžinami centais (Number, sveikasis), pavadinimai — JSON objektais su lt/en/ru reikšmėmis (kur taikoma).

Išsamesnė dokumentacija

Visi endpoint'ai, užklausų / atsakymų schemos ir klaidų kodai pateikiami interaktyvioje API nuorodoje: /docs/api. Ten užklausas galima iškart išbandyti su savo API raktu.

Taip pat yra oficialus TypeScript SDK: @jars-lt/jars-app-sdk.