Klasse gesellschaften

Teilnehmende Gesellschaften, Vorversicherer, Bewertungen und Infotexte

Alle Beispiele setzen die Hilfsfunktion curlSend() und den Aufbau aus den Grundlagen voraus.

MethodeZweck
fetchListAm Vergleich teilnehmende (oder nicht teilnehmende) Gesellschaften inkl. Erklärungstext
fetchListBeforeGesellschaften für die Vorversicherung im Antrag
getRatingDetaillierte Gesellschaftsbewertung
getTextAboutInformationstext zur Gesellschaft

fetchList – Teilnehmende Gesellschaften

Es werden nur teilnehmende Gesellschaften ausgegeben, die im Adminbereich des SACH-Rechners aktiviert wurden.

Pflichtparameter

ParameterBedeutung
sparteAllgemein gültiges Spartenkürzel, z.B. phv, hug, unf, wg

Optionale Parameter

ParameterWirkung
subid Schränkt die Abfrage auf eine SUBID ein
komplett true – liefert drei Listen: Erklärungstext, Versicherungsgesellschaften und Assekuradeure
korrekteBezeichnung true/false – bei true werden die Gesellschaftsnamen nicht mehr mit Kurzname ausgeliefert
getrennt true/false – nur in Verbindung mit korrekteBezeichnung => true. Liefert zwei getrennte Listen für Versicherungsgesellschaften und Assekuradeure
nicht_teilnehmend true – alternative Liste der nicht teilnehmenden Gesellschaften. Hier werden immer die korrekten langen Bezeichnungen ausgeliefert; eine getrennte Liste ist in diesem Modus nicht verfügbar
Request – komplette Ausgabe mit Text
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'gesellschaften' => array (
            'fetchList' => array (
                array (
                    'sparte'   => 'phv',
                    'komplett' => true,
                    'subid'    => '',
                ),
            ),
        ),
    ),
);
Response (gekürzt)
array (
  'response' =>
  array (
    'gesellschaften' =>
    array (
      'fetchList' =>
      array (
        0 =>
        array (
          'text' => 'Im durchgeführten Produktvergleich wurden Privathaftpflicht'
                  . 'versicherungsvertraege ...',
          'versicherungen' =>
          array (
            'ARAG Allgemeine Versicherungs-AG'            => 'ARAG Allgemeine Versicherungs-AG',
            'AXA Versicherung AG (DBV)'                   => 'AXA Versicherung AG (DBV)',
            'BA die Bayerische Allgemeine Versicherung AG' => 'BA die Bayerische Allgemeine Versicherung AG',
            'Cosmos Versicherung Aktiengesellschaft'      => 'Cosmos Versicherung Aktiengesellschaft',
            // ...
          ),
          'assekuradeure' =>
          array (
            'AMEXPool AG'                   => 'AMEXPool AG',
            'Adam Riese GmbH'               => 'Adam Riese GmbH',
            'Adcuri GmbH'                   => 'Adcuri GmbH',
            'Asspario Versicherungsdienst AG' => 'Asspario Versicherungsdienst AG',
            // ...
          ),
        ),
      ),
    ),
  ),
)

Die Listen sind assoziative Arrays, bei denen Schlüssel und Wert identisch sind – praktisch für die direkte Verwendung in einem <select>.

fetchListBefore – Vorversicherer

Liefert die Gesellschaften, die im Antrag als Vorversicherung ausgewählt werden können.

ParameterBedeutung
sparteAllgemein gültiges Spartenkürzel, z.B. phv, hug, unf, wg
gesellGesellschafts-Kurzname – einige wenige Gesellschaften besitzen eine eigene Liste der Vorversicherer
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'gesellschaften' => array (
            'fetchListBefore' => array (
                array (
                    'sparte' => 'phv',
                    'gesell' => 'HanseMerkur',
                ),
            ),
        ),
    ),
);
Response (JSON, gekürzt)
{
  "response": {
    "gesellschaften": {
      "fetchListBefore": [
        [
          [
            { "id": 0, "name": "1822direkt Gesellschaft der Frankfurter Sparkasse mbH" },
            { "id": 1, "name": "Allgemeine Beamten Kasse Kreditbank AG" },
            { "id": 2, "name": "ACE European Group Limited, Direktion für Deutschland" },
            { "id": 3, "name": "ADAC-Rechtsschutz Versicherungs-AG" },
            { "id": 4, "name": "Adler Versicherung AG" }
          ]
        ]
      ]
    }
  }
}

getRating – Gesellschaftsbewertung

Liefert die detaillierte Bewertung einer Gesellschaft, gegliedert nach Kategorien.

ParameterPflichtBedeutung
spartejaMöglich sind: phv, rs, unf, wg, tie, hr
gesellschaftjaName der Gesellschaft, z.B. Domcura-Kiel
subidoptionalEinschränkung der Abfrage auf eine SUBID
v_idoptionalID des Vermittlers bzw. Untervermittlers

Aufbau der Rückgabe

FeldBedeutung
kategorien Die Bewertungskriterien, gruppiert nach Kategorie (z.B. Vertrag, Schaden). Der 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

FeldBedeutung
name Bezeichnung des Bewertungskriteriums, z.B. Angebotswesen
hilfe Erklärungstext zum Bewertungskriterium – kann leer sein
bewertung Die Bewertung als Schulnote von 1 bis 5: 1 = sehr gut … 5 = sehr schlecht.
bewertung_text Der Klartext zur Note, z.B. sehr gut, gut, mittelmäßig, schlecht, sehr schlecht
sterne Anzahl der gefüllten Sterne, 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
⚠ bewertung und sterne laufen gegenläufig
Beide Felder beschreiben dieselbe Bewertung, nur in umgekehrter Skala. Es gilt immer bewertung = 6 - sterne: 5 Sterne entsprechen der Note 1 (sehr gut), 1 Stern der Note 5 (sehr schlecht). Verwenden Sie sterne zusammen mit sterne_max für die Sterne-Anzeige und bewertung für Sortierung, Vergleich und Berechnungen.

Ist ein Kriterium nicht bewertet, werden bewertung, bewertung_text und sterne als Leerstring ausgeliefert – diese Werte also nicht ungeprüft als Zahl weiterverarbeiten.
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'gesellschaften' => array (
            'getRating' => array (
                array (
                    'sparte'       => 'phv',
                    'gesellschaft' => 'Domcura-Kiel',
                    'subid'        => '',
                ),
            ),
        ),
    ),
);
Response (gekürzt)
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,
              ),
              // ...
            ),
            // weitere Kategorien
          ),
          'bewertungstext' => '',
        ),
      ),
    ),
  ),
)

getTextAbout – Informationstext

Liefert den hinterlegten Informationstext zu einer Gesellschaft.

ParameterBedeutung
sparteMöglich sind: phv, rs, unf, wg, tie, hr
gesellschaftName der Gesellschaft
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'gesellschaften' => array (
            'getTextAbout' => array (
                array (
                    'sparte'       => 'phv',
                    'gesellschaft' => 'Domcura-Kiel',
                ),
            ),
        ),
    ),
);
Response
array (
  'response' =>
  array (
    'gesellschaften' =>
    array (
      'getTextAbout' =>
      array (
        0 =>
        array (
          'gesellschaft' => 'Interlloyd-Duesseldorf',
          'sparte'       => 'hr',
          'infotext'     => 'Die Interlloyd ist ein deutscher Versicherer.<br> Wir '
                          . 'arbeiten schon sehr lange mit dieser Gesellschaft zusammen ...',
        ),
        1 =>
        array (
          'gesellschaft' => 'Interlloyd-Duesseldorf',
          'sparte'       => 'phv',
          'infotext'     => 'Die Interlloyd ist ein deutscher Versicherer. ...',
        ),
        2 =>
        array (
          'gesellschaft' => 'VHV',
          'sparte'       => 'rs',
          'infotext'     => '',
          'notice'       => 'notFound',
        ),
      ),
    ),
  ),
)
⚠ Zwei Besonderheiten
Der infotext enthält HTML (z.B. <br>) – er darf also nicht escaped ausgegeben werden.
Existiert kein Text, kommt notice => notFound zurück und infotext ist leer. Das ist kein Fehler, sondern eine reguläre Antwort.
✉ Feedback
Fehler oder Unstimmigkeit in dieser Doku entdeckt? Schreiben Sie uns: ts@mr-money.de