Merr gjendjen e arkës (v2): fature.al API

Merr gjendjen e arkës

GET /api/v2/cash-register/balance 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 gjendjen e pajisjes fiskale (TCR) të përdoruesit të token-it, në ALL, bashkë me kodin e saj fiscal_tcr_code.

Pa toDate kthehet gjendja e tanishme. Me toDate kthehet gjendja në fund të asaj dite, për rakordim me një ditë të shkuar. Gjendja ruhet në cache për 5 sekonda, ndaj një veprim i sapo regjistruar mund të duket pas pak.

Përdoruesi duhet të ketë një TCR.

URL-ja e plotë: https://fature.al/api/v2/cash-register/balance

Query parameters

Name	Tipi	E detyrueshme	Përshkrimi
toDate	string<date>, nullable	no	Data, `YYYY-MM-DD`, deri te e cila llogaritet gjendja e arkës. Pa të kthehet gjendja e fundit.

Përgjigjet

200 Kur përdoruesi nuk ka pajisje fiskale, përgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja është te `message`.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.fiscal_tcr_code	string	Kodi i pajisjes fiskale (TCR) të përdoruesit të token-it, ajo për të cilën u llogarit gjendja
data.currency	string	Kodi ISO 4217 i monedhës së gjendjes; gjithmonë `ALL`
data.to_date	string, nullable	Parametri `toDate` i kërkesës ashtu siç u dërgua, `YYYY-MM-DD`: gjendja është ajo në fund të kësaj dite, me çdo veprim dhe faturë të regjistruar deri në orën 23:59:59. `null` kur nuk u dërgua dhe gjendja është e tanishmja
data.balance	number	Gjendja, në lekë, me dy shifra pas presjes: hyrjet minus daljet e regjistruara në këtë TCR plus faturat cash të lëshuara prej saj, ku vetëfaturimet zbriten dhe faturat porosi nuk hyjnë

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

422 Të dhënat nuk kaluan validimin. 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`

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/v2/cash-register/balance' \
  -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/cash-register/balance');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/cash-register/balance', [
    '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/cash-register/balance', {
  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": {
        "fiscal_tcr_code": "pp556gh743",
        "currency": "ALL",
        "to_date": "2026-09-14",
        "balance": 23450.5
    }
}

401

{
    "message": "Unauthenticated."
}

422

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

500

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

This page as Markdown, or the whole API as OpenAPI.