Balanca e arkes fiskale (v1)

Balanca e arkes fiskale

GET /api/v1/cash-register/balance Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Kthen gjendjen e arkes fiskale (TCR) te perdoruesit, ne ALL.

Pa toDate kthehet balanca e fundit. Me toDate llogaritet gjendja sic ka qene ne fund te asaj dite, cka e ben te dobishme per rakordim me nje dite te shkuar.

Full URL: https://fature.al/api/v1/cash-register/balance

Query parameters

Name	Type	Required	Description
toDate	string<date>, nullable	no	Data deri te cila llogaritet balanca. Pa te kthehet balanca e fundit.

Responses

200 Kur perdoruesi nuk ka pajisje fiskale, pergjigja kthehet me HTTP 200 dhe `status: false`.

422 Te dhenat nuk kaluan validimin. Kjo pergjigje perdor fushen `success`, jo `status`.

Field	Type	Description
success	boolean	Always false
message	string	A single summary line, the same for every validation failure
errors	object	The failing fields, each with the messages for it. Dotted keys point into nested objects and array items, e.g. `lines.0.quantity`

500 Gabim i papritur ne server.

Field	Type	Description
status	boolean	Always false. A successful response carries `status: true` and a `data` object instead
message	string	The exception message. Empty when the failure carries no exception of its own
errors	array	Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message`

Example request

cURL

curl -X GET 'https://fature.al/api/v1/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/v1/cash-register/balance');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/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/v1/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();

Example response

422

{
    "success": true,
    "message": "Hello there",
    "errors": []
}

500

{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}

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