| Info |
|---|
Die hier referenzierte PEIQ Ad API befindet sich noch im Modus Beta und ist teilweise noch “work in progress” |
Inhaltsverzeichnis
| Expand | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
|
Anlegen und Ändern von Geschäftspartnern
Geschäftspartner können direkt aus dem CRM heraus mit POST /businesspartners über die AdAPI in PEIQ angelegt und mit PUT /businesspartners/{number} geändert werden. Neben den definierten Pflichtfeldern gilt, dass dabei nicht mitgelieferte Elemente in PEIQ beim Anlegen mit Default-Werten gefüllt werden bzw. leer bleiben. Auch bei Änderungen werden einzelne Werte, deren Elemente an der AdAPI nicht mitgeliefert werden, in PEIQ nicht verändert. So können über die AdAPI gezielt nur die relevanten Werte übertragen werden.
...
| Note |
|---|
Eine Ausnahme gibt es bei Adressen:
|
| Info |
Das Befüllen mit Default-Werten bei Anlage neuer Cluster funktioniert nur dann, wenn die entsprechenden Felder in der API nicht mit übergeben werden.
Nummernvergabe beim Anlegen
...
Beim Anlegen über die AdAPI wird die jeweils neu vergebene Nummer von PEIQ an das externe System zurückgegeben. Diese Logik wird verwendet, wenn beim Anlegen mit POST /businesspartners das Element "number" nicht mitgeliefert wird.
...
Abrufen von zuletzt geänderten Geschäftspartnern
Über den Endpunkt GET /businesspartners/events (Feed-orientiert) kann sich ein externes System die Geschäftspartnernummern, welche seit dem letzten Offset geändert wurden oder neu hinzugekommen sind (beim ersten Mal ohne Offset), abrufen. Mit dem Ergebnis wird ein Offset zurückgegeben.
...
Die Daten der Geschäftspartner können dann jeweils mit Hilfe der ID ("number") mittels GET /businesspartners/{number} abgefragt werden.
Abrufen von bekannten Geschäftspartnern
...
Informationen eines bekannten Geschäftspartners können bei GET /businesspartners/{number} unter Angabe der Geschäftspartnernummer "number" abgefragt werden.
...
Die Suche nach Geschäftspartnern erfolgt als GET über folgenden Endpunkt GET /businesspartners/search.
Parameter - Suchkriterien
...
Detaillierte Informationen zu den gefundenen Geschäftspartnern können über den Endpunkt GET /businesspartners/{number} abgefragt werden (siehe Absatz “Abrufen von bekannten Geschäftspartnern”).
...
Bankverbindungen sind als eigenständige Cluster mit Geschäftspartnern verknüpft.
...
Der Endpunkt accountdetails ermöglicht das Abfragen und Anlegen von Bankverbindungen. Neu angelegte Bankverbindungen sind über den Endpunkt businesspartners mit Geschäftspartnern zu verknüpfen.
Abrufen von Bankdaten(-Nummern) eines Geschäftspartners
Über den Endpunkt GET /businesspartners/{number} kann sich ein externes System die eindeutige Nummer der Bankdaten, welche bereits mit einem Geschäftspartner verknüpft ist, ausgeben lassen:
...
Bei der Abfrage der Bankverbindung ist die aus dem Endpunkt GET /businesspartners/{number} erhaltene number aus den account_details anzugeben (ID der Bankverbindung). Nun kann sich ein externes System über den Endpunkt GET /accountdetails/{number} die Daten der Bankverbindung des Geschäftspartners abrufen.
Anlage der Bankverbindung
Über den Endpunkt POST /accountdetails können Bankverbindungen neu angelegt werden. Der Rückgabewert des POST ist die ID der Bankverbindung (“account_details” → “number”: “204-4996543”).
...
Aktualisierung der Bankverbindung
Über den Endpunkt PUT /accountdetails/{number} können Bankverbindungen aktualisiert werden.
...
Um eine neue Bankverbindung zu einem Geschäftspartner hinzuzufügen muss der Rückgabewert des Endpunktes POST /accountdetails via Endpunkt PUT /accountdetails/{number} am Geschäftspartner hinzugefügt werden. Dabei ist es möglich, ausschließlich die accountdetails zum Geschäftspartner zu übermitteln:
| Code Block |
|---|
{
"account_details": [
{
"number": "204-4996543"
},
{
"number": "204-4996770"
},
{
"number": "204-4996780"
}
]
}
|
| Include Page | ||||
|---|---|---|---|---|
|