---
title: "Krijo fature shoqeruese (WTN)"
operation_id: "api.v1.invoice.wtn.create"
method: POST
path: "/api/v1/invoice/wtn"
group: "Fletë shoqëruese"
api_version: "v1"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v1-invoice-wtn-create.html"
---

# Krijo fature shoqeruese (WTN)

Part of the [fature.al API](/api-reference/index.html) documentation.

## POST /api/v1/invoice/wtn

Fleta shoqeruese nuk eshte shitje: shoqeron mall qe leviz nga nje pike ne tjetren, dhe kerkohet
nga ligji edhe kur asgje nuk shitet.

Rreshtat quhen `invoice_lines`, jo `lines` si tek faturat.

## Fushat e detyrueshme

- `vehPlates`, targa e automjetit;
- `valueOfGoods`, vlera e mallit qe udheton;
- `invoice_lines`, te pakten nje rresht.

## Vlerat e lejuara

| Fusha | Vlerat |
| --- | --- |
| `type` | `WTN`, `SALE` |
| `transaction` | `TRANSFER`, `EXAMINATION`, `SALES`, `DOOR` |
| `vehOwnership` | `OWNER`, `THIRDPARTY` |
| `startPoint`, `destinPoint` | `ANOTHER`, `CUSTOMS`, `EXHIBITION`, `OTHER`, `SALE`, `STORE`, `WAREHOUSE` |
| `carrier_id_type` | `NUIS`, `ID` |

Full URL: `https://fature.al/api/v1/invoice/wtn`

API version: `v1`.

Authentication: required (bearer token).

### Body parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `vehPlates` | string | yes | Targa e automjetit. |
| `valueOfGoods` | number | yes | Vlera e mallrave, ne ALL. |
| `invoice_lines` | array | yes | Rreshtat e mallit, minimumi nje rresht. |
| `invoice_lines[].product_name` | string, maxLength 255 | yes | Emri ose pershkrimi i mallit. |
| `invoice_lines[].product_code` | string, maxLength 50 | yes | Kodi i mallit. |
| `invoice_lines[].unit` | string, maxLength 50 | yes | Njesia matese. |
| `invoice_lines[].quantity` | number | yes | Sasia, gjithmone me e madhe se 0. |
| `startCity` | string, nullable | no | Qyteti i nisjes. |
| `startAddr` | string, nullable | no | Adresa e nisjes. |
| `destinCity` | string, nullable | no | Qyteti i destinacionit. |
| `destinAddr` | string, nullable | no | Adresa e destinacionit. |
| `carrier_id_num` | string, nullable | no | ID ose NIPT i transportuesit. |
| `carrier_name` | string, nullable | no | Emri i transportuesit. |
| `carrier_town` | string, nullable | no | Qyteti i transportuesit. |
| `carrier_address` | string, nullable | no | Adresa e transportuesit. |

### Example request

```bash
curl -X POST 'https://fature.al/api/v1/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' \
  -H 'Content-Type: application/json' \
  -d '{
    "vehPlates": "AA123BB",
    "valueOfGoods": 10000,
    "invoice_lines": [
        {
            "product_name": "Kafe",
            "product_code": "K1",
            "unit": "cope",
            "quantity": 5
        }
    ],
    "startCity": "Tirane",
    "startAddr": "Rruga X",
    "destinCity": "Durres",
    "destinAddr": "Rruga Y",
    "carrier_id_num": "L01234567A",
    "carrier_name": "Transport SHPK",
    "carrier_town": "Tirane",
    "carrier_address": "Rruga Z"
}'
```

### Responses

**201** — Created

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean |  |
| `message` | any |  |

```json
{
    "status": false,
    "message": "Hello there"
}
```