Přejít na hlavní obsah
PUT
Upraviť objednávku

Autorizace

Authorization
string
header
povinné

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

Parametry cesty

order
integer
povinné

ID objednávky.

Příklad:

501

Tělo

application/json

Úplné údaje objednávky. Vynechané hodnoty sa vyhodnotia ako pri vytvorení. Vynechanie quotationId odstráni väzbu na cenovú ponuku.

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 objednávky. Bez hodnoty sa vygeneruje z číselného radu. Nemožno kombinovať s numericalSeriesId.

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

"20260001"

quotationId
integer | null

ID cenovej ponuky, ktorá ešte nie je priradená alebo je naviazaná na práve upravovaný doklad. Vynechanie alebo null existujúcu väzbu odstráni.

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

Příklad:

12

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"

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

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ěď

Objednávka bola aktualizovaná.

Objednávka.

id
integer
Příklad:

501

uuid
string
Příklad:

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

type
string
Příklad:

"order"

number
string
Příklad:

"20260001"

webDokladUrl
string<uri>

Absolútna URL na verejný web doklad tejto objednávky.

Příklad:

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

pdfDownloadUrl
string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tejto objednávky ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/orders/501/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.

issueDate
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
enum<string> | null
Dostupné možnosti:
percentage,
fixed
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

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

hasVat
boolean
Příklad:

true

items
object[]