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 fletën shoqëruese për printim

GET /api/v2/invoice/wtn/print/{id} 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.

Kthen të dhënat e fletës si JSON të gatshëm për dokument, jo si PDF: kompaninë me logon, transportuesin, nisjen dhe mbërritjen, dhe te invoice numrin, kodet fiskale, rreshtat, amounts dhe verifyUrl.

Përdoreni kur e formatoni vetë dokumentin, në sistemin tuaj të printimit. Adresa e këtij endpoint-i vjen te fusha print e listës dhe e detajeve.

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

Path parameters

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

Përgjigjet

200 Dokumenti i fletës në JSON, gati për ta formatuar vetë: kompania me logon, transportuesi, nisja, mbërritja dhe `invoice` me rreshtat dhe kodet fiskale.

Field Tipi Përshkrimi
status boolean
data object
data.logo string, nullable Logoja e kompanisë si përmbajtje e skedarit në base64, pa prefiksin `data:`; `null` kur nuk është vendosur
data.title string Titulli i dokumentit; gjithmonë `Faturë Shoqëruese`
data.company object Lëshuesi i fletës
data.company.name string, nullable Emri siç printohet: kompania, ose njësia që e lëshoi fletën kur kompania e ka zgjedhur këtë në cilësimet e saj
data.company.nuis string, nullable NIPT-i i kompanisë
data.company.address string, nullable Adresa e njësisë që e lëshoi fletën; adresa e kompanisë kur njësia nuk ka të vetën
data.carrier object Transportuesi dhe automjeti
data.carrier.name string, nullable Emri i transportuesit
data.carrier.idType string, nullable Lloji i identifikuesit të transportuesit: `NUIS` për një biznes, `ID` për një person
data.carrier.idNum string, nullable NIPT-i ose numri i dokumentit të transportuesit, sipas `idType`
data.carrier.town string, nullable Qyteti i transportuesit
data.carrier.address string, nullable Adresa e transportuesit
data.carrier.vehicleOwnership string, nullable Pronësia e automjetit: `OWNER` automjet i kompanisë, `THIRDPARTY` automjet i një pale të tretë
data.carrier.vehiclePlates string, nullable Targa e automjetit, me shkronja të mëdha
data.origin object Pika e nisjes së mallit, me datën dhe orën
data.origin.point string, nullable Lloji i vendit: `WAREHOUSE` magazinë, `STORE` dyqan, `SALE` pikë shitjeje, `EXHIBITION` panair, `CUSTOMS` doganë, `ANOTHER` magazinë e një personi tjetër, `OTHER` tjetër. Kur nuk u dërgua gjë, nisja mban `WAREHOUSE` dhe mbërritja `STORE`
data.origin.city string, nullable Qyteti; qyteti i kompanisë kur nuk u dërgua
data.origin.address string, nullable Adresa; adresa e njësisë së biznesit kur nuk u dërgua
data.origin.dateTime string, nullable Data dhe ora e nisjes ose e mbërritjes, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua
data.destination object Pika e mbërritjes së mallit, me datën dhe orën
data.destination.point string, nullable Lloji i vendit: `WAREHOUSE` magazinë, `STORE` dyqan, `SALE` pikë shitjeje, `EXHIBITION` panair, `CUSTOMS` doganë, `ANOTHER` magazinë e një personi tjetër, `OTHER` tjetër. Kur nuk u dërgua gjë, nisja mban `WAREHOUSE` dhe mbërritja `STORE`
data.destination.city string, nullable Qyteti; qyteti i kompanisë kur nuk u dërgua
data.destination.address string, nullable Adresa; adresa e njësisë së biznesit kur nuk u dërgua
data.destination.dateTime string, nullable Data dhe ora e nisjes ose e mbërritjes, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua
data.invoice object Vetë fleta: numri, kodet fiskale, rreshtat dhe vlera e mallit
data.invoice.issueDate string, nullable Data dhe ora e lëshimit, `YYYY-MM-DD HH:MM:SS`, orë lokale
data.invoice.businessCode string, nullable Kodi i njësisë së biznesit nën të cilën u lëshua fleta
data.invoice.operatorCode string, nullable Kodi i operatorit që e lëshoi fletën
data.invoice.deviceCode string, nullable Kodi TCR i pajisjes fiskale të përdoruesit që e lëshoi fletën
data.invoice.number string, nullable Numri i fletës, si `3/2026`: numri rendor i fletës brenda ditës për njësinë e biznesit, dhe viti
data.invoice.type string, nullable Lloji i fletës: `WTN` për mall që lëviz pa shitje, `SALE` për mall që shoqëron një shitje
data.invoice.transaction string, nullable Lloji i transaksionit: `TRANSFER` zhvendosje malli, `EXAMINATION` dërgim për ekzaminim ose provë, `SALES` shitje, `DOOR` shitje derë më derë
data.invoice.lines array Rreshtat e mallit
data.invoice.lines[].name any Emri ose përshkrimi i mallit
data.invoice.lines[].code any Kodi i mallit
data.invoice.lines[].unit any Njësia matëse
data.invoice.lines[].quantity any Sasia, siç është ruajtur; `null` vetëm te një rresht i ruajtur pa sasi
data.invoice.amounts object Vlera e mallit dhe sasia, gati për printim
data.invoice.amounts.valueOfGoods number Vlera e mallit që udhëton, në lekë
data.invoice.amounts.currency string Monedha e vlerës; gjithmonë `ALL`
data.invoice.amounts.itemsNum integer Sasia e mallit: shuma e `quantity` të rreshtave, si numër i plotë
data.invoice.iic string, nullable Kodi identifikues i fletës (WTNIC, në rolin e IIC-së së faturave), 32 shifra hex
data.invoice.fic string, nullable Kodi që ktheu CIS-i kur e regjistroi fletën (FWTNIC, në rolin e FIC-ut); `null` sa kohë fleta pret fiskalizimin
data.invoice.fiscalStatus string, nullable `FISCALIZED` kur CIS-i e ka regjistruar fletën, `UNFISCALIZED` sa kohë ajo pret fiskalizimin
data.invoice.verifyUrl string, nullable URL-ja e verifikimit të fletës te administrata tatimore, ajo që kodohet si QR; `null` kur fleta nuk ka `iic`
data.invoice.footer array Rreshtat që printohen në fund të dokumentit, tashmë të renditur: shënimi i parazgjedhur i faturave të kompanisë kur ekziston, pastaj `fiskalizoi: fature.al` dhe `---`

401 Unauthenticated

Field Tipi Përshkrimi
message string

404 Fleta nuk u gjet, ose nuk i përket kompanisë suaj.

Shembull kërkese

cURL 
curl -X GET 'https://fature.al/api/v2/invoice/wtn/print/403' \
  -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/wtn/print/403');

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

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice/wtn/print/403', [
    '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/wtn/print/403', {
  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": {
        "logo": "iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAA",
        "title": "Faturë Shoqëruese",
        "company": {
            "name": "Alba Trade SHPK",
            "nuis": "L01234567A",
            "address": "Rruga e Kavajës 12"
        },
        "carrier": {
            "name": "Transport Alba SHPK",
            "idType": "NUIS",
            "idNum": "L01234567A",
            "town": "Tiranë",
            "address": "Rruga e Kavajës 12",
            "vehicleOwnership": "OWNER",
            "vehiclePlates": "AA123BB"
        },
        "origin": {
            "point": "WAREHOUSE",
            "city": "Tiranë",
            "address": "Rruga e Kavajës 12",
            "dateTime": "2026-09-13 10:30:00"
        },
        "destination": {
            "point": "WAREHOUSE",
            "city": "Tiranë",
            "address": "Rruga e Kavajës 12",
            "dateTime": "2026-09-13 10:30:00"
        },
        "invoice": {
            "issueDate": "2026-09-13 10:30:00",
            "businessCode": "bb123bb123",
            "operatorCode": "oo123oo123",
            "deviceCode": "cc123cc123",
            "number": "3/2026",
            "type": "WTN",
            "transaction": "TRANSFER",
            "lines": [
                {
                    "name": "Kafe e pjekur 1kg",
                    "code": "K1",
                    "unit": "cope",
                    "quantity": 5
                }
            ],
            "amounts": {
                "valueOfGoods": 10000,
                "currency": "ALL",
                "itemsNum": 5
            },
            "iic": "A1B2C3D4E5F60718293A4B5C6D7E8F90",
            "fic": "7f1e2d3c-4b5a-4c6d-8e9f-0a1b2c3d4e5f",
            "fiscalStatus": "FISCALIZED",
            "verifyUrl": "https://efiskalizimi-app.tatime.gov.al/invoice-check/#/wtn?wtnic=A1B2C3D4E5F60718293A4B5C6D7E8F90&tin=L01234567A&crtd=2026-09-13T10:30:00+02:00&ord=3&bu=bb123bb123&sw=ss123ss123",
            "footer": [
                "fiskalizoi: fature.al",
                "---"
            ]
        }
    }
}
401 
{
    "message": "Unauthenticated."
}
404 
example

Regjistrimi është falas.

Regjistrohu në fature.al

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