---
title: "Cfare mund te ndertoni"
page_id: "use-cases"
section: "Si te fillosh"
canonical: "https://fature.al/api-reference/pages/use-cases.html"
---

# Cfare mund te ndertoni

Part of the [fature.al API](/api-reference/index.html) documentation.

Fiskalizimi eshte i detyrueshem per cdo shitje ne Shqiperi, dhe ndertimi i tij nga
e para do te thote certifikata dixhitale, nenshkrim XML, SOAP me sistemin qendror,
mbajtje e TCR-ve dhe nje plan per momentin kur sherbimi i tatimeve nuk pergjigjet.

Kjo API e ben ate pune. Ju dergoni nje fature si JSON dhe merrni nje dokument te
fiskalizuar, me IIC, NIVF, URL verifikimi dhe PDF. Sistemi juaj nuk e di qe ekziston
SOAP.

## Kush ndertohet mbi te

**Programe kontabiliteti dhe ERP.** Fatura leshohet aty ku eshte shitja, jo ne nje
faqe te dyte qe operatori duhet ta hape. Klientet dhe produktet rrine te sinkronizuara
ne te dy anet.

**Dyqane online.** Porosia e paguar behet fature ne te njejtin cast, dhe bleresi merr
PDF-in bashke me konfirmimin, pa nderhyrje njerezore.

**Programe arke, bar dhe restorant.** Porosia hapet kur tavolina ulet dhe mbyllet me
nje pagese te vetme, me faturat e ndermjetme te lidhura vete.

**Aplikacione vertikale.** Nje program qe njeh mire nje zanat, inventarin e nje bari
ose porosite e nje furre, merr faturimin ligjor pa u marre me te.

**Ofrues qe shesin te njejtin program shume bizneseve.** Nje instalim, shume kompani,
secila me identitetin e vet fiskal.

## Fiskalizim pa e ndertuar vete

Ky eshte thelbi. Cfare merrni pa e shkruar:

- **Te kater llojet e dokumentit.** Cash, jo-cash, e-fature dhe fature shoqeruese,
  secili me rregullat e veta. Shihni [Llojet e faturave](/api-reference/pages/invoice-types.html).
- **Certifikatat.** Nenshkrimi dixhital, skadimi dhe rinovimi jane pune e jona.
- **Pajisjet fiskale.** TCR-te, njesite e biznesit dhe kodet e operatoreve zgjidhen
  vete nga token-i qe dergoni.
- **Numerimi.** Numri rendor per biznes, vit dhe TCR ruhet i sakte edhe kur dy
  kerkesa vijne ne te njejtin cast.
- **Rikthimi pas nderprerjes.** Kur sistemi i tatimeve nuk pergjigjet, fatura ruhet
  dhe fiskalizohet me vone. Shitja nuk ndalon.
- **Dokumenti per bleresin.** PDF dhe URL verifikimi qe hapet me QR, pa gjeneruar gje.

Praktikisht kjo do te thote se nje ekip qe do te kalonte muaj te tere mbi fiskalizimin
e nis javen e pare duke leshuar fatura te vertetuara.

## Te dhena qe nuk i keni ju

Kjo pjese kalon me shpesh pa u vene re, dhe eshte aty ku API-ja jep me shume nga sa
kerkohet prej saj.

**Regjistri i NIPT-eve.** `GET /client/search` kerkon nje kompani ne regjistrin
fiskal me NIPT dhe kthen emrin, adresen, qytetin dhe nje shenje `verified`. Formulari
juaj i klientit te ri kerkon nje fushe te vetme dhe i mbush vete te tjerat, ndersa
nje NIPT i gabuar kapet para se te dale ne fature.

**Faturat e blerjes, nga tatimet.** `GET /purchase-invoices` sjell faturat qe ju kane
leshuar juve, ashtu sic i ka regjistruar sistemi fiskal. Furnitoret nuk ju dergojne
gje: dokumentet vijne me artikujt, shitesin, TVSH-ne dhe menyren e pageses. Kjo
mundeson rakordim blerjesh dhe TVSH pa asnje hap manual.

**Kursi i kembimit i dites.** `GET /exchange-rates` kthen kursin e shitjes per cdo
monedhe nga Banka e Shqiperise, BKT, Iliria '98 ose Adon, sipas asaj qe zgjidhni.
Pergjigja ruhet ne cache ne server dhe mban `fetchedAt`, prandaj klienti juaj mund ta
mbaje snapshot-in e fundit dhe te punoje edhe pa internet. Nese keni ndertuar nje
lexues kursesh diku ne kodin tuaj, kjo e zevendeson.

## Provizionim i klienteve tuaj, pa nderhyrje

Nje ofrues programi nuk do qe cdo klient i ri te prese dike qe t'i hapi llogarine.
Grupi i onboarding-ut e ben te gjithe rrugen nga API-ja:

1. `POST /register` krijon kompanine dhe ju kthen nje `api_token` pune.
2. `POST /on-boarding/branch` shton njesine e biznesit.
3. `POST /on-boarding/fiscal-device` regjistron TCR-ne.
4. `POST /on-boarding/certificate` ngarkon certifikaten elektronike.
5. `POST /on-boarding/user` dhe `/on-boarding/bank-account` mbyllin konfigurimin.

Ne fund klienti juaj leshon fatura pa e hapur asnjehere fature.al.

Ky grup eshte i mbyllur si parazgjedhje dhe hapet per partneret, prandaj kerkoni akses
para se ta planifikoni. Ne instancen DEMO ka nje rrjedhe sandbox qe ju kthen nje
token te vertete pa krijuar kompani, keshtu qe integrimin e provoni sa here te doni.

## Raportet llogariten ne server

Nje liste faturash e lexuar faqe pas faqeje dhe e mbledhur ne kodin tuaj eshte e
ngadalte dhe gabon lehte. Raportet e bejne mbledhjen ne bazen e te dhenave dhe
kthejne shifren:

| Raporti | Cfare jep |
| --- | --- |
| `reports/sales-summary` | Shitjet per nje periudhe |
| `reports/vat` | TVSH e mbledhur, sipas normes |
| `reports/daily-trend` | Ecuria dite pas dite, per grafik |
| `reports/top-clients`, `reports/top-products` | Renditjet |
| `reports/by-operator`, `reports/by-tcr` | Kush shiti dhe nga cila pajisje |
| `reports/cash-register`, `reports/cash-register/closing` | Gjendja dhe mbyllja e arkes |
| `reports/reversals` | Faturat e anuluara |

Nje panel drejtuesi ndertohet mbi keto pa mbajtur asnje kopje te te dhenave.

## Arka si sistem me vete

Grupi i arkes fiskale hap dhe mbyll balancen, regjistron hyrje dhe dalje parash, dhe
jep raportin e mbylljes. Nje program arke merr keshtu turnin, rakordimin e fundit te
dites dhe historikun e veprimeve pa i ndertuar vete.

`GET /dashboard/summary` mbyll pamjen: turni i hapur, shitjet e sotme perballe atyre
te djeshme, gjendja e arkes dhe faturat e fundit, ne nje thirrje te vetme. Eshte
menduar per ekranin kryesor, jo per rakordim, sepse pergjigja ruhet ne cache per pak
sekonda.

## Levizja e mallit

Fleta shoqeruese mbulon mallin qe udheton pa u shitur ende: nga magazina ne dyqan,
tek doganat, ne panair. Kerkohet nga ligji dhe shpesh harrohet ne integrime, prandaj
`POST /invoice/wtn` ju kursen nje siperfaqe te tere.

## Kanale shitjeje te gatshme

Nese biznesi shet ne Wolt, `/api/partner/v1/wolt` sjell porosite, i pranon, i refuzon
dhe i fiskalizon. Kanali eshte i lidhur tashme, prandaj nuk ka nevoje ta ndertoni.

## Nga ku te filloni

- [Fillimi i shpejte](/api-reference/pages/quickstart.html) ju con te fatura e pare.
- [Llojet e faturave](/api-reference/pages/invoice-types.html) tregon cilin endpoint
  te thirrni dhe me cfare.
- [Fatura elektronike](/api-reference/pages/e-invoice.html) mbulon e-faturat dhe
  korrigjimet e tyre.