Přeplánování výjezdu

Přeplánováním lze změnit termín výjezdu, alokaci techniků i kategorii výjezdu.

PUThttps://app.mwork365.com/main/publicapi/order/{orderId}/intervention/{interventionId}/Replan

PUThttps://app.mwork365.com/main/publicapi/order/externalId/{orderExternalId}/intervention/{interventionExternalId}/Replan

Poznámka

Přeplánovat lze pouze výjezd ve stavu Naplánovaný, který je v zakázce ve stavu Otevřená.

Parametry

orderIdstring(GUID)povinné

ID zakázky

interventionIdstring(GUID)povinné

ID výjezdu

nebo

orderExternalIdstringpovinné

Externí ID zakázky

interventionExternalIdstringpovinné

Externí ID výjezdu

Tělo požadavku

categoryIdstring/string(GUID)povinné

ID nebo Slug kategorie výjezdu (InterventionCategory)

primaryAssigneeIdstring/string(GUID)povinné

ID nebo Externí ID hlavního technika (User)

daystring(Date)povinné

Nové datum výjezdu

assignationsInterventionAssignation[]povinné

Technici alokovaní na výjezd včetně časového rozpětí. Musí být uveden alespoň jeden (hlavní) technik.
Původní alokace jsou nahrazeny těmi, které jsou uvedeny v požadavku.

Response Body: objekt s poli userId (string/string(GUID) - ID nebo Externí ID technika), plannedStart (string(DateTime) - naplánovaný začátek) a plannedEnd (string(DateTime) - naplánovaný konec).

Upozornění

Pro techniky platí následující pravidla:

• Hlavní technik i všichni alokovaní technici musí mít roli Technik a nesmí být deaktivovaní
• Každý technik může mít na jednom výjezdu pouze jednu alokaci
• plannedStart i plannedEnd musí spadat do dne day a plannedStart musí být dříve než plannedEnd
• Pokud má firma zapnuté nastavení Zakázat kolize, nelze technika alokovat na čas, ve kterém již je alokovaný na jiném výjezdu

customStateIdstring/string(GUID)

ID nebo Slug Vlastního stavu výjezdu (InterventionCustomState)
Není potřeba posílat, pokud hodnotu neměníte. Hodnotou null lze hodnotu vymazat.

externalIdstring

Unikátní identifikátor záznamu

priorityInterventionPriority

Priorita výjezdu (InterventionPriority)

internalNotestring

Interní poznámka k výjezdu

sendNotificationNowboolean

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

sendReminderOneDayBeforeboolean

V případě true se zákazníkovi odešle připomínka den před výjezdem.
Připomínka se neodesílá, pokud je výjezd plánován na dnešní nebo zítřejší den (v takovém případě odchází pouze notifikace o naplánování).

Odpověď

200 OK

Výjezd byl přeplánován
Response Body: InterventionDetail

400, 401, atd.

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

Příklad

curl -L -X PUT 'https://app.mwork365.com/main/publicapi/order/3d6ecf6b-6755-44f1-a7ff-93982ec7bb1b/intervention/fdf9f792-7657-4abe-8385-171efc7a6017/Replan' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "categoryId": "servis",
    "primaryAssigneeId": "9210e180-06ab-4deb-85b4-14264e78bb66",
    "day": "2025-09-18",
    "sendNotificationNow": true,
    "assignations": [
        {
            "userId": "9210e180-06ab-4deb-85b4-14264e78bb66",
            "plannedStart": "2025-09-18T12:00:00Z",
            "plannedEnd": "2025-09-18T15:00:00Z"
        }
    ]
}'