Concept Office Rest API - Ansprechpartner

Ein Concept Office Ansprechpartner wird primär über die folgenden Datenbanktabellen befüllt:

Domänenbegriff Tabelle Rolle Abhängigkeiten
Ansprechpartner AnsprechPartner Hauptobjekt Referenziert Kontakt und optional Anschrift
Firma Kontakte Referenzobjekt Muss vor dem Ansprechpartner existieren
Anschrift Anschriften Referenzobjekt Kann zur Suche verwendet werden

Hinweis: Ein Ansprechpartner kann erst angelegt werden, wenn der zugehörige Kontakt angelegt ist.


AnsprechPartner (Hauptobjekt)

Get

  • Mehrere Ansprechpartner aufrufen:
    GET /Office/CoServiceRestApi/office/ansprechpartner
  • Ausgewählten Ansprechpartner aufrufen:
    GET /Office/CoServiceRestApi/office/ansprechpartner/{ansprechpartnerNummer}
  • Ansprechpartner zu Anschrift suchen:
    GET /Office/CoServiceRestApi/office/ansprechpartner?q=[{"anschriftsnummer":{"value":{anschriftsNummer},"Operator":"="}}]

Post (Pflichtfelder / Beispiel)

Neuen Ansprechpartner anlegen:

POST /Office/CoServiceRestApi/office/ansprechpartner
{
  "kontaktnummer": 10000,
  "nachname": "Mustermann",
  "vorname": "Max",
  "geschlecht": 1,
  "berufsbezeichnung": "Einkauf",
  "bemerkungen": "Angelegt ueber API",
  "sprache": "de",
  "qualifikation": 0,
  "aktiv": true,
  "angelegtprogramm": "API"
}

Put

Ausgewählten Ansprechpartner bearbeiten:

PUT /Office/CoServiceRestApi/office/ansprechpartner/{ansprechpartnerNummer}
{
  "nachname": "Mustermann",
  "vorname": "Max",
  "geschlecht": 1,
  "berufsbezeichnung": "Leitung Einkauf",
  "bemerkungen": "Aktualisiert ueber API",
  "sprache": "de",
  "aktiv": true
}

Delete

Ausgewählten Ansprechpartner löschen:

DELETE /Office/CoServiceRestApi/office/ansprechpartner/{ansprechpartnerNummer}

Verbindungen (Unterobjekt)

Put

Verbindungen eines Ansprechpartners bearbeiten:

PUT /Office/CoServiceRestApi/office/ansprechpartner/{ansprechpartnerNummer}
{
  "verbindungen": [
    {
      "VerbindungsNummer": "+49 9131 123456",
      "KommunikationsArt": "T",
      "Bezeichnung": "Telefon",
      "Privat": false,
      "VerbindungsArt": "Telefon"
    },
    {
      "VerbindungsNummer": "max.mustermann@example.com",
      "KommunikationsArt": "M",
      "Bezeichnung": "E-Mail",
      "Privat": false,
      "VerbindungsArt": "eMail"
    }
  ]
}