Merr raportin e fletëve shoqëruese (v1): fature.al API

GET /api/v1/reports/wtn Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

Fletët shoqëruese (WTN) të periudhës, të grupuara sipas gjendjes fiskale te by_status, bashkë me destinacionet e përdorura dhe vlerën e mallit që ka lëvizur.

Një fletë e pafiskalizuar këtu kërkon vëmendje: malli ka lëvizur pa dokumentin që ligji kërkon.

URL-ja e plotë: https://fature.al/api/v1/reports/wtn

Query parameters

Name	Tipi	E detyrueshme	Përshkrimi
from	string<date>	yes	Data e fillimit, `YYYY-MM-DD`, e përfshirë. E detyrueshme.
to	string<date>	yes	Data e mbarimit, `YYYY-MM-DD`, e përfshirë. E detyrueshme. Kur është para `from`, të dyja ndërrohen vend.

Përgjigjet

200 Fletët shoqëruese të periudhës te `data`: `totals`, ndarja sipas gjendjes fiskale te `by_status` dhe qytetet e destinacionit te `destinations`; `by_status` dhe `destinations` janë bosh kur periudha nuk ka fletë.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.period	object	Periudha e konfirmuar e raportit
data.period.from	string	Data e fillimit, `YYYY-MM-DD`, përfshirëse
data.period.to	string	Data e mbarimit, `YYYY-MM-DD`, përfshirëse
data.totals	object	Numri dhe vlera e të gjitha fletëve të periudhës
data.totals.count	integer	Numri i fletëve shoqëruese të periudhës
data.totals.value_of_goods	number	Vlera e mallit e deklaruar në fletë, gjithsej, në lekë
data.by_status	array	Një rresht për çdo gjendje fiskale të hasur
data.by_status[].status	string, nullable	Gjendja fiskale e fletëve: `FISCALIZED` të regjistruara në CIS, `UNFISCALIZED` ende pa u regjistruar; `null` te fletët pa gjendje të shënuar
data.by_status[].count	integer	Sa fletë janë në këtë gjendje
data.by_status[].value_of_goods	number	Vlera e mallit e deklaruar në to, gjithsej, në lekë
data.unique_destinations	integer	Sa qytete të ndryshme destinacioni kanë fletët e periudhës; sa gjatësia e `destinations`
data.destinations	array	Qytetet e destinacionit, secili një herë, ashtu siç janë shkruar në fletë; fletët pa qytet nuk hyjnë

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

403 Përdoruesi nuk ka të drejtën e raporteve. Një operator merr në raport vetëm faturat e veta.

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`

422 `from` ose `to` mungon, ose nuk është në formatin `YYYY-MM-DD`. Kjo përgjigje përdor fushën `success`, jo `status`, dhe `errors` është objekt sipas fushës.

Field	Tipi	Përshkrimi
success	boolean	Gjithmonë false
message	string	Një rresht përmbledhës, i njëjtë për çdo dështim validimi
errors	object	Fushat që nuk kaluan validimin, secila me mesazhet e veta. Çelësat me pikë tregojnë brenda objekteve dhe elementëve të array-ve, p.sh. `lines.0.quantity`

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.

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/v1/reports/wtn?from=2026-01-01&to=2026-01-31' \
  -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/v1/reports/wtn?from=2026-01-01&to=2026-01-31');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/reports/wtn?from=2026-01-01&to=2026-01-31', [
    '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/v1/reports/wtn?from=2026-01-01&to=2026-01-31', {
  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": {
        "period": {
            "from": "2026-09-01",
            "to": "2026-09-13"
        },
        "totals": {
            "count": 42,
            "value_of_goods": 1560000
        },
        "by_status": [
            {
                "status": "FISCALIZED",
                "count": 40,
                "value_of_goods": 1498000
            }
        ],
        "unique_destinations": 3,
        "destinations": [
            "Tiranë",
            "Durrës",
            "Shkodër"
        ]
    }
}

401

{
    "message": "Unauthenticated."
}

403

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}

422

{
    "success": false,
    "message": "Te dhena jo te sakta",
    "errors": []
}

429

{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}