fature.al API

Si te fillosh

• Hyrje API-ja e fature.al ju jep fiskalizimin shqiptar si sherbim: dergoni nje fature si JSON dhe merrni nje dokument te fiskalizuar, me IIC, NIVF, URL verifikimi dhe PDF.
• Fillimi i shpejte Nga token-i deri te fatura e pare e leshuar me API-n e fature.al, ne tri thirrje.
• Cfare mund te ndertoni Kjo API ju jep fiskalizimin shqiptar si sherbim, bashke me te dhena qe nuk i keni ju: regjistrin e NIPT-eve, faturat e blerjes nga tatimet dhe kursin e dites.
• Identifikimi Cdo endpoint kerkon token-in e perdoruesit. Integrimet e ofruesve dergojne edhe nje cift kredencialesh qe tregon cili program po therret.
• Versionet e API-t v1 eshte API-ja e plote dhe ajo mbi te cilen ndertohet. v2 eshte formati i ri i klientit dhe mbulon vetem klientet. Asnje nga te dyja nuk eshte ne dalje.
• Gabimet Kodet HTTP qe kthen kjo API, forma e trupit te gabimit, dhe perjashtimi i vetem qe duhet ditur: validimi ne v1 perdor success ne vend te status.
• Kufiri i kerkesave Cfare e kufizon nje integrim me fature.al: kufiri i pergjithshem per token, intervali minimal mes dy thirrjeve, endpoint-et qe kryhen nje nga nje, dhe buxheti per grup endpoint-esh.
• Faqezimi Listat nuk faqezohen te gjitha njesoj. Cili endpoint pranon limit me offset, cili pranon page, dhe ku qendron numri i pergjithshem.

Shembuj

• Llojet e faturave Cash, jo-cash, e-fature, porosi me permbledhese, bllok dhe flete shoqeruese. Cili endpoint leshon cilin dokument, dhe cilat fusha ndryshojne mes tyre.
• Fatura elektronike Cfare e ndan nje fature elektronike nga nje fature e zakonshme jo-cash, dhe si zgjidhet doc_type me process per secilin dokument.
• Zbritjet ne fature Si zbritet nje fature nga API, si zbritet nje rresht i vetem, si lexohen perqindja dhe vlera fikse dhe cfare kthehet ne pergjigje.

Klienti (v2)

Versioni 2 i endpoint-eve te klientit. Perdor nje format te ri me objekte te ndara (company/person/address/contact) dhe nje fushe diskriminuese type (company|person). Identifikuesi jepet si objekt id me type dhe value. Lloji (type) eshte i pandryshueshem ne editim.

• GET /api/v2/clients Lista e klienteve
• POST /api/v2/clients Krijo klient (v2)
• GET /api/v2/clients/{id} Detajet e klientit (v2)
• PATCH /api/v2/clients/{id} Perditeso klient (v2)

Ping (v1)

Nje thirrje qe nuk prek asgje, per te provuar lidhjen dhe token-in.

• GET /api/v1/ping Ping

Regjistrimi (v1)

Ne kete koleksion perfshihen endpoint-et qe ju lejojne te regjistroni nje kompani ne fature.al dhe te plotesoni te dhenat e nevojshme per ta bere gati per leshimin e faturave.

• GET /api/v1/register Ping (Register)
• POST /api/v1/register Regjistro kompani te re
• POST /api/v1/on-boarding/branch/{id} Perditeso njesine e biznesit (Branch)
• POST /api/v1/on-boarding/user/{id} Perditeso perdoruesin
• POST /api/v1/on-boarding/certificate Ngarko certifikaten elektronike
• POST /api/v1/on-boarding/bank-account Krijo llogari bankare
• POST /api/v1/on-boarding/fiscal-device Krijo pajisje fiskale (TCR)
• POST /api/v1/on-boarding/branch Krijo njesi biznesi (Branch)
• POST /api/v1/on-boarding/user Krijo perdorues te ri

Faturat (v1)

Leshimi i faturave dhe gjithcka qe vjen pas tij: cash, jo-cash, e-fature, porosi, permbledhese dhe bllok jo-cash, si dhe anulimi, detajet dhe PDF-ja.

• GET /api/v1/invoice Lista e faturave
• POST /api/v1/invoice/bulk-noncash Krijo fatura pa para ne dore ne bllok (Bulk NonCash)
• POST /api/v1/invoice/cancel-by-internal-id/{internalId} Anulo fature sipas Internal ID
• POST /api/v1/invoice/cancel/{id} Anulo fature sipas ID
• POST /api/v1/invoice/cash Krijo fature me para ne dore (Cash)
• POST /api/v1/invoice/details/{internalId} Detajet e fatures sipas Internal ID
• POST /api/v1/invoice/e-invoice Krijo fature elektronike (E-Invoice)
• POST /api/v1/invoice/noncash Krijo fature pa para ne dore (NonCash)
• POST /api/v1/invoice/order Krijo fature porosi (Order)
• GET /api/v1/invoice/print-eic/{eic} Shkarko PDF te fatures sipas EIC
• GET /api/v1/invoice/print/{id} Shkarko PDF te fatures sipas ID
• POST /api/v1/invoice/summary Krijo fature permbledhese (Summary)
• GET /api/v1/invoice/{id}/details Detajet e fatures sipas ID

Arka Fiskale (v1)

Dita ne arken fiskale: hapja e balances para fatures se pare cash, hyrjet dhe daljet e parave, mbyllja ne fund dhe gjendja ne cdo moment.

• GET /api/v1/cash-register/actions Lista e veprimeve me arken
• GET /api/v1/cash-register/balance Balanca e arkes fiskale
• POST /api/v1/cash-register/close-balance Mbyll balancen e arkes
• POST /api/v1/cash-register/deposit Hyrje ne arke (Deposit)
• POST /api/v1/cash-register/open-balance Hap balancen e arkes
• POST /api/v1/cash-register/withdraw Dalje nga arka (Withdraw)

Klienti (v1)

Klientet e kompanise: lista, detajet, krijimi dhe perditesimi, si dhe nje kerkim sipas NIPT-it qe e gjen subjektin qe te mos e krijoni dy here.

• GET /api/v1/client/search Kerko klient sipas NIPT
• GET /api/v1/clients Lista e klienteve
• POST /api/v1/clients Krijo klient
• PUT /api/v1/clients/{id} Perditeso klient
• GET /api/v1/clients/{id}/details Detajet e klientit sipas ID

Produkte (v1)

Katalogu i produkteve dhe kategorite e tyre: lista, detajet, krijimi dhe perditesimi. Keta jane artikujt qe dalin si rreshta ne fature.

• GET /api/v1/product/categories Lista e kategorive
• GET /api/v1/products Lista e produkteve
• POST /api/v1/products Krijo produkt
• PUT /api/v1/products/{id} Perditeso produkt
• GET /api/v1/products/{id}/details Detajet e produktit sipas ID

Llogaritë bankare (v1)

Llogarite bankare te kompanise, ashtu sic dalin si informacion pagese ne faturat jo-cash dhe elektronike. Vetem lexim: nje llogari e re shtohet gjate regjistrimit ose nga paneli.

• GET /api/v1/bank-accounts Lista e llogarive bankare

Monedhat (v1)

Monedhat e konfiguruara per kompanine dhe kursi i kembimit i dites, i marre nga kursi.al.

• GET /api/v1/currencies Lista e monedhave
• GET /api/v1/exchange-rates Kursi i kembimit

Fletë shoqëruese (v1)

Fletet shoqeruese (WTN) per mallin qe leviz midis njesive ose drejt nje klienti pa qene shitje: krijimi, lista, detajet dhe te dhenat per printim.

• GET /api/v1/invoice/wtn Lista e faturave shoqeruese (WTN)
• POST /api/v1/invoice/wtn Krijo fature shoqeruese (WTN)
• GET /api/v1/invoice/wtn/print/{id} Te dhenat e fatures shoqeruese ne format printimi (JSON)
• GET /api/v1/invoice/wtn/{id}/details Detajet e fatures shoqeruese sipas ID

Faturat e blerjes (v1)

Faturat qe kompania ka marre nga furnitoret, ashtu sic vijne nga sistemi i e-faturave. Vetem lexim: keto dokumente nuk leshohen ketu.

• GET /api/v1/purchase-invoices Lista e faturave te blerjes

Llogaria (v1)

Kush eshte perdoruesi qe mban token-in: emri, kompania, NIPT-i, njesia e biznesit, kodi fiskal dhe te drejtat.

• GET /api/v1/account Te dhenat e llogarise

Paneli (v1)

Permbledhja e dites ne nje thirrje te vetme: turni i hapur, shitjet e sotme perballe atyre te djeshme, gjendja e arkes dhe faturat e fundit.

• GET /api/v1/dashboard/summary Permbledhja e dites

Raportet (v1)

Shifra te grumbulluara mbi nje periudhe: shitjet, TVSH-ja, ecuria ditore, klientet dhe produktet kryesore, shitjet sipas operatorit dhe sipas pajisjes, arka dhe fletet shoqeruese.

• GET /api/v1/reports/by-operator Shitjet sipas operatorit
• GET /api/v1/reports/by-tcr Shitjet sipas pajisjes fiskale
• GET /api/v1/reports/cash-register Gjendja e arkes per nje dite
• GET /api/v1/reports/cash-register/closing Raporti i mbylljes se arkes
• GET /api/v1/reports/daily-trend Ecuria ditore
• GET /api/v1/reports/reversals Faturat e anulluara
• GET /api/v1/reports/sales-summary Permbledhje e shitjeve
• GET /api/v1/reports/top-clients Klientet kryesore
• GET /api/v1/reports/top-products Produktet me te shitura
• GET /api/v1/reports/vat Raporti i TVSH
• GET /api/v1/reports/wtn Raporti i faturave shoqeruese

Wolt Partner API

The venue side of a Wolt integration: read the order feed, accept or reject what arrives, move an order through pickup and delivery, and fetch the fiscal invoice it produced.

• GET /api/partner/v1/wolt/events Event feed
• GET /api/partner/v1/wolt/orders List orders
• GET /api/partner/v1/wolt/orders/{id} Get an order
• POST /api/partner/v1/wolt/orders/{id}/accept Accept an order
• POST /api/partner/v1/wolt/orders/{id}/confirm-preorder Confirm a pre-order
• POST /api/partner/v1/wolt/orders/{id}/courier-at-customer Self-delivery step 2: the courier reached the customer
• POST /api/partner/v1/wolt/orders/{id}/delivered Close the order
• GET /api/partner/v1/wolt/orders/{id}/invoice Get the order's fiscal invoice
• POST /api/partner/v1/wolt/orders/{id}/pickup-completed Self-delivery step 1: the venue's own courier collected the order
• POST /api/partner/v1/wolt/orders/{id}/ready Mark an order ready for handover
• POST /api/partner/v1/wolt/orders/{id}/reject Reject an order
• POST /api/partner/v1/wolt/orders/{id}/retry-fiscalize Retry a deferred or failed fiscalisation for this order
• GET /api/partner/v1/wolt/ping Ping