Skip to main content
POST
Vytvoriť skladovú príjemku

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 príjemky.

number
string
povinné

Číslo skladovej príjemky. Ak chcete použiť automatické ďalšie číslo skladu, pošlite ho explicitne podľa aktuálneho warehouse radu.

Required string length: 1 - 20
Příklad:

"PRI-2026-0001"

warehouseId
integer
povinné

ID skladu.

Příklad:

301

languageId
integer
povinné

ID jazyka z lookup endpointu jazykov.

Příklad:

1

issueDate
string<date>
povinné

Dátum vystavenia príjemky.

Příklad:

"2026-03-11"

items
object[]
povinné

Položky príjemky. Každá položka musí smerovať na warehouse-enabled cenníkovú položku.

Minimum array length: 1
supplierId
integer | null

Voliteľné ID existujúceho dodávateľa. Ak pošlete supplierId, objekt supplier sa použije len ako override snapshotu pre túto konkrétnu príjemku.

Příklad:

401

supplier
object | null

Sparse dodávateľský payload. Ak pošlete supplierId, slúži ako override snapshotu na príjemke. Ak supplierId nepošlete, backend podľa týchto údajov dodávateľa dopáruje alebo vytvorí.

note
string | null

Voliteľná interná poznámka na príjemke.

Maximum string length: 3000
Příklad:

"Príjem z externého nákupu"

Odpověď

Skladová príjemka bola vytvorená.

Skladová príjemka vrátane skladu, dodávateľského snapshotu a položiek.

id
integer

Interné ID skladovej príjemky.

Příklad:

901

uuid
string

Verejné UUID skladovej príjemky použité aj vo webDoklad URL.

Příklad:

"5d6f8b1d-44c2-4ef6-a2c9-2d4d1c1a6e10"

number
string

Číslo skladovej príjemky.

Příklad:

"PRI-2026-0001"

webDokladUrl
string

URL verejného web dokladu tejto príjemky.

Příklad:

"https://app.fintoro.sk/web-doklad/company/warehouse-inbound-receipt/uuid"

pdfDownloadUrl
string

Priama URL na stiahnutie PDF exportu tejto príjemky.

Příklad:

"https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/901/pdf"

company
object

Historický snapshot dodávateľa uložený na doklade.

warehouse
object

Sklad, do ktorého príjemka zapisuje tovar.

supplierId
integer | null

Live ID dodávateľa, ak je príjemka stále naviazaná na existujúceho dodávateľa.

Příklad:

401

supplier
object | null

Historický snapshot dodávateľa uložený na príjemke.

currency
object

Mena príjemky.

language
object

Jazyk príjemky.

issueDate
string<date>

Dátum vystavenia príjemky.

Příklad:

"2026-03-11"

note
string | null

Voliteľná interná poznámka na príjemke.

Příklad:

"Príjem z externého nákupu"

hasVat
boolean

Označuje, či príjemka obsahuje DPH.

Příklad:

true

total
number<float>

Celková suma bez DPH.

Příklad:

45

totalWithVat
number<float>

Celková suma s DPH.

Příklad:

54

items
object[]

Položky skladovej príjemky.