Lësho fatura jo-cash në bulk (v1): fature.al API

Lësho fatura jo-cash në bulk

POST /api/v1/invoice/bulk-noncash 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.

Lëshon shumë fatura jo-cash me një kërkesë të vetme, për faturim periodik. Çdo element i invoices ka të njëjtat fusha si body i POST /invoice/noncash, internalId përfshirë, dhe lëshohet me të njëjtat rregulla.

Përgjigja është një objekt me një hyrje për çdo internalId, dhe statusi HTTP mbetet 200 edhe kur ndonjë faturë dështon:

kontrolloni status brenda çdo hyrjeje më vete, jo kodin HTTP;
riprovoni vetëm internalId-të që dështuan, jo të gjithë bulk-un;
faturat lëshohen një nga një, në radhë, ndaj një bulk i madh zgjat aq sa shuma e lëshimeve.

URL-ja e plotë: https://fature.al/api/v1/invoice/bulk-noncash

Body parameters

Name	Tipi	E detyrueshme	Përshkrimi
invoices	array	yes	Faturat që do të lëshohen, secila me të njëjtat fusha si body i `POST /invoice/noncash`, `internalId` përfshirë. Nuk ka kufi në numrin e tyre, por endpoint-i lejon vetëm 3 kërkesa në minutë, prandaj dërgoni pak bulk-e të mëdha në vend të shumë të vogla.

Përgjigjet

200 Një objekt me një hyrje për çdo `internalId`. Një faturë që dështon mban formatin e gabimit brenda hyrjes së vet, dhe statusi i përgjigjes mbetet 200.

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

Shembull kërkese

cURL

curl -X POST 'https://fature.al/api/v1/invoice/bulk-noncash' \
  -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 '{
    "invoices": [
        "invoices"
    ]
}'

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/invoice/bulk-noncash', [
    'invoices' => [
        'invoices',
    ],
]);

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://fature.al/api/v1/invoice/bulk-noncash', [
    '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' => [
        'invoices' => [
            'invoices',
        ],
    ],
]);

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

JavaScript

const response = await fetch('https://fature.al/api/v1/invoice/bulk-noncash', {
  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({
      "invoices": [
          "invoices"
      ]
  })
});

const data = await response.json();

Shembull përgjigjeje

200

[]

401

{
    "message": "Unauthenticated."
}

This page as Markdown, or the whole API as OpenAPI.