{"id":22538,"date":"2021-07-06T08:33:38","date_gmt":"2021-07-06T08:33:38","guid":{"rendered":"https:\/\/www.erplybooks.com\/?page_id=22538"},"modified":"2023-07-05T08:20:27","modified_gmt":"2023-07-05T08:20:27","slug":"queue-api","status":"publish","type":"page","link":"https:\/\/www.erplybooks.com\/et\/queue-api\/","title":{"rendered":"Queue API"},"content":{"rendered":"

Queue API<\/h1>\n

 <\/p>\n

Queue API on Partner API\u2019le lisatud funktsionaalsus, mis aitab paremini korraldada dokumentide saatmist ERPLY Booksi ja \u00e4ra hoida selle k\u00e4igus tekkida v\u00f5ivaid probleeme. Luuakse dokumentide ERPLY Books\u2019i salvestamise j\u00e4rjekord ja uus salvestamine saab alata ainult siis, kui eelmine on l\u00f5petatud.\u00a0<\/span><\/p>\n

 <\/p>\n

Queue API sobib v\u00e4ga kenasti lahendustele, kus on palju arveid ja v\u00f5imalikud on arvete muudatused (ehk siis \u00fchte arvet v\u00f5idakse sama sekundi sees kaks korda saata). Queue API t\u00f6\u00f6tab stiilis \u201csaada ja unusta\u201d.\u00a0<\/span><\/p>\n

 <\/p>\n

Url: invoices\/add_to_queue<\/span><\/p>\n

Meetod: POST<\/span><\/p>\n

 <\/p>\n

N\u00e4iteurl: https:\/\/api.erplybooks.com\/api\/invoices\/add_to_queue<\/code><\/span><\/p>\n

N\u00e4iteobjekt: {number:”5343353″,customerName:”Gangster”,date:”2021-05-05″,currencyCode:”CURRENCY_USD”,languageCode:”LANGUAGE_EN”,deadlineDate:”2021-06-28″,sumNoVat:16.5,sumWithVat:16.5,currencyRate:1,typeCode:”DOCUMENT_BUY”,code:”98329″,transactionDate:”2021-03-29″,note:”We need it now”,partnerDocumentId:”KDDK49839″,documentStatusTypeCode:”STATUS_NOT_CONFIRMED”,projectNames:[“Location in the mall”],rows:[{articleName:”Products”,quantity:1,price:16.5,typeCode:”ARTICLE_ROW_BUY”,partnerArticleId:”prod”,partnerTaxRateId:”TAX_0″,vatPercent:0},{articleName:”Transport”,quantity:1,price:0,cogs:88,typeCode:”ARTICLE_ROW_BUY”,partnerArticleId:”tran”,partnerTaxRateId:”TAX_20″,vatPercent:20}],customer:{name:”Gangster”,legalCountryCode:”US”,email:”coolio@gangsters.paradise”,partnerCustomerId:”IAMID”}}<\/span><\/p>\n

N\u00e4itevastus: {“id”: 24, “json”: \u2026 }<\/span><\/p>\n

 <\/p>\n

Queue API on kasutatav ainult Partner API\u2019ga. Queue kasutamisel sisaldab url \u201cinvoices\/partner\u201d asemel \u201cinvoices\/add_to_queue\u201d. Funktsiooni kasutamisel luuakse uus rida tabelisse Document_Queue, kuhu salvestub muu hulgas dokumendi j\u00e4rjekorra numbri Id, dokumendi saatnud organisatsiooni Id, dokumendi staatus ja JSON.<\/span><\/p>\n

 <\/p>\n

Queue\u2019s oleval dokumendil on neli erinevat staatust:<\/span><\/p>\n

FAIL – kui dokument ei vasta n\u00f5uetele<\/span><\/p>\n

PENDING – kui dokument vastab n\u00f5uetele, aga ei ole veel salvestatud<\/span><\/p>\n

REJECTED – sellest dokumendist on uuem versioon queue\u2019s olemas<\/span><\/p>\n

CONFIRMED – dokument on salvestatud<\/span><\/p>\n

 <\/p>\n

Saadetud dokument kontrollitakse ja kui tegemist on dokumendiga, siis salvestatakse ta DOCUMENT_QUEUE tabelisse staatusega PENDING. Kui dokument ei vasta n\u00f5uetele, on tema staatus FAIL ja dokumendi saatja saab veateate. Queue job k\u00e4ivitub iga kolme minuti tagant. Valitakse k\u00f5ik \u00fche organisatsiooni id-ga dokumendid, mille staatus on PENDING ja kontrollitakse \u00fcle partnerDocumentId unikaalsus. Kui leitakse mitu dokumenti sama id\u2019ga, siis hakatakse salvestama viimast saabunud versiooni sellest. \u00dclej\u00e4\u00e4nud sama id\u2019ga dokumendid saavad staatuseks REJECTED. Edasi toimub tavap\u00e4rane Partner API dokumentide salvestamise protsess. Kui salvestamine mingil p\u00f5hjusel eba\u00f5nnestus, siis j\u00e4\u00e4b dokument PENDING staatusesse ja teda p\u00fc\u00fctakse uuesti salvestada j\u00e4rgmise queue job\u2019i k\u00e4igus. Kui salvestamine eba\u00f5nnestub viis korda, saab dokumendi staatuseks FAIL. Tarkvara saadab veateate juhul, kui veateadete saamine on seadistatud.<\/span><\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Queue API   Queue API on Partner API\u2019le lisatud funktsionaalsus, mis aitab paremini korraldada dokumentide saatmist ERPLY Booksi ja \u00e4ra hoida selle k\u00e4igus tekkida v\u00f5ivaid probleeme. Luuakse dokumentide ERPLY Books\u2019i salvestamise j\u00e4rjekord ja uus salvestamine saab alata ainult siis, kui eelmine on l\u00f5petatud.\u00a0   Queue API sobib v\u00e4ga kenasti lahendustele, kus on palju arveid ja […]<\/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,789],"class_list":["post-22538","page","type-page","status-publish","hentry","category-integratsioonid","tag-api-2","tag-queque"],"_links":{"self":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/pages\/22538","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=22538"}],"version-history":[{"count":0,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/pages\/22538\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/media?parent=22538"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/categories?post=22538"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.erplybooks.com\/et\/wp-json\/wp\/v2\/tags?post=22538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}