Merr përmbledhjen e ditës (v1): fature.al API

GET /api/v1/dashboard/summary 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ë pamje të shpejtë të ditës së sotme për ekranin kryesor, në tre objekte:

Objekti	Përmbajtja
`shift`	`is_open`, `opened_at`, `cash_in_drawer` dhe `currency` për pajisjen fiskale të përdoruesit. Pa pajisje, `is_open` është `false` dhe `cash_in_drawer` është `0`.
`today`	`invoice_count`, `gross_total` dhe `hourly_series`, një pikë për çdo dy orë me `hour` dhe `gross`.
`week`	`series`, një pikë për secilën nga 7 ditët e fundit me `date` dhe `gross`, dhe `wow_delta_percent`, ndryshimi në përqindje ndaj 7 ditëve të mëparshme, `null` kur ato nuk kanë shitje.

Shitjet numërojnë faturat cash, jo-cash dhe e-faturat, pa faturat porosi dhe pa faturat e anuluara. Shumat janë në ALL.

Përgjigja ruhet në cache për 5 sekonda për përdorues, prandaj nuk është burim për rakordim: për shifra të sakta mbi një periudhë përdorni raportet.

URL-ja e plotë: https://fature.al/api/v1/dashboard/summary

Përgjigjet

200 Përmbledhja e ditës te `data`, në tre objekte: `shift`, `today` dhe `week`; shifrat mund të jenë deri në 5 sekonda të vjetra nga cache.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.shift	object	Turni dhe arka e pajisjes fiskale të përdoruesit
data.shift.is_open	boolean	`true` kur arka e pajisjes u hap sot dhe nuk është mbyllur ende
data.shift.opened_at	string, nullable	Data dhe ora e hapjes së sotme të arkës, ISO 8601 me zonën orare; kur sot nuk u hap, hapja e fundit e ditëve të mëparshme. `null` kur arka nuk është hapur asnjëherë
data.shift.cash_in_drawer	number	Gjendja e arkës tani, në lekë, sipas librit të fature.al: veprimet e arkës dhe faturat cash të TCR-it, me çdo mënyrë pagese. `0` kur turni nuk është i hapur
data.shift.currency	string	Monedha e `cash_in_drawer`, gjithmonë `ALL`
data.today	object	Shitjet e sotme
data.today.invoice_count	integer	Numri i faturave të sotme
data.today.gross_total	number	Vlera bruto e tyre, në lekë
data.today.hourly_series	array	Dymbëdhjetë pika, një për çdo dy orë të ditës, nga ora `0` deri në orën `22`
data.today.hourly_series[].hour	integer	Ora e fillimit të intervalit: `0`, `2`, `4` e me radhë deri në `22`. Pika mbulon faturat nga kjo orë deri para orës `hour + 2`
data.today.hourly_series[].gross	number	Vlera bruto e faturave të intervalit, në lekë; `0` kur nuk ka
data.week	object	Shtatë ditët e fundit përballë shtatë të mëparshmeve
data.week.series	array	Shtatë pika, një për secilën nga 7 ditët e fundit deri sot, në rend kronologjik
data.week.series[].date	string	Data, `YYYY-MM-DD`
data.week.series[].gross	number	Vlera bruto e faturave të ditës, në lekë; `0` kur nuk ka
data.week.wow_delta_percent	number, nullable	Ndryshimi në përqind i shitjeve bruto të 7 ditëve të fundit ndaj 7 ditëve para tyre, me dy shifra pas presjes: `12.5` do të thotë 12.5% më shumë, negative kur më pak. `null` kur 7 ditët e mëparshme nuk kanë shitje

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

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/dashboard/summary' \
  -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/dashboard/summary');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/dashboard/summary', [
    '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/dashboard/summary', {
  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": {
        "shift": {
            "is_open": true,
            "opened_at": "2026-09-13T08:02:11+02:00",
            "cash_in_drawer": 23450,
            "currency": "ALL"
        },
        "today": {
            "invoice_count": 57,
            "gross_total": 48900,
            "hourly_series": [
                {
                    "hour": 10,
                    "gross": 6300
                }
            ]
        },
        "week": {
            "series": [
                {
                    "date": "2026-09-13",
                    "gross": 48900
                }
            ],
            "wow_delta_percent": 12.5
        }
    }
}

401

{
    "message": "Unauthenticated."
}

429

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