Merr një produkt sipas id (v1): fature.al API

GET /api/v1/products/{id}/details 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.

Kthen një produkt të vetëm me të gjitha fushat: kodin, emrin, njësinë me kodin e saj fiskal, çmimet, normën e TVSH-së me llojin e përjashtimit, service dhe kategorinë si objekt.

Përdoreni kur keni id-në nga lista ose nga krijimi dhe ju duhen fushat që lista nuk i mban.

URL-ja e plotë: https://fature.al/api/v1/products/{id}/details

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
id	integer	yes	Id-ja e produktit në fature.al.

Përgjigjet

200 Produkti i kërkuar te `product`, me të gjitha fushat.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.product	object
data.product.id	integer	Id-ja e produktit në fature.al
data.product.code	string, nullable	Kodi unik i produktit
data.product.name	string	Emri i produktit
data.product.description	string, nullable	Përshkrimi i produktit
data.product.unit	string, nullable	Njësia matëse, e nxjerrë nga `unit_code`
data.product.unit_code	string, nullable	Kodi i njësisë matëse, p.sh. `C62`, `XPP`, `LTR`
data.product.last_price	number	Çmimi i shitjes
data.product.cost_price	number, nullable	Çmimi i blerjes, kur është regjistruar
data.product.vat_rate	number	Norma e TVSH-së në përqind: 0, 6, 10 ose 20
data.product.vat_exempt_type	string, nullable	Tipi i përjashtimit nga TVSH-ja, kur produkti është i përjashtuar
data.product.vat_exempt_description	string, nullable	Përjashtimi i shkruar në gjuhën e llogarisë
data.product.currency	string, nullable	Monedha e çmimit
data.product.id_category	integer, nullable	Id-ja e kategorisë, ose null kur produkti nuk ka
data.product.service	boolean	true për një shërbim, false për një artikull që ndiqet në magazinë
data.product.category	object, nullable	Kategoria e produktit, ose null kur nuk ka
data.product.category.id	integer	Id-ja e kategorisë
data.product.category.name	string	Emri i kategorisë
data.product.category.color	string, nullable	Ngjyra në hex që përdor rrjeta e produkteve në POS
data.product.created_at	string, nullable	Data dhe ora e krijimit, ISO 8601

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

404 Produkti 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`

500 Gabim i papritur në server.

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/products/42/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/v1/products/42/details');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/products/42/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/v1/products/42/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": {
        "product": {
            "id": 314,
            "code": "SRV-MNT",
            "name": "Orë pune mirëmbajtje",
            "description": "Mirëmbajtje e sistemit, faturohet për orë",
            "unit": "Orë",
            "unit_code": "HUR",
            "last_price": 300,
            "cost_price": 150,
            "vat_rate": 20,
            "vat_exempt_type": "TYPE_1",
            "vat_exempt_description": "Përjashtim i llojit 1. (Përjashtim në bazë të nenit 51 të Ligjit për TVSH-në.)",
            "currency": "EUR",
            "id_category": 12,
            "service": true,
            "category": {
                "id": 12,
                "name": "Shërbime",
                "color": "dd9f52"
            },
            "created_at": "2026-01-15T09:00:00+01:00"
        }
    }
}

401

{
    "message": "Unauthenticated."
}

404

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

500

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