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

GET /api/v2/invoice/wtn/details/{internalId} 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ë njëjtin objekt si GET /invoice/wtn/{id}/details, por sipas identifikuesit që ju dërguat te internalId kur u lëshua fleta, pa mbajtur id-në tonë. Meqë te v2 internalId është i detyrueshëm, çdo fletë e lëshuar nga ky version lexohet kështu.

Kur i njëjti internalId është përdorur në më shumë se një vit, kthehet fleta më e re.

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

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
internalId	string	yes	Identifikuesi juaj i fletës, i dërguar kur u lëshua.

Përgjigjet

200 Fleta e plotë te `invoice`, e njëjta që kthen `GET /invoice/wtn/{id}/details`.

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 Asnjë fletë me këtë `internalId` në njësinë tuaj.

422 `internalId` është bosh.

500 Gabim i papritur në server.

Shembull kërkese

cURL

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice/wtn/details/WTN-2026-000412', [
    '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/details/WTN-2026-000412', {
  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

422

example

500

example