Přejít na hlavní obsah
POST
/
warehouse-inbound-receipts
Vytvoriť skladovú príjemku
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "PRI-2026-0001",
  "warehouseId": 301,
  "languageId": 1,
  "issueDate": "2026-03-11",
  "items": [
    {
      "priceListItemId": 701,
      "quantity": 3,
      "unitPrice": 15,
      "vatRate": 20
    }
  ],
  "supplierId": 401,
  "supplier": {
    "name": "Supply s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@supply.test",
    "street": "Dodávateľská 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703
  },
  "note": "Príjem z externého nákupu"
}
'
{
  "id": 901,
  "uuid": "5d6f8b1d-44c2-4ef6-a2c9-2d4d1c1a6e10",
  "number": "PRI-2026-0001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/company/warehouse-inbound-receipt/uuid",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/901/pdf",
  "company": {
    "name": "Fintoro s.r.o.",
    "subjectId": "12345678",
    "legalForm": "Spoločnosť s ručením obmedzeným",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "vatPayerTypeId": 4,
    "country": "Slovensko",
    "city": "Bratislava",
    "street": "Hlavná 1",
    "zip": "81101",
    "logo": "https://cdn.fintoro.sk/company/logo.svg",
    "signature": "https://cdn.fintoro.sk/company/signature.png",
    "registrationCourt": "Mestský súd Bratislava III",
    "registrationNumber": "12345/B",
    "email": "support@fintoro.sk",
    "phone": "+421900000000",
    "web": "https://fintoro.sk"
  },
  "warehouse": {
    "id": 301,
    "name": "Hlavný sklad",
    "code": "MAIN-WH",
    "inboundNumericalSeriesPattern": "PRI-(RR)-(CCCC)",
    "inboundNumericalSeriesNextNumber": 12,
    "outboundNumericalSeriesPattern": "VYD-(RR)-(CCCC)",
    "outboundNumericalSeriesNextNumber": 8
  },
  "supplierId": 401,
  "supplier": {
    "name": "Supply s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@supply.test",
    "street": "Dodávateľská 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "country": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    }
  },
  "currency": {
    "id": 1,
    "symbol": "EUR",
    "name": "Euro",
    "mark": "€"
  },
  "language": {
    "id": 1,
    "name": "Slovenčina",
    "code": "sk"
  },
  "issueDate": "2026-03-11",
  "note": "Príjem z externého nákupu",
  "hasVat": true,
  "total": 45,
  "totalWithVat": 54,
  "items": [
    {
      "id": 7001,
      "priceListItemId": 701,
      "priceListItemName": "Montážna sada",
      "priceListItemWarehouseCode": "SKU-001",
      "unitName": "ks",
      "quantity": 3,
      "unitPrice": 15,
      "unitPriceWithVat": 18,
      "vatRate": 20
    }
  ]
}

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

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

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.