---
title: "Zákazníci a zařízení"
description: "Datové typy zákazníka, jeho adres, kontaktních osob, zařízení a uživatelů."
url: /cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/
---

## Customer

Základní informace o zákazníkovi

<Param name="id" type="string(GUID)">
</Param>

<Param name="externalId" type="string">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="name" type="string">
</Param>

<Param name="kind" type="CustomerKind">
Druh zákazníka ([CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))
</Param>

<Param name="identificationNumber" type="string">
IČ
</Param>

<Param name="taxNumber" type="string">
DIČ
</Param>

<Param name="categoryId" type="string(GUID)">
ID Kategorie zákazníka ([CustomerCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customercategory))
</Param>

<Param name="categoryName" type="string">
Název kategorie zákazníka ([CustomerCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customercategory))
</Param>

<Param name="typeId" type="string(GUID)">
ID Typu zákazníka ([CustomerType](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customertype))
</Param>

<Param name="typeName" type="string">
Název typu zákazníka ([CustomerType](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customertype))
</Param>

<Param name="ownerId" type="string(GUID)">
ID vlastníka ([User](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#user)). Vlastník je automaticky dispečer, který zákazníka založil. V případě založení zákazníka systémem (např. přes API) je vlastníkem zákazníka administrátor firmy.\
Vlastník zákazníka jde změnit.
</Param>

<Param name="ownerName" type="string">
Jméno vlastníka ([User](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#user)). Vlastník je automaticky dispečer, který zákazníka založil. V případě založení zákazníka systémem (např. přes API) je vlastníkem zákazníka administrátor firmy.\
Vlastník zákazníka jde změnit.
</Param>

<Param name="invoiceAddressId" type="string(GUID)">
ID Fakturační adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="invoiceAddress" type="CustomerAddress">
Fakturační adresa zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="contactAddressId" type="string(GUID)">
ID Kontaktní adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="contactAddress" type="CustomerAddress">
Kontaktní adresa zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="primaryContactPersonId" type="string(GUID)">
ID primární kontaktní osoby ([ContactPerson](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#contactperson))
</Param>

<Param name="primaryContactPerson" type="ContactPerson">
Primární kontaktní osoba ([ContactPerson](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#contactperson))
</Param>

## CustomerDetail

Detailní informace o zákazníkovi včetně navázaných dat​

<Param name="id" type="string(GUID)">
</Param>

<Param name="externalId" type="string">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="name" type="string">
</Param>

<Param name="kind" type="CustomerKind">
Druh zákazníka ([CustomerKind](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customerkind))
</Param>

<Param name="identificationNumber" type="string">
IČ
</Param>

<Param name="taxNumber" type="string">
DIČ
</Param>

<Param name="categoryId" type="string(GUID)">
ID Kategorie zákazníka ([CustomerCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customercategory))
</Param>

<Param name="categoryName" type="string">
Název kategorie zákazníka ([CustomerCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customercategory))
</Param>

<Param name="typeId" type="string(GUID)">
ID Typu zákazníka ([CustomerType](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customertype))
</Param>

<Param name="typeName" type="string">
Název typu zákazníka ([CustomerType](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#customertype))
</Param>

<Param name="ownerId" type="string(GUID)">
ID vlastníka ([User](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#user)). Vlastník je automaticky dispečer, který zákazníka založil. V případě založení zákazníka systémem (např. přes API) je vlastníkem zákazníka administrátor firmy.\
Vlastník zákazníka jde změnit.
</Param>

<Param name="ownerName" type="string">
Jméno vlastníka ([User](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#user)). Vlastník je automaticky dispečer, který zákazníka založil. V případě založení zákazníka systémem (např. přes API) je vlastníkem zákazníka administrátor firmy.\
Vlastník zákazníka jde změnit.
</Param>

<Param name="invoiceAddressId" type="string(GUID)">
ID Fakturační adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="contactAddressId" type="string(GUID)">
ID Kontaktní adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="addresses" type="CustomerAddress[]">
Adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="primaryContactPersonId" type="string(GUID)">
ID primární kontaktní osoby ([ContactPerson](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#contactperson))
</Param>

<Param name="primaryContactPerson" type="ContactPerson">
Primární kontaktní osoba ([ContactPerson](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#contactperson))
</Param>

<Param name="contactPeople" type="ContactPerson[]">
Kontaktní osoby zákazníka ([ContactPerson](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#contactperson))
</Param>

<Param name="website" type="string">
Webová stránka
</Param>

<Param name="description" type="string">
Poznámka
</Param>

<Param name="reportEmails" type="string[]">
E-maily pro zasílání dokumentů (všechny kategorie zakázek)
</Param>

<Param name="orderCategoryReportEmails" type="CustomerOrderCategoryReportEmails[]">
E-maily pro zasílání dokumentů pro jednotlivé kategorie zakázek (CustomerOrderCategoryReportEmails)
</Param>

<Param name="nextRevisionEmails" type="string[]">
Emaily pro zasílání upozornění na blížící se revize
</Param>

<Param name="orders" type="OrderInCustomer[]">
Zakázky zákazníka (OrderInCustomer)

:::caution
V budoucích verzích API nebude dostupné. Použijte [Seznam zakázek](/cs/api-reference/legacy/zakazky/seznam-zakazek/) v kombinaci s filtrem `CustomerId`
:::
</Param>

<Param name="serviceObjects" type="ServiceObjectInCustomer[]">
Zařízení zákazníka (ServiceObjectInCustomer)

:::caution
V budoucích verzích API nebude dostupné. Použijte [Seznam zařízení](/cs/api-reference/legacy/zarizeni/seznam-zarizeni/) v kombinaci s filtrem `CustomerId`
:::
</Param>

<Param name="workItems" type="CustomerWorkItem[]">
Ceník práce pro zákazníka (CustomerWorkItem)
</Param>

<Param name="customData" type="string(JSON)">
Dodatečná data k zákazníkovi ve formátu JSON
</Param>

## CustomerAddress

Adresa zákazníka

<Param name="id" type="string(GUID)">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="name" type="string">
Název adresy
</Param>

<Param name="street" type="string">
Ulice a ČP
</Param>

<Param name="city" type="string">
Město
</Param>

<Param name="postalCode" type="string">
PSČ
</Param>

<Param name="country" type="string">
</Param>

<Param name="coordinates" type="GeoCoordinate">
Zeměpisné souřdnice ([GeoCoordinate](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#geocoordinate))
</Param>

<Param name="hasFlatRateTravelFee" type="boolean">
Určuje zda se na tuto adresu vztahuje paušální cestovné. Pokud ano, cena cestovného se určí buď paušálem z nastavení firmy, nebo (pokud je vyplněno) paušálem nastaveným na adrese v poli `travelFee`
</Param>

<Param name="travelFee" type="decimal">
Paušální cestovné pro tuto adresu. \
Pokud je vyplněno, musí být kladné číslo. Pokud vyplněno není, použije se paušální cestovné z nastavení firmy.\
Pro použití paušálního cestovného musí být příznak `hasFlatRateTravelFee` nastaven na `true`
</Param>

<Param name="pricePerKilometer" type="decimal">
Cena za kilometr pro zakázky s touto adresou

:::note
pricePerKilometer na adrese je plánovaná funkce, ve výpočtech cestovného se momentálně nepoužívá
:::
</Param>

<Param name="description" type="string">
Poznámky
</Param>

## ContactPerson

Kontaktní osoba zákazníka

<Param name="id" type="string(GUID)">
</Param>

<Param name="externalId" type="string">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="firstName" type="string">
Křestní jméno kontaktní osoby
</Param>

<Param name="lastName" type="string">
Příjmení kontaktní osoby
</Param>

<Param name="position" type="string">
Pracovní pozice kontaktní osoby
</Param>

<Param name="phone" type="PhoneNumber">
Telefonní číslo kontaktní osoby ([PhoneNumber](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#phonenumber))
</Param>

<Param name="email" type="string(Email)">
Emailová adresa kontaktní osoby
</Param>

<Param name="description" type="string">
Poznámky
</Param>

<Param name="sendNotifications" type="boolean">
Určuje zda se kontaktní osobě mají odesílat notifikace o zakázkách, ke kterým je tato kontaktní osoba přiřazena (např. potvrzení o naplánování výjezdu).\
Odesílá se dle nastavení firmy e-mailem i zprávou SMS v případě, že jsou vyplněny odpovídající kontaktní údaje.
</Param>

<Param name="sendReports" type="boolean">
Určuje, zda se kontaktní osobě mají odesílat e-maily s dokumenty ze zakázek, ke kterým je tato kontaktní osoba přiřazena (musí být zároveň vyplněna e-mailová adresa)
</Param>

<Param name="addressId" type="string/string(GUID)">
ID nebo externí ID adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))\
Adresa musí patřit zákazníkovi, kterému je kontaktní osoba přidávána.
</Param>

## ServiceObject

Zařízení zákazníka

<Param name="id" type="string(GUID)">
</Param>

<Param name="externalId" type="string">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="name" type="string">
Název zařízení
</Param>

<Param name="customerId" type="string(GUID)">
ID zákazníka ([Customer](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customer))
</Param>

<Param name="customerName" type="string">
Jméno zákazníka ([Customer](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customer))
</Param>

<Param name="categoryId" type="string(GUID)">
ID kategorie zařízení ([ServiceObjectCategory](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#serviceobjectcategory))
</Param>

<Param name="manufacturerId" type="string(GUID)">
ID výrobce zařízení ([ServiceObjectManufacturer](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#serviceobjectmanufacturer))
</Param>

<Param name="addressId" type="string(GUID)">
ID adresy zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="address" type="CustomerAddress">
Adresa zákazníka ([CustomerAddress](/cs/api-reference/legacy/obecne-informace/datovy-model/zakaznici-a-zarizeni/#customeraddress))
</Param>

<Param name="identificationNumber" type="string">
Výrobní číslo
</Param>

<Param name="location" type="string">
Textový popis, kde je zařízení umístěno (např. v které místnosti)
</Param>

<Param name="soldDate" type="string(Date)">
Datum prodeje
</Param>

<Param name="nextRevision" type="string(Date)">
Datum příští kontroly. Používá se pro plánování pravidelného servisu (viz [NextRevisionMode](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#nextrevisionmode))
</Param>

<Param name="installationDate" type="string(Date)">
Datum instalace/montáže
</Param>

<Param name="warrantyTill" type="string(Date)">
V záruce do
</Param>

<Param name="description" type="string">
Popis
</Param>

<Param name="isMoved" type="boolean">
Toto zařízení bylo přesunuto k jinému zákazníkovi. Jedná se o historický záznam.
</Param>

<Param name="movedAt" type="string(DateTime)">
Vyplněno pokud isMoved = true. Datum a čas, kdy bylo zařízení přesunuto k jinému zákazníkovi.
</Param>

<Param name="nextRevisionPeriodInMonths" type="integer">
Perioda pravidelného servisu v měsících. V případě dokončení výjezdu s formulářem, který prodlužuje pravidelný servis se automaticky posune datum příští kontoly od daný počet měsíců.
</Param>

<Param name="nextRevisionMode" type="NextRevisionMode">
Způsob plánování pravidelného servisu ([NextRevisionMode](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#nextrevisionmode))
</Param>

<Param name="customData" type="string(JSON)">
Dodatečná data k zařízení ve formátu JSON
</Param>

## User

Uživatel v systému mWork365. Může se jednat například o technika nebo dispečera

<Param name="id" type="string(GUID)">
</Param>

<Param name="externalId" type="string">
</Param>

<Param name="created" type="string(DateTime)">
Datum vytvoření
</Param>

<Param name="modified" type="string(DateTime)">
Datum poslední úpravy
</Param>

<Param name="firstName" type="string">
Křestní jméno
</Param>

<Param name="lastName" type="string">
Příjmení
</Param>

<Param name="fullName" type="string">
Křestní jméno a příjmení dohromady (oddělené mezerou)
</Param>

<Param name="phone" type="PhoneNumber">
Telefonní číslo ([PhoneNumber](/cs/api-reference/legacy/obecne-informace/datovy-model/ciselniky-a-vycty/#phonenumber))
</Param>

<Param name="email" type="string(Email)">
Emailová adresa
</Param>

<Param name="technicianCostPrice" type="decimal">
Nákladová hodinová cene technika (pouze pro uživatele s rolí Technik)
</Param>