---
title: "Refuzo një faturë elektronike blerjeje"
operation_id: "api.v2.purchase-einvoices.refuse"
method: POST
path: "/api/v2/purchase-einvoices/{eic}/refuse"
group: "Faturat elektronike të blerjes"
api_version: "v2"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v2-purchase-einvoices-refuse.html"
---

# Refuzo një faturë elektronike blerjeje

Pjesë e dokumentacionit [fature.al API](/api-reference/index.html).

## POST /api/v2/purchase-einvoices/{eic}/refuse

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/v2/purchase-einvoices/{eic}/refuse`

Versioni i API-t: `v2`.

Identifikimi: i detyrueshëm (bearer token, plus the `X-Client-Id` and `X-Client-Secret` headers).

### Parametrat në path

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

### Fushat e body-t

| Fusha | Tipi | E detyrueshme | Përshkrimi |
| --- | --- | --- | --- |
| `reason` | string, maxLength 500 | po | Arsyeja e refuzimit. Ruhet në historikun e faturës te fature.al; CIS-i nuk e merr. |
| `code` | string, nullable | jo | 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. |

### Shembull kërkese

```bash
curl -X POST 'https://fature.al/api/v2/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"
}'
```

### Përgjigjet

**200**: CIS-i e regjistroi refuzimin.

| Fusha | 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` |

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

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

| Fusha | 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` |

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

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

| Fusha | 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` |

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

**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.

| Fusha | 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` |

```json
{
    "success": false,
    "message": "Te dhena jo te sakta",
    "errors": []
}
```

**429**: Kufiri i kërkesave u arrit.

| Fusha | 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` |

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

**500**: Gabim i papritur në server.

| Fusha | 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` |

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

**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`.

| Fusha | 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` |

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

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

| Fusha | 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` |

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