{"id":20740,"date":"2021-03-15T13:48:46","date_gmt":"2021-03-15T13:48:46","guid":{"rendered":"https:\/\/www.erplybooks.com\/?page_id=20740"},"modified":"2023-07-07T07:32:08","modified_gmt":"2023-07-07T07:32:08","slug":"partner-api","status":"publish","type":"page","link":"https:\/\/www.erplybooks.com\/et\/partner-api\/","title":{"rendered":"Partner API"},"content":{"rendered":"<h1>Partner API<\/h1>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Partner API on professionaalne <a href=\"https:\/\/www.erplybooks.com\/et\/worlds-best-accounting-api\/\">API<\/a> funktsionaalsus, mis v\u00f5imaldab ERPLY Books&#8217;iga integreerida. Booksi API-t kasutatakse nii, et saad oma ID v\u00e4\u00e4rtused salvestada ERPLY Books&#8217;is. Sa ei pea salvestama Booksi ID v\u00e4\u00e4rtuseid, vaid saad lasta ERPLY Books&#8217;il uuendada v\u00e4\u00e4rtused, kui saadad omaenda ID.<\/span><\/p>\n<p>&nbsp;<\/p>\n<h3><strong>ID v\u00e4\u00e4rtused<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">Vaatame n\u00e4idet, kus Sul on arve ID-ga 82738732. Sa saadad selle ERPLY Books&#8217;i, kus partnerDocumentID on 82738732. Sel juhul peate ainult lugema infot, kas Books annab arve saatmisel veateate v\u00f5i mitte. Kui ei anna veateadet, siis luuakse Books&#8217;is vastava infoga arve. Kui Sa saadad n\u00e4iteks selle arve uuesti homme, \u00f6eldes, et partnerDocumentID on 82738732, siis Partner API&#8217;t kasutades teab ERPLY Books, et see arve juba eksisteerib juba. Sel juhul ei looda uut arvet, vaid uuendatakse olemasolevat.<\/span><\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Partner API&#8217;l on j\u00e4gmised ID valikud:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerCustomerId<\/span><i><span style=\"font-weight: 400;\"> (Partnerkliendi ID)<\/span><\/i><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerSupplierId<\/span><i><span style=\"font-weight: 400;\"> (Partnerhankija ID)<\/span><\/i><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerDocumentId <\/span><i><span style=\"font-weight: 400;\">(Partnerdokumendi ID)<\/span><\/i><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerArticleId <\/span><i><span style=\"font-weight: 400;\">(Partnerartikli ID)<\/span><\/i><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerAccountId <\/span><i><span style=\"font-weight: 400;\">(Partnerkonto ID)<\/span><\/i><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">PartnerTaxRateId <\/span><i><span style=\"font-weight: 400;\">(Partner maksum\u00e4\u00e4ra ID)<\/span><\/i><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p><span style=\"font-weight: 400;\">Kui Sa saadad informatsiooni Partner API kaudu, siis on k\u00e4sitletakse Sind partner t\u00fc\u00fcbina PARTNER_API. Kui ka keegi teine hakkab infot saatma API kaudu, siis peab ta kasutama Sinuga samasid ID v\u00e4\u00e4rtuseid. Kui \u00fchel saatjal on n\u00f5uete kontoks X ja teine saatja soovib kasutada n\u00f5uete jaoks kontot Y, siis ei leita erinevate kontode puhul unikaalset v\u00f5tit, kuna m\u00f5lemad olete k\u00e4sitletud kui PARNTER_API. L\u00fchidalt \u00f6eldes, kui Sul on rohkem kui \u00fcks koht, kust arveid saadetakse, siis pead olema kindlad, et k\u00f5ik kohad kasutavad sama partner ID-d.<\/span><\/p>\n<p>&nbsp;<\/p>\n<h3><strong>Reeglid<\/strong><\/h3>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_USE_PARTNER_API<\/span>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Peate aktiveerima selle, et partner API tunnuseid kasutada.<\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_AGGREGATE_DOCUMENTS<\/span>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Kui see on aktiveeritud, siis ERPLY Books liidab kokku dokumendi read, grupeerides artiklid ja projektid.<\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_UPDATE_SUPPLIERS<\/span>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Kui saadad kliendi andmed koos arvega, siis see uuendab automaatselt kliendi informatsiooni (kohandub samuti maksjale, kui maksja on k\u00e4ttesaadav).<\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_UPDATE_CUSTOMERS<\/span>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Kui saadad kliendi andmed koos arvega, siis see uuendab automaatselt kliendi informatsiooni (kohandub samuti maksjale, kui maksja on k\u00e4ttesaadav).<\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_DO_NOT_UPDATE_SUPPLIERS<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_DO_NOT_UPDATE_CUSTOMERS<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_DO_NOT_UPDATE_PAYMENTS<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">GLOBAL_API_ROUND_INVOICE_TOTALS<\/span>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Sellega saad saata samuti arve kokku summad (sumWithVat, SumNoVat) ja ERPLY Books arvutab, kas esineb erinevus arve ridade summa ja tegeliku arve kokku summa vahel. Erinevuse puhul lisatakse \u00fcmardus automaatselt arvele.<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h3><strong>Atribuudid<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">API dokumentatsioon Partner API jaoks on sama nagu tavaliste arvete puhul. Ainus erinevus on see, et url on \u201cinvoices\/partner\u201d, mitte \u201cinvoices\u201d. Lisaks on oluline meeles pidada, et lisaksid partnerDocumentID elemendi. Partner API puhul on j\u00e4rgmised atribuudid:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Invoice.partnerDocumentId (String)<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Invoice.projectNames (String array) &#8211; see \u00fcritab leida sama nimega projekte olemasolevate seast. Kui ei leia, siis lisab uue projekti automaatselt.<\/span>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">[&#8220;Project1&#8221;, &#8220;Project2&#8221;]<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Projects &#8211; kui see eksisteerib, siis rohkem projekti v\u00e4lja pole kasutusel <\/span><span style=\"font-weight: 400;\">[23982, 439832]<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li><span style=\"font-weight: 400;\">Invoice.connectedDocuments &#8211;\u00a0 saad \u00fchendada erinevad dokumendid \u00fcksteisega. N\u00e4iteks saab \u00fchendada tellimused m\u00fc\u00fcgiarvega. V\u00e4li:\u00a0<\/span>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">id (Long) &#8211; j\u00e4ta t\u00fchjaks<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">parentDocumentId (Long) &#8211; j\u00e4ta t\u00fchjaks<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">baseDocumentId (Long) &#8211; j\u00e4ta t\u00fchjaks<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">partnerParentDocumentId (String) &#8211; lisa oma ID<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">partnerBaseDocumentId (String) &#8211; lisa oma ID<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li><span style=\"font-weight: 400;\">Invoice.rows.partnerTaxRateId (String)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Invoice.rows.partnerTaxRateName (String)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Invoice.rows.partnerArticleId (String)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Invoice.payer (CustomerInfo) &#8211; sellega saab lisada maksja. Klientide puhul kehtib sama andmete struktuur.<\/span><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h3><strong>Kuidas tagada, et s\u00fcsteem t\u00f6\u00f6taks t\u00f5rgeteta?<\/strong><\/h3>\n<h5><strong>API tunnuse uuendamine<\/strong><\/h5>\n<p>Vaikimisi API tunnuse kehtivusaeg on 1 aasta.<\/p>\n<p>API tunnus peab olema kinnitatud ERPLY Booksi supporti poolt. Saada p\u00e4ring <a href=\"mailto:support@erplybooks.com\">support@erplybooks.com<\/a><\/p>\n<p>POST\/settings\/update_token &#8211; see annab uue tunnuse.<\/p>\n<p>&nbsp;<\/p>\n<h5><strong>API turvamine Teie IP aadressiga<\/strong><\/h5>\n<p>API seadete all saab m\u00e4\u00e4rata IP aadressid API p\u00e4ringute jaoks.<\/p>\n<p>&nbsp;<\/p>\n<h5><strong>Veateadete saatmine API-ga<\/strong><\/h5>\n<p>Kirjuta pealehe otsingukasti <strong>&#8220;Globaalsed atribuudid&#8221;<\/strong> ja lisa j\u00e4rgmise atribuudiga rida:<\/p>\n<p><span style=\"font-weight: 400;\">Global name = GLOBAL_API_SEND_ERROR_MESSAGE<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Value = emaili pealkiri<\/span><\/p>\n<p><span style=\"font-weight: 400;\">altValue = kes saab veateate<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Partner API &nbsp; Partner API on professionaalne API funktsionaalsus, mis v\u00f5imaldab ERPLY Books&#8217;iga integreerida. Booksi API-t kasutatakse nii, et saad oma ID v\u00e4\u00e4rtused salvestada ERPLY Books&#8217;is. Sa ei pea salvestama Booksi ID v\u00e4\u00e4rtuseid, vaid saad lasta ERPLY Books&#8217;il uuendada v\u00e4\u00e4rtused, kui saadad omaenda ID. &nbsp; ID v\u00e4\u00e4rtused Vaatame n\u00e4idet, kus Sul on arve ID-ga 82738732. [&hellip;]<\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[459],"tags":[741,742],"class_list":["post-20740","page","type-page","status-publish","hentry","category-integratsioonid","tag-api-2","tag-partner"],"_links":{"self":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/pages\/20740","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/comments?post=20740"}],"version-history":[{"count":0,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/pages\/20740\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/media?parent=20740"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/categories?post=20740"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/tags?post=20740"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}