Editace zakázky

Zobrazit zdroj

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

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

Parametry

idstring(GUID)povinné

ID zakázky

nebo

externalIdstringpovinné

Externí ID zakázky

Tělo požadavku

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 upravena

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/1039a20b-4ce3-46db-b82c-845b7b3a1c9c' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "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"
    ]
}'