Lista e veprimeve me arken (v1)

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

Send a bearer token in the Authorization header.

Historiku i arkes: hyrjet, daljet dhe hapjet me mbylljet e dites, me filtrim dhe faqosje.

`type`	Veprimi
`MONEY_IN`	Hyrje parash
`MONEY_OUT`	Dalje parash
`OPEN_DAY`	Hapje e dites
`CLOSE_DAY`	Mbyllje e dites

Disa tipe ndahen me presje, pra type=MONEY_IN,MONEY_OUT kthen vetem levizjet e parave. Faqezohet me limit dhe offset.

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

Query parameters

Name	Type	Required	Description
limit	integer	no	Numri i veprimeve per faqe. Defaults to `20`.
offset	integer	no	Nga cili veprim te fillohet. Defaults to `0`.
type	string	no	Filtro sipas tipit: MONEY_IN, MONEY_OUT, OPEN_DAY, CLOSE_DAY. Disa tipe ndahen me presje.
fromDate	string	no	Data e fillimit (YYYY-MM-DD).
toDate	string	no	Data e perfundimit (YYYY-MM-DD).

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.items	array
data.items[].id	integer
data.items[].action_type	string
data.items[].amount	number
data.items[].currency	string
data.items[].transaction_date	string
data.items[].transaction_no	integer
data.items[].cash_action_no	string
data.items[].fiscal_status	string, nullable
data.items[].fiscal_uuid	string, nullable
data.items[].fiscal_fic	string, nullable
data.items[].fiscal_tcr_code	string, nullable
data.items[].description	string, nullable
data.items[].third_party	string, nullable
data.items[].id_client	integer, nullable
data.items[].created_at	string
data.pagination	object
data.pagination.records	integer
data.pagination.limit	integer
data.pagination.offset	integer
data.pagination.type	string, nullable

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/cash-register/actions', [
    '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/actions', {
  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

200

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "action_type": "action type",
                "amount": 4200,
                "currency": "USD",
                "transaction_date": "transaction date",
                "transaction_no": 1,
                "cash_action_no": "cash action no",
                "fiscal_status": "fiscal status",
                "fiscal_uuid": "9f8c7b6a-5d4e-3f2a-1b0c-9d8e7f6a5b4c",
                "fiscal_fic": "fiscal fic",
                "fiscal_tcr_code": "fiscal tcr code",
                "description": "A short description.",
                "third_party": "third party",
                "id_client": 1,
                "created_at": "created at"
            }
        ],
        "pagination": {
            "records": 1,
            "limit": 25,
            "offset": 0,
            "type": "type"
        }
    }
}

500

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