Listo faturat elektronike të blerjes (v1): fature.al API

GET /api/v1/purchase-einvoices Requires authentication Rate limited by the `api-global` limiter v1

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

Kthen faturat elektronike që furnitorët i kanë dërguar biznesit tuaj, të lexuara nga shërbimi i faturave elektronike të CIS-it, secila me EIC-në dhe statusin. Ato me canChangeStatus: true presin përgjigjen tuaj: pranojini me POST /purchase-einvoices/{eic}/accept ose refuzojini me POST /purchase-einvoices/{eic}/refuse.

Periudha përfshin të dyja ditët, nga ora 00:00:00 e fromDate deri në 23:59:59 të toDate, sipas datës kur CIS-i e mori faturën. Data që mungon merr ditën e sotme.
CIS-i i kthen të gjitha faturat e periudhës në një përgjigje, prandaj lista nuk ka faqe. Për periudha të gjata kërkoni muaj pas muaji.
Lista kthehet nga më e reja te më e vjetra.

URL-ja e plotë: https://fature.al/api/v1/purchase-einvoices

Query parameters

Name	Tipi	E detyrueshme	Përshkrimi
status	string	no	Kthe vetëm faturat me këtë status: `DELIVERED`, `ACCEPTED`, `REFUSED`, `PAID`, `PARTIALLY_PAID` ose `OVERPAID`.
fromDate	string	no	Data e fillimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme.
toDate	string	no	Data e mbarimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme.
eic	string	no	Kthe vetëm faturën me këtë EIC.
sellerTin	string	no	Kthe vetëm faturat e furnitorit me këtë NIPT.

Përgjigjet

200 Faturat elektronike të periudhës te `items`, me numrin e tyre te `count`.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.items	array
data.items[].eic	string	Kodi identifikues i faturës elektronike, EIC. Me të pranohet ose refuzohet fatura
data.items[].docNumber	string	Numri i faturës siç e lëshoi furnitori
data.items[].sellerTin	string	NIPT-i i furnitorit
data.items[].sellerName	string, nullable	Emri i furnitorit, kur NIPT-i i tij është te klientët tuaj në fature.al; ndryshe `null`
data.items[].buyerTin	string	NIPT-i i blerësit, pra i biznesit tuaj
data.items[].receivedAt	string	Data dhe ora kur CIS-i e mori faturën: datë-orë ISO 8601 me zonën orare
data.items[].dueDate	string, nullable	Afati i pagesës, `YYYY-MM-DD`; `null` kur fatura nuk mban afat
data.items[].status	string	Statusi i faturës te CIS-i: `DELIVERED` (pret përgjigjen tuaj), `ACCEPTED`, `REFUSED`, `PAID`, `PARTIALLY_PAID` ose `OVERPAID`
data.items[].canChangeStatus	boolean	`true` kur statusi lejon ende pranimin ose refuzimin: `DELIVERED` ose `PARTIALLY_PAID`
data.items[].amount	number	Shuma totale e faturës, me TVSH, në monedhën e saj
data.items[].currency	string	Kodi ISO 4217 i monedhës së faturës
data.count	integer

401 Token-i mungon ose nuk është i vlefshëm, ose biznesi nuk lëshon fatura.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

403 Përdoruesi nuk ka të drejtën e faturave elektronike të blerjes.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

422 Datat nuk janë në formatin `YYYY-MM-DD`, ose `status` nuk është një nga vlerat e lejuara.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

429 Kufiri i kërkesave u arrit. Nga kufiri i përgjithshëm përgjigja mban vetëm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard të gabimit.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

500 Gabim i papritur në server.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

502 CIS-i u përgjigj me një gabim; arsyeja është te `message`.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

503 Shërbimi i faturave elektronike nuk u arrit. Riprovoni më vonë. `message` vjen bosh; arsyeja është te `errors`.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data`
message	string	Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin
errors	array	Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message`

Shembull kërkese

cURL

curl -X GET 'https://fature.al/api/v1/purchase-einvoices' \
  -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/v1/purchase-einvoices');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/purchase-einvoices', [
    '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/v1/purchase-einvoices', {
  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": {
        "items": [
            {
                "eic": "3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76",
                "docNumber": "152/2026",
                "sellerTin": "K12345678A",
                "sellerName": "Furnizime Tirana shpk",
                "buyerTin": "L88776655B",
                "receivedAt": "2026-11-03T10:15:23+01:00",
                "dueDate": "2026-12-03",
                "status": "DELIVERED",
                "canChangeStatus": true,
                "amount": 24000,
                "currency": "ALL"
            }
        ],
        "count": 3
    }
}

401

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

403

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

422

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

429

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

500

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

502

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

503

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}