fature.al është platforma e faturimit dhe fiskalizimit për bizneset në Shqipëri. Hap një llogari
Skip to content
fature.al API Menu

Merr një faturë sipas id

GET /api/v2/invoice/{id}/details Requires authentication Rate limited by the `api-global` limiter v2

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

Të njëjtat detaje si te v1, ku pagesa vjen si listë payment_methods. Kur fatura nuk gjendet, data.invoice është null me statusin 200.

URL-ja e plotë: https://fature.al/api/v2/invoice/{id}/details

Ndryshuar që nga v1:

What changed v1 v2
200 data.invoice.payment_method string, nullable —
200 data.invoice.payment_methods — array
200 data.invoice.payment_methods[].type — string
200 data.invoice.payment_methods[].amount — number
200 data.invoice.payment_methods[].company_card — any
200 data.invoice.payment_methods[].vouchers — any
429 documented not documented
500 documented not documented

Path parameters

Name Tipi E detyrueshme Përshkrimi
id integer yes Id-ja e faturës në fature.al.

Përgjigjet

200 Fatura e plotë te `data.invoice`, ose `null` kur nuk gjendet.

Field Tipi Përshkrimi
status boolean
data object
data.invoice object, nullable
data.invoice.id integer Id-ja e faturës në fature.al
data.invoice.number string, nullable Numri i faturës, si `12/2026`
data.invoice.type string Lloji i faturës: `CASH`, `NONCASH` ose `EINVOICE`
data.invoice.issue_date string Data e lëshimit, `YYYY-MM-DD`
data.invoice.due_date string Afati i pagesës, `YYYY-MM-DD`
data.invoice.delivery_date string Data e dorëzimit, ose fundi i periudhës së furnizimit, `YYYY-MM-DD`
data.invoice.created_at string, nullable Data dhe ora e krijimit, `YYYY-MM-DD HH:MM:SS`, ora lokale
data.invoice.supply_start_date string, nullable Fillimi i periudhës së furnizimit, `YYYY-MM-DD`
data.invoice.supply_end_date string, nullable Fundi i periudhës së furnizimit, `YYYY-MM-DD`
data.invoice.client object Blerësi i faturës
data.invoice.client.name string Emri i plotë i personit ose emri i kompanisë
data.invoice.client.id object Identifikuesi fiskal i blerësit
data.invoice.client.address object Adresa e blerësit
data.invoice.amount object Shumat e faturës, në monedhën e saj dhe në lekë
data.invoice.amount.currency string Monedha e faturës, ISO 4217
data.invoice.amount.exchange_rate any Kursi i këmbimit ndaj lekut; null kur fatura është tashmë në lek
data.invoice.amount.gross number Totali me TVSH, pasi është hequr zbritja mbi faturën
data.invoice.amount.net number Totali pa TVSH, pasi është hequr zbritja mbi faturën
data.invoice.amount.vat number TVSH-ja gjithsej
data.invoice.amount.discount number Zbritja mbi të gjithë faturën, si shumë pa TVSH: sa u hoq nga vlera pa TVSH e faturës. Zbritjet e rreshtave nuk janë këtu; ato janë te `lines[].discount`. Zero kur fatura nuk ka zbritje mbi faturën
data.invoice.amount.net_all number Totali pa TVSH në lek
data.invoice.amount.gross_all number Totali me TVSH në lek
data.invoice.amount.vat_all number TVSH-ja në lek
data.invoice.amount.discount_all number Zbritja mbi faturën në lek
data.invoice.amount.local_currency any I pranishëm vetëm në një faturë në monedhë të huaj
data.invoice.payment object Sa është shlyer nga fatura
data.invoice.payment.state string `PAID`, `PARTIALLY_PAID` ose `UNPAID`
data.invoice.payment.amount_paid number Shuma e arkëtuar deri tani, në monedhën e faturës
data.invoice.payment.amount_left number Totali me TVSH minus shumën e arkëtuar, në monedhën e faturës
data.invoice.bank_account object, nullable Llogaria bankare e shtypur në faturë, ose `null`
data.invoice.bank_account.id any Id-ja e llogarisë bankare në fature.al
data.invoice.bank_account.bank_name any Emri i bankës
data.invoice.bank_account.iban any IBAN-i i llogarisë
data.invoice.bank_account.swift any Kodi SWIFT i bankës
data.invoice.bank_account.currency any Monedha e llogarisë, ISO 4217
data.invoice.bank_account.notes any Shënime të lira mbi llogarinë
data.invoice.notes string, nullable Shënimet që dalin në faturë
data.invoice.iic string, nullable Kodi identifikues i faturës (IIC, në ligj NSLF)
data.invoice.fic string, nullable Kodi që ktheu CIS-i kur e regjistroi faturën (FIC, në ligj NIVF). `null` sa kohë fatura pret fiskalizimin
data.invoice.eic string, nullable Kodi i faturës në platformën e e-faturave. Vetëm te e-faturat
data.invoice.doc_type string, nullable Lloji i dokumentit në UBL: `380` faturë, `381` notë krediti, `383` notë debiti. `null` te një faturë e zakonshme fiskale
data.invoice.process string, nullable Profili UBL: `P1` për një shitje, `P9` për një korrigjim. Vendoset te e-faturat
data.invoice.self_issue_type string, nullable Lloji i vetëfaturimit, kur fatura është vetëfaturim
data.invoice.reversed_at string, nullable Kur u anulua fatura, `YYYY-MM-DD HH:MM:SS`, ose `null`
data.invoice.reversed_by integer, nullable Id-ja e faturës që kjo faturë anulon, ose `null`
data.invoice.pdf_url string URL-ja për të shkarkuar PDF-në e faturës
data.invoice.reverse_charge boolean Ngarkesë e kundërt: TVSH-në e deklaron blerësi
data.invoice.periodic_invoice boolean Faturë e një cikli të përsëritur faturimi
data.invoice.payment_methods array Një element për çdo mënyrë pagese, me shumën që u shlye me secilën. Një faturë e paguar me një mënyrë të vetme mban një element me të gjithë shumën
data.invoice.payment_methods[].type string Mënyra e pagesës, p.sh. `BANKNOTE` ose `CARD`
data.invoice.payment_methods[].amount number Shuma e shlyer me këtë mënyrë, me TVSH, në monedhën e faturës
data.invoice.payment_methods[].company_card any Numri i kartës së kompanisë; i plotësuar vetëm kur `type` është `COMPANY`, përndryshe null
data.invoice.payment_methods[].vouchers any Numrat serialë të tollonave; të plotësuar vetëm kur `type` është `SVOUCHER`, përndryshe listë bosh
data.invoice.lines array Rreshtat e faturës; ngarkohen vetëm kur lexohet një faturë e vetme
data.invoice.lines[].name string Emri i produktit ose i shërbimit
data.invoice.lines[].product_code string, nullable Kodi i produktit në fature.al, kur rreshti i përket një produkti të katalogut
data.invoice.lines[].unit string, nullable Njësia matëse
data.invoice.lines[].unit_code string, nullable Kodi i njësisë matëse, p.sh. `C62`
data.invoice.lines[].quantity number Sasia
data.invoice.lines[].unitPrice number Çmimi për njësi me TVSH, pasi është hequr zbritja e rreshtit
data.invoice.lines[].vat_rate number, nullable Norma e TVSH-së në përqind
data.invoice.lines[].vat_exempt_type string, nullable Tipi i përjashtimit nga TVSH-ja, kur rreshti është i përjashtuar
data.invoice.lines[].discount_rate number, nullable Zbritja e rreshtit në përqind, siç u dërgua te `lines[].discount`; null kur rreshti nuk ka zbritje
data.invoice.lines[].discount number, nullable Shuma e zbritjes së rreshtit, pa TVSH
data.invoice.lines[].amount_net number Vlera e rreshtit pa TVSH
data.invoice.lines[].amount_vat number TVSH-ja e rreshtit
data.invoice.lines[].total number Totali i rreshtit me TVSH

401 Unauthenticated

Field Tipi Përshkrimi
message string

Shembull kërkese

cURL 
curl -X GET 'https://fature.al/api/v2/invoice/403/details' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
PHP (Laravel) 
use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/v2/invoice/403/details');

$data = $response->json();
PHP (Guzzle) 
use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice/403/details', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);
JavaScript 
const response = await fetch('https://fature.al/api/v2/invoice/403/details', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Shembull përgjigjeje

200 
{
    "status": true,
    "data": {
        "invoice": {
            "id": 40323,
            "number": "12/2026",
            "type": "EINVOICE",
            "issue_date": "2026-09-13",
            "due_date": "2026-09-27",
            "delivery_date": "2026-09-13",
            "created_at": "2026-09-13 10:15:00",
            "supply_start_date": "2026-09-01",
            "supply_end_date": "2026-09-13",
            "client": {
                "name": "Alba Trade shpk",
                "id": [],
                "address": []
            },
            "amount": {
                "currency": "EUR",
                "exchange_rate": 98.5,
                "gross": 540,
                "net": 450,
                "vat": 90,
                "discount": 0,
                "net_all": 44325,
                "gross_all": 53190,
                "vat_all": 8865,
                "discount_all": 0,
                "local_currency": "USD"
            },
            "payment": {
                "state": "PARTIALLY_PAID",
                "amount_paid": 300,
                "amount_left": 240
            },
            "bank_account": {
                "id": 27,
                "bank_name": "Banka Kombëtare Tregtare",
                "iban": "AL47212110090000000235698741",
                "swift": "NCBAALTX",
                "currency": "EUR",
                "notes": "Llogaria në euro"
            },
            "notes": "Pagesa brenda 14 ditëve.",
            "iic": "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35",
            "fic": "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91",
            "eic": "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65",
            "doc_type": 380,
            "process": "P1",
            "self_issue_type": "DOMESTIC",
            "reversed_at": "2026-09-14 08:05:00",
            "reversed_by": 40311,
            "pdf_url": "https://fature.al/api/v1/invoice/print/40323",
            "reverse_charge": false,
            "periodic_invoice": false,
            "payment_methods": [
                {
                    "type": "ACCOUNT",
                    "amount": 540,
                    "company_card": "company card",
                    "vouchers": []
                }
            ],
            "lines": [
                {
                    "name": "Orë pune mirëmbajtje",
                    "product_code": "SRV-MNT",
                    "unit": "Orë",
                    "unit_code": "HUR",
                    "quantity": 2,
                    "unitPrice": 270,
                    "vat_rate": 20,
                    "vat_exempt_type": "TYPE_1",
                    "discount_rate": 10,
                    "discount": 50,
                    "amount_net": 450,
                    "amount_vat": 90,
                    "total": 540
                }
            ]
        }
    }
}
401 
{
    "message": "Unauthenticated."
}

Regjistrimi është falas.

Regjistrohu në fature.al

This page as Markdown, or the whole API as OpenAPI.