Dobropisy

Vytvoriť dobropis

Vytvorí nový dobropis.

Business pravidlá

Dobropis musí byť naviazaný na existujúcu faktúru cez invoiceId.
Klient dobropisu sa vždy preberá zo zvolenej zdrojovej faktúry; clientId neposielajte.
Tento endpoint nepodporuje inline client payload, client resolution ani automatické vytváranie klienta.
Výsledná celková suma dobropisu musí zostať záporná; ak payload vyprodukuje kladný doklad, endpoint vráti 422.

Payload kontrakt

Na rozdiel od Fintoro API faktúr a zálohových faktúr ide o explicitný create flow bez smart defaultov. Pošlite kompletný business payload dokladu vrátane dátumov, bankového účtu, symbolov, meny a položiek.

Ak používate skladové alokácie na položkách, backend ich spracuje ako príjemové pohyby naviazané na dobropis.

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

POST

credit-notes

Vytvoriť dobropis

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/credit-notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "invoiceId": 301,
  "number": "20260051",
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "bankAccountId": 201,
  "variableSymbol": 20260051,
  "transferTaxLiability": false,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "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",
      "warehouseAllocations": [
        {
          "warehouseId": 1,
          "quantity": 2
        }
      ]
    }
  ],
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "discountType": "percentage",
  "discountValue": 10,
  "note": "Dobropis k pôvodnej faktúre.",
  "textAboveItems": "Dobropisujeme časť pôvodného plnenia."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/credit-notes"

payload = {
    "invoiceId": 301,
    "number": "20260051",
    "issueDate": "2026-03-03",
    "dueDate": "2026-03-17",
    "deliveryDate": "2026-03-03",
    "bankAccountId": 201,
    "variableSymbol": 20260051,
    "transferTaxLiability": False,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "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",
            "warehouseAllocations": [
                {
                    "warehouseId": 1,
                    "quantity": 2
                }
            ]
        }
    ],
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "note": "Dobropis k pôvodnej faktúre.",
    "textAboveItems": "Dobropisujeme časť pôvodného plnenia."
}
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({
    invoiceId: 301,
    number: '20260051',
    issueDate: '2026-03-03',
    dueDate: '2026-03-17',
    deliveryDate: '2026-03-03',
    bankAccountId: 201,
    variableSymbol: 20260051,
    transferTaxLiability: false,
    paymentMethodId: 1,
    currencyId: 1,
    currencyRate: 1,
    languageId: 1,
    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',
        warehouseAllocations: [{warehouseId: 1, quantity: 2}]
      }
    ],
    businessCaseId: 701,
    numericalSeriesId: 12,
    constantSymbol: 308,
    specificSymbol: 55,
    discountType: 'percentage',
    discountValue: 10,
    note: 'Dobropis k pôvodnej faktúre.',
    textAboveItems: 'Dobropisujeme časť pôvodného plnenia.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/credit-notes', 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/credit-notes",
  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([
    'invoiceId' => 301,
    'number' => '20260051',
    'issueDate' => '2026-03-03',
    'dueDate' => '2026-03-17',
    'deliveryDate' => '2026-03-03',
    'bankAccountId' => 201,
    'variableSymbol' => 20260051,
    'transferTaxLiability' => false,
    'paymentMethodId' => 1,
    'currencyId' => 1,
    'currencyRate' => 1,
    'languageId' => 1,
    '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',
                'warehouseAllocations' => [
                                [
                                                                'warehouseId' => 1,
                                                                'quantity' => 2
                                ]
                ]
        ]
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'constantSymbol' => 308,
    'specificSymbol' => 55,
    'discountType' => 'percentage',
    'discountValue' => 10,
    'note' => 'Dobropis k pôvodnej faktúre.',
    'textAboveItems' => 'Dobropisujeme časť pôvodného plnenia.'
  ]),
  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/credit-notes"

	payload := strings.NewReader("{\n  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\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/credit-notes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\n}"

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

{
  "id": 351,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "credit-note",
  "number": "20260051",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/credit-note/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/credit-notes/351/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
    }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": {
      "id": 23,
      "name": "Tatra Banka",
      "swift": "TATRSKBX"
    },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "payments": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Platba prevodom"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "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",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ],
  "invoiceId": 301,
  "variableSymbol": 20260051,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "note": "Dobropis k pôvodnej faktúre.",
  "textAboveItems": "Dobropisujeme pôvodné plnenie.",
  "itemsTotal": -20,
  "itemsTotalWithVat": -24,
  "alreadyPaid": 0,
  "total": -20,
  "totalWithVat": -24,
  "toBePaid": -24,
  "status": "unpaid",
  "hasVat": true,
  "items": [
    {
      "id": 1,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "name": "Dobropisovaná konzultácia",
      "description": "Storno časti mesačného balíka",
      "unitPrice": -10,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "priceListItemId": 501,
      "total": -20,
      "totalWithVat": -24
    }
  ]
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

{
  "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

Payload pre vytvorenie dobropisu. Ide o explicitný create flow bez inline client resolution. Musíte poslať kompletný business payload vrátane invoiceId, všetkých kľúčových dokladových polí a položiek. Klient sa automaticky odvodí zo zdrojovej faktúry a výsledná celková suma dobropisu musí zostať záporná.

invoiceId

integer

povinné

ID pôvodnej faktúry, ku ktorej sa dobropis viaže.

Příklad:

301

number

string

povinné

Explicitné číslo dobropisu. Musí byť unikátne v rámci dobropisov aj faktúr. Tento flow vyžaduje number, preto spolu s ním neposielajte numericalSeriesId.

Required string length: 1 - 20

Příklad:

"20260051"

issueDate

string<date>

povinné

Dátum vystavenia vo formáte Y-m-d.

Příklad:

"2026-03-03"

dueDate

string<date>

povinné

Dátum splatnosti vo formáte Y-m-d. Musí byť väčší alebo rovný issueDate.

Příklad:

"2026-03-17"

deliveryDate

string<date>

povinné

Dátum dodania vo formáte Y-m-d. Musí byť menší alebo rovný issueDate.

Příklad:

"2026-03-03"

bankAccountId

integer

povinné

ID bankového účtu firmy použitého na dobropise.

Příklad:

201

variableSymbol

integer

povinné

Variabilný symbol s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

20260051

transferTaxLiability

boolean

povinné

Príznak prenesenej daňovej povinnosti.

Příklad:

false

paymentMethodId

integer

povinné

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

currencyId

integer

povinné

ID meny z referenčnej tabuľky mien.

Příklad:

1

currencyRate

number<float>

povinné

Kurz meny k EUR. Ak je mena dokladu EUR, backend vždy uloží a vráti 1.0.

Požadovaný rozsah: 0.00001 <= x <= 10000000

Příklad:

1

languageId

integer

povinné

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

items

object[]

povinné

Položky dobropisu. Výsledný doklad musí mať zápornú celkovú sumu.

Required array length: 1 - 100 elements

Payload jednej položky faktúry. 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.

Option 1
Option 2

Show child attributes

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi zdrojovej faktúry.

Příklad:

701

numericalSeriesId

integer | null

ID číselného radu pre dobropisy. V tomto explicitnom public create/update flowe ho neposielajte spolu s povinným poľom number.

Příklad:

12

constantSymbol

integer | null

Konštantný symbol s dĺžkou 1 až 4 číslic.

Požadovaný rozsah: 0 <= x <= 9999

Příklad:

308

specificSymbol

integer | null

Špecifický symbol s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

55

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.

Příklad:

10

note

string | null

Poznámka na doklade.

Maximum string length: 3000

Příklad:

"Dobropis k pôvodnej faktúre."

textAboveItems

string | null

Text nad položkami.

Maximum string length: 3000

Příklad:

"Dobropisujeme časť pôvodného plnenia."

Odpověď

Dobropis bol vytvorený.

Dobropis.

integer

Příklad:

351

uuid

string

Příklad:

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

type

string

Příklad:

"credit-note"

number

string

Příklad:

"20260051"

webDokladUrl

string<uri>

Absolútna URL na verejný web doklad tohto dobropisu.

Příklad:

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

pdfDownloadUrl

string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tohto dobropisu ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/credit-notes/351/pdf"

company

object

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

Show child attributes

clientId

integer

Live ID klienta naviazaného na dobropis.

Příklad:

101

client

object

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

Show child attributes

bankAccount

object | null

Bankový účet naviazaný na dobropis ako živá väzba načítaná aj cez soft delete.

Show child attributes

payments

object[]

Úhrady naviazané na tento dobropis v poradí od najnovšej.

Show child attributes

invoiceId

integer | null

ID pôvodnej faktúry, ku ktorej je dobropis naviazaný.

Příklad:

301

variableSymbol

integer | null

Příklad:

20260051

constantSymbol

integer | null

Příklad:

308

specificSymbol

integer | null

Příklad:

55

issueDate

string<date>

Příklad:

"2026-03-03"

dueDate

string<date>

Příklad:

"2026-03-17"

deliveryDate

string<date> | null

Příklad:

"2026-03-03"

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi zdrojovej faktúry.

Příklad:

701

discountType

string | null

Příklad:

"percentage"

discountValue

number<float> | null

Příklad:

10

transferTaxLiability

boolean

Příklad:

false

numericalSeriesId

integer | null

Příklad:

12

paymentMethodId

integer

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

currencyId

integer

ID meny z referenčnej tabuľky mien.

Příklad:

1

currencyRate

number<float>

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

note

string | null

Příklad:

"Dobropis k pôvodnej faktúre."

textAboveItems

string | null

Příklad:

"Dobropisujeme pôvodné plnenie."

itemsTotal

number<float>

Příklad:

-20

itemsTotalWithVat

number<float>

Příklad:

-24

alreadyPaid

number<float>

Příklad:

0

total

number<float>

Příklad:

-20

totalWithVat

number<float>

Příklad:

-24

toBePaid

number<float>

Příklad:

-24

status

enum<string>

Dostupné možnosti:

paid,

unpaid,

partially_paid,

overdue,

will_not_be_paid

Příklad:

"unpaid"

hasVat

boolean

Příklad:

true

items

object[]

Show child attributes

Předchozí

Detail dobropisuVráti detail dobropisu. Response obsahuje snapshot dodávateľa, historický snapshot klienta uložený na dobropise, live väzbu na bankový účet použitý na doklade, `invoiceId` pôvodnej faktúry a aj zoznam `payments` patriacich k tomuto dobropisu. Nájdete tu aj `webDokladUrl` a `pdfDownloadUrl` pre ďalšie integračné flowy.

Další

Vytvoriť dobropis

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/credit-notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "invoiceId": 301,
  "number": "20260051",
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "bankAccountId": 201,
  "variableSymbol": 20260051,
  "transferTaxLiability": false,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "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",
      "warehouseAllocations": [
        {
          "warehouseId": 1,
          "quantity": 2
        }
      ]
    }
  ],
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "discountType": "percentage",
  "discountValue": 10,
  "note": "Dobropis k pôvodnej faktúre.",
  "textAboveItems": "Dobropisujeme časť pôvodného plnenia."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/credit-notes"

payload = {
    "invoiceId": 301,
    "number": "20260051",
    "issueDate": "2026-03-03",
    "dueDate": "2026-03-17",
    "deliveryDate": "2026-03-03",
    "bankAccountId": 201,
    "variableSymbol": 20260051,
    "transferTaxLiability": False,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "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",
            "warehouseAllocations": [
                {
                    "warehouseId": 1,
                    "quantity": 2
                }
            ]
        }
    ],
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "note": "Dobropis k pôvodnej faktúre.",
    "textAboveItems": "Dobropisujeme časť pôvodného plnenia."
}
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({
    invoiceId: 301,
    number: '20260051',
    issueDate: '2026-03-03',
    dueDate: '2026-03-17',
    deliveryDate: '2026-03-03',
    bankAccountId: 201,
    variableSymbol: 20260051,
    transferTaxLiability: false,
    paymentMethodId: 1,
    currencyId: 1,
    currencyRate: 1,
    languageId: 1,
    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',
        warehouseAllocations: [{warehouseId: 1, quantity: 2}]
      }
    ],
    businessCaseId: 701,
    numericalSeriesId: 12,
    constantSymbol: 308,
    specificSymbol: 55,
    discountType: 'percentage',
    discountValue: 10,
    note: 'Dobropis k pôvodnej faktúre.',
    textAboveItems: 'Dobropisujeme časť pôvodného plnenia.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/credit-notes', 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/credit-notes",
  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([
    'invoiceId' => 301,
    'number' => '20260051',
    'issueDate' => '2026-03-03',
    'dueDate' => '2026-03-17',
    'deliveryDate' => '2026-03-03',
    'bankAccountId' => 201,
    'variableSymbol' => 20260051,
    'transferTaxLiability' => false,
    'paymentMethodId' => 1,
    'currencyId' => 1,
    'currencyRate' => 1,
    'languageId' => 1,
    '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',
                'warehouseAllocations' => [
                                [
                                                                'warehouseId' => 1,
                                                                'quantity' => 2
                                ]
                ]
        ]
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'constantSymbol' => 308,
    'specificSymbol' => 55,
    'discountType' => 'percentage',
    'discountValue' => 10,
    'note' => 'Dobropis k pôvodnej faktúre.',
    'textAboveItems' => 'Dobropisujeme časť pôvodného plnenia.'
  ]),
  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/credit-notes"

	payload := strings.NewReader("{\n  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\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/credit-notes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"invoiceId\": 301,\n  \"number\": \"20260051\",\n  \"issueDate\": \"2026-03-03\",\n  \"dueDate\": \"2026-03-17\",\n  \"deliveryDate\": \"2026-03-03\",\n  \"bankAccountId\": 201,\n  \"variableSymbol\": 20260051,\n  \"transferTaxLiability\": false,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\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      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ]\n    }\n  ],\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"note\": \"Dobropis k pôvodnej faktúre.\",\n  \"textAboveItems\": \"Dobropisujeme časť pôvodného plnenia.\"\n}"

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

{
  "id": 351,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "credit-note",
  "number": "20260051",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/credit-note/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/credit-notes/351/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
    }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": {
      "id": 23,
      "name": "Tatra Banka",
      "swift": "TATRSKBX"
    },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "payments": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Platba prevodom"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "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",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ],
  "invoiceId": 301,
  "variableSymbol": 20260051,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "note": "Dobropis k pôvodnej faktúre.",
  "textAboveItems": "Dobropisujeme pôvodné plnenie.",
  "itemsTotal": -20,
  "itemsTotalWithVat": -24,
  "alreadyPaid": 0,
  "total": -20,
  "totalWithVat": -24,
  "toBePaid": -24,
  "status": "unpaid",
  "hasVat": true,
  "items": [
    {
      "id": 1,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "name": "Dobropisovaná konzultácia",
      "description": "Storno časti mesačného balíka",
      "unitPrice": -10,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "priceListItemId": 501,
      "total": -20,
      "totalWithVat": -24
    }
  ]
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Prehľad

Endpointy

Vytvoriť dobropis

Business pravidlá

Payload kontrakt

Autorizace

Hlavičky

Tělo

Odpověď