Merr një fletë shoqëruese sipas id (v2): fature.al API

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

Kthen fletën e plotë sipas id-së së saj në fature.al: automjetin, pikën e nisjes dhe të mbërritjes, transportuesin, kodet fiskale dhe rreshtat e mallit. Është i njëjti objekt që kthen lista.

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

Ndryshuar që nga v1:

What changed	v1	v2
200 `data.invoice.origin.point`	string, nullable	—
200 `data.invoice.origin.city`	string, nullable	—
200 `data.invoice.origin.address`	string, nullable	—
200 `data.invoice.destination.point`	string, nullable	—
200 `data.invoice.destination.city`	string, nullable	—
200 `data.invoice.destination.address`	string, nullable	—
200 `data.invoice.carrier.name`	string, nullable	—
200 `data.invoice.carrier.id_type`	string, nullable	—
200 `data.invoice.carrier.id_num`	string, nullable	—
200 `data.invoice.carrier.town`	string, nullable	—
200 `data.invoice.carrier.address`	string, nullable	—
200 `data.invoice.carrier.vehicle_ownership`	string, nullable	—
200 `data.invoice.carrier.vehicle_plates`	string, nullable	—
200 `data.invoice.fiscal.status`	string, nullable	—
200 `data.invoice.fiscal.iic`	string, nullable	—
200 `data.invoice.fiscal.fic`	string, nullable	—
200 `data.invoice.fiscal.tcr_code`	string, nullable	—
200 `data.invoice.fiscal.business_code`	string, nullable	—
200 `data.invoice.fiscal.operator_code`	string, nullable	—
200 `data.invoice.fiscal.fiscalized_at`	string, nullable	—
200 `data.invoice.fiscal.verify_url`	string, nullable	—
200 `data.invoice.lines[].product_name`	string, nullable	—
200 `data.invoice.lines[].product_code`	string, nullable	—
200 `data.invoice.lines[].unit`	string, nullable	—
200 `data.invoice.lines[].quantity`	number	—
200 `data.invoice.internalId`	—	string
200 `data.invoice.origin`	object	any
200 `data.invoice.destination`	object	any
200 `data.invoice.carrier`	object	any
200 `data.invoice.fiscal`	object	any

Path parameters

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

Përgjigjet

200 Fleta e plotë te `invoice`: pikat e nisjes dhe të mbërritjes, transportuesi, kodet fiskale dhe rreshtat e mallit.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.invoice	object
data.invoice.id	integer	Id-ja e fletës në fature.al; me të lexohen detajet dhe të dhënat për printim
data.invoice.internalId	string	Identifikuesi i fletës në sistemin tuaj, ai që dërguat te `internalId` kur u lëshua
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.issue_date	string, nullable	Data dhe ora e lëshimit, `YYYY-MM-DD HH:MM:SS`, orë lokale
data.invoice.start_date	string, nullable	Data dhe ora e nisjes së mallit, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua
data.invoice.destination_date	string, nullable	Data dhe ora e mbërritjes së mallit, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua
data.invoice.origin	any	Pika e nisjes së mallit
data.invoice.destination	any	Pika e mbërritjes së mallit
data.invoice.carrier	any	Transportuesi dhe automjeti
data.invoice.value_of_goods	number	Vlera e mallit që udhëton, në lekë, siç u dërgua te `valueOfGoods`
data.invoice.items_num	integer	Sasia e mallit: shuma e `quantity` të rreshtave, si numër i plotë
data.invoice.fiscal	any	Gjendja dhe kodet e fiskalizimit të fletës
data.invoice.lines	array	Rreshtat e mallit, ashtu siç u dërguan te `invoice_lines`
data.invoice.print	string	URL-ja e `GET /invoice/wtn/print/{id}`, të dhënat e kësaj flete për printim. Vjen nën të njëjtin version që e ktheu fletën

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

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

500 Gabim i papritur në server.

Shembull kërkese

cURL

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice/wtn/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/wtn/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": 403,
            "internalId": "WTN-2026-000412",
            "number": "3/2026",
            "type": "WTN",
            "transaction": "TRANSFER",
            "issue_date": "2026-09-13 10:30:00",
            "start_date": "2026-09-13 10:30:00",
            "destination_date": "2026-09-13 14:30:00",
            "origin": "origin",
            "destination": "destination",
            "carrier": "carrier",
            "value_of_goods": 10000,
            "items_num": 5,
            "fiscal": "fiscal",
            "lines": [
                "lines"
            ],
            "print": "https://fature.al/api/v1/invoice/wtn/print/403"
        }
    }
}

401

{
    "message": "Unauthenticated."
}

404

example

500

example