---
title: "Listo fletët shoqëruese"
operation_id: "api.v2.invoice.wtn.list"
method: GET
path: "/api/v2/invoice/wtn"
group: "Fletët shoqëruese"
api_version: "v2"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v2-invoice-wtn-list.html"
---

# Listo fletët shoqëruese

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

## GET /api/v2/invoice/wtn

E njëjta listë si te [`GET /api/v1/invoice/wtn`](/docs/api): fletët e kompanisë, nga më e reja
te më e vjetra, me filtrim sipas datës së krijimit. Çdo fletë vjen e plotë, me `origin`,
`destination`, `carrier`, `fiscal` dhe `lines`, kështu që për rreshtat nuk duhet një thirrje e
dytë, dhe me `internalId` ashtu siç u dërgua.

- Pagination me `limit` dhe `offset`. `pagination` nuk kthen `total`, ndaj ndaloni kur një faqe
  vjen më e shkurtër se `limit`.
- Një kërkesë e dytë nga i njëjti token, ndërsa e para nuk ka mbaruar, refuzohet menjëherë me
  `429`. Vendi lirohet sapo kthehet përgjigja, ose pas 30 sekondash nëse kërkesa u ndërpre.

Ndryshuar që nga `v1`:

| What changed | v1 | v2 |
| --- | --- | --- |
| 200 `data.items[].origin.point` | string, nullable | — |
| 200 `data.items[].origin.city` | string, nullable | — |
| 200 `data.items[].origin.address` | string, nullable | — |
| 200 `data.items[].destination.point` | string, nullable | — |
| 200 `data.items[].destination.city` | string, nullable | — |
| 200 `data.items[].destination.address` | string, nullable | — |
| 200 `data.items[].carrier.name` | string, nullable | — |
| 200 `data.items[].carrier.id_type` | string, nullable | — |
| 200 `data.items[].carrier.id_num` | string, nullable | — |
| 200 `data.items[].carrier.town` | string, nullable | — |
| 200 `data.items[].carrier.address` | string, nullable | — |
| 200 `data.items[].carrier.vehicle_ownership` | string, nullable | — |
| 200 `data.items[].carrier.vehicle_plates` | string, nullable | — |
| 200 `data.items[].fiscal.status` | string, nullable | — |
| 200 `data.items[].fiscal.iic` | string, nullable | — |
| 200 `data.items[].fiscal.fic` | string, nullable | — |
| 200 `data.items[].fiscal.tcr_code` | string, nullable | — |
| 200 `data.items[].fiscal.business_code` | string, nullable | — |
| 200 `data.items[].fiscal.operator_code` | string, nullable | — |
| 200 `data.items[].fiscal.fiscalized_at` | string, nullable | — |
| 200 `data.items[].fiscal.verify_url` | string, nullable | — |
| 200 `data.items[].lines[].product_name` | any | — |
| 200 `data.items[].lines[].product_code` | any | — |
| 200 `data.items[].lines[].unit` | any | — |
| 200 `data.items[].lines[].quantity` | number | — |
| 200 `data.items[].internalId` | — | string |
| 200 `data.items[].origin` | object | any |
| 200 `data.items[].destination` | object | any |
| 200 `data.items[].carrier` | object | any |
| 200 `data.items[].fiscal` | object | any |

URL-ja e plotë: `https://fature.al/api/v2/invoice/wtn`

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 |
| --- | --- | --- | --- |
| `limit` | integer | jo | Sa fletë të kthehen në një faqe. Defaults to `20`. |
| `offset` | integer | jo | Nga cila fletë të fillohet, duke numëruar nga 0. Defaults to `0`. |
| `fromDate` | string | jo | Data e fillimit, `YYYY-MM-DD`, sipas datës së krijimit. |
| `toDate` | string | jo | Data e mbarimit, `YYYY-MM-DD`. |

### Shembull kërkese

```bash
curl -X GET 'https://fature.al/api/v2/invoice/wtn' \
  -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**: Lista e fletëve të periudhës, me `pagination`; `items` është bosh kur nuk ka fletë.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.items` | array |  |
| `data.items[].id` | integer | Id-ja e fletës në fature.al; me të lexohen detajet dhe të dhënat për printim |
| `data.items[].internalId` | string | Identifikuesi i fletës në sistemin tuaj, ai që dërguat te `internalId` kur u lëshua |
| `data.items[].number` | string, nullable | Numri i fletës, si `3/2026`: numri rendor i fletës brenda ditës për njësinë e biznesit, dhe viti |
| `data.items[].type` | string, nullable | Lloji i fletës: `WTN` për mall që lëviz pa shitje, `SALE` për mall që shoqëron një shitje |
| `data.items[].transaction` | string, nullable | Lloji i transaksionit: `TRANSFER` zhvendosje malli, `EXAMINATION` dërgim për ekzaminim ose provë, `SALES` shitje, `DOOR` shitje derë më derë |
| `data.items[].issue_date` | string, nullable | Data dhe ora e lëshimit, `YYYY-MM-DD HH:MM:SS`, orë lokale |
| `data.items[].start_date` | string, nullable | Data dhe ora e nisjes së mallit, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua |
| `data.items[].destination_date` | string, nullable | Data dhe ora e mbërritjes së mallit, `YYYY-MM-DD HH:MM:SS`, orë lokale; çasti i lëshimit kur nuk u dërgua |
| `data.items[].origin` | any | Pika e nisjes së mallit |
| `data.items[].destination` | any | Pika e mbërritjes së mallit |
| `data.items[].carrier` | any | Transportuesi dhe automjeti |
| `data.items[].value_of_goods` | number | Vlera e mallit që udhëton, në lekë, siç u dërgua te `valueOfGoods` |
| `data.items[].items_num` | integer | Sasia e mallit: shuma e `quantity` të rreshtave, si numër i plotë |
| `data.items[].fiscal` | any | Gjendja dhe kodet e fiskalizimit të fletës |
| `data.items[].lines` | array | Rreshtat e mallit, ashtu siç u dërguan te `invoice_lines` |
| `data.items[].print` | string | URL-ja e `GET /invoice/wtn/print/{id}`, të dhënat e kësaj flete për printim. Vjen nën të njëjtin version që e ktheu fletën |
| `data.pagination` | object |  |
| `data.pagination.records` | integer | Sa fletë mban `items` në këtë faqe |
| `data.pagination.limit` | integer | Parametri `limit` i kërkesës, pas rrumbullakimit në të paktën 1 |
| `data.pagination.offset` | integer | Parametri `offset` i kërkesës, pas rrumbullakimit në të paktën 0 |

```json
{
    "status": true,
    "data": {
        "items": [
            {
                "id": 403,
                "internalId": "WTN-2026-000412",
                "number": "3/2026",
                "type": "WTN",
                "transaction": "TRANSFER",
                "issue_date": "2026-09-13 10:30:00",
                "start_date": "2026-09-13 10:30:00",
                "destination_date": "2026-09-13 14:30:00",
                "origin": "origin",
                "destination": "destination",
                "carrier": "carrier",
                "value_of_goods": 10000,
                "items_num": 5,
                "fiscal": "fiscal",
                "lines": [
                    "lines"
                ],
                "print": "https://fature.al/api/v1/invoice/wtn/print/403"
            }
        ],
        "pagination": {
            "records": 20,
            "limit": 20,
            "offset": 0
        }
    }
}
```

**401**: Unauthenticated

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `message` | string |  |

```json
{
    "message": "Unauthenticated."
}
```

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

```json
example
```

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

```json
example
```

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

```json
example
```