Přidat nebo Upravit zákazníka

Zobrazit zdroj

Parametry, které nebudou zaslány zůstanou v případě úpravy existujícího zákazníka nezměněny.
Navázané entity (adresy, kontaktní osoby, zařízení) budou také upraveny, v případě shody identifikátoru, v opačném případě budou přidány.
Existující navázané entity, které nejsou součástí požadavku, se nesmažou ale zůstanou v systému beze změny.

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

Tělo požadavku

idstring(GUID)

Nepovinné. ID zákazníka.

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 a jedná se o přidání zákazníka, použije se první hodnota z číselníku CustomerCategory.

typeIdstring/string(GUID)

ID nebo Slug typu zákazníka (CustomerType)
Pokud není vyplněno a jedná se o přidání zákazníka, použije se první hodnota z číselníku CustomerType

kindCustomerKind

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

contactPeopleContactPersonToAdd[]

Kontaktní osoby zákazníka.
Obsah je shodný s endpointem Přidání kontaktní osoby s tím, že je doplněn o ID.

addressesCustomerAddressToAdd[]

Adresy zákazníka
Obsah je shodný s endpointem Přidání adresy s tím, že je doplněn o ID.

serviceObjectsServiceObjectToAdd[]

Zařízení zákazníka
Obsah je shodný s endpointem Přidání zařízení s tím, že je doplněn o ID.

primaryContactPersonIdstring

Externí ID primární kontaktní osoby
Pokud není vyplněno a jedná se o přidání zákazníka, použije se první kontaktní osoba z contactPeople

invoiceAddressIdstring

Externí ID fakturační adresy
Pokud není vyplněno a jedná se o přidání zákazníka, použije se první adresa z addresses

contactAddressIdstring

Externí ID kontaktní adresy zákazníka (pouze pro firmy viz CustomerKind)

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.

identificationNumberstring

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

204 No Content

Zákazník byl úspěšně přidán, nebo upraven.

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/addOrEdit' \
-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"
}'