Cenové ponuky

Vytvoriť cenovú ponuku

Vytvorí novú cenovú ponuku.

Odporúčaný flow

Odporúčaný happy path je poslať clientId a items.

Ak klienta ešte vo Fintoro nemáte alebo nechcete robiť samostatný krok na jeho vytvorenie, pošlite objekt client bez clientId. Backend sa pokúsi klienta dopárovať k existujúcemu záznamu a ak nič nenájde, vytvorí nového klienta.

Ak pošlete clientId aj objekt client, objekt client sa správa ako sparse override snapshotu klienta pre túto konkrétnu cenovú ponuku.

Ako fungujú defaulty

Väčšina dokladových polí je voliteľná. Backend ich vyhodnocuje v tomto poradí:

explicitná hodnota z payloadu,
klientské predvolené hodnoty,
firemné document settings.

V praxi to znamená napríklad:

number a numericalSeriesId sa doplnia z primárneho číselného radu, ak ich nepošlete,
issueDate defaultuje na dnešný deň,
validityDate defaultuje na issueDate + 30 dní,
transferTaxLiability defaultuje na false,
currencyId, languageId, note a textAboveItems sa môžu dopočítať z klienta alebo z firemných nastavení.

Ako funguje client resolution

Client resolution je striktne deterministický:

ak pošlete clientId, backend načíta klienta podľa ID v rámci,
ak clientId nepošlete, objekt client sa používa na dopárovanie alebo vytvorenie klienta,
ak pošlete clientId aj objekt client, objekt client sa použije iba ako snapshot override pre doklad.

Matching prebieha deterministicky v tomto poradí:

pri firmách: vatId, potom countryId + subjectId, potom name + email, potom name + street,
pri fyzických osobách: name + email, potom name + street.

Ako fungujú položky

Položka môže byť vytvorená tromi spôsobmi:

ako manuálna položka s vlastným názvom, jednotkou, cenou a DPH,
cez priceListItemId a quantity,
cez priceListItemId a sparse override vybraných polí, napríklad ceny alebo názvu.

priceListItemId slúži len na input hydratáciu. Response cenovej ponuky vracia už finálnu kanonickú položku a neponecháva tento cenníkový odkaz ako samostatné pole.

Cenové ponuky nepoužívajú per-item uuid; ak ho pošlete, backend ho ignoruje. warehouseAllocations pri cenových ponukách nie sú podporované.

Stav novej cenovej ponuky sa vytvára ako waiting.

Ak pošlete Idempotency-Key, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia cenovej ponuky.

POST

quotations

Vytvoriť cenovú ponuku

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/quotations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientId": 101,
  "items": [
    {
      "quantity": 2,
      "priceListItemId": 501,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "vatRate": 20,
      "discountType": "percentage",
      "discountValue": 10,
      "discountName": "Vernostná zľava"
    }
  ],
  "number": "20260001",
  "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,
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 5",
    "deliveryCity": "Trnava",
    "deliveryZip": "91701",
    "deliveryCountryId": 703
  },
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "issueDate": "2026-03-03",
  "validityDate": "2026-04-02",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "currencyId": 1,
  "languageId": 1,
  "note": "Cenová ponuka platí 30 dní.",
  "textAboveItems": "Dakujeme za Váš záujem."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/quotations"

payload = {
    "clientId": 101,
    "items": [
        {
            "quantity": 2,
            "priceListItemId": 501,
            "name": "Konzultácia",
            "description": "Mesačný balík konzultácií",
            "unitPrice": 100,
            "unitId": 1,
            "vatRate": 20,
            "discountType": "percentage",
            "discountValue": 10,
            "discountName": "Vernostná zľava"
        }
    ],
    "number": "20260001",
    "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,
        "hasDeliveryAddress": True,
        "deliveryStreet": "Skladová 5",
        "deliveryCity": "Trnava",
        "deliveryZip": "91701",
        "deliveryCountryId": 703
    },
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "issueDate": "2026-03-03",
    "validityDate": "2026-04-02",
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": False,
    "currencyId": 1,
    "languageId": 1,
    "note": "Cenová ponuka platí 30 dní.",
    "textAboveItems": "Dakujeme za Váš záujem."
}
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({
    clientId: 101,
    items: [
      {
        quantity: 2,
        priceListItemId: 501,
        name: 'Konzultácia',
        description: 'Mesačný balík konzultácií',
        unitPrice: 100,
        unitId: 1,
        vatRate: 20,
        discountType: 'percentage',
        discountValue: 10,
        discountName: 'Vernostná zľava'
      }
    ],
    number: '20260001',
    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,
      hasDeliveryAddress: true,
      deliveryStreet: 'Skladová 5',
      deliveryCity: 'Trnava',
      deliveryZip: '91701',
      deliveryCountryId: 703
    },
    businessCaseId: 701,
    numericalSeriesId: 12,
    issueDate: '2026-03-03',
    validityDate: '2026-04-02',
    discountType: 'percentage',
    discountValue: 10,
    transferTaxLiability: false,
    currencyId: 1,
    languageId: 1,
    note: 'Cenová ponuka platí 30 dní.',
    textAboveItems: 'Dakujeme za Váš záujem.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/quotations', 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/quotations",
  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([
    'clientId' => 101,
    'items' => [
        [
                'quantity' => 2,
                'priceListItemId' => 501,
                'name' => 'Konzultácia',
                'description' => 'Mesačný balík konzultácií',
                'unitPrice' => 100,
                'unitId' => 1,
                'vatRate' => 20,
                'discountType' => 'percentage',
                'discountValue' => 10,
                'discountName' => 'Vernostná zľava'
        ]
    ],
    'number' => '20260001',
    '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,
        'hasDeliveryAddress' => true,
        'deliveryStreet' => 'Skladová 5',
        'deliveryCity' => 'Trnava',
        'deliveryZip' => '91701',
        'deliveryCountryId' => 703
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'issueDate' => '2026-03-03',
    'validityDate' => '2026-04-02',
    'discountType' => 'percentage',
    'discountValue' => 10,
    'transferTaxLiability' => false,
    'currencyId' => 1,
    'languageId' => 1,
    'note' => 'Cenová ponuka platí 30 dní.',
    'textAboveItems' => 'Dakujeme za Váš záujem.'
  ]),
  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/quotations"

	payload := strings.NewReader("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\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/quotations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/quotations")

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  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 601,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "quotation",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/cp/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/quotations/601/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"
  },
  "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
    }
  },
  "issueDate": "2026-03-03",
  "validityDate": "2026-04-02",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "currencyId": 1,
  "languageId": 1,
  "note": "Cenová ponuka platí 30 dní.",
  "textAboveItems": "Dakujeme za Váš záujem.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "status": "waiting",
  "hasVat": true,
  "items": [
    {
      "id": 1,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

{
  "error": "Idempotency-Key reused with different request payload"
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

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

Option 1
Option 2

Payload pre vytvorenie cenovej ponuky. V bežnom prípade stačí poslať clientId a items; ostatné polia môže backend dopočítať. Musíte poslať buď clientId, alebo objekt client.

clientId

integer | null

povinné

ID existujúceho klienta. Toto je odporúčaný spôsob tvorby cenovej ponuky. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad.

Příklad:

101

items

object[]

povinné

Položky cenovej ponuky. Toto pole je povinné vždy. Per-item uuid nie je súčasťou request kontraktu; ak ho pošlete, backend ho ignoruje. warehouseAllocations pri cenových ponukách nie sú podporované.

Required array length: 1 - 100 elements

Payload jednej položky cenovej ponuky. Podporované sú tri režimy: manuálna položka, priceListItemId + quantity, alebo priceListItemId s čiastočnými override poľami. Povinné je vždy quantity. Ak nepošlete priceListItemId, musíte poslať aj name, unitPrice a vatRate. unitId je voliteľné; ak ho pri manuálnej položke nepošlete, backend použije jednotku 1 (ks / Unit::Piece). Ak priceListItemId pošlete, backend si z cenníkovej položky vie dopočítať názov, jednotku, cenu a sadzbu DPH; payload potom slúži len ako sparse override. uuid nie je súčasťou request kontraktu cenových ponúk; ak ho pošlete, backend ho ignoruje. warehouseAllocations pri cenových ponukách nie sú podporované.

Option 1
Option 2

Show child attributes

number

string | null

Manuálne číslo cenovej ponuky. Ak ho nepošlete, backend ho vygeneruje z číselného radu. Ak pošlete number, nepošlite zároveň numericalSeriesId.

Required string length: 1 - 20

Příklad:

"20260001"

client

object | null

Sparse klientský payload. Ak pošlete clientId, slúži ako override snapshotu pre tento doklad. Ak clientId nepošlete, backend podľa týchto údajov klienta dopáruje alebo vytvorí.

Show child attributes

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi určenému cez finálny clientId.

Příklad:

701

numericalSeriesId

integer | null

ID číselného radu. Ak ho nepošlete a nepošlete ani number, použije sa primárny číselný rad pre cenové ponuky. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

issueDate

string<date>

Dátum vystavenia vo formáte Y-m-d. Musí byť po 2009-01-01 a pred dátumom o jeden rok v budúcnosti. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-03"

validityDate

string<date> | null

Dátum platnosti vo formáte Y-m-d. Musí byť rovný alebo neskorší než finálny issueDate. Ak ho nepošlete, použije sa issueDate + 30 dní.

Příklad:

"2026-04-02"

discountType

enum<string> | null

Typ zľavy na úrovni celého dokladu.

Dostupné možnosti:

percentage,

fixed

Příklad:

"percentage"

discountValue

number<float> | null

Hodnota zľavy na úrovni celého dokladu.

Požadovaný rozsah: x >= 0

Příklad:

10

transferTaxLiability

boolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.

Příklad:

false

currencyId

integer

ID meny z referenčnej tabuľky mien. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

note

string | null

Poznámka na doklade. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000

Příklad:

"Cenová ponuka platí 30 dní."

textAboveItems

string | null

Text nad položkami. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000

Příklad:

"Dakujeme za Váš záujem."

Odpověď

Cenová ponuka bola vytvorená.

Cenová ponuka.

integer

Příklad:

601

uuid

string

Příklad:

"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

type

string

Příklad:

"quotation"

number

string

Příklad:

"20260001"

webDokladUrl

string<uri>

Absolútna URL na verejný web doklad tejto cenovej ponuky.

Příklad:

"https://app.fintoro.sk/web-doklad/cp/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1"

pdfDownloadUrl

string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tejto cenovej ponuky ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/quotations/601/pdf"

company

object

Snapshot dodávateľa uložený priamo na tomto doklade.

Show child attributes

clientId

integer

Live ID klienta naviazaného na cenovú ponuku.

Příklad:

101

client

object

Historický snapshot klienta uložený priamo na tomto doklade.

Show child attributes

issueDate

string<date>

Příklad:

"2026-03-03"

validityDate

string<date> | null

Příklad:

"2026-04-02"

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť zvolenému klientovi na doklade.

Příklad:

701

discountType

enum<string> | null

Dostupné možnosti:

percentage,

fixed

Příklad:

"percentage"

discountValue

number<float> | null

Příklad:

10

transferTaxLiability

boolean

Příklad:

false

numericalSeriesId

integer | null

Příklad:

12

currencyId

integer

ID meny z referenčnej tabuľky mien.

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

note

string | null

Příklad:

"Cenová ponuka platí 30 dní."

textAboveItems

string | null

Příklad:

"Dakujeme za Váš záujem."

itemsTotal

number<float>

Příklad:

200

itemsTotalWithVat

number<float>

Příklad:

240

total

number<float>

Příklad:

200

totalWithVat

number<float>

Příklad:

240

status

enum<string>

Dostupné možnosti:

waiting,

accepted,

rejected

Příklad:

"waiting"

hasVat

boolean

Příklad:

true

items

object[]

Show child attributes

Předchozí

Detail cenovej ponukyVráti detail cenovej ponuky. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený priamo na doklade, finálne vypočítané položky cenovej ponuky a URL na verejný web doklad aj PDF download endpoint.

Další

Vytvoriť cenovú ponuku

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/quotations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientId": 101,
  "items": [
    {
      "quantity": 2,
      "priceListItemId": 501,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "vatRate": 20,
      "discountType": "percentage",
      "discountValue": 10,
      "discountName": "Vernostná zľava"
    }
  ],
  "number": "20260001",
  "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,
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 5",
    "deliveryCity": "Trnava",
    "deliveryZip": "91701",
    "deliveryCountryId": 703
  },
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "issueDate": "2026-03-03",
  "validityDate": "2026-04-02",
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "currencyId": 1,
  "languageId": 1,
  "note": "Cenová ponuka platí 30 dní.",
  "textAboveItems": "Dakujeme za Váš záujem."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/quotations"

payload = {
    "clientId": 101,
    "items": [
        {
            "quantity": 2,
            "priceListItemId": 501,
            "name": "Konzultácia",
            "description": "Mesačný balík konzultácií",
            "unitPrice": 100,
            "unitId": 1,
            "vatRate": 20,
            "discountType": "percentage",
            "discountValue": 10,
            "discountName": "Vernostná zľava"
        }
    ],
    "number": "20260001",
    "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,
        "hasDeliveryAddress": True,
        "deliveryStreet": "Skladová 5",
        "deliveryCity": "Trnava",
        "deliveryZip": "91701",
        "deliveryCountryId": 703
    },
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "issueDate": "2026-03-03",
    "validityDate": "2026-04-02",
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": False,
    "currencyId": 1,
    "languageId": 1,
    "note": "Cenová ponuka platí 30 dní.",
    "textAboveItems": "Dakujeme za Váš záujem."
}
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({
    clientId: 101,
    items: [
      {
        quantity: 2,
        priceListItemId: 501,
        name: 'Konzultácia',
        description: 'Mesačný balík konzultácií',
        unitPrice: 100,
        unitId: 1,
        vatRate: 20,
        discountType: 'percentage',
        discountValue: 10,
        discountName: 'Vernostná zľava'
      }
    ],
    number: '20260001',
    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,
      hasDeliveryAddress: true,
      deliveryStreet: 'Skladová 5',
      deliveryCity: 'Trnava',
      deliveryZip: '91701',
      deliveryCountryId: 703
    },
    businessCaseId: 701,
    numericalSeriesId: 12,
    issueDate: '2026-03-03',
    validityDate: '2026-04-02',
    discountType: 'percentage',
    discountValue: 10,
    transferTaxLiability: false,
    currencyId: 1,
    languageId: 1,
    note: 'Cenová ponuka platí 30 dní.',
    textAboveItems: 'Dakujeme za Váš záujem.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/quotations', 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/quotations",
  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([
    'clientId' => 101,
    'items' => [
        [
                'quantity' => 2,
                'priceListItemId' => 501,
                'name' => 'Konzultácia',
                'description' => 'Mesačný balík konzultácií',
                'unitPrice' => 100,
                'unitId' => 1,
                'vatRate' => 20,
                'discountType' => 'percentage',
                'discountValue' => 10,
                'discountName' => 'Vernostná zľava'
        ]
    ],
    'number' => '20260001',
    '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,
        'hasDeliveryAddress' => true,
        'deliveryStreet' => 'Skladová 5',
        'deliveryCity' => 'Trnava',
        'deliveryZip' => '91701',
        'deliveryCountryId' => 703
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'issueDate' => '2026-03-03',
    'validityDate' => '2026-04-02',
    'discountType' => 'percentage',
    'discountValue' => 10,
    'transferTaxLiability' => false,
    'currencyId' => 1,
    'languageId' => 1,
    'note' => 'Cenová ponuka platí 30 dní.',
    'textAboveItems' => 'Dakujeme za Váš záujem.'
  ]),
  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/quotations"

	payload := strings.NewReader("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\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/quotations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/quotations")

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  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"issueDate\": \"2026-03-03\",\n  \"validityDate\": \"2026-04-02\",\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"currencyId\": 1,\n  \"languageId\": 1,\n  \"note\": \"Cenová ponuka platí 30 dní.\",\n  \"textAboveItems\": \"Dakujeme za Váš záujem.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 601,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "quotation",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/cp/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/quotations/601/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"
  },
  "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
    }
  },
  "issueDate": "2026-03-03",
  "validityDate": "2026-04-02",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "currencyId": 1,
  "languageId": 1,
  "note": "Cenová ponuka platí 30 dní.",
  "textAboveItems": "Dakujeme za Váš záujem.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "status": "waiting",
  "hasVat": true,
  "items": [
    {
      "id": 1,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

{
  "error": "Idempotency-Key reused with different request payload"
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Prehľad

Endpointy

Vytvoriť cenovú ponuku

Odporúčaný flow

Ako fungujú defaulty

Ako funguje client resolution

Ako fungujú položky

Autorizace

Hlavičky

Tělo

Odpověď