Zrušení zakázky

PUThttps://app.mwork365.com/main/publicapi/order/{id}/cancel

PUThttps://app.mwork365.com/main/publicapi/order/externalId/{externalId}/cancel

Poznámka

Zrušit lze pouze zakázku, která je ve stavu Otevřená nebo Dokončená.

Všechny výjezdy v zakázce, které nejsou ve stavu Dokončený nebo Zrušený, budou označené jako zrušené (a bude k nim propsán důvod zrušení).

Parametry

idstring(GUID)povinné

ID zakázky

nebo

externalIdstringpovinné

Externí ID zakázky

Tělo požadavku

sendNotificationToCustomerboolean

V případě true se pro každý výjezd, zrušený spolu se zakázkou, odešle notifikace zákazníkovi s informací o zrušení výjezdu.
Notifikace odchází kontaktní osobě na zakázce (pokud to má povolené) a dále na e-mailové adresy pro notifikace, které jsou nastavené na zákazníkovi.
Notifikace se dále řídí nastavením notifikací v systému (mohou být např. globálně vypnuté notifikace pomocí SMS nebo e-mailu)

reasonstring

Důvod zrušení zakázky. Volitelný text který se zobrazí na detailu zakázky (a výjezdech, které byly zrušeny spolu se zakázkou)

Odpověď

204 No Content

Zakázka byla zrušena

400, 401, atd.

Více informací na stránce standardní chybové stavy.

Příklad

curl --location --request PUT 'https://app.mwork365.com/main/publicapi/order/3d6ecf6b-6755-44f1-a7ff-93982ec7bb1b/cancel' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "reason": "Dle telefonické dohody se zákazníkem, který si to rozmyslel.",
    "sendNotificationToCustomer": false
}'