Lista e faturave te blerjes (v1)

GET /api/v1/purchase-invoices Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Merrni faturat qe furnitoret ju kane leshuar juve, ashtu sic i ka regjistruar sistemi fiskal. Furnitori nuk ju dergon gje: dokumentet vijne nga tatimet.

Per cdo fature terhiqen te dhenat e plota: artikujt, shitesi, bleresi, TVSH-ja dhe menyrat e pageses. Kjo e ben rakordimin e blerjeve dhe te TVSH-se te mundur pa asnje hap manual.

Faqezimi#

Ky endpoint lexon nga fiskalizimi, jo nga baza jone, prandaj faqezohet me page qe fillon nga 1 dhe jo me limit me offset. Perseritni me page + 1 derisa items te kthehet bosh.

Pa fromDate dhe toDate merret dita e sotme, jo e gjithe historia.

Full URL: https://fature.al/api/v1/purchase-invoices

Query parameters

Name	Type	Required	Description
fromDate	string	no	Data e fillimit (YYYY-MM-DD). Pa te merret sot.
toDate	string	no	Data e perfundimit (YYYY-MM-DD). Pa te merret sot.
fic	string	no	Filtro sipas FIC per nje fature te vetme.
page	integer	no	Faqja e listes nga fiskalizimi. Perserit me page+1 derisa items te kthehet bosh. Defaults to `1`.

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.items	array
data.items[].iic	string
data.items[].fic	string
data.items[].invoiceNumber	string
data.items[].invoiceOrderNumber	integer
data.items[].dateTimeCreated	string
data.items[].payDeadline	string, nullable
data.items[].invoiceType	string
data.items[].issuerTaxNumber	string
data.items[].seller	object
data.items[].seller.idType	string
data.items[].seller.idNum	string
data.items[].seller.name	string
data.items[].seller.address	string, nullable
data.items[].seller.town	string, nullable
data.items[].seller.country	string, nullable
data.items[].buyer	object
data.items[].buyer.idType	string
data.items[].buyer.idNum	string
data.items[].buyer.name	string
data.items[].buyer.address	string, nullable
data.items[].buyer.town	string, nullable
data.items[].buyer.country	string, nullable
data.items[].items	array
data.items[].items[].name	string
data.items[].items[].code	string, nullable
data.items[].items[].unit	string, nullable
data.items[].items[].quantity	number
data.items[].items[].unitPriceAfterVat	number
data.items[].items[].priceAfterVat	number
data.items[].items[].vatAmount	number
data.items[].items[].vatRate	number, nullable
data.items[].items[].exemptFromVat	string, nullable
data.items[].paymentMethod	array
data.items[].paymentMethod[].typeCode	string
data.items[].paymentMethod[].compCard	string, nullable
data.items[].currency	object, nullable
data.items[].currency.code	string
data.items[].currency.exchangeRate	number
data.items[].totalPrice	number
data.items[].totalPriceWithoutVAT	number
data.items[].reverseCharge	boolean
data.items[].businessUnit	string, nullable
data.items[].operatorCode	string, nullable
data.items[].tcrCode	string, nullable
data.items[].softwareCode	string, nullable
data.items[].iicSignature	string, nullable
data.pagination	object
data.pagination.records	integer
data.pagination.page	integer

422 Formati i datave nuk eshte YYYY-MM-DD.

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`

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`

502 Fiskalizimi u pergjigj me nje gabim.

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`

503 Sherbimi i fiskalizimit eshte i paarritshem.

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

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/purchase-invoices', [
    '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/purchase-invoices', {
  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": [
            {
                "iic": "iic",
                "fic": "fic",
                "invoiceNumber": "invoiceNumber",
                "invoiceOrderNumber": 1,
                "dateTimeCreated": "dateTimeCreated",
                "payDeadline": "payDeadline",
                "invoiceType": "invoiceType",
                "issuerTaxNumber": "issuerTaxNumber",
                "seller": {
                    "idType": "idType",
                    "idNum": "idNum",
                    "name": "Jane Doe",
                    "address": "1 Example Street",
                    "town": "town",
                    "country": "US"
                },
                "buyer": {
                    "idType": "idType",
                    "idNum": "idNum",
                    "name": "Jane Doe",
                    "address": "1 Example Street",
                    "town": "town",
                    "country": "US"
                },
                "items": [
                    {
                        "name": "Jane Doe",
                        "code": "code",
                        "unit": "unit",
                        "quantity": 2,
                        "unitPriceAfterVat": 1999,
                        "priceAfterVat": 1999,
                        "vatAmount": 4200,
                        "vatRate": 19.99,
                        "exemptFromVat": "exemptFromVat"
                    }
                ],
                "paymentMethod": [
                    {
                        "typeCode": "typeCode",
                        "compCard": "compCard"
                    }
                ],
                "currency": {
                    "code": "code",
                    "exchangeRate": 19.99
                },
                "totalPrice": 4200,
                "totalPriceWithoutVAT": 4200,
                "reverseCharge": true,
                "businessUnit": "businessUnit",
                "operatorCode": "operatorCode",
                "tcrCode": "tcrCode",
                "softwareCode": "softwareCode",
                "iicSignature": "iicSignature"
            }
        ],
        "pagination": {
            "records": 1,
            "page": 1
        }
    }
}

422

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

500

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

502

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

503

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