CSV, JSON ir XML | Pagalbos centras

Įvesk.lt sąskaitas galima eksportuoti į įvairias apskaitos sistemas naudojant konkrečiai sistemai pritaikytus eksporto formatus. Taip pat galima naudoti bendruosius eksporto formatus - CSV, JSON ir XML, kurie skirti integracijoms su kitomis sistemomis.

Šiame straipsnyje aprašomi bendrieji CSV, JSON ir XML eksporto formatai, jų struktūra ir perduodami duomenys.

Kokiais formatais galima eksportuoti sąskaitas?

Įvesk.lt palaiko šiuos sąskaitų eksporto formatus:

CSV - tekstinis failas su sąskaitų duomenimis.
JSON - sąskaitų duomenys JSON formatu.
XML - sąskaitų duomenys XML formatu.

XML eksportas

Sąskaitas galite eksportuoti XML formatu.

XML schemą ir jos aprašymą rasite čia: XML eksporto schema

Svarbu: XML schema ateityje gali būti išplėsta taip, kad esamos integracijos ir toliau veiktų.

JSON eksportas

Sąskaitas galite eksportuoti JSON formatu.

JSON schemą ir jos aprašymą rasite čia: JSON eksporto schema

Svarbu: JSON schema ateityje gali būti išplėsta taip, kad esamos integracijos ir toliau veiktų.

CSV eksporto struktūra

Jei naudojate CSV eksportą iš Įvesk.lt į apskaitos sistemą, atkreipkite dėmesį į šias CSV failo taisykles:

Failai eksportuojami UTF-8 koduote.
Pirmoje eilutėje pateikiami stulpelių pavadinimai.
Stulpeliai atskiriami kableliu ,.
Jei duomenyse yra kablelis, tokia reikšmė pateikiama dvigubose kabutėse ".
Pirkimo ir pardavimo sąskaitos eksportuojamos į atskirus CSV failus, tačiau jų struktūra yra vienoda.

Kokie laukai eksportuojami į CSV?

Dokumento informacija

id - Įvesk.lt dokumento identifikatorius. UUID formatas. Privalomas.
date - dokumento data. Formatas YYYY-MM-DD. Privalomas.
duedate - apmokėjimo data. Formatas YYYY-MM-DD.
paymentterm - apmokėjimo terminas dienomis.
operationdate - sąskaitos įtraukimo į apskaitą data. Privalomas.
docnum - dokumento numeris. Privalomas.
ordernum - užsakymo numeris.
parentid - Įvesk.lt paketo, iš kurio atsirado dokumentas, identifikatorius. UUID formatas.
doctype - dokumento tipas: invoice, duplicate, package arba rejected.
hasreceipt - nurodo, ar dokumentas yra su čekiu.

Sumos ir PVM informacija

subtotal - eilutės suma be PVM. Formatas 999.99. Privalomas.
vat - eilutės PVM suma. Formatas 999.99. Privalomas.
vatpercent - PVM procentas.
total - eilutės suma su PVM. Formatas 999.99. Privalomas.
currency - dokumento valiuta. Privalomas.
vatclass - PVM klasifikatorius, pvz., PVM1, PVM2 ir kt.
report2isaf - nurodo, ar sąskaita turi būti raportuojama į i.SAF. Privalomas.
separatevat - nurodo, ar PVM suma turi būti išskiriama. Privalomas.

Apskaitos informacija

code - išlaidų / pajamų paskirstymo kodas arba buhalterinė sąskaita.
name - išlaidų / pajamų paskirstymo kodo arba buhalterinė sąskaitos pavadinimas.
warehouse - sandėlis arba padalinys.

Pardavėjo informacija

sellerid - pardavėjo ID apskaitos programoje. Privalomas.
sellercode - pardavėjo kodas. Privalomas.
sellervat - pardavėjo PVM kodas.
sellername - pardavėjo pavadinimas. Privalomas.
selleraddress - pardavėjo adresas.
sellerisperson - nurodo, ar pardavėjas yra fizinis asmuo.
sellercountry - pardavėjo šalis. Naudojamas ISO Alpha-2 šalies kodas. Privalomas.
selleriban - pardavėjo banko sąskaita. IBAN formatas.

Pirkėjo informacija

buyerid - pirkėjo ID apskaitos programoje. Privalomas.
buyercode - pirkėjo kodas. Privalomas.
buyervat - pirkėjo PVM kodas.
buyername - pirkėjo pavadinimas. Privalomas.
buyeraddress - pirkėjo adresas.
buyerisperson - nurodo, ar pirkėjas yra fizinis asmuo. Reikšmė 1 arba tuščia.
buyercountry - pirkėjo šalis. Naudojamas ISO Alpha-2 šalies kodas.

Failo ir dokumento apdorojimo informacija

url - nuoroda į originalų PDF failą Įvesk.lt sistemoje. Privalomas.
filename - į Įvesk.lt įkelto failo pavadinimas. Privalomas.
created - dokumento įkėlimo į Įvesk.lt data ir laikas.
digitizedat - dokumento suskaitmeninimo data ir laikas.
error – dokumento atmetimo priežastis.

Pvz:

id,date,duedate,paymentterm,operationdate,docnum,ordernum,subtotal,vat,vatpercent,code,name,vatclass,total,currency,warehouse,url,filename,report2isaf,separatevat,sellerid,sellercode,sellervat,sellername,selleraddress,sellerisperson,sellercountry,selleriban,buyerid,buyercode,buyervat,buyername,buyeraddress,buyerisperson,buyercountry,parentid,doctype,hasreceipt,created,digitizedat,error
041f64e9-5bba-4444-b55f-bda7fab6bad9-c,2021-03-28,2021-04-15,18,2021-03-28,MBD8410001,ORD75995,1800,336,21,6301,6301,PVM1,1936,EUR,,https://app.ivesk.lt/public/041f64e9-5bba-4444-b55f-bda7fab6bad9-c,Test.pdf,1,1,304503308,304503308,LT100011640818,"Įvesk, MB","Vilnius, Pagrandos g. 7C",,lt,LT277044060008153723,302320404,302320404,LT100004603018,"Dycode, UAB","Vilniaus r. sav., Avižienių sen., Gilužių k., Gilužio g. 29",,lt,041f64e9-5bba-4c8d-b55f-bda7fab6bad9,invoice,,2021-04-14T05:17:52.001Z,2021-04-14T05:26:01.140Z,
041f64e9-5bba-4444-b55f-bda7fab6bad9-c,2021-03-28,2021-04-15,18,2021-03-28,MBD8410001,ORD75995,1800,0,0,6000,6000,PVM1,200,EUR,,https://app.ivesk.lt/public/041f64e9-5bba-4444-b55f-bda7fab6bad9-c,Test.pdf,1,1,304503308,304503308,LT100011640818,"Įvesk, MB","Vilnius, Pagrandos g. 7C",,lt,LT277044060008153723,302320404,302320404,LT100004603018,"Dycode, UAB","Vilniaus r. sav., Avižienių sen., Gilužių k., Gilužio g. 29",,lt,041f64e9-5bba-4c8d-b55f-bda7fab6bad9,invoice,,2021-04-14T05:17:52.001Z,2021-04-14T05:26:01.140Z,
be6ac5cb-4887-5555-ba01-9dbfef29a268,2021-03-31,2020-04-15,,2021-03-31,MBD8410017,ORD74999,1800,16.8,21,6208,6208,,96.8,EUR,,https://app.ivesk.lt/public/be6ac5cb-4887-5555-ba01-9dbfef29a268,Test.pdf,1,1,304503308,304503308,LT100011640818,"Įvesk, MB","Vilnius, Pagrandos g. 7C",,lt,LT277044060008153723,302320404,302320404,LT100004603018,"Dycode, UAB","Vilniaus r. sav., Avižienių sen., Gilužių k., Gilužio g. 29",,lt,,invoice,,2021-05-19T10:23:50.001Z,2021-05-19T16:30:19.830Z,