Přejít na hlavní obsah
POST
/
price-list-items
Vytvoriť skladovú alebo cenníkovú položku
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/price-list-items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Servisný balík",
  "unitPrice": 129.9,
  "unitId": 1,
  "vatRate": 20,
  "description": "Mesačný servis a podpora",
  "ean": "8586012345678",
  "useWarehouse": true,
  "warehouseCode": "SKU-PUBLIC-001",
  "enableNegativeStock": false,
  "maxStock": 250,
  "purchasePrice": 89.5,
  "purchaseVatRate": 20
}
'
{
  "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
}

Autorizace

​
Authorization
string
header
povinné

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

Hlavičky

​
Idempotency-Key
string

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre vytvorenie skladovej alebo cenníkovej položky. Required business polia sú vždy name, unitPrice, unitId a vatRate. Ak pošlete useWarehouse: true, warehouseCode sa stáva povinným poľom.

​
name
string
povinné

Názov položky.

Maximum string length: 255
Příklad:

"Servisný balík"

​
unitPrice
number<float>
povinné

Predajná jednotková cena bez DPH.

Požadovaný rozsah: -10000000000000 <= x <= 10000000000000
Příklad:

129.9

​
unitId
integer
povinné

ID jednotky z referenčnej tabuľky jednotiek.

Příklad:

1

​
vatRate
number<float>
povinné

Predajná sadzba DPH položky.

Požadovaný rozsah: 0 <= x <= 23
Příklad:

20

​
description
string | null

Voliteľný detailnejší popis položky.

Maximum string length: 1000
Příklad:

"Mesačný servis a podpora"

​
ean
string | null

Voliteľný EAN kód položky. Ak ho pošlete, musí byť unikátny.

Maximum string length: 255
Příklad:

"8586012345678"

​
useWarehouse
boolean
výchozí:false

Ak pošlete true, položka bude vedená ako skladová.

Příklad:

true

​
warehouseCode
string | null

Voliteľný kód skladovej karty. Ak pošlete useWarehouse: true, toto pole je povinné a musí byť unikátne.

Maximum string length: 255
Příklad:

"SKU-PUBLIC-001"

​
enableNegativeStock
boolean
výchozí:false

Označuje, či je povolený záporný skladový stav.

Příklad:

false

​
maxStock
number<float> | null

Voliteľný maximálny odporúčaný stav skladu.

Požadovaný rozsah: 0 <= x <= 10000000000000
Příklad:

250

​
purchasePrice
number<float> | null

Voliteľná nákupná cena bez DPH.

Požadovaný rozsah: -10000000000000 <= x <= 10000000000000
Příklad:

89.5

​
purchaseVatRate
number<float> | null

Voliteľná nákupná sadzba DPH.

Požadovaný rozsah: 0 <= x <= 23
Příklad:

20

Odpověď

Položka bola vytvorená.

Skladová alebo cenníková položka. Objekt vracia business údaje použiteľné pri tvorbe dokladov aj skladové nastavenia, ak má položka zapnutú evidenciu skladu.

​
id
integer

Interné ID položky vo Fintoro.

Příklad:

701

​
name
string

Názov položky.

Příklad:

"Servisný balík"

​
description
string | null

Detailnejší popis položky, ak je na nej uložený.

Příklad:

"Mesačný servis a podpora"

​
unitId
integer

ID jednotky z referenčnej tabuľky jednotiek.

Příklad:

1

​
unit
object

Jednotka položky ako vnorený lookup objekt.

​
unitPrice
number<float>

Predajná jednotková cena bez DPH.

Příklad:

129.9

​
vatRate
number<float>

Sadzba DPH použitá na predajnú cenu položky.

Příklad:

20

​
unitPriceWithVat
number<float>

Predajná jednotková cena s DPH dopočítaná backendom.

Příklad:

155.88

​
stock
number<float>

Aktuálny celkový skladový stav položky naprieč všetkými skladmi.

Příklad:

12

​
stocks
object[]

Rozpis aktuálneho skladového stavu položky po jednotlivých skladoch firmy.

​
ean
string | null

EAN kód položky, ak je evidovaný.

Maximum string length: 255
Příklad:

"8586012345678"

​
useWarehouse
boolean

Označuje, či je na položke zapnutá skladová evidencia.

Příklad:

true

​
warehouseCode
string | null

Interný kód skladovej karty. Pri zapnutej skladovej evidencii má byť unikátny v rámci firmy.

Maximum string length: 255
Příklad:

"SKU-PUBLIC-001"

​
enableNegativeStock
boolean

Označuje, či položka povoľuje záporný stav skladu.

Příklad:

false

​
maxStock
number<float> | null

Maximálny odporúčaný stav skladu, ak je na položke nastavený.

Příklad:

250

​
purchasePrice
number<float> | null

Nákupná cena bez DPH, ak je na položke evidovaná.

Příklad:

89.5

​
purchaseVatRate
number<float> | null

Nákupná sadzba DPH, ak je na položke evidovaná.

Příklad:

20

​
purchasePriceWithVat
number<float> | null

Nákupná cena s DPH dopočítaná backendom, ak je dostupná nákupná cena a sadzba DPH.

Příklad:

107.4