Naplánování výjezdu

Zobrazit zdroj

POSThttps://app.mwork365.com/main/publicapi/order/{orderId}/PlanIntervention

POSThttps://app.mwork365.com/main/publicapi/order/externalId/{orderExternalId}/PlanIntervention

Parametry

orderIdstring(GUID)povinné

ID zakázky

nebo

orderExternalIdstringpovinné

Externí ID zakázky

Tělo požadavku

externalIdstring

Nepovinné. Unikátní identifikátor záznamu

primaryAssigneeIdstring/string(GUID)povinné

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

daystring(Date)povinné

Datum výjezdu

assignationsInterventionAssignation[]povinné

Technici alokovaní na výjezd včetně časového rozpětí. Musí být uveden alespoň jeden (hlavní) technik.

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).

categoryIdstring/string(GUID)povinné

ID nebo Slug kategorie výjezdu (InterventionCategory)

customStateIdstring/string(GUID)

ID nebo Slug Vlastního stavu výjezdu (InterventionCustomState)

priorityInterventionPriority

Priorita výjezdu (InterventionPriority)
Pokud není vyplněno, přebírá se priorita ze zakázky.

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 naplánován
Response Body: InterventionDetail

400, 401, atd.

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

Příklad

curl -L -X POST 'https://app.mwork365.com/main/publicapi/order/3d6ecf6b-6755-44f1-a7ff-93982ec7bb1b/PlanIntervention' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "categoryId": "servis",
    "primaryAssigneeId": "9210e180-06ab-4deb-85b4-14264e78bb66",
    "day": "2025-09-15",
    "priority": "High",
    "internalNote": "Zákazník bude na místě až od 9:00",
    "sendNotificationNow": true,
    "sendReminderOneDayBefore": true,
    "assignations": [
        {
            "userId": "9210e180-06ab-4deb-85b4-14264e78bb66",
            "plannedStart": "2025-09-15T07:00:00Z",
            "plannedEnd": "2025-09-15T11:00:00Z"
        }
    ]
}'