Přejít na hlavní obsah
GET
/
price-list-items
Zoznam skladových a cenníkových položiek
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/price-list-items \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 701,
      "name": "Servisný balík",
      "description": "Mesačný servis a podpora",
      "unitId": 1,
      "unit": {
        "id": 1,
        "name": "ks"
      },
      "unitPrice": 129.9,
      "vatRate": 20,
      "unitPriceWithVat": 155.88,
      "stock": 12,
      "stocks": [
        {
          "warehouseId": 15,
          "warehouseName": "Hlavný sklad",
          "warehouseCode": "MAIN-WH",
          "stockQuantity": 7
        }
      ],
      "ean": "8586012345678",
      "useWarehouse": true,
      "warehouseCode": "SKU-PUBLIC-001",
      "enableNegativeStock": false,
      "maxStock": 250,
      "purchasePrice": 89.5,
      "purchaseVatRate": 20,
      "purchasePriceWithVat": 107.4
    }
  ],
  "paginator": {
    "currentPage": 2,
    "perPage": 10,
    "totalPages": 5,
    "totalResults": 42,
    "currentFrom": 11,
    "currentTo": 20,
    "firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
    "nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
    "previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "links": [
      {
        "url": "https://app.fintoro.sk/api/public/v1/invoices?page=2",
        "label": "2",
        "active": false
      }
    ]
  }
}

Autorizace

Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Parametry dotazu

name
string

Fulltextové vyhľadávanie podľa názvu položky, skladového kódu alebo EANu.

Maximum string length: 255
Příklad:

"match"

priceFrom
number<float>

Minimálna jednotková cena bez DPH.

Příklad:

10

priceTo
number<float>

Maximálna jednotková cena bez DPH.

Příklad:

100

stockFrom
number<float>

Minimálny aktuálny stav skladu položky.

Příklad:

1

stockTo
number<float>

Maximálny aktuálny stav skladu položky.

Příklad:

50

onlyWarehouseItems
boolean
výchozí:false

Ak pošlete true, endpoint vráti len položky so zapnutou skladovou evidenciou.

Příklad:

true

sortBy
enum<string>
výchozí:name

Pole, podľa ktorého sa zoznam zoradí.

Dostupné možnosti:
name,
unit_price,
stock
Příklad:

"stock"

sortDirection
enum<string>
výchozí:asc

Smer zoradenia.

Dostupné možnosti:
asc,
desc
Příklad:

"desc"

perPage
integer
výchozí:50

Počet položiek na jednu stránku. Maximum je 200.

Požadovaný rozsah: 1 <= x <= 200
Příklad:

50

page
integer
výchozí:1

Číslo stránky, ktorá sa má vrátiť.

Požadovaný rozsah: x >= 1
Příklad:

2

Odpověď

Zoznam skladových a cenníkových položiek.

data
object[]

Položky aktuálnej stránky.

paginator
object

Metadata stránkovania pre aktuálny výsledok.