Přidání zákazníka

POSThttps://app.mwork365.com/main/publicapi/customer

Tělo požadavku

externalIdstring

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

namestringpovinné

Jméno zákazníka

categoryIdstring/string(GUID)

ID nebo Slug kategorie zákazníka (CustomerCategory)
Pokud není vyplněno, použije se první hodnota z číselníku CustomerCategory

typeIdstring/string(GUID)

ID nebo Slug typu zákazníka (CustomerType)
Pokud není vyplněno, použije se první hodnota z číselníku CustomerType

kindCustomerKind

Druh zákazníka (CustomerKind)
Výchozí hodnota: Company

contactPeopleContactPersonToAdd[]povinné

Kontaktní osoby zákazníka.
Musí obsahovat alespoň jednu kontaktní osobu. Obsah je shodný s endpointem Přidání kontaktní osoby

addressesCustomerAddressToAdd[]povinné

Adresy zákazníka
Musí obsahovat alespoň jednu adresu. Obsah je shodný s endpointem Přidání adresy

serviceObjectsServiceObjectToAdd[]

Zařízení zákazníka
Obsah je shodný s endpointem Přidání zařízení

primaryContactPersonIdstring

Externí ID primární kontaktní osoby
Pokud není vyplněno, použije se první kontaktní osoba z contactPeople

invoiceAddressIdstring

Externí ID fakturační adresy
Pokud není vyplněno, použije se první adresa z addresses

contactAddressIdstring

Externí ID kontaktní adresy zákazníka (pouze pro firmy viz CustomerKind)
Pokud není vyplněno, je kontaktní adresa shodná s adresou fakturační

ownerIdstring

ID nebo Externí ID vlastníka. Pokud není manuálně nastaveno, je vlastníkem standardně uživatel, který zákazníka založil. V případě založení přes API je vlastníkem zákazníka uživatel s rolí Administrátor.

identificationNumberstringpovinné pro firmy

IČ (pouze pro firmy viz CustomerKind)

taxNumberstring

DIČ (pouze pro firmy viz CustomerKind)

websitestring

Webová stránka

descriptionstring

Poznámky

customDatastring(JSON)

Dodatečná data k zákazníkovi ve formátu JSON. Musí odpovídat šabloně.

Odpověď

201 Created

Zákazník byl úspěšně přidán

400, 401, atd.

Více informací na stránce standardní chybové stavy.

Příklad

curl -L -X POST 'https://app.mwork365.com/main/publicapi/customer' \
-H 'Authorization: Bearer eyJhb...WlUw' \
-H 'Content-Type: application/json' \
--data-raw '{
    "externalId": "mwork",
    "kind": "Company",
    "name": "mWork365 s.r.o.",
    "identificationNumber": "07722923"
    "categoryId": "zakladni",
    "typeId": "normal",
    "website": "https://www.mwork365.com",
    "contactPeople:" [
        {
            "externalId": "mwork_p1",
            "firstName": "Jan",
            "lastName": "Novák",
            "position": "Vedoucí provozu",
            "phone": {
                "prefix": "+420",
                "phone": "999777888"
            },
            "sendNotifications": true
        },
        {
            "externalId": "mwork_p2",
            "firstName": "Tomáš",
            "lastName": "Dvořák",
            "position": "Jednatel",
            "email": "tomas.dvorak@mwork365.com"
            "sendNotifications": true,
            "sendReports": true
        }
    ],
    "addresses": [
        {
            "street": "Novoveská 1262/95",
            "city": "Ostrava",
            "postalCode": "709 00",
            "country": "Česká Republika",
            "coordinates": {
                "latitude": 49.83284,
                "longitude": 18.24369
            }
        }
    ],
    "primaryContactPersonId": "mwork_p2"
}'