Centas API dokumentacija

Kilus klausimams susisiekti el. paštu [e-mail]

Dokumento importavimas

POST https://ws.centas.lt/v1/documents/create

Naudojama norint importuoti naują dokumentą.

Query Parameters

Name	Type	Description
rows	array	JSON masyvas, kuriame nurodytos sąskaitos eilutės
trans_id	string	Transakcijos ID (reikalingas automatiniam SF numeriui iš programos blankų)
intrs_transprusis	string	Transporto kodas (intrastatui)
intrs_pristsal	string	Pristatymo sąlygų kodas (instrastatui)
intrs_sandoris	string	Sandorio kodas (intrastatui)
intrs_apskritis	string	Apskrities kodas (intrastatui)
intrs_eusalis	string	ES šalies kodas (intrastatui)
oper_apras	string	Papildomas operacijos aprašymas
projektas	string	Projekto (kaštų centro) informacija
uzsaknr	string	Priimto užsakymo numeris
isaf	string	Naudojama, kai sąskaita neįtraukiama į I.SAF registrus
pastaba	string	Papildoma dokumento pastaba
israse_pareigos	string	Sąskaitą išrašiusio asmens pareigos
israse_asmuo	string	Sąskaitą išrašęs asmuo
sask_moketpvm	number	Buhalterinė mokėtino PVM sąskaita
sask_pirkskol	string	Buhalterinė pirkėjo skolų sąskaita
sask_pajamos	number	Buhalterinė pajamų sąskaita
kl_kodas	string	Pirkėjo kodas pardavėjo informacinėse sistemose
estipas	string	Pirkėjo ES tipas (0 - vietinis, 1 - kitas ES šalis, 2 - ne ES šalis)
email	string	Pirkėjo el. paštas
miestas	string	Pirkėjo miestas
adresas	string	Pirkėjo adresas
salis	string	Pirkėjo šalis
grupe	string	Pirkėjo grupė (jeigu priskiriamas naujas pirkėjas)
pvm_kodas	string	Pirkėjo PVM kodas
im_kodas	string	Pirkėjo įmonės (asmens) kodas
savikaina	number	Dokumento savikaina
bepvm_suma	number	Dokumento suma be PVM
pvm_suma	number	Dokumento PVM suma
apmok_iki	string	Dokumento apmokėjimo terminas
dok_num	string	Dokumento numeris. Pastaba: kai norima naudoti laisvus SF blankus, naudojama reikšmė "auto" ir būtinai pildomas laukas trans_id.
dok_suma	number	Dokumento suma
data	string	Dokumento data
token	string	API raktas, skirtas Jūsų projektui
pirkejas	string	Pirkėjo pavadinimas
asmuo_status	string
salis_kodas	string

200 Visuomet grąžinamas Response 200 atsakymas, tačiau įvykus klaidai, success parametras tampa 0. Atitinkamai, įvykus klaidai, nurodomas error parametras, kuriame detaliau nurodytas klaidos pranešimas.

{
    "success": 1,
    "document_id": "[Created document hash]"
}

JSON prekių eilučių masyvo rows reikšmės

OPTIONS

Query Parameters

Name	Type	Description
kodas	string	Prekės (paslaugos) kodas, pagal kurį vykdoma paieška
pavadinimas	string	Prekės (paslaugos) pavadinimas
matovnt	string	Prekės (paslaugos) matas
kiekis	number	Prekės (paslaugos) kiekis
kaina	number	Prekės (paslaugos) pardavimo kaina be PVM
pvmtar	number	Eilutės PVM tarifas
Mok_kodas	string	Eilutės PVM mokesčio kodas, pagal VMI klasifikatorių (I.SAF)
sask_pajamos	string	Eilutės buhalterinė pajamų sąskaita
projektas	string	Eilutės projektas

200

JSON masyvo - rows (prekių eilučių) pavyzdys:

[
  {
    "kodas": "11222",
    "pavadinimas": "Kompiuteris",
    "matovnt": "vnt.",
    "kiekis": "2",
    "kaina": "1050",
    "pvmtar": "21",
    "Mok_kodas": "12255",
    "sask_pajamos": "200",
    "projektas": "Kompiuteriai"
 },
 {
    "kodas": "11223",
    "pavadinimas": "Telefonas",
    "matovnt": "vnt.",
    "kiekis": "5",
    "kaina": "100",
    "pvmtar": "21",
    "Mok_kodas": "12255",
    "sask_pajamos": "20",
    "projektas": "Telefonai"
 }
]

Užsakymo importavimas

POST https://ws.centas.lt/v1/orders/create

Naujo užsakymo importavimas

Query Parameters

Name	Type	Description
rows	string	Užsakymo prekių eilutės JSON array formatu (specifikacija nurodyta apačioje)
token	string	API raktas, skirtas Jūsų projektui
uzsakovas	string	Užsakovo (pirkėjo) pavadinimas
miestas	string	Užsakovo (pirkėjo) miestas
adresas	string	Užsakovo (pirkėjo) adresas
tel	string	Užsakovo (pirkėjo) telefono numeris
im_kodas	string	Užsakovo (pirkėjo) įmonės kodas
pvm_kodas	string	Užsakovo (pirkėjo) PVM kodas
email	string	Užsakovo (pirkėjo) el. paštas
uzsak_data	string	Užsakymo data
vykd_data	string	Vykdymo data
pristat_data	string	Pristatymo data
apmok_data	string	Apmokėjimo data
atvyk_data	string	Atvykimo data
isvyk_data	string	Išvykimo data
uzsak_suma	number	Užsakymo suma
uzsak_num	string	Užsakymo numeris
pvm_suma	number	Užsakymo PVM suma
bepvm_suma	number	Užsakymo suma be PVM
sandelis	string	Sandėlis
pasto_kodas	string	Pašto kodas
uzsakovas_pastaba	string	Užsakovo (pirkėjo) pastaba
pirk_skolsask	string	Užsakovo (pirkėjo) skolų sąskaita

200 Visuomet grąžinamas Response 200 atsakymas, tačiau įvykus klaidai success parametras tampa su reikšme 0. Klaidos atveju taip pat pateikiamas papildomas Response parametras - error, kuriame nurodoma, kokia klaida įvyko. Sėkmingo užsakymo importavimo atveju, grąžinamas parametras order_hash, kuris yra unikalus Jūsų užsakymo pateikimo kodas, pagal kurį sistema gali atpažinti užsakymą.

{
    "success": 1,
    "order_hash": "[Created order hash]"
}

JSON užsakymo prekių eilučių reikšmės

OPTIONS

Query Parameters

Name	Type	Description
kodas	string	Prekės/paslaugos kodas
t_kodas	string	Tiekėjo kodas
pavadinimas	string	Prekės/paslaugos pavadinimas
matovnt	string	Prekės/paslaugos mato vnt.
kiekis	number	Prekės/paslaugos kiekis
kaina	number	Prekės/paslaugos kaina
pvm_tar	number	PVM tarifas

200

Pavyzdys:

[
  {
    "kodas": "11222",
    "t_kodas": "122",
    "pavadinimas": "Kompiuteris",
    "matovnt": "vnt.",
    "kiekis": "2",
    "kaina": "1050",
    "pvmtar": "21",
 },
 {
    "kodas": "11222",
    "t_kodas": "122",
    "pavadinimas": "Kompiuteris",
    "matovnt": "vnt.",
    "kiekis": "2",
    "kaina": "1050",
    "pvmtar": "21",
 }
]

Produktų importavimas

POST http://ws.centas.lt/v1/products/import

Produktų importavimas vykdomas pateikiant XML dokumentą kaip tekstą per POST parametrą data.

Query Parameters

Name	Type	Description
token	string	API raktas, skirtas Jūsų projektui

Request Body

Name	Type	Description
data	string	Duomenys XML formatu

200 Sėkmingo importavimo atveju, grąžinas JSON su informacija, pavyzdys:

{
    "success": 1,
    "products_found_xml": 1,
    "products_created": 1,
    "products_updated": 0
}

data parametro turinio (xml) pavyzdys:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <item>
        <token>tk_91875401d16245911c7021313258bc25ac40836367edvdcff</token>
        <oper>UPD</oper>
        <id>101</id>
        <kodas>C001</kodas>
        <pavadinimas>Programa nr. 1</pavadinimas>
        <matovnt>vnt.</matovnt>
        <kaina>100.000000</kaina>
        <pvmtar>21</pvmtar>
        <likutis>250</likutis>
        <grupe1></grupe1>
        <grupe2>0</grupe2>
        <grupe3></grupe3>
        <barkodas>123456789</barkodas>
        <aprasymas>Prekės aprašymas</aprasymas>
        <Nuotrauka></Nuotrauka>
        <Stocks>
					<Stock>
						<WarehouseId>1</WarehouseId>
						<WarehouseName>Sandelis Nr. 1</WarehouseName>
						<Quantity>18566.6440</Quantity>
					</Stock>
					<Stock>
						<WarehouseId>2</WarehouseId>
						<WarehouseName>Sandelis Nr. 2</WarehouseName>
						<Quantity>61.0000</Quantity>
					</Stock>
		    </Stocks>
     		<ProductParameters>
     			<Parameter>
     				<Name>Kuras</Name>
     				<Value>Dujos</Value>
     			</Parameter>
     			<Parameter>
     				<Name>Automobilio modelis</Name>
     				<Value>Opel</Value>
     			</Parameter>
     		</ProductParameters>
        <AnalogProducts></AnalogProducts>
        <RecommendedProducts></RecommendedProducts>
    </item>
    <item>
        <token>tk_91875401d16245911c7021313258bc25ac40836367edvdcff</token>
        <oper>UPD</oper>
        <id>102</id>
        <kodas>C002</kodas>
        <pavadinimas>Programa nr. 2</pavadinimas>
        <matovnt>vnt.</matovnt>
        <kaina>180.000000</kaina>
        <pvmtar>21</pvmtar>
        <likutis>147</likutis>
        <grupe1></grupe1>
        <grupe2></grupe2>
        <grupe3></grupe3>
        <Nuotrauka></Nuotrauka>
        <AnalogProducts></AnalogProducts>
        <RecommendedProducts></RecommendedProducts>
    </item>
</root>

Produktų eksportavimas (XML)

GET http://ws.centas.lt/v1/products/export

Metodas skirtas produktų/produkto informacijos eksportavimui pagal token raktą XML formatu.

Query Parameters

Name	Type	Description
token	string	API raktas, skirtas Jūsų projektui
id	string	Produkto ID, jeigu nori išgauti tik vieno produkto informaciją (neprivaloma)

200 Metodas, sėkmingo produktų eksportavimo atveju, grąžina atsakymą XML formatu, pavyzdys:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <item>
        <token>tk_456453214565416283b911c70b1df65sdxh65fds4h65</token>
        <oper>UPD</oper>
        <id>1547</id>
        <kodas>1-15</kodas>
        <pavadinimas>Prekė 01</pavadinimas>
        <matovnt>vnt.</matovnt>
        <kaina>113.99</kaina>
        <pvmtar>21</pvmtar>
        <likutis>907.0000</likutis>
        <grupe1></grupe1>
        <grupe2></grupe2>
        <grupe3></grupe3>
        <Nuotrauka></Nuotrauka>
        <barkodas>123456789</barkodas>
        <aprasymas>Prekės aprašymas</aprasymas>
        <Stocks>
					<Stock>
						<WarehouseId>1</WarehouseId>
						<WarehouseName>Sandelis Nr. 1</WarehouseName>
						<Quantity>18566.6440</Quantity>
					</Stock>
					<Stock>
						<WarehouseId>2</WarehouseId>
						<WarehouseName>Sandelis Nr. 2</WarehouseName>
						<Quantity>61.0000</Quantity>
					</Stock>
		    </Stocks>
     		<ProductParameters>
     			<Parameter>
     				<Name>Kuras</Name>
     				<Value>Dujos</Value>
     			</Parameter>
     			<Parameter>
     				<Name>Automobilio modelis</Name>
     				<Value>Opel</Value>
     			</Parameter>
     		</ProductParameters>
    </item>
</root>

Mokėjimų importavimas

POST http://ws.centas.lt/v1/payments/import

Metodas skirtas mokėjimų importavimui pagal token raktą XML formatu.

Query Parameters

Name	Type	Description
token	string	API raktas, skirtas Jūsų projektui

Request Body

Name	Type	Description
data	string	XML dokumentas teksto pavidalu

200 Sėkmingo importavimo metu, grąžinamas atsakymas JSON formatu:

{
    "success": 1,
    "payments_found_xml": 1,
    "payments_created": 1
}

data parametro turinio pavyzdys:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <Payment>
        <PaymentType>BankDeb</PaymentType>
        <Date>2020.01.01</Date>
        <Amount>123.23</Amount>
        <DocNr>NR001_is_banko</DocNr>
        <RefNr>ABC001001001_unikalus nr dokumento identifikacijai</RefNr>
        <Details>mokejimo paskirtis</Details>
        <RecName>UAB Moketojas</RecName>
        <RecId>303030303</RecId>
        <ToAccountNumber>LT1234567890</ToAccountNumber>
    </Payment>
</root>

Mokėjimų eksportavimas

GET http://ws.centas.lt/v1/payments/export

Metodas skirtas išgauti mokėjimus pagal Token raktą XML formatu.

Query Parameters

Name	Type	Description
token	string	API raktas, skirtas Jūsų projektui

200 Sėkmingo eksportavimo atveju, grąžinamas atsakymas XML formatu su mokėjimų informacija:

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<Payment>
		<token>99875401d16283b911c70b1ddbc25ac40836367f</token>
		<PaymentType>BankDeb</PaymentType>
		<Date>2020.01.01</Date>
		<Amount>123.23</Amount>
		<DocNr>NR001_is_banko</DocNr>
		<RefNr>ABC001001001_unikalus nr dokumento identifikacijai</RefNr>
		<Details>mokejimo paskirtis</Details>
		<RecName>UAB Moketojas</RecName>
		<RecId>303030303</RecId>
		<ToAccountNumber>LT1234567890</ToAccountNumber>
	</Payment>
</root>

Pirkimo dokumento įkėlimas

POST http://ws.centas.lt/v1/documents/purchase/import

Postman užklausos pvz.: https://www.postman.com/collections/aaf18c6264096f4225e5

Query Parameters

Name	Type	Description
token*	String	Token raktas

Request Body

Name	Type	Description
kontrah*	String	Pardavėjo pavadinimas
data*	String	Data
dok_suma*	String	Dokumento suma
dok_num*	String	Dokumento nr.
pvm_suma*	String	PVM suma
bepvm_suma*	String	Suma be PVM
rows*	String	JSON produktų masyvas

200: OK Pirkimo dokumentas s4k

{
    "success": 1,
    "purchase_id": 1
}