Šajā dokumentā ir aprakstīta Jumis REST API servisa lietošanas instrukcija, kuru var izmantot, lai importētu vai eksportētu datus no datu bāzēm, kas izvietotas Jumis mākonī.

Izmantojot REST API ir iespējams veikt šādu datu apmaiņu:

• Finanšu dokumentu (kases un bankas darījumi, kā arī citas finanšu operācijas) imports un eksports;
• Noliktavas dokumentu (preču un pakalpojumu uzskaites dokumenti) imports un eksports;
• Partneru (partneri, to adreses, kontaktpersonas, reģistrācijas informācija) imports un eksports;
• Preču kartīšu (preču nomenklatūra ar cenu katalogu) imports un eksports.

Ja pašlaik API nenodrošina Jums vajadzīgās iespējas, lūdzu, pastāsti mums par to šeit !

REST API ir veidots kā tīmekļa serviss, kurš implementē Jumis XML importa un eksporta bibliotēkas. Pieprasījumi jāveido JSON formātā ar POST metodi. Atbildes no REST API tiks veidotas JSON formātā.

Visa komunikācija ar REST API servisu notiek caur drošu SSL kanālu.

Import

Pieprasījums nodrošina datu importu.

URL - https://vadiba.mansjumis.lv/cloudapi/JumisImportExportService.ImportExportService.svc/import

Metode - POST

Parametri:

Piemērs:

Piemērs zemāk importē datu bāzē partneri “Jumis Pro, SIA” ar rekvizītiem un juridisko adresi.

{"username":"abc@mansjumis.lv.lv",

"password":"parole123",

"database":"datubaze",

"apikey":"2BFC1C2B748D4C04BB0ECABA7FBFB1A6",

"XMLrequest":"<?xml version=\"1.0\" encoding=\"utf-8\" ?><dataroot><tjDocument Version=\"TJ5.5.101\"/><tjResponse Name=\"Partner\" Operation=\"Insert\" Version=\"TJ7.0.112\" Structure=\"Tree\"><Partner><PartnerKindName>Juridiska persona</PartnerKindName><PartnerTitle>SIA</PartnerTitle><PartnerName>Jumis Pro</PartnerName><PartnerRegistrationNo>42103112933</PartnerRegistrationNo><PartnerAddress><AddressJuridicalNoticeID>1</AddressJuridicalNoticeID><AddressDefaultNoticeID>1</AddressDefaultNoticeID><AddressStreet>Sporta iela 11</AddressStreet><AddressCity>Rīga</AddressCity><AddressCountryCode>LV</AddressCountryCode><AddressPostalCode>LV-1013</AddressPostalCode></PartnerAddress><PartnerVatNo><VatNo>LV42103112933</VatNo><VatNoCountryCode>LV</VatNoCountryCode><VatNoDefaultNoticeID>1</VatNoDefaultNoticeID></PartnerVatNo></Partner></tjResponse></dataroot>"}

• XML pieprasījums FINANŠU DOKUMENTU importam Jumī izmantojot REST API savienojumu
• XML pieprasījums NOLIKTAVAS DOKUMENTU importam Jumī izmantojot REST API savienojumu
• XML pieprasījums PARTNERU importam Jumī izmantojot REST API savienojumu
• XML pieprasījums PREČU importam Jumī izmantojot REST API savienojumu

Export

Pieprasījums nodrošina datu eksportu.

URL - https://vadiba.mansjumis.lv/cloudapi/JumisImportExportService.ImportExportService.svc/export

Metode - POST

Parametri:

Piemērs:

Piemērs zemāk eksportē pilnu partneru sarakstu ar diviem laukiem: “Partnera veids” un ”Partnera nosaukums”.

{"username":"abc@mansjumis.lv",

"password":"parole123",

"database":"datubaze",

"apikey":"2BFC1C2B748D4C04BB0ECABA7FBFB1A6",

"XMLrequest":"<?xml version=\"1.0\" ?><dataroot><tjDocument Version=\"TJ5.5.101\"/><tjRequest Name=\"Partner\" Operation=\"Read\" Version=\"TJ7.0.112\" Structure=\"Tree\"><tjFields><Field Name=\"PartnerKindName\"/><Field Name=\"PartnerName\"/></tjFields></tjRequest></dataroot>"}

Parametrā "XMLrequest" norādāmo XML pieprasījumu datu eksportam visvienkāršāk ir iegūt, izveidojot datu eksporta pieprasījuma failu Jumī un pārveidojot to JSON formātā: Jumis datu eksporta XML pieprasījuma faila izveidošana

* XML importa un XML eksporta pieprasījumi satur vienādus XML laukus, bet tiem ir atšķirīgi parametri (read, write), tāpēc, to izmantošanai pretējiem mērķiem, nepieciešams pielāgot atšķirīgos parametrus.

Plašāka informācija par XML lauku aprakstiem ir pieejama šeit: Jumis XML apraksts

Apraksts, kā iegūt lietotāja SQL paroli: Jumis pieslēgums datu bāzei no trešo pušu risinājumiem

Apraksts, kā noskaidrot datu bāzes nosaukumu: Kā noskaidrot pieslēguma serveri un datu bāzes nosaukumu