Přejít na hlavní obsah
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",
    "logo": "https://cdn.fintoro.sk/company/logo.svg",
    "signature": "https://cdn.fintoro.sk/company/signature.png",
    "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.

​
id
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.

​
clientId
integer

Live ID klienta naviazaného na dobropis.

Příklad:

101

​
client
object

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

​
bankAccount
object

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

​
payments
object[]

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

​
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[]