Přejít na hlavní obsah
PUT
Upraviť zálohovú faktúru

Autorizace

Authorization
string
header
povinné

API token firmy vytvorený vo Fintoro v Automatizácie → Fintoro API. Správa tokenov.

Parametry cesty

proforma
integer
povinné

ID zálohovej faktúry.

Příklad:

401

Tělo

application/json

Úplné údaje zálohovej faktúry. Vynechané hodnoty sa vyhodnotia ako pri vytvorení.

clientId
integer | null
povinné

ID existujúceho klienta firmy. Súčasne zadaný objekt client mení iba údaje klienta na tomto doklade.

Příklad:

101

items
object[]
povinné

Položky dokladu.

Required array length: 1 - 100 elements

S priceListItemId sa názov, jednotka, cena a DPH doplnia z cenníka; zaslané hodnoty ich prepíšu. Bez ID pošlite ručnú položku s názvom, množstvom, cenou a DPH. uuid sa ignoruje a warehouseAllocations sa nepodporujú.

number
string | null

Manuálne číslo zálohovej faktúry. Bez hodnoty sa vygeneruje z číselného radu. Nemožno kombinovať s numericalSeriesId.

Required string length: 1 - 20
Příklad:

"20260001"

orderId
integer | null

ID objednávky, ktorá ešte nie je priradená alebo je naviazaná na práve upravovaný doklad.

Příklad:

501

quotationId
integer | null

ID cenovej ponuky, ktorá ešte nie je priradená alebo je naviazaná na práve upravovaný doklad.

Příklad:

601

client
object | null

Údaje na vyhľadanie alebo vytvorenie klienta; s clientId menia iba údaje na doklade.

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

Příklad:

12

bankAccountId
integer

Bankový účet firmy. Bez hodnoty sa použije primárny účet; ak neexistuje, API vráti 422 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 požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

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

14

variableSymbol
integer

Variabilný symbol s 1 až 10 číslicami. Bez hodnoty sa odvodí z čísla dokladu.

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 požiadavka → 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 požiadavka → 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 požiadavka → 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 požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

currencyId
integer

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

Příklad:

1

languageId
integer

ID jazyka z referenčnej tabuľky jazykov. Priorita je požiadavka → 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 požiadavka → 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 požiadavka → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000
Příklad:

"Dakujeme za spoluprácu."

Odpověď

Zálohová faktúra bola aktualizovaná.

Zálohová faktúra.

id
integer
Příklad:

401

uuid
string
Příklad:

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

type
string
Příklad:

"proforma"

number
string
Příklad:

"20260001"

webDokladUrl
string<uri>

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

Příklad:

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

pdfDownloadUrl
string<uri>

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

Příklad:

"https://app.fintoro.sk/api/public/v1/proformas/401/pdf"

company
object

Údaje dodávateľa uložené priamo na tomto doklade.

clientId
integer | null

ID klienta. Po jeho zmazaní je null; údaje klienta uložené na doklade zostanú zachované.

Příklad:

101

client
object

Údaje klienta uložené na doklade. Jeho ID je samostatne v clientId.

bankAccount
object

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

payments
object[]

Úhrady naviazané na túto zálohovú 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"

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

1

paymentMethodId
integer
Příklad:

1

currencyId
integer
Příklad:

1

languageId
integer
Příklad:

1

qrTypeId
integer
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

alreadyPaid
number<float>
Příklad:

0

total
number<float>
Příklad:

200

totalWithVat
number<float>
Příklad:

240

toBePaid
number<float>
Příklad:

240

willBePaid
boolean
Příklad:

true

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