Přejít na hlavní obsah
PUT
/
invoices
/
{invoice}
Upraviť faktúru
curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/invoices/{invoice} \
  --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",
      "warehouseAllocations": [
        {
          "warehouseId": 1,
          "quantity": 2
        }
      ],
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
    }
  ],
  "number": "20260001",
  "proformaId": 401,
  "orderId": 501,
  "quotationId": 601,
  "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,
  "bankAccountId": 201,
  "issueDate": "2026-03-03",
  "dueDateDays": 14,
  "deliveryDate": "2026-03-03",
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu."
}
'
{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/fa/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/invoices/123/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
      }
    }
  ],
  "variableSymbol": 20260001,
  "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,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    {
      "id": 1,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "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,
      "priceListItemId": 501,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Parametry cesty

​
invoice
integer
povinné

ID faktúry.

Příklad:

301

Tělo

application/json

Payload pre aktualizáciu faktúry. Update používa rovnaké polia, rovnaké validačné pravidlá a rovnaké defaulty ako create flow. Musíte poslať buď clientId, alebo objekt client. Omitted polia sa nedoťahujú z aktuálnej faktúry; backend ich vyrieši rovnako ako pri create flowe. Jediný rozdiel oproti create je, že pri položkách môžete navyše posielať pôvodné uuid existujúcich riadkov faktúry; create flow ich ignoruje.

​
clientId
integer | null
povinné

ID existujúceho klienta. Toto je odporúčaný spôsob tvorby faktúry. 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 faktúry. Toto pole je pri update povinné vždy. Ak pri existujúcej položke pošlete jej pôvodné uuid z detailu faktúry, backend vie zachovať väzby na skladové výdajky a synchronizovať zmenené alokácie na tom istom riadku.

Required array length: 1 - 100 elements

Payload jednej položky faktúry pri update. Pravidlá sú rovnaké ako pri create, ale navyše môžete poslať pôvodné uuid existujúceho riadku faktúry. Toto UUID máte k dispozícii v detaile faktúry. Backend ho používa pri synchronizácii skladových alokácií a výdajok, aby vedel spárovať upravovaný riadok s pôvodným riadkom dokladu. Pri create flowe uuid nie je súčasťou item request kontraktu; ak ho pošlete, backend ho ignoruje.

​
number
string | null

Manuálne číslo faktúry. 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"

​
proformaId
integer | null

Voliteľné ID zálohovej faktúry, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

401

​
orderId
integer | null

Voliteľné ID objednávky, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

501

​
quotationId
integer | null

Voliteľné ID cenovej ponuky, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

601

​
client
object

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í.

​
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 faktúry. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

​
bankAccountId
integer

ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, použije sa primárny bankový účet firmy. Ak firma nemá nastavený žiadny primárny bankový účet, endpoint vráti 422 validačnú chybu s chybou pri bankAccountId.

Příklad:

201

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

​
dueDateDays
integer

Počet dní splatnosti. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Požadovaný rozsah: 0 <= x <= 1000
Příklad:

14

​
deliveryDate
string<date>

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

Příklad:

"2026-03-03"

​
variableSymbol
integer

Variabilný symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic. Ak ho nepošlete, backend ho odvodí z finálneho čísla faktúry.

Požadovaný rozsah: 0 <= x <= 9999999999
Příklad:

20260001

​
constantSymbol
integer | null

Konštantný symbol. Povolené sú hodnoty s dĺžkou 1 až 4 číslic. Priorita je payload → klientská predvolená hodnota → null.

Požadovaný rozsah: 0 <= x <= 9999
Příklad:

308

​
specificSymbol
integer | null

Špecifický symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic. Priorita je payload → klientská predvolená hodnota → null.

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.

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

​
deliveryMethodId
integer

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

​
paymentMethodId
integer

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

​
currencyId
integer

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

Příklad:

1

​
currencyRate
number<float>

Kurz meny k EUR. Ak ho nepošlete, backend ho vyrieši server-side podľa currencyId a deliveryDate. Ak je finálna mena dokladu EUR, backend vždy uloží a vráti 1.0.

Požadovaný rozsah: 0.00001 <= x <= 10000000
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

​
qrTypeId
integer

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, použije sa 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:

"Ďakujeme za objednávku."

​
textAboveItems
string | null

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

Maximum string length: 3000
Příklad:

"Dakujeme za spoluprácu."

Odpověď

Faktúra bola aktualizovaná.

Faktúra.

​
id
integer
Příklad:

301

​
uuid
string
Příklad:

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

​
type
string
Příklad:

"invoice"

​
number
string
Příklad:

"20260001"

​
webDokladUrl
string<uri>

Absolútna URL na verejný web doklad tejto faktúry.

Příklad:

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

​
pdfDownloadUrl
string<uri>

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

Příklad:

"https://app.fintoro.sk/api/public/v1/invoices/123/pdf"

​
company
object

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

​
clientId
integer

Live ID klienta naviazaného na faktúru.

Příklad:

101

​
client
object

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

​
bankAccount
object

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

​
payments
object[]

Úhrady naviazané na túto faktúru v poradí od najnovšej.

​
variableSymbol
integer
Příklad:

20260001

​
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>
Příklad:

"2026-03-03"

​
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
string | null
Příklad:

"percentage"

​
discountValue
number<float> | null
Příklad:

10

​
transferTaxLiability
boolean
Příklad:

false

​
numericalSeriesId
integer | null
Příklad:

12

​
deliveryMethodId
integer

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

Příklad:

1

​
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

​
qrTypeId
integer

ID QR typu z referenčnej tabuľky QR typov.

Příklad:

1

​
note
string | null
Příklad:

"Ďakujeme za objednávku."

​
textAboveItems
string | null
Příklad:

"Dakujeme za spoluprácu."

​
itemsTotal
number<float>
Příklad:

200

​
itemsTotalWithVat
number<float>
Příklad:

240

​
total
number<float>
Příklad:

200

​
totalWithVat
number<float>
Příklad:

240

​
toBePaid
number<float>
Příklad:

240

​
status
string
Příklad:

"unpaid"

​
hasVat
boolean
Příklad:

true

​
creditNotesSumTotalWithVat
number<float>
Příklad:

0

​
items
object[]