---
title: "Listo faturat e importit (deklaratat doganore)"
operation_id: "api.v2.purchase-invoices.customs-imports"
method: GET
path: "/api/v2/purchase-invoices/customs-imports"
group: "Faturat e blerjes"
api_version: "v2"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v2-purchase-invoices-customs-imports.html"
---

# Listo faturat e importit (deklaratat doganore)

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

## GET /api/v2/purchase-invoices/customs-imports

Kthen vetëm faturat e blerjes që dogana i ka regjistruar në CIS për importet e mallrave të
kompanisë suaj, secila me numrin e deklaratës doganore te `customsDeclarationNumber`. CIS-i
i regjistron këto fatura në emër të importuesit, prandaj shitësi i tyre është vetë NIPT-i juaj.

Përdoreni për të rakorduar importet, TVSH-në e paguar në doganë dhe koston e mallit të
importuar me deklaratat doganore.

Funksionon si `GET /purchase-invoices`, me të njëjtat parametra, datat dhe faqet e CIS-it:

- Faqet janë faqet e listës së blerjeve në CIS, dhe faturat pa deklaratë doganore hiqen nga
  `items`. Një faqe mund të vijë bosh edhe kur pas saj ka të tjera: përsëritni me `page + 1`
  sa kohë `pagination.hasMore` është `true`.
- `pagination.records` është numri i të gjitha blerjeve të periudhës në CIS, jo vetëm i
  faturave të importit.
- Vetëm faturat e importit kërkohen te shërbimi i verifikimit, prandaj një faqe pa importe
  kushton vetëm thirrjen e listës.

URL-ja e plotë: `https://fature.al/api/v2/purchase-invoices/customs-imports`

Versioni i API-t: `v2`.

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

### Parametrat query

| Fusha | Tipi | E detyrueshme | Përshkrimi |
| --- | --- | --- | --- |
| `fromDate` | string | jo | Data e fillimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme. |
| `toDate` | string | jo | Data e mbarimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme. |
| `fic` | string | jo | Kthe vetëm faturën me këtë FIC, nëse është brenda periudhës dhe është faturë importi. |
| `page` | integer | jo | Faqja e listës së blerjeve nga CIS-i, duke filluar nga 1. Një vlerë më e vogël se 1 ose jo numër lexohet si 1. Përsëritni me `page + 1` sa kohë `pagination.hasMore` është `true`. Defaults to `1`. |

### Shembull kërkese

```bash
curl -X GET 'https://fature.al/api/v2/purchase-invoices/customs-imports' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
```

### Përgjigjet

**200**: Faturat e importit të faqes te `items`, secila e plotë dhe me `customsDeclarationNumber`, me `pagination`.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.items` | array |  |
| `data.items[].iic` | string | Kodi identifikues i faturës, IIC (NSLF), 32 shifra hex. Me të fatura gjendet përsëri |
| `data.items[].fic` | string | Kodi që ktheu CIS-i kur regjistroi faturën, FIC (NIVF). Shërben edhe si filtër `fic` i listës |
| `data.items[].invoiceNumber` | string | Numri i faturës siç e lëshoi furnitori: numri rendor dhe viti te një faturë jo-cash, si `152/2026`; me kodin TCR në fund te një faturë cash, si `152/2026/cc123cc123` |
| `data.items[].invoiceOrderNumber` | integer | Numri rendor i faturës në serinë e furnitorit |
| `data.items[].dateTimeCreated` | string | Data dhe ora e lëshimit të faturës, siç e kthen CIS-i: datë-orë ISO 8601 me zonën orare |
| `data.items[].payDeadline` | string, nullable | Afati i pagesës, siç e kthen CIS-i; `null` kur fatura nuk mban afat |
| `data.items[].invoiceType` | string | Lloji i faturës: `CASH` ose `NONCASH` |
| `data.items[].issuerTaxNumber` | string | NIPT-i i lëshuesit, i njëjti me `seller.idNum` |
| `data.items[].seller` | object | Furnitori që e lëshoi faturën |
| `data.items[].seller.idType` | string | Tipi i identifikuesit: `NUIS`, `VAT` ose `TAX` te një biznes; `ID`, `PASS` ose `SOC` te një person |
| `data.items[].seller.idNum` | string | Vlera e identifikuesit, p.sh. NIPT-i |
| `data.items[].seller.name` | string | Emri i biznesit ose i personit |
| `data.items[].seller.address` | any | Adresa, siç e ka CIS-i; `null` kur mungon |
| `data.items[].seller.town` | any | Qyteti; `null` kur mungon |
| `data.items[].seller.country` | any | Kodi i shtetit me tre shkronja, si `ALB`; `null` kur mungon |
| `data.items[].buyer` | object | Blerësi, pra kompania juaj |
| `data.items[].buyer.idType` | string | Tipi i identifikuesit: `NUIS`, `VAT` ose `TAX` te një biznes; `ID`, `PASS` ose `SOC` te një person |
| `data.items[].buyer.idNum` | string | Vlera e identifikuesit, p.sh. NIPT-i |
| `data.items[].buyer.name` | string | Emri i biznesit ose i personit |
| `data.items[].buyer.address` | any | Adresa, siç e ka CIS-i; `null` kur mungon |
| `data.items[].buyer.town` | any | Qyteti; `null` kur mungon |
| `data.items[].buyer.country` | any | Kodi i shtetit me tre shkronja, si `ALB`; `null` kur mungon |
| `data.items[].items` | array | Rreshtat e faturës |
| `data.items[].items[].name` | any | Emri i produktit ose i shërbimit, siç e shkroi furnitori |
| `data.items[].items[].code` | any | Kodi i produktit te furnitori; `null` kur ai nuk dërgoi kod |
| `data.items[].items[].unit` | any | Njësia matëse; `null` kur mungon |
| `data.items[].items[].quantity` | any | Sasia |
| `data.items[].items[].unitPriceAfterVat` | any | Çmimi për njësi me TVSH, në lekë |
| `data.items[].items[].priceAfterVat` | any | Vlera e rreshtit me TVSH, në lekë |
| `data.items[].items[].vatAmount` | any | TVSH-ja e rreshtit, në lekë |
| `data.items[].items[].vatRate` | any | Norma e TVSH-së në përqind; `null` kur rreshti nuk mban normë, rast që fature.al e lexon si 0 |
| `data.items[].items[].exemptFromVat` | any | Tipi i përjashtimit nga TVSH-ja: `TYPE_1` (neni 51 i ligjit për TVSH-në), `TYPE_2` (nenet 53 dhe 54), `EXPORT_OF_GOODS` eksport mallrash, `TAX_FREE` normë zero. `null` kur rreshti ka TVSH |
| `data.items[].paymentMethod` | array | Mënyrat e pagesës: një element te një faturë e paguar me një mënyrë të vetme, një për çdo pjesë te një pagesë e ndarë |
| `data.items[].paymentMethod[].typeCode` | any | Mënyra e pagesës: `BANKNOTE`, `CARD`, `CHECK`, `SVOUCHER`, `COMPANY` ose `ORDER` te një faturë cash; `ACCOUNT`, `TRANSFER`, `COMPENSATION`, `FACTORING`, `KIND`, `WAIVER` ose `OTHER` te një faturë jo-cash |
| `data.items[].paymentMethod[].compCard` | any | Numri i kartës së kompanisë kur `typeCode` është `COMPANY`. Te pagesat me bankë programet e faturimit, edhe fature.al, vendosin këtu IBAN-in e llogarisë. `null` kur mungon |
| `data.items[].currency` | object, nullable | Monedha dhe kursi i faturës; `null` kur fatura është në lekë |
| `data.items[].currency.code` | any | Kodi ISO 4217 i monedhës së faturës |
| `data.items[].currency.exchangeRate` | any | Sa lekë vlen një njësi e monedhës. Shumat e faturës vijnë në lekë; pjesëtuar me këtë kurs japin shumën në monedhën e faturës |
| `data.items[].totalPrice` | number | Totali i faturës me TVSH, në lekë |
| `data.items[].totalPriceWithoutVAT` | number | Totali i faturës pa TVSH, në lekë |
| `data.items[].reverseCharge` | boolean | Ngarkesë e kundërt: TVSH-në e deklaron blerësi |
| `data.items[].businessUnit` | string, nullable | Kodi i njësisë së biznesit të furnitorit nga u lëshua fatura |
| `data.items[].operatorCode` | string, nullable | Kodi i operatorit të furnitorit që e lëshoi faturën |
| `data.items[].tcrCode` | string, nullable | Kodi TCR i pajisjes fiskale të furnitorit; `null` te faturat që nuk lëshohen nga një TCR |
| `data.items[].softwareCode` | string, nullable | Kodi i programit me të cilin furnitori e lëshoi faturën |
| `data.items[].iicSignature` | string, nullable | Nënshkrimi i IIC-së me certifikatën e furnitorit, në hex |
| `data.items[].customsDeclarationNumber` | string | Numri i deklaratës doganore të importit, siç e regjistroi dogana në CIS |
| `data.pagination` | object |  |
| `data.pagination.records` | integer | Numri i faturave që CIS-i gjen për gjithë periudhën dhe filtrat, i njëjtë në çdo faqe. Nuk është numri i `items` të kësaj faqeje |
| `data.pagination.page` | integer | Parametri `page` i kërkesës, pas rrumbullakimit në të paktën 1 |
| `data.pagination.hasMore` | boolean | `true` kur kjo faqe kishte fatura dhe CIS-i ka më shumë për periudhën: kërkoni `page + 1`. `false` do të thotë që lista mbaroi. CIS-i nuk e tregon madhësinë e faqes, prandaj faqja e fundit mund të thotë `true` dhe ajo pas saj të vijë bosh me `false` |

```json
{
    "status": true,
    "data": {
        "items": [
            {
                "iic": "0F1E2D3C4B5A69788796A5B4C3D2E1F0",
                "fic": "8a941d47-7d47-4b7e-8f3a-1c2d3e4f5a6b",
                "invoiceNumber": "152/2026",
                "invoiceOrderNumber": 152,
                "dateTimeCreated": "2026-07-01T10:15:23+02:00",
                "payDeadline": "2026-07-31T00:00:00+02:00",
                "invoiceType": "NONCASH",
                "issuerTaxNumber": "K71828301A",
                "seller": {
                    "idType": "NUIS",
                    "idNum": "K71828301A",
                    "name": "Furnizimi Alba SHPK",
                    "address": "Rruga e Durrësit 5",
                    "town": "Tiranë",
                    "country": "ALB"
                },
                "buyer": {
                    "idType": "NUIS",
                    "idNum": "K71828301A",
                    "name": "Furnizimi Alba SHPK",
                    "address": "Rruga e Durrësit 5",
                    "town": "Tiranë",
                    "country": "ALB"
                },
                "items": [
                    {
                        "name": "Kafe e pjekur 1kg",
                        "code": "K1",
                        "unit": "kg",
                        "quantity": 100,
                        "unitPriceAfterVat": 120,
                        "priceAfterVat": 12000,
                        "vatAmount": 2000,
                        "vatRate": 20,
                        "exemptFromVat": "TYPE_1"
                    }
                ],
                "paymentMethod": [
                    {
                        "typeCode": "ACCOUNT",
                        "compCard": "AL47212110090000000235698741"
                    }
                ],
                "currency": {
                    "code": "EUR",
                    "exchangeRate": 100.5
                },
                "totalPrice": 12000,
                "totalPriceWithoutVAT": 10000,
                "reverseCharge": false,
                "businessUnit": "bb123bb123",
                "operatorCode": "oo123oo123",
                "tcrCode": "cc123cc123",
                "softwareCode": "ss123ss123",
                "iicSignature": "3a5f9c1e7b2d4680a1c3e5f7092b4d6e8f0a1b2c3d4e5f60718293a4b5c6d7e8f9a0b1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f6",
                "customsDeclarationNumber": "26TIR0123456"
            }
        ],
        "pagination": {
            "records": 12,
            "page": 1,
            "hasMore": true
        }
    }
}
```

**401**: Token-i mungon ose nuk është i vlefshëm, ose përdoruesi nuk ka të drejtën e faturave të blerjes.

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

**422**: Datat nuk janë në formatin `YYYY-MM-DD`.

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

**429**: Kufiri i kërkesave u arrit. Nga kufiri i përgjithshëm përgjigja mban vetëm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard të gabimit.

| 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 u përgjigj me një gabim; 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 fiskalizimit nuk u arrit. Riprovoni më vonë. `message` vjen bosh; arsyeja është te `errors`.

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