Vytvoriť skladovú príjemku
Vytvorí novú skladovú príjemku. Ak pošlete supplierId, použije sa existujúci dodávateľ. Ak supplierId nepošlete a pošlete objekt supplier, backend podľa týchto údajov dodávateľa dopáruje alebo vytvorí. Ak pošlete Idempotency-Key, opakované create volanie s rovnakým payloadom vráti pôvodnú odpoveď.
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"
}
'import requests
url = "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts"
payload = {
"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"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts"
payload := strings.NewReader("{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}"
response = http.request(request)
puts response.read_body{
"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",
"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
}
]
}{
"message": "The given data was invalid.",
"errors": {}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}Autorizace
Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.
Hlavičky
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ť.
"invoice-create-2026-03-03-001"
Tělo
Payload pre vytvorenie skladovej príjemky.
Číslo skladovej príjemky. Ak chcete použiť automatické ďalšie číslo skladu, pošlite ho explicitne podľa aktuálneho warehouse radu.
1 - 20"PRI-2026-0001"
ID skladu.
301
ID jazyka z lookup endpointu jazykov.
1
Dátum vystavenia príjemky.
"2026-03-11"
Položky príjemky. Každá položka musí smerovať na warehouse-enabled cenníkovú položku.
1Show child attributes
Show child attributes
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.
401
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í.
Show child attributes
Show child attributes
Voliteľná interná poznámka na príjemke.
3000"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.
Interné ID skladovej príjemky.
901
Verejné UUID skladovej príjemky použité aj vo webDoklad URL.
"5d6f8b1d-44c2-4ef6-a2c9-2d4d1c1a6e10"
Číslo skladovej príjemky.
"PRI-2026-0001"
URL verejného web dokladu tejto príjemky.
"https://app.fintoro.sk/web-doklad/company/warehouse-inbound-receipt/uuid"
Priama URL na stiahnutie PDF exportu tejto príjemky.
"https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/901/pdf"
Historický snapshot dodávateľa uložený na doklade.
Show child attributes
Show child attributes
Sklad, do ktorého príjemka zapisuje tovar.
Show child attributes
Show child attributes
Live ID dodávateľa, ak je príjemka stále naviazaná na existujúceho dodávateľa.
401
Historický snapshot dodávateľa uložený na príjemke.
Show child attributes
Show child attributes
Mena príjemky.
Show child attributes
Show child attributes
Jazyk príjemky.
Show child attributes
Show child attributes
Dátum vystavenia príjemky.
"2026-03-11"
Voliteľná interná poznámka na príjemke.
"Príjem z externého nákupu"
Označuje, či príjemka obsahuje DPH.
true
Celková suma bez DPH.
45
Celková suma s DPH.
54
Položky skladovej príjemky.
Show child attributes
Show child attributes
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"
}
'import requests
url = "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts"
payload = {
"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"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts"
payload := strings.NewReader("{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"number\": \"PRI-2026-0001\",\n \"warehouseId\": 301,\n \"languageId\": 1,\n \"issueDate\": \"2026-03-11\",\n \"items\": [\n {\n \"priceListItemId\": 701,\n \"quantity\": 3,\n \"unitPrice\": 15,\n \"vatRate\": 20\n }\n ],\n \"supplierId\": 401,\n \"supplier\": {\n \"name\": \"Supply s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@supply.test\",\n \"street\": \"Dodávateľská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Príjem z externého nákupu\"\n}"
response = http.request(request)
puts response.read_body{
"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",
"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
}
]
}{
"message": "The given data was invalid.",
"errors": {}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}
