Kunde bearbeiten

Aktualisiert die Daten eines bestehenden Kunden.

Request

PUT /api/oauth/v2/resource/customers/{uuid}

Header

Header	Wert
Authorization	Bearer {access_token}
Content-Type	application/json

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string	Ja	Eindeutige Kunden-ID

Body-Parameter

Hinweis: Alle Felder sind optional. Mindestens eines der Felder firstName, lastName oder companyName muss nach der Aktualisierung gesetzt sein.

Feld	Typ	Pflicht	Beschreibung
firstName	string	Nein	Vorname
lastName	string	Nein	Nachname
companyName	string	Nein	Firmenname
title	string	Nein	Titel (z.B. Dr., Mag.)
email	string	Nein	E-Mail-Adresse
tel	string	Nein	Telefonnummer
telCode	string	Nein	Ländervorwahl (z.B. +43)
street	string	Nein	Straße und Hausnummer
zip	string	Nein	Postleitzahl
city	string	Nein	Stadt
country	string	Nein	Ländercode (ISO 3166-1 alpha-2, z.B. AT)
birthday	string	Nein	Geburtsdatum (YYYY-MM-DD)
sex	integer	Nein	Geschlecht
notice	string	Nein	Interne Notiz
customerNumber	string	Nein	Kundennummer
socialNumber	string	Nein	Sozialversicherungsnummer

Response

Erfolg (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": null,
    "firstName": "Anna",
    "lastName": "Muster",
    "email": "anna.neu@example.com",
    "phone": "+43 664 1234567",
    "birthday": "1985-04-12",
    "socialNumber": "1234 120485",
    "tenancies": [
      {
        "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
        "name": "Ordination Muster",
        "abbreviation": "OM",
        "color": "#00adba"
      }
    ]
  }
}

Response-Felder

Siehe Kunde anzeigen für die vollständige Feldbeschreibung.

Beispiele

bash

curl -X PUT "https://my.offisy.at/api/oauth/v2/resource/customers/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Max",
    "lastName": "Mustermann",
    "companyName": "Muster GmbH",
    "title": "beispiel",
    "email": "anna.muster@example.com",
    "tel": "+43 664 1234567",
    "telCode": "+43 664 1234567",
    "street": "Musterstraße 1",
    "zip": "4020",
    "city": "Linz",
    "country": "AT",
    "birthday": "beispiel",
    "sex": "1",
    "notice": "beispiel",
    "customerNumber": "beispiel",
    "socialNumber": "1234010190"
  }'

Server

Client-ID

Client-Secret

Parameter

uuid *integer

firstName string

lastName string

companyName string

title string

email string

tel string

telCode string

street string

zip string

city string

country string

birthday string

sex integer

notice string

customerNumber string

socialNumber string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Ungültige Request-Daten (z.B. kein Name gesetzt)
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope customers nicht vorhanden
404	not_found	Kunde nicht gefunden