Před použitím tohoto endpointu dokončete průvodce Začínáme a získejte svůj API klíč a ID společnosti.
Předpoklady
- ✅ Platný Bearer token pro schváleného člena workspace
- ✅ ID společnosti získané z
GET {{URL}}/accounts/companies - ✅ ID objednávky (ID projektu,
pid) objednávky, kterou chcete aktualizovat
Endpoint
multipart/form-data — použijte i tehdy, když nejsou připojeny žádné soubory, aby byl uspokojen multipart parser serveru.
Hlavičky
Parametry dotazu
Pole těla požadavku
Nový stav objednávky. Musí být jedním z:
Pending, Ongoing, Review, Completed, Cancelled.Povolené přechody:Reviewmůže následovat pouze poOngoingnebo dalšímReview. Přechod přímo zPendingnaReviewvrátí chybu400 ValidationError.- Objednávky ve stavu
CompletedneboCancellednelze aktualizovat. - Klienti nemohou zrušit objednávku, která postoupila za stav
Pending.
Celková výše rozpočtu. Musí být
≥ 0. Používá stávající měnu objednávky, pokud není zároveň zadána i currency.Řetězec data ve formátu ISO 8601 pro datum splatnosti objednávky. Příklad:
"2025-12-31T00:00:00.000Z".Úplný seznam ID členů projektových manažerů přiřazených k této objednávce. Nová ID jsou přidána do týmu; odebraná ID jsou smazána. Každé ID musí patřit členovi s rolí
projectManager ve stejné společnosti.Povinné když je
status Completed nebo Cancelled. Pokud je true, všechny úkoly v objednávce jsou po změně stavu označeny jako dokončené. Pokud je false, úkoly zůstanou ve svém aktuálním stavu.Povoleno pouze když je
status Completed nebo Cancelled. Pokud je true, všechny nevyřešené úkoly vyžádané klientem jsou po aktualizaci stavu zamítnuty.Vyžadováno pouze pro objednávky předplatného při změně frekvence opakování. Párujte s
repeatDuration.Vyžadováno spolu s
repeatCount pro objednávky předplatného. Jedna z hodnot: day, week, month, year.Nula nebo více příloh souborů. Soubory jsou připojeny do systémové složky objednávky; stávající soubory nejsou nikdy přepsány. Použijte kódování
multipart/form-data a každý soubor připojte pod pole files.Ukázkový požadavek
Odpovědi
Odpověď při úspěchu
Obchodní pravidla a vedlejší efekty
- Přechody stavů jsou omezeny.
Reviewmůže následovat pouze poOngoingnebo dalšímReview. Pokus o přechodPending → Reviewvrátí chybu400 ValidationError. - Přechod stavu z
PendingnaOngoing,ReviewneboCompletedaktivuje složku souborů objednávky, takže nahrané soubory budou přístupné projektovému týmu. - Nastavení
statusnaCompletedneboCancelledvyžaduje explicitní nastavenímarkTasksAsDonenatruenebofalse. - Změny stavu na
Review,CompletedneboCancelledautomaticky spustí oznámení klientovi:- Review — upozorní klienta, že je potřeba kontrola.
- Completed — odešle klientovi oznámení
orderCompletion. - Cancelled — odešle klientovi oznámení
orderCancellation.
- Každá úspěšná aktualizace spustí webhook událost
ORDER.UPDATEDs aktualizovaným dokumentem objednávky a metadaty příloh, pokud máte aktivní webhook přihlášený k odběru této události.

