Kontakt anlegen (REST API)

Diese Artikel könnten ebenfalls für Sie interessant sein:
Adressen auflisten

Kontakt anlegen (Adresse und Ansprechpartner)

POST auf api/mixed

Sind Nachname und Organisation gefüllt, so werden eine Adresse (die Organisation) und ein Ansprechpartner angelegt. Ansonsten wird nur eine Adresse angelegt.

Rückgabewert: Die ID des neu angelegten Kontaktes (beginnt mit "C" bei Adresse und "P" bei Ansprechpartner). Diese ID kann bei weiteren Aufrufen, z.B. dem Anlegen einer Aufgabe, im Feld ContactId übergeben werden.

Beispiel JSON Body:

{
   "Gender":null,
   "Title":null,
   "FirstName":"Johannes",
   "LastName":"Geyer",
   "Organization":"Große Firma",
   "Organization2":null,
   "Organization3":null,
   "Department":null,
   "Position":null,
   "Salutation":null,
   "TextSalutation":null,
   "Birthday":null,
   "AccountManager":null,
   "AccountManagerId":null,
   "CustomerNo":null,
   "VATIDNumber":null,
   "MainCategory":"Kunde",
   "Tags":[  
      "Golf",
      "Hockey"
   ],
   "BlockedForMailingList":null,
   "Address":{
      "Street":null,
      "ZipCode":null,
      "City":"Lindelburg",
      "State":null,
      "Country":null,
      "MailBox":null,
      "MailBoxZipCode":null,
      "AddressType":null
   },
   "CustomField":{
      "TextFeld":"Mit Inhalt",
      "ZweitesFeld":"Im zweiten Feld"
   },
   "Communication":{
      "PhoneMobile":"01791141988",
      "EMailAddress":"test@test.de"
   }
}

Felder, die nicht gefüllt werden sollen, können weggelassen werden im JSON.

Feld Typ Bedeutung
Gender Enum

Wird das Geschlecht nicht definiert, so versucht julitec anhand des Vornamens und der Anrede das Geschlecht zu erkennen.

Mögliche Werte:
Organization
Male
Female

Salutation Text Die Anrede auf dem Briefumschlag. Normalerweise "Herrn" oder "Frau"
Wird die Anrede nicht übergeben, so wird sie automatisch von julitec gefüllt.
TextSalutation Text Die Anrede am Anfang eines Briefes, z.B. "Sehr geehrter Herr Müller"
Wird die Briefanrede nicht übergeben, so wird sie automatisch von julitec gefüllt.
AccountManager AccountManagerId Text
ID
Der Betreuer der Adresse. Es kann entweder die ID des Benutzers übergeben werden (in AccountManagerId) oder die E-Mail-Adresse (in AccountManager).
CustomerNo Text Die Kundennummer oder Lieferantennummer.
Ist in den Einstellungen konfiguriert, dass diese automatisch vergeben werden (Default), so geschieht das auch beim Anlegen eines Kontaktes über die API.
BlockedForMailingList Bool

Bestimmt, ob der Kontakt für Mailings (Newsletter) gesperrt ist.

Mögliche Werte:
True
False

Tags Array

Cloud: Die Merkmale des Kontaktes
WebAccess: Die Kategorien der Adresse

Achtung: Die Merkmale / Kategorien werden nicht automatisch angelegt, wenn sie nicht existieren.

Communications.Type Text Der Typ des Kommunikationseintrags:
PhoneOffice
PhoneMobile
PhoneHome
PhoneOther
FaxOffice
EMailAddress
Homepage
Facebook
Skype
Twitter
Xing
GooglePlus
LinkedIn
YouTube 
VATIDNumber Text Umsatzsteuer ID Nummer
Address.AddressType Text Name eines vorhanden Anschriftstypen, z.B. "Büroanschrift"

 

Haben Sie Fragen? Anfrage einreichen

Kommentare

Powered by Zendesk