Listo fletët shoqëruese (v2): fature.al API

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

E njëjta listë si te GET /api/v1/invoice/wtn: fletët e kompanisë, nga më e reja te më e vjetra, me filtrim sipas datës së krijimit. Çdo fletë vjen e plotë, me origin, destination, carrier, fiscal dhe lines, kështu që për rreshtat nuk duhet një thirrje e dytë, dhe me internalId ashtu siç u dërgua.

Pagination me limit dhe offset. pagination nuk kthen total, ndaj ndaloni kur një faqe vjen më e shkurtër se limit.
Një kërkesë e dytë nga i njëjti token, ndërsa e para nuk ka mbaruar, refuzohet menjëherë me 429. Vendi lirohet sapo kthehet përgjigja, ose pas 30 sekondash nëse kërkesa u ndërpre.

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

Ndryshuar që nga v1:

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

Query parameters

Name	Tipi	E detyrueshme	Përshkrimi
limit	integer	no	Sa fletë të kthehen në një faqe. Defaults to `20`.
offset	integer	no	Nga cila fletë të fillohet, duke numëruar nga 0. Defaults to `0`.
fromDate	string	no	Data e fillimit, `YYYY-MM-DD`, sipas datës së krijimit.
toDate	string	no	Data e mbarimit, `YYYY-MM-DD`.

Përgjigjet

200 Lista e fletëve të periudhës, me `pagination`; `items` është bosh kur nuk ka fletë.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.items	array
data.items[].id	integer	Id-ja e fletës në fature.al; me të lexohen detajet dhe të dhënat për printim
data.items[].internalId	string	Identifikuesi i fletës në sistemin tuaj, ai që dërguat te `internalId` kur u lëshua
data.items[].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.items[].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.items[].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.items[].issue_date	string, nullable	Data dhe ora e lëshimit, `YYYY-MM-DD HH:MM:SS`, orë lokale
data.items[].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.items[].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.items[].origin	any	Pika e nisjes së mallit
data.items[].destination	any	Pika e mbërritjes së mallit
data.items[].carrier	any	Transportuesi dhe automjeti
data.items[].value_of_goods	number	Vlera e mallit që udhëton, në lekë, siç u dërgua te `valueOfGoods`
data.items[].items_num	integer	Sasia e mallit: shuma e `quantity` të rreshtave, si numër i plotë
data.items[].fiscal	any	Gjendja dhe kodet e fiskalizimit të fletës
data.items[].lines	array	Rreshtat e mallit, ashtu siç u dërguan te `invoice_lines`
data.items[].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
data.pagination	object
data.pagination.records	integer	Sa fletë mban `items` në këtë faqe
data.pagination.limit	integer	Parametri `limit` i kërkesës, pas rrumbullakimit në të paktën 1
data.pagination.offset	integer	Parametri `offset` i kërkesës, pas rrumbullakimit në të paktën 0

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

422 Datat nuk janë në formatin `YYYY-MM-DD`.

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.

500 Gabim i papritur në server.

Shembull kërkese

cURL

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice/wtn', [
    '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', {
  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": [
            {
                "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"
            }
        ],
        "pagination": {
            "records": 20,
            "limit": 20,
            "offset": 0
        }
    }
}

401

{
    "message": "Unauthenticated."
}

422

example

429

example

500

example