Kunde erstellen

Erstellt einen neuen Kunden.

Request

POST /api/oauth/v2/resource/customers

Header

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

Body-Parameter

Hinweis: Mindestens eines der Felder firstName, lastName oder companyName ist erforderlich.

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 (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": null,
    "firstName": "Max",
    "lastName": "Mustermann",
    "email": "max.mustermann@example.com",
    "phone": "+43 676 9876543",
    "birthday": "1990-08-23",
    "socialNumber": null,
    "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 POST "https://my.offisy.at/api/oauth/v2/resource/customers" \
  -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

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 angegeben)
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope customers nicht vorhanden