POST api/v{version}/personsBulk

Erstellt oder aktualisiert mehrere Personen

Request

URI Parameter

Name	Beschreibung	Typ
version		string

Body Parameter

Collection of Person

Name	Beschreibung	Typ
Guid	Die eindeutige Guid der Person. Wird generiert, falls nicht angegeben.	string
Aktiv	Aktiv-Status des Mitglieds	boolean
Kundennummer	Die Kundennummer der Person	integer
Vorname	Obligatorisch - Der Vorname der Person	string
Nachname	Obligatorisch - Der Nachname der Person	string
Geb_Datum	Das Geburtsdatum der Person	timestamp
Geschlecht	Das Geschlecht (m/w/d) der Person - leer, wenn unbekannt	string
PLZ	Die PLZ der Adresse der Person	string
Ort	Der Ort der Adresse der Person	string
StrasseNr	Die Straße und die Hausnummer der Adresse der Person	string
Telefon_1	Erste Telefonnummer der Person	string
Telefon_2	Zweite Telefonnummer der Person	string
Mobil	Mobil-Telefonnummer der Person	string
EMail	E-Mail der Person	string
Versichertennummer	Krankenkasse-Versichertennummer der Person	string
Kostentraegernummer	Krankenkassen-Nummer der Person	string
Kartennummer	Karten-Nummer / Check-In-Nummer der Person	string
ZuletzGeaendertTimestampUTC	Nur lesen - Timestamp der letzten Erzeugung / Änderung dieser Person (in UTC / GMT). Wird von myYOLO automatisch gesetzt.	timestamp
MagicLineCustomerID	Die CustomerID des Kunden in MagicLine.	string

Request Format

application/json

Beispiel:

[
  {
    "Guid": "5f4b11bb-648e-4e7c-8a52-408134803992",
    "Aktiv": true,
    "Kundennummer": 0,
    "Vorname": "Hermine",
    "Nachname": "Dienstag",
    "Geb_Datum": "1980-04-13T00:00:00",
    "Geschlecht": "w",
    "PLZ": "37284",
    "Ort": "Waldkappel",
    "StrasseNr": "Oberweg 3",
    "Telefon_1": "123456",
    "Telefon_2": "",
    "Mobil": "015146430020",
    "EMail": "hallo@azh-myyolo.de",
    "Versichertennummer": "123456",
    "Kostentraegernummer": "99999901",
    "Kartennummer": "16",
    "ZuletzGeaendertTimestampUTC": "2025-06-27T09:43:02Z",
    "MagicLineCustomerID": "0"
  },
  {
    "Guid": "1bc7d5b6-f76d-4bc1-a845-0a0649f79594",
    "Aktiv": true,
    "Kundennummer": 0,
    "Vorname": "Jennifer",
    "Nachname": "Test",
    "Geb_Datum": "1991-07-02T00:00:00",
    "Geschlecht": null,
    "PLZ": "12133",
    "Ort": "Am Bahnhof",
    "StrasseNr": "89",
    "Telefon_1": "+49 12345678",
    "Telefon_2": "",
    "Mobil": "+49 12345678",
    "EMail": "example123123123123s@email.com",
    "Versichertennummer": null,
    "Kostentraegernummer": null,
    "Kartennummer": "",
    "ZuletzGeaendertTimestampUTC": "2023-05-10T15:04:27Z",
    "MagicLineCustomerID": "0"
  }
]

Response

Rückgabe-Objekt

Collection of PersonResult

Name	Beschreibung	Typ
ResData	Die Person	Person
Status	Ergebnis des Aufrufs (OK, WARN, ERR)	ResStatus
StatusText	Ergebnis des Aufrufs (OK, WARN, ERR) als Text	string
Reason	Begründung eines Fehler-Ergebnisses	ErrReason
ReasonText	Begründung eines Fehler-Ergebnisses als Text	string
ErrDesc	Fehlerbeschreibung	string
ExText	Erweiterte Informationen zum Fehler	string
ExStack	Call-Stack	string
ResDataTypeName	Typ-Name des Ergebnisses (z. Bsp. "Person" oder "PersonList")	string

Response Format

application/json

Beispiel:

[
  {
    "ResData": {
      "Guid": "5f4b11bb-648e-4e7c-8a52-408134803992",
      "Aktiv": true,
      "Kundennummer": 0,
      "Vorname": "Hermine",
      "Nachname": "Dienstag",
      "Geb_Datum": "1980-04-13T00:00:00",
      "Geschlecht": "w",
      "PLZ": "37284",
      "Ort": "Waldkappel",
      "StrasseNr": "Oberweg 3",
      "Telefon_1": "123456",
      "Telefon_2": "",
      "Mobil": "015146430020",
      "EMail": "hallo@azh-myyolo.de",
      "Versichertennummer": "123456",
      "Kostentraegernummer": "99999901",
      "Kartennummer": "16",
      "ZuletzGeaendertTimestampUTC": "2025-06-27T09:43:02Z",
      "MagicLineCustomerID": "0"
    },
    "Status": 0,
    "StatusText": "OK",
    "Reason": 0,
    "ReasonText": "None",
    "ErrDesc": "",
    "ExText": "",
    "ExStack": "",
    "ResDataTypeName": "Person"
  },
  {
    "ResData": {
      "Guid": "1bc7d5b6-f76d-4bc1-a845-0a0649f79594",
      "Aktiv": true,
      "Kundennummer": 0,
      "Vorname": "Jennifer",
      "Nachname": "Test",
      "Geb_Datum": "1991-07-02T00:00:00",
      "Geschlecht": null,
      "PLZ": "12133",
      "Ort": "Am Bahnhof",
      "StrasseNr": "89",
      "Telefon_1": "+49 12345678",
      "Telefon_2": "",
      "Mobil": "+49 12345678",
      "EMail": "example123123123123s@email.com",
      "Versichertennummer": null,
      "Kostentraegernummer": null,
      "Kartennummer": "",
      "ZuletzGeaendertTimestampUTC": "2023-05-10T15:04:27Z",
      "MagicLineCustomerID": "0"
    },
    "Status": 0,
    "StatusText": "OK",
    "Reason": 0,
    "ReasonText": "None",
    "ErrDesc": "",
    "ExText": "",
    "ExStack": "",
    "ResDataTypeName": "Person"
  }
]