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, e rrumbullakosur lart në numër të plotë (0,3 kg jep 1)
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.

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/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 
{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

Regjistrimi është falas.

Regjistrohu në fature.al

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