Přidat nebo upravit zakázku

Parametry, které nebudou zaslány, zůstanou v případě úpravy existující zakázky nezměněny.

POSThttps://app.mwork365.com/main/publicapi/order/addOrEdit

Upozornění

V případě úpravy existující zakázky musí být zakázka ve stavu Open a nesmí mít žádný aktivní výjezd (tzn. výjezd ve stavu Running nebo WaitingForSignature)
U existující zakázky dále není povolena změna zákazníka.

Tělo požadavku

idstring(GUID)

Nepovinné. ID zakázky.

externalIdstring

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

Poznámka

Pokud není zaslán ani jeden z identifikátorů (ID nebo Externí ID) dojde vždy k založení nové zakázky.

Pokud není vyplněno ID, použije se pro vyhledání existujícího záznamu pouze Externí ID. Pokud je vyplněno ID i Externí ID, musí existovat zakázka, která ma oba údaje shodné. Tzn. v případě existující zakázky není možné touto operací Externí ID změnit ani nastavit.

Pro změnu Externího ID existující zakázky použijte Editace zakázky.

customerIdstring/string(GUID)povinné

ID nebo Externí ID zákazníka (Customer)
Změna zákazníka u existující zakázky není povolena

addressIdstring/string(GUID)povinné

ID nebo Externí ID adresy zákazníka (CustomerAddress)
Adresa musí patřit zákazníkovi, kterému je zakázka plánována.

contactPersonIdstring/string(GUID)povinné

ID nebo Externí ID kontaktní osoby (ContactPerson)
Kontaktní osoba musí patřit zákazníkovi, kterému je zakázka plánována.

categoryIdstring/string(GUID)povinné

ID nebo Slug kategorie zakázky (OrderCategory)

invoiceCustomerIdstring/string(GUID)

ID nebo Externí ID objednatele

namestring

Název zakázky

estimatedDurationinteger

Odhadovaná doba trvání v minutách

problemDescriptionFromCustomerstring

Popis požadavku od zákazníka

internalNotestring

Interní poznámka k zakázce

customDatastring(JSON)

Dodatečná data k zakázce ve formátu JSON. Musí odpovídat šabloně.

priorityOrderPriority

Priorita zakázky (OrderPriority)
Výchozí hodnota: Normal

customStateIdstring

ID nebo Slug Vlastního stavu zakázky (OrderCustomState)

serviceObjectIdsstring[]/string(GUID)[]

ID nebo externí ID zařízení, kterých se zakázka týká. Zařízení musí patřit stejnému zákazníkovi, kterému je zakázka plánována. Adresa zařízení nemusí odpovídat.

ownerIdstring/string(GUID)

ID nebo Externí ID vlastníka. Pokud není určeno, je vlastníkem automaticky dispečer, který zakázku založil. V případě založení zakázky systémem (např. přes API, nebo automaticky pro pravidelný servis) je vlastníkem zakázky administrátor firmy.

requestedDatestring(DateTime)

Požadované datum

sendByPostboolean

Odeslat dokumenty poštou (pokud není nastaveno, přenáší se ze zákazníka)

useWorkItemsFromInvoiceCustomerboolean

Použít ceny práce podle objednatele.
Lze nastavit na true pouze pokud je nastaven Objednatel.

Odpověď

204 No Content

Zakázka byla úspěšně přidána, nebo upravena.

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/addOrEdit' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "externalId": "z123",
    "customerId": "1039a20b-4ce3-46db-b82c-845b7b3a1c9c",
    "addressId": "9210e180-06ab-4deb-85b4-14264e78bb66",
    "contactPersonId": "de500aba-3465-b884-e180-4f50c091a10a",
    "categoryId": "servis",
    "estimatedDuration": 90,
    "problemDescriptionFromCustomer": "Oprava plynového kotle",
    "priority": "High",
    "serviceObjectIds": [
        "9da646b2-5de7-4a47-b332-548cb7c95bcd",
        "98c2d22a-7862-4251-a7ef-7911f8faf20f"
    ]
}'