Merr një faturë sipas internalId (v2): fature.al API

POST /api/v2/invoice/details/{internalId} 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.

I njëjti rezultat lëshimi si te v1, me payment_methods bashkë me të. Përdoreni për të lexuar gjendjen pas një timeout-i ose pas një 409.

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

Ndryshuar që nga v1:

What changed	v1	v2
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`	—	string, nullable
200 `data.invoice.payment_methods[].vouchers`	—	array
404	documented	not documented
422	documented	not documented
500	documented	not documented

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
internalId	string	yes	Identifikuesi juaj i faturës, i dërguar kur u lëshua.

Përgjigjet

200 Rezultati i lëshimit të faturës me këtë `internalId`, i njëjti që ktheu lëshimi, me `payment_methods`.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.invoice	object, or OrderInvoiceIssueResult, SummaryInvoiceIssueResult
data.invoice.id	integer	Id-ja e faturës në fature.al. Ruajeni pranë `internalId` tuaj
data.invoice.number	string, nullable	Numri i faturës, si `12/2026`
data.invoice.iic	string, nullable	Kodi identifikues i faturës, IIC (NSLF)
data.invoice.fic	string, nullable	Kodi që kthen CIS-i kur regjistron faturën, FIC (NIVF). Null sa kohë fatura pret fiskalizimin e shtyrë
data.invoice.tcrCode	string, nullable	Kodi TCR i pajisjes fiskale që e lëshoi; null te faturat që nuk lëshohen nga një TCR
data.invoice.businessCode	string, nullable	Kodi i njësisë së biznesit nën të cilën u lëshua fatura
data.invoice.operatorCode	string, nullable	Kodi i operatorit që e lëshoi faturën
data.invoice.fiscalizedAt	string	Data dhe ora e krijimit të faturës, `YYYY-MM-DD HH:MM:SS`, orë lokale
data.invoice.verifyURL	string, nullable	URL-ja e verifikimit te administrata tatimore, ajo që hap kodi QR
data.invoice.pdf	string	URL-ja për të shkarkuar dokumentin. Te një e-faturë që ka tashmë EIC, tregon PDF-në zyrtare të platformës së e-faturave në vend të asaj të fature.al
data.invoice.eic	string, nullable	Kodi i e-faturës në platformën e e-faturave, EIC. Çelësi është i pranishëm vetëm te një e-faturë që e ka tashmë; te çdo faturë tjetër mungon fare, nuk vjen null
data.invoice.payment_methods	array	Një element për çdo mënyrë pagese, me shumën që u shlye me secilën. E njëjta listë që kthen `GET /invoice/{id}/details`
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	string, nullable	Numri i kartës së kompanisë; i plotësuar vetëm kur `type` është `COMPANY`, përndryshe null
data.invoice.payment_methods[].vouchers	array	Numrat serialë të tollonave; të plotësuar vetëm kur `type` është `SVOUCHER`, përndryshe listë bosh

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

Shembull kërkese

cURL

curl -X POST 'https://fature.al/api/v2/invoice/details/CASH-001' \
  -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',
])->post('https://fature.al/api/v2/invoice/details/CASH-001');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://fature.al/api/v2/invoice/details/CASH-001', [
    '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/details/CASH-001', {
  method: 'POST',
  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",
            "iic": "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35",
            "fic": "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91",
            "tcrCode": "xb131xb131",
            "businessCode": "bb123bb123",
            "operatorCode": "aa123aa123",
            "fiscalizedAt": "2026-09-13 10:15:00",
            "verifyURL": "https://efiskalizimi-app.tatime.gov.al/invoice-check/#/verify?iic=3C7E9A1F52B84D0E6A2C4F8B1D9E7A35&tin=L81306019C&crtd=2026-09-13T10:15:00+02:00&prc=53190.00",
            "pdf": "https://fature.al/api/v1/invoice/print/40323",
            "eic": "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65",
            "payment_methods": [
                {
                    "type": "ACCOUNT",
                    "amount": 540,
                    "company_card": "company card",
                    "vouchers": []
                }
            ]
        }
    }
}

401

{
    "message": "Unauthenticated."
}