Krijo pajisje fiskale (TCR) (v1)

POST /api/v1/on-boarding/fiscal-device Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Regjistron nje pajisje fiskale te re ne sistemin e tatimeve dhe kthen kodin TCR. Ky kod perdoret per faturat me para ne dore dhe duhet te lidhet me perdoruesin perkates.

Full URL: https://fature.al/api/v1/on-boarding/fiscal-device

Body parameters

Name	Type	Required	Description
branchId	integer	yes	ID e njesise se biznesit ku ndodhet pajisja, ashtu sic ju ktheu `POST /on-boarding/branch`. Cdo TCR i perket nje njesie te vetme.
name	string, maxLength 255	yes	Emri i pajisjes fiskale, ai qe e dallon nga te tjerat ne te njejten njesi.
fromDate	string	yes	Data nga e cila pajisja fillon te leshoje fatura, ne formatin `YYYY-MM-DD`.
toDate	string, nullable	no	Data deri kur pajisja eshte aktive. Pa te, pajisja mbetet aktive pa afat.

Responses

200 Kur regjistrimi i pajisjes ne fiskalizim deshton, pergjigja kthehet me HTTP 200 dhe `status: false`.

201 Created

Field	Type	Description
status	boolean
data	object
data.device	object
data.device.fiscalTcrCode	string

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`

Example request

cURL

curl -X POST 'https://fature.al/api/v1/on-boarding/fiscal-device' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "branchId": 12,
    "name": "Arka 1",
    "fromDate": "2026-01-01",
    "toDate": "2026-12-31"
}'

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',
    'Content-Type' => 'application/json',
])->post('https://fature.al/api/v1/on-boarding/fiscal-device', [
    'branchId' => 12,
    'name' => 'Arka 1',
    'fromDate' => '2026-01-01',
    'toDate' => '2026-12-31',
]);

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://fature.al/api/v1/on-boarding/fiscal-device', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'branchId' => 12,
        'name' => 'Arka 1',
        'fromDate' => '2026-01-01',
        'toDate' => '2026-12-31',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

JavaScript

const response = await fetch('https://fature.al/api/v1/on-boarding/fiscal-device', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "branchId": 12,
      "name": "Arka 1",
      "fromDate": "2026-01-01",
      "toDate": "2026-12-31"
  })
});

const data = await response.json();

Example response

201

{
    "status": true,
    "data": {
        "device": {
            "fiscalTcrCode": "fiscalTcrCode"
        }
    }
}

422

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