Vytvoriť skladovú výdajku
Vytvorí novú skladovú výdajku. Ak pošlete clientId, použije sa existujúci klient. Ak clientId nepošlete a pošlete objekt client, backend podľa týchto údajov klienta dopáruje alebo vytvorí. Request používa rovnakú stock availability validáciu ako web, preto pri nedostatočnom stave skladu endpoint vráti 422.
curl --request POST \
--url https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"number": "VYD-2026-0001",
"warehouseId": 301,
"languageId": 1,
"issueDate": "2026-03-11",
"items": [
{
"priceListItemId": 701,
"quantity": 3,
"unitPrice": 15,
"vatRate": 20
}
],
"clientId": 101,
"client": {
"name": "Client s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@client.test",
"street": "Klientská 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703
},
"note": "Výdaj pre manuálny odber"
}
'import requests
url = "https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts"
payload = {
"number": "VYD-2026-0001",
"warehouseId": 301,
"languageId": 1,
"issueDate": "2026-03-11",
"items": [
{
"priceListItemId": 701,
"quantity": 3,
"unitPrice": 15,
"vatRate": 20
}
],
"clientId": 101,
"client": {
"name": "Client s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": True,
"email": "billing@client.test",
"street": "Klientská 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703
},
"note": "Výdaj pre manuálny odber"
}
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: 'VYD-2026-0001',
warehouseId: 301,
languageId: 1,
issueDate: '2026-03-11',
items: [{priceListItemId: 701, quantity: 3, unitPrice: 15, vatRate: 20}],
clientId: 101,
client: {
name: 'Client s.r.o.',
type: 'company',
subjectId: '12345678',
taxId: '2020123456',
vatId: 'SK2020123456',
isVatPayer: true,
email: 'billing@client.test',
street: 'Klientská 1',
city: 'Bratislava',
zip: '81101',
countryId: 703
},
note: 'Výdaj pre manuálny odber'
})
};
fetch('https://app.fintoro.sk/api/public/v1/warehouse-outbound-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-outbound-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' => 'VYD-2026-0001',
'warehouseId' => 301,
'languageId' => 1,
'issueDate' => '2026-03-11',
'items' => [
[
'priceListItemId' => 701,
'quantity' => 3,
'unitPrice' => 15,
'vatRate' => 20
]
],
'clientId' => 101,
'client' => [
'name' => 'Client s.r.o.',
'type' => 'company',
'subjectId' => '12345678',
'taxId' => '2020123456',
'vatId' => 'SK2020123456',
'isVatPayer' => true,
'email' => 'billing@client.test',
'street' => 'Klientská 1',
'city' => 'Bratislava',
'zip' => '81101',
'countryId' => 703
],
'note' => 'Výdaj pre manuálny odber'
]),
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-outbound-receipts"
payload := strings.NewReader("{\n \"number\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\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-outbound-receipts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"number\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/warehouse-outbound-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\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\n}"
response = http.request(request)
puts response.read_body{
"id": 951,
"uuid": "3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4",
"number": "VYD-2026-0001",
"webDokladUrl": "https://app.fintoro.sk/web-doklad/company/warehouse-outbound-receipt/uuid",
"pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/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
},
"clientId": 101,
"client": {
"name": "Acme s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@acme.test",
"street": "Hlavná 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703,
"country": {
"id": 703,
"name": "Slovensko",
"code": "SK",
"eu": true
},
"hasDeliveryAddress": true,
"deliveryStreet": "Skladová 9",
"deliveryCity": "Košice",
"deliveryZip": "04001",
"deliveryCountryId": 703,
"deliveryCountry": {
"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": "Výdaj pre manuálny odber",
"hasVat": true,
"total": 30,
"totalWithVat": 36,
"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 výdajky.
Číslo skladovej výdajky. Ak chcete použiť automatické ďalšie číslo skladu, pošlite ho explicitne podľa aktuálneho warehouse radu.
1 - 20"VYD-2026-0001"
ID skladu.
301
ID jazyka z lookup endpointu jazykov.
1
Dátum vystavenia výdajky.
"2026-03-11"
Položky výdajky. Každá položka musí smerovať na warehouse-enabled cenníkovú položku a backend overuje dostupný stock.
1Show child attributes
Show child attributes
Voliteľné ID existujúceho klienta. Ak pošlete clientId, objekt client sa použije len ako override snapshotu pre túto konkrétnu výdajku.
101
Sparse klientský payload. Ak pošlete clientId, slúži ako override snapshotu na výdajke. Ak clientId nepošlete, backend podľa týchto údajov klienta dopáruje alebo vytvorí.
Show child attributes
Show child attributes
Voliteľná interná poznámka na výdajke.
3000"Výdaj pre manuálny odber"
Odpověď
Skladová výdajka bola vytvorená.
Skladová výdajka vrátane skladu, klientského snapshotu a položiek.
Interné ID skladovej výdajky.
951
Verejné UUID skladovej výdajky použité aj vo webDoklad URL.
"3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4"
Číslo skladovej výdajky.
"VYD-2026-0001"
URL verejného web dokladu tejto výdajky.
"https://app.fintoro.sk/web-doklad/company/warehouse-outbound-receipt/uuid"
Priama URL na stiahnutie PDF exportu tejto výdajky.
"https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/pdf"
Historický snapshot dodávateľa uložený na doklade.
Show child attributes
Show child attributes
Sklad, z ktorého výdajka odpíše tovar.
Show child attributes
Show child attributes
Live ID klienta, ak je výdajka stále naviazaná na existujúceho klienta.
101
Historický snapshot klienta uložený na výdajke.
Show child attributes
Show child attributes
Mena výdajky.
Show child attributes
Show child attributes
Jazyk výdajky.
Show child attributes
Show child attributes
Dátum vystavenia výdajky.
"2026-03-11"
Voliteľná interná poznámka na výdajke.
"Výdaj pre manuálny odber"
Označuje, či výdajka obsahuje DPH.
true
Celková suma bez DPH.
30
Celková suma s DPH.
36
Položky skladovej výdajky.
Show child attributes
Show child attributes
curl --request POST \
--url https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"number": "VYD-2026-0001",
"warehouseId": 301,
"languageId": 1,
"issueDate": "2026-03-11",
"items": [
{
"priceListItemId": 701,
"quantity": 3,
"unitPrice": 15,
"vatRate": 20
}
],
"clientId": 101,
"client": {
"name": "Client s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@client.test",
"street": "Klientská 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703
},
"note": "Výdaj pre manuálny odber"
}
'import requests
url = "https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts"
payload = {
"number": "VYD-2026-0001",
"warehouseId": 301,
"languageId": 1,
"issueDate": "2026-03-11",
"items": [
{
"priceListItemId": 701,
"quantity": 3,
"unitPrice": 15,
"vatRate": 20
}
],
"clientId": 101,
"client": {
"name": "Client s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": True,
"email": "billing@client.test",
"street": "Klientská 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703
},
"note": "Výdaj pre manuálny odber"
}
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: 'VYD-2026-0001',
warehouseId: 301,
languageId: 1,
issueDate: '2026-03-11',
items: [{priceListItemId: 701, quantity: 3, unitPrice: 15, vatRate: 20}],
clientId: 101,
client: {
name: 'Client s.r.o.',
type: 'company',
subjectId: '12345678',
taxId: '2020123456',
vatId: 'SK2020123456',
isVatPayer: true,
email: 'billing@client.test',
street: 'Klientská 1',
city: 'Bratislava',
zip: '81101',
countryId: 703
},
note: 'Výdaj pre manuálny odber'
})
};
fetch('https://app.fintoro.sk/api/public/v1/warehouse-outbound-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-outbound-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' => 'VYD-2026-0001',
'warehouseId' => 301,
'languageId' => 1,
'issueDate' => '2026-03-11',
'items' => [
[
'priceListItemId' => 701,
'quantity' => 3,
'unitPrice' => 15,
'vatRate' => 20
]
],
'clientId' => 101,
'client' => [
'name' => 'Client s.r.o.',
'type' => 'company',
'subjectId' => '12345678',
'taxId' => '2020123456',
'vatId' => 'SK2020123456',
'isVatPayer' => true,
'email' => 'billing@client.test',
'street' => 'Klientská 1',
'city' => 'Bratislava',
'zip' => '81101',
'countryId' => 703
],
'note' => 'Výdaj pre manuálny odber'
]),
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-outbound-receipts"
payload := strings.NewReader("{\n \"number\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\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-outbound-receipts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"number\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/warehouse-outbound-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\": \"VYD-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 \"clientId\": 101,\n \"client\": {\n \"name\": \"Client s.r.o.\",\n \"type\": \"company\",\n \"subjectId\": \"12345678\",\n \"taxId\": \"2020123456\",\n \"vatId\": \"SK2020123456\",\n \"isVatPayer\": true,\n \"email\": \"billing@client.test\",\n \"street\": \"Klientská 1\",\n \"city\": \"Bratislava\",\n \"zip\": \"81101\",\n \"countryId\": 703\n },\n \"note\": \"Výdaj pre manuálny odber\"\n}"
response = http.request(request)
puts response.read_body{
"id": 951,
"uuid": "3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4",
"number": "VYD-2026-0001",
"webDokladUrl": "https://app.fintoro.sk/web-doklad/company/warehouse-outbound-receipt/uuid",
"pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/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
},
"clientId": 101,
"client": {
"name": "Acme s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@acme.test",
"street": "Hlavná 1",
"city": "Bratislava",
"zip": "81101",
"countryId": 703,
"country": {
"id": 703,
"name": "Slovensko",
"code": "SK",
"eu": true
},
"hasDeliveryAddress": true,
"deliveryStreet": "Skladová 9",
"deliveryCity": "Košice",
"deliveryZip": "04001",
"deliveryCountryId": 703,
"deliveryCountry": {
"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": "Výdaj pre manuálny odber",
"hasVat": true,
"total": 30,
"totalWithVat": 36,
"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"
}
