Přidat nebo upravit zakázku

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

Tělo požadavku

idstring(GUID)

Nepovinné. ID zakázky. Pokud zakázka s tímto ID neexistuje, založí se nová s tímto ID.

externalIdstring

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

Zakázka se vyhledá podle ID, pokud je zasláno, jinak podle Externího ID. Pokud se nenajde, založí se nová.

Zasláno	Zakázka existuje	Zakázka neexistuje
ani jedno	—	založí se s novým ID
jen ID	upraví se	založí se s tímto ID
jen Externí ID	upraví se	založí se s tímto Externím ID
ID i Externí ID	upraví se, Externí ID se jí nastaví na zaslanou hodnotu	založí se s oběma

Externí ID musí být unikátní — pokud ho už má jiná zakázka, API vrátí 400. Totéž platí pro ID při zakládání: pokud ho má jiná, například smazaná zakázka, API vrátí 400.

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)

ID nebo Externí ID adresy zákazníka (CustomerAddress)
Adresa musí patřit zákazníkovi, kterému je zakázka plánována.
Pokud není zasláno, použije se při založení zakázky první adresa zákazníka (pokud zákazník žádnou nemá, API vrátí 400).

contactPersonIdstring/string(GUID)

ID nebo Externí ID kontaktní osoby (ContactPerson)
Kontaktní osoba musí patřit zákazníkovi, kterému je zakázka plánována.
Pokud není zasláno, použije se při založení zakázky první kontaktní osoba zákazníka (pokud zákazník žádnou nemá, API vrátí 400).

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
Výchozí hodnota: výchozí délka výjezdu nastavená ve firmě

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: Low

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.
Při založení zakázky musí všechna zaslaná zařízení existovat (jinak API vrátí 404), při úpravě se neznámá zařízení ignorují. Zařízení, ke kterému už na zakázce existuje formulář, nelze odebrat (API vrátí 400).

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ěď

200 OK

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

Response Body: OrderDetail

403 Forbidden

Upravovaná zakázka není ve stavu Open nebo má aktivní výjezd.

404 Not Found

Neexistuje některý z odkazovaných záznamů (zákazník, kategorie, adresa, zařízení a podobně).

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