Abfrage der detailierten Gesellschaftsbewertung
Folgende Parameter können übergeben werden:
- sparte - Allgemein gültiges Spartenkürzel, Möglich sind: "phv", "rs", "unf", "wg", "tie", "hr"
- gesellschaft - Name der Gesellschaft für Abfrage der Bewertung
- subid (optional) - Einschränkung der Abfrage auf eine SUBID
- v_id (optional) - ID des Vermittlers / Untervermittlers
Die maximale Anzahl an Bewertungssternen ist 5.
Request:
$UpdateParams = array (
"dataUser" => array (
'user' => 'IHREVERMITTLERNUMMER',
'pass' => '********',
),
"content" => array (
'gesellschaften' => array (
'getRating' => array(
array(
"sparte" => "phv",
"gesellschaft" => "Domcura-Kiel",
"subid" => ""
)
)
)
)
);
Response:
array (
'response' =>
array (
'gesellschaften' =>
array (
'getRating' =>
array (
0 =>
array (
'kategorien' =>
array (
'Vertrag' =>
array (
1 =>
array (
'name' => 'Angebotswesen',
'hilfe' => 'Beurteilen Sie die Zuverlässigkeit und den Service wenn Sie individuelle Angebote anfordern.',
'bewertung' => '2',
'bewertung_text' => 'gut',
'sterne' => 4,
'sterne_max' => 5,
),
2 =>
array (
'name' => 'Antragsabwicklung',
'hilfe' => 'Beurteilen Sie die Antragspolitik, Antragsannahme, wie Rückfragen zu Anträgen bearbeitet werden.',
'bewertung' => '1',
'bewertung_text' => 'sehr gut',
'sterne' => 5,
'sterne_max' => 5,
),
...
...
)
),
),
'bewertungstext' => ''
),
),
),
),
)
Aufbau der Response:
- kategorien - Die Bewertungskriterien, gruppiert nach Kategorie (bsp. "Vertrag", "Schaden"). Schlüssel innerhalb einer Kategorie ist die ID des Bewertungskriteriums.
- bewertungstext - Persönliche Meinung des Maklers zur Gesellschaft als Freitext, kann leer sein.
Felder je Bewertungskriterium:
- name - Bezeichnung des Bewertungskriteriums, bsp. "Angebotswesen"
- hilfe - Erklärungstext zum Bewertungskriterium, kann leer sein
- bewertung - Die Bewertung als Schulnote von 1 bis 5. 1 = sehr gut, 5 = sehr schlecht (je kleiner der Wert, desto besser).
- bewertung_text - Der Klartext zur Note, bsp. "sehr gut", "gut", "mittelmäßig", "schlecht", "sehr schlecht"
- sterne - Anzahl der gefüllten Sterne von 1 bis 5. 5 = sehr gut, 1 = sehr schlecht (je größer der Wert, desto besser).
- sterne_max - Maximal mögliche Anzahl an Sternen, immer 5
Wichtig: "bewertung" und "sterne" beschreiben dieselbe Bewertung, nur in umgekehrter Skala. Es gilt immer: bewertung = 6 - sterne. Für die Sterne-Anzeige im Frontend "sterne" zusammen mit "sterne_max" verwenden, für Sortierung, Vergleich und Berechnungen die Note aus "bewertung".
Ist ein Kriterium nicht bewertet, werden "bewertung", "bewertung_text" und "sterne" als Leerstring ausgeliefert. Diese Werte daher nicht ungeprüft als Zahl weiterverarbeiten.