Kontakt (party
)
Kontakt je entita, která reprezentuje jeden záznam v adresáři kontaktů. Jedná se obvykle o fyzickou nebo právnickou osobu, ale existují další typy kontaktů.
SQL tabulka: customer
, customer_attr
(zákaznická pole)
Entita pro XML Connector: party
nebo customer
Před verzí 6.0 byly některé kontakty uloženy v tabulkách branch
(provozovny) a person
(fyzické osoby). Nyní je vše sjednoceno v jedné databázové tabulce s vyhrazeným sloupcem, který určuje typ identity.
Poznámky
- Každý záznam kontaktu může pojmout max. 2 poštovní adresy. Pole s příponou
M
v názvu patří k druhé adrese, bez přípony k první adrese. Poleowners
,salesmen
- mohou obsahovat seznam uživatelských jmen nebo skupin (login názvy oddělené čárkou)
Vlastní pole
Název | Typ | Popis |
---|---|---|
adrState | string | Název státu |
adrStateM | string | Název státu (druhá adresa) |
avatar | string | Obrázek/Logo kontaktu ve formátu Data URL - [<mediatype>][;base64],<data> ,kde data jsou v base64 kódování. Příklad: data:text/plain;base64,SGVsbG8sIFdvcmxkIQ== |
bankAccount | string | Číslo bankovního účtu |
bankCode | string | Kód banky |
bankSymbol | string | Specifický symbol pro peněžní transakce |
birthday | date | Narozeniny osoby |
bornNumber | string | Rodné číslo osoby (nebo podobný národní identifikátor) |
card | string | Číslo zákaznické karty |
canShopping | boolean | Zákazník může nakupovat (bude přejmenováno na canPurchase) |
categories | string | Kódy kategorií, do kterých kontakt patří. (hodnotou je seznam kódů kategorií c1, c2, …, c64 - kódy musí být odděleny čárkou) |
categoriesValue | string | Vyjmenované názvy kategorií, do kterých kontakt patří. |
city | string | Město |
cityM | string | Město (druhá adresa) |
comment | string | Komentář ke kontaktu |
company | string | Název společnosti (u kontaktu typu BRANCH je zde název provozovny nebo zopakovaný název společnosti, do které provozovna patří) |
country | string | Kód země (CZ, SK, PL, ...) |
countryM | string | Kód země (druhá adresa) |
countryValue | string | Název země |
countryMValue | string | Název země (druhá adresa) |
debit | int | Dluh po splatnosti v hlavní měně |
deliveryAddr | string | Index adresy, která je určena pro doručování zboží (0 = nenastaveno, 1 = první adresa, 2 = druhá adresa) |
dic | string | DIČ |
dic2 | string | Druhé DIČ (pro SK) |
entered | datetime | Kdy byl záznam vytvořen |
enteredBy | string | Uživatel, který záznam vytvořil (login) |
enteredByValue | string | Uživatel, který záznam vytvořil (jméno) |
enteredFrom | string | Kód původu kontaktu (jak byl získán) |
enteredFromValue | string | Název původu kontaktu (jak byl získán) |
fileAs | string | Pod jakým názvem bude kontakt zobrazován (v seznamech, v našeptávači, apod.). Generuje se - není třeba zapisovat |
firstname | string | Křestní jméno |
gender | int | Pohlaví osoby (0 = nenastaveno, 1 = muž, 2 = žena) |
hearAbout | int | Jak se o nás dozvěděl (kód) |
hearAboutValue | string | Jak se o nás dozvěděl (název) |
homeAddr | string | Index adresy, která je sídlo (u firmy) nebo trvalé bydliště (u osoby) (0 = nenastaveno, 1 = první adresa, 2 = druhá adresa) |
ico | string | IČO |
id | int | Kód kontaktu (primární klíč) |
importance | int | Důležitost (kód). Větší číslo = větší důležitost kontaktu |
importanceValue | string | Důležitost (název) |
importProtected | boolean | Tento záznam není možné aktualizovat z importovaných dat. |
invoiceAddr | string | Index adresy, která je určena pro zasílání faktur (0 = nenastaveno, 1 = první adresa, 2 = druhá adresa) |
invoiceMaturity | string | Splatnost faktur |
language | string | Kód jazyka (ISO-639-1), kterým tento kontakt komunikuje (cs, sk, en, de, ...) |
languageValue | string | Název jazyka komunikace |
login | string | Přidělené přihlašovací jméno do extranetu |
mailingAddr | string | Index adresy, která je určena pro zasílání pošty (0 = nenastaveno, 1 = první adresa, 2 = druhá adresa) |
maritalStatus | string | Rodinný stav (viz. číselník mast ) |
modified | datetime | Čas poslední změny |
modifiedBy | string | Uživatel, který záznam naposledy změnil (login) |
modifiedByValue | string | Uživatel, který záznam naposledy změnil (jméno) |
owners | string | Uživatelé vlastnící tento kontakt |
password | string | Přidělené heslo do extranetu |
pricelist | int | Kód ceníku, za který kontakt nakupuje produkty (0 = standardní ceník) |
pricelistValue | string | Název přiděleného ceníku |
private | boolean | Kontakt je považován za Osobní a vidí jej pouze vlastníci |
region | int | Kód regionu |
salutation | string | Oslovení v 5. pádě |
salesmen | string | Login uživatele, který je odpovědným obchodníkem pro tento kontakt (account manager) |
salesmenValue | string | Jméno uživatele, který je obchodníkem pro tento kontakt |
street | string | Ulice - první řádek |
streetM | string | Ulice - první řádek (druhá adresa) |
street1 | string | Ulice - druhý řádek |
street1M | string | Ulice - druhý řádek (druhá adresa) |
street2 | string | Ulice - třetí řádek |
street2M | string | Ulice - třetí řádek (druhá adresa) |
streetLat | double | GPS Latitude (šířka) |
streetLng | double | GPS Longitude (délka) |
streetMLat | double | GPS Latitude (šířka - druhá adresa) |
streetMLng | double | GPS Longitude (délka - druhá adresa) |
surname | string | Příjmení osoby |
symbol | string | Unikátní kód přidělený uživatelem |
tariff | int | Kód ceníku služeb, za který kontakt nakupuje služby (0 = standardní ceník) |
tariffValue | string | Název přiděleného ceníku služeb |
titleAfter | string | Titul(y) za jménem |
titleBefore | string | Titul(y) před jménem |
type | string | Typ záznamu/kontaktu, viz. přehled typů |
vip | boolean | VIP kontakt |
zip | string | PSČ |
zipM | string | PSČ (druhá adresa) |
Typy kontaktů
Název typu je vždy velkými písmeny (case sensitive). Podporované typy (hodnota pole type
) jsou:
Typ | Popis |
---|---|
ORGANIZATION | Firma nebo jiná organizace |
INDIVIDUAL | Fyzická osoba |
FREELANCER | Podnikající fyzická osoba (může mít navíc IČO a DIČ plus obchodní značku) |
BRANCH | Provozovna organizace |
JOB | Pracovní pozice v organizaci (účetní, recepční, ...) |
DEPARTMENT | Oddělení v rámci organizace (např. HR) |
ROBOT | Subjekt, který není osobou. Existence tohoto typu je důležitá pro řízení přístupových práv a možnost vytvářet uživatelské účty, které nepatří osobám (např. e-shop, který zapisuje do CRM) |
FAMILY | Rodina (sdružuje 2 a více fyzických osob) |
GROUP | Libovolná pracovní skupina zahrnující osoby z jedné nebo více organizací |
ANONYMOUS | Kontakt, ke kterému nemáme jméno, pouze kontaktní údaj (např. e-mail) |
Formát JSON
{
"addresses": [ /* Poštovní adresy mohou být max 2 */
{
"accuracy": 99, /* Přesnost zjištění GPS pozice */
"city": "Godrikův Důl",
"country": "CZ",
"lat": 0.0, /* GPS Latitude */
"lng": 0.0, /* GPS Longitude */
"state": null,
"streets": [ /* Toto pole max 3 řádky adresy */
"Grimauldovo nám. 12"
],
"zip": "24133" /* PSČ */
}
],
"birthday": "1992-07-31",
"canPurchase": false, /* Zákazník může nakupovat */
"cantShare": false,
"categories": [ "c1", "c5" ], /* Kategorie c1, "c64" */
"comment": "Je to opravdu neobyčejný kouzelník",
"company": null, /* Název společnosti */
"consents": [ /* Souhlasy */
{
"entered": "2020-02-19T08:59:08",
"enteredBy": "gregor",
"source": 1,
"type": 1, /* Typ 1 - zpracování osobních údajů */
"value": true /* Souhlas udělil */
},
{
"entered": null,
"source": 0,
"type": 10, /* Typ 10 - zasílat zpravodaj */
"value": false /* Souhlas nebyl udělen */
}
],
"debit": 0,
"dic": "CZ9207315524",
"eaddresses": [ /* Kontaktní údaje, nebo-li elektronické adresy */
{
"id": 562,
"junk": false,
"priority": 1,
"raw": "+420608245226",
"type": 2, /* typ 2 = telefon */
"value": "+420608245226"
},
{
"id": 563,
"junk": false,
"priority": 2,
"type": 1, /* typ 1 = e-mail */
"value": "potter@bradavice.cz"
}
],
"entered": "2020-02-19T08:57:55",
"enteredBy": "gregor",
"enteredFrom": "srch",
"etag": "1582099147000",
"fileAs": "Ing. Harry Potter, CSc.",
"firstname": "Harry",
"gender": 1, /* Pohlaví */
"globalStatus": 0,
"hearAbout": null,
"ico": "25632188",
"id": "350", /* Unikání ID - je vždy integer */
"importProtected": false,
"importance": 21,
"invoiceMaturity": 10,
"isirLastCheck": null,
"isirStatus": 0,
"language": "cs",
"maritalStatus": 0,
"modified": "2020-02-19T08:59:07",
"modifiedBy": "gregor",
"owners": "gregor",
"pricelist": null,
"private": false,
"region": null,
"regionName": "",
"salesmen": [
"gregor"
],
"salutation": "Vážený pane Pottere", /* Oslovení v pátém pádě */
"surname": "Potter",
"tariff": null,
"titleAfter": "CSc.",
"titleBefore": "Ing.",
"type": "FREELANCER", /* Typ identity: Živnostník */
"vip": false
}