---
title: "Naplánování výjezdu"
description: "Naplánuje nový výjezd do zakázky."
url: /cs/api-reference/legacy/vyjezdy/naplanovani-vyjezdu/
---

<Endpoint method="POST" path="/order/{orderId}/PlanIntervention" />

<Endpoint method="POST" path="/order/externalId/{orderExternalId}/PlanIntervention" />

:::note
Výjezd lze naplánovat pouze do zakázky ve stavu `Otevřená`.
:::

### Parametry
<Param name="orderId" type="string(GUID)" required>
ID zakázky
</Param>

nebo

<Param name="orderExternalId" type="string" required>
Externí ID zakázky
</Param>

### Tělo požadavku
<Param name="externalId" type="string">
Nepovinné. Unikátní identifikátor záznamu
</Param>

<Param name="primaryAssigneeId" type="string/string(GUID)" required>
ID nebo Externí ID hlavního technika ([User](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#user))
</Param>

<Param name="day" type="string(Date)" required>
Datum výjezdu
</Param>

<Param name="assignations" type="InterventionAssignation[]" required>
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).

:::caution
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
:::
</Param>

<Param name="categoryId" type="string/string(GUID)" required>
ID nebo Slug kategorie výjezdu ([InterventionCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#interventioncategory))
</Param>

<Param name="customStateId" type="string/string(GUID)">
ID nebo Slug Vlastního stavu výjezdu ([InterventionCustomState](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#interventioncustomstate))
</Param>

<Param name="priority" type="InterventionPriority">
Priorita výjezdu ([InterventionPriority](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#interventionpriority))\
Pokud není vyplněno, přebírá se priorita ze zakázky.
</Param>

<Param name="internalNote" type="string">
Interní poznámka k výjezdu
</Param>

<Param name="sendNotificationNow" type="boolean">
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)
</Param>

<Param name="sendReminderOneDayBefore" type="boolean">
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í).
</Param>

### Odpověď
<Status code="200 OK">
Výjezd byl naplánován\
Response Body: [InterventionDetail](/cs/api-reference/legacy/obecne-informace/datovy-model/zakazky-a-vyjezdy/#interventiondetail)
</Status>

<Status code="400, 401, atd.">
Více informací na stránce [standardní chybové stavy](/cs/api-reference/legacy/obecne-informace/standardni-chybove-stavy/).
</Status>

### Příklad

```bash
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"
        }
    ]
}'
```