Dobropisy

Vytvoriť dobropis z faktúry

Vytvorí dobropis priamo zo zvolenej faktúry.

Kedy použiť tento endpoint

Tento endpoint je DX shortcut pre bežný full-credit flow, keď už máte invoiceId a nechcete skladať celý payload ručne. Nenahrádza kanonický POST /credit-notes; ten je stále určený pre explicitný create flow s plným payloadom.

Čo backend preberie zo zdrojovej faktúry

klienta vždy odvodí zo zvolenej faktúry,
prekopíruje položky ako záporné kreditné riadky vrátane skladových alokácií,
zachová bankový účet, menu, jazyk, spôsob úhrady, prenesenú daňovú povinnosť a document-level zľavu,
zachová note, textAboveItems, constantSymbol a specificSymbol, pokiaľ ich explicitne neoverride-nete tam, kde je to povolené.

Defaulty a override polia

issueDate defaultuje na dnešný dátum.
dueDate defaultuje na finálny issueDate.
deliveryDate defaultuje na finálny issueDate.
Ak nepošlete number, backend vygeneruje číslo z primárneho číselného radu dobropisov. Ak pošlete numericalSeriesId bez number, číslo sa vygeneruje z tohto radu.
variableSymbol sa dopočíta server-side z finálneho čísla dobropisu.
Povolené overrides sú len polia definované v request schéme nižšie.

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

POST

invoices

{invoice}

credit-notes

Vytvoriť dobropis z faktúry

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/invoices/{invoice}/credit-notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "20260051",
  "numericalSeriesId": 12,
  "issueDate": "2026-03-05",
  "dueDate": "2026-03-19",
  "deliveryDate": "2026-03-04",
  "note": "Dobropis k čiastočnému storno plnenia.",
  "textAboveItems": "Dobropisujeme pôvodné plnenie v plnom rozsahu."
}
'

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

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"

Parametry cesty

invoice

integer

povinné

ID faktúry.

Příklad:

301

Tělo

application/json

Voliteľný override payload pre shortcut endpoint POST /invoices/{invoice}/credit-notes. Všetky ostatné business polia dobropisu sa odvodia na serveri zo zdrojovej faktúry. Nepodporuje položky, klienta ani bankový účet v requeste.

number

string

Manuálne číslo dobropisu. Ak ho nepošlete, backend použije číslo z primárneho číselného radu dobropisov, resp. z radu určeného cez numericalSeriesId. Ak pošlete number, nepošlite zároveň numericalSeriesId.

Required string length: 1 - 20

Příklad:

"20260051"

numericalSeriesId

integer | null

ID číselného radu dobropisov. Ak ho pošlete bez number, backend z neho vygeneruje finálne číslo dobropisu. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

issueDate

string<date>

Voliteľný dátum vystavenia vo formáte Y-m-d. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-05"

dueDate

string<date>

Voliteľný dátum splatnosti vo formáte Y-m-d. Ak ho nepošlete, použije sa finálny issueDate. Ak ho pošlete, musí byť väčší alebo rovný finálnemu issueDate.

Příklad:

"2026-03-19"

deliveryDate

string<date>

Voliteľný dátum dodania vo formáte Y-m-d. Ak ho nepošlete, použije sa finálny issueDate. Ak ho pošlete, musí byť menší alebo rovný finálnemu issueDate.

Příklad:

"2026-03-04"

note

string | null

Voliteľný override poznámky. Ak pole nepošlete, použije sa note zo zdrojovej faktúry. Ak pošlete null, poznámka sa vynuluje.

Maximum string length: 3000

Příklad:

"Dobropis k čiastočnému storno plnenia."

textAboveItems

string | null

Voliteľný override textu nad položkami. Ak pole nepošlete, použije sa textAboveItems zo zdrojovej faktúry. Ak pošlete null, text sa vynuluje.

Maximum string length: 3000

Příklad:

"Dobropisujeme pôvodné plnenie v plnom rozsahu."

Odpověď

Dobropis bol vytvorený zo zvolenej faktúry.

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

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í

Zoznam dobropisovVráti paginovaný zoznam dobropisov v zjednodušenom preview tvare. Endpoint je vhodný na listy, synchronizáciu a rýchly prehľad nad stavom dobropisov; pre detail použite detail endpoint dobropisu.

Další

Vytvoriť dobropis z faktúry

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/invoices/{invoice}/credit-notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "20260051",
  "numericalSeriesId": 12,
  "issueDate": "2026-03-05",
  "dueDate": "2026-03-19",
  "deliveryDate": "2026-03-04",
  "note": "Dobropis k čiastočnému storno plnenia.",
  "textAboveItems": "Dobropisujeme pôvodné plnenie v plnom rozsahu."
}
'

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