Refuzo një faturë elektronike blerjeje (v1): fature.al API

POST /api/v1/purchase-einvoices/{eic}/refuse 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.

I thotë CIS-it që biznesi e refuzon faturën, e cila kalon në statusin REFUSED. Veprimi regjistrohet te CIS-i dhe nuk kthehet mbrapsht nga API.

Kërkon, përveç të drejtës së faturave elektronike të blerjes, edhe të drejtën e refuzimit. Kur biznesi e kërkon te Konfigurimet, dërgoni edhe fjalëkalimin e certifikatës te code.

URL-ja e plotë: https://fature.al/api/v1/purchase-einvoices/{eic}/refuse

Path parameters

Name	Tipi	E detyrueshme	Përshkrimi
eic	string	yes	EIC-ja e faturës elektronike, nga `GET /purchase-einvoices`.

Body parameters

Name	Tipi	E detyrueshme	Përshkrimi
reason	string, maxLength 500	yes	Arsyeja e refuzimit. Ruhet në historikun e faturës te fature.al; CIS-i nuk e merr.
code	string, nullable	no	Fjalëkalimi i certifikatës elektronike të biznesit. I detyrueshëm vetëm kur biznesi e ka ndezur te Konfigurimet kërkesën e fjalëkalimit për refuzimin e faturave të blerjes.

Përgjigjet

200 CIS-i e regjistroi refuzimin.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.eic	string	EIC-ja e faturës, ajo e adresës
data.status	string	Statusi i ri te CIS-i: `ACCEPTED` ose `REFUSED`

401 Token-i mungon ose nuk është i vlefshëm, ose biznesi nuk lëshon fatura.

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`

403 Përdoruesi nuk ka të drejtën e faturave elektronike të blerjes ose të drejtën e refuzimit.

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`

404 `eic` nuk është një UUID.

422 Mungon `reason`, mungon `code` kur biznesi e kërkon, ose `code` nuk është fjalëkalimi i certifikatë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.

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`

502 CIS-i nuk e pranoi ndryshimin, për shembull sepse fatura nuk i përket biznesit ose është pranuar a refuzuar më parë; arsyeja është te `message`.

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`

503 Shërbimi i faturave elektronike nuk u arrit. Riprovoni më vonë.

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 POST 'https://fature.al/api/v1/purchase-einvoices/3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76/refuse' \
  -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 '{
    "reason": "Sasia e faturuar nuk përputhet me mallin e marrë.",
    "code": "code"
}'

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/purchase-einvoices/3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76/refuse', [
    'reason' => 'Sasia e faturuar nuk përputhet me mallin e marrë.',
    'code' => 'code',
]);

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://fature.al/api/v1/purchase-einvoices/3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76/refuse', [
    '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' => [
        'reason' => 'Sasia e faturuar nuk përputhet me mallin e marrë.',
        'code' => 'code',
    ],
]);

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

JavaScript

const response = await fetch('https://fature.al/api/v1/purchase-einvoices/3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76/refuse', {
  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({
      "reason": "Sasia e faturuar nuk përputhet me mallin e marrë.",
      "code": "code"
  })
});

const data = await response.json();

Shembull përgjigjeje

200

{
    "status": true,
    "data": {
        "eic": "3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76",
        "status": "ACCEPTED"
    }
}

401

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

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"
    ]
}

502

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

503

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