Merr gjendjen e arkës për një ditë (v1): fature.al API

GET /api/v1/reports/cash-register 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.

Gjendja e arkës fiskale të përdoruesit për një ditë të vetme: hapja, mbyllja dhe mbyllja e pritur, bashkë me shitjet sipas mënyrës së pagesës dhe lëvizjet e parave.

Mbyllja e pritur, expected_closing, është ajo që duhet të ketë arka po të jetë regjistruar gjithçka. Diferenca me mbylljen reale është pikërisht ajo që kërkohet në rakordim.

Pa date merret dita e sotme. Formati është YYYY-MM-DD.
Raporti i përket pajisjes fiskale të përdoruesit të token-it. Pa pajisje fiskale, ose kur monedha ALL nuk është e konfiguruar, arka nuk është e disponueshme dhe përgjigja kthehet me 200 dhe status: false.

URL-ja e plotë: https://fature.al/api/v1/reports/cash-register

Query parameters

Name	Tipi	E detyrueshme	Përshkrimi
date	string<date>, nullable	no	Dita e raportit, `YYYY-MM-DD`. Pa të merret sot.

Përgjigjet

200 Gjendja e arkës së ditës te `data`, me `sales_by_method` dhe `movements`; pa pajisje fiskale, ose kur monedha ALL nuk është e konfiguruar, përgjigja kthehet me HTTP 200 dhe `status: false`, me arsyen te `errors`.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.date	string	Dita e raportit, `YYYY-MM-DD`
data.currency	string	Monedha e shumave, gjithmonë `ALL`
data.opening	number	Gjendja fillestare e deklaruar për ditën, në lekë: shuma e hapjeve të arkës së ditës për këtë TCR. `0` kur arka nuk u hap atë ditë
data.closing	number	Gjendja e arkës në mbarim të ditës sipas librit të fature.al, në lekë: shuma e të gjitha veprimeve të arkës dhe e të gjitha faturave cash të këtij TCR-i që nga fillimi deri në mbarim të ditës, me çdo mënyrë pagese, jo vetëm me para në dorë
data.expected_closing	number	Sa duhet të ketë arka në para në dorë po të jetë regjistruar gjithçka, në lekë: `opening` plus shitjet e ditës me `BANKNOTE` plus `movements.deposits_total` minus `movements.withdrawals_total`. Diferenca me `closing` është ajo që kërkon rakordimi
data.tcr	string, nullable	Kodi TCR i pajisjes fiskale të përdoruesit; `null` kur pajisja nuk ka ende kod
data.operator	string	Emri i plotë i përdoruesit të token-it; bosh kur përdoruesi nuk ka emër
data.sales_by_method	array	Shitjet e ditës sipas mënyrës së pagesës që i shleu, nga bruto më e madhe: `BANKNOTE`, `CARD`, `CHECK`, `SVOUCHER` ose `COMPANY`
data.sales_by_method[].method	string	Kodi i mënyrës së pagesës, ai i CIS-it: `BANKNOTE`, `CARD`, `CHECK`, `SVOUCHER`, `COMPANY` te faturat cash; `ACCOUNT`, `TRANSFER`, `COMPENSATION`, `FACTORING`, `KIND`, `WAIVER`, `OTHER` te faturat jo-cash dhe e-faturat. `OTHER` edhe kur fatura nuk mban mënyrë pagese
data.sales_by_method[].count	integer	Sa fatura u shlyen, plotësisht ose pjesërisht, me këtë mënyrë
data.sales_by_method[].gross	number	Shuma bruto e shlyer me këtë mënyrë, në lekë
data.sales_by_method[].net	number	Pjesa neto (pa TVSH), në lekë. Te faturat e ndara ndahet në përpjesëtim me bruton
data.sales_by_method[].vat	number	Pjesa e TVSH-së, në lekë, e ndarë po njësoj
data.sales_by_method[].label	string	Emri i mënyrës për ekran, në shqip; kur kodi nuk ka përkthim, vjen vetë kodi
data.movements	object	Hyrjet dhe daljet e parave të ditës në këtë TCR
data.movements.deposits_count	integer	Sa hyrje parash (`MONEY_IN`) u regjistruan
data.movements.deposits_total	number	Shuma e hyrjeve, në lekë
data.movements.withdrawals_count	integer	Sa dalje parash (`MONEY_OUT`) u regjistruan
data.movements.withdrawals_total	number	Shuma e daljeve, në lekë, si vlerë pozitive

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

403 Përdoruesi nuk ka të drejtën e raporteve. Një operator merr në raport vetëm faturat e veta.

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`

422 `date` nuk është në formatin `YYYY-MM-DD`. 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`

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`

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/reports/cash-register', [
    '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/reports/cash-register', {
  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": {
        "date": "2026-09-13",
        "currency": "ALL",
        "opening": 5000,
        "closing": 68450,
        "expected_closing": 68450,
        "tcr": "ab123cd456",
        "operator": "Arben Hoxha",
        "sales_by_method": [
            {
                "method": "BANKNOTE",
                "count": 318,
                "gross": 1210400,
                "net": 1008666.67,
                "vat": 201733.33,
                "label": "Me para në dorë"
            }
        ],
        "movements": {
            "deposits_count": 1,
            "deposits_total": 3000,
            "withdrawals_count": 1,
            "withdrawals_total": 2000
        }
    }
}

401

{
    "message": "Unauthenticated."
}

403

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

422

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

429

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

500

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