Dokumentation der API
Eigene Quellen
Eine Bank kann zwei Arten eigener Quellen in ihren Arbeitsbereich bringen, die Benachrichtigungen der Suchagenten ihrer eigenen Vergabeportalzugänge und einen Anbieter von Unternehmensdaten, den sie bereits lizenziert. Beide bleiben im Arbeitsbereich der Bank. Keine wird je einer anderen Bank gezeigt oder in die gemeinsame Recherchegrundlage übernommen, und Stonewake meldet sich nie für Sie bei einem Portal oder auf der Website eines Anbieters an. Beide sind noch nicht eingeschaltet.
Portalzugänge
- Ein Administrator legt in den Einstellungen unter Portalzugänge einen Portalzugang für ein Team an, und Stonewake zeigt einmal die eigene Adresse an,
t-gefolgt von 32 Buchstaben und Ziffern,@in.stonewake.ai. Tragen Sie sie als Empfänger eines Suchagenten im Portal ein. Kein Portalpasswort wird eingegeben oder gespeichert. - Nach dem Einschalten werden die Benachrichtigungen von e-Vergabe des Bundes, Vergabe.NRW und vergabe.bayern (RIB Tender) angenommen. Die Benachrichtigungen von Deutsches Vergabeportal, Vergabe24, Deutsches Ausschreibungsblatt, DTAD, HAD, vergabe.saarland, subreport und den Vergabemarktplätzen der Länder auf cosinex werden vorerst nicht angenommen.
- Eine Benachrichtigung wird nur gelesen, wenn sie nachweislich vom Portal kommt und die eigene Adresse dieses Zugangs als Empfänger nennt. Der Eingangsserver entfernt jedes Authentifizierungsergebnis, das ein Absender geschrieben hat, und hält dann fest, wie sich der Absender ausgewiesen hat (SPF und DKIM). Eine Mail, die nicht nachweislich vom Portal kommt oder die das Portal an eine andere Adresse gerichtet hat, wird mit dem Grund festgehalten, und nichts davon wird gelesen.
- Aus einer geprüften Benachrichtigung wird jede Bekanntmachung, die das Portal mit seinem eigenen Bekanntmachungslink und einem Titel nennt, zu einer Bekanntmachung des Teams, mit Kennung, Titel, Veröffentlichungsdatum, Frist und dem Link des Portals. Namen von Auftraggebern und die übrigen Zellen werden nicht gespeichert. Text, Betreff, Adressen und Anhänge einer Mail werden nie im Arbeitsbereich aufbewahrt.
- Jede Bekanntmachung wird ein Ausschreibungstreffer des Teams, ausgewählt vom Suchagenten des Portals selbst, und die Suchprofile des Teams beurteilen sie ebenfalls. Siehe Suchprofile und Treffer für Ausschreibungen.
- Eine Mail ist höchstens 2 MB groß. Eine Adresse lässt sich sofort ersetzen oder der Zugang beenden, und Mail an eine alte Adresse wird verworfen und gezählt. Die Schaltfläche Testen zeigt, wie viele Benachrichtigungen angekommen sind und was sie gebracht haben, nur als Zahlen.
Lizenzierte Unternehmensdaten
- Ein Administrator bindet in den Einstellungen unter Lizenzierte Daten einen Anbieter von Unternehmensdaten an, den die Bank bereits lizenziert, mit dem eigenen Schlüssel der Bank, dem Lizenzumfang und dem monatlichen Kontingent aus dem Vertrag der Bank, und bestätigt, dass der Vertrag einem Dienstleister erlaubt, den Schlüssel für die Bank zu nutzen. Der Schlüssel wird verschlüsselt und nur für diese Bank gespeichert und nie wieder angezeigt.
- Nach dem Einschalten lässt sich North Data anbinden, gebaut auf seiner öffentlichen Schnittstellendokumentation. Creditreform und Bureau van Dijk Orbis sind aufgeführt, lassen sich aber noch nicht anbinden.
- Ein Analyst ruft ein Unternehmen über seine deutsche Registernummer mit Gericht ab. Der Wert bleibt im Arbeitsbereich der Bank, nennt seinen Anbieter, die Quellenseite des Anbieters und den Zeitpunkt des Abrufs und wird einem Unternehmen nur über die Registernummer oder den LEI zugeordnet, die der Anbieter nennt, nie über den Namen.
- Jeder Abruf zählt gegen das monatliche Kontingent, das die Bank angibt, ein Unternehmen je Kalendermonat, so wie der Anbieter abrechnet. Ist das Kontingent verbraucht, wird bis zum nächsten Monat kein weiteres Unternehmen abgerufen. Ein Abruf wird einmal gesendet und nie von selbst wiederholt.
- Die Schaltfläche Testen fragt mit dem eigenen Schlüssel der Bank beim Anbieter an und zeigt, ob der Anbieter ihn angenommen hat. Ein Test ruft kein Unternehmen ab und zählt höchstens einmal im Monat als ein Abruf des monatlichen Kontingents.
- Nennt der Anbieter eine natürliche Person oder einen Einzelunternehmer, wird keiner seiner Werte gespeichert.
- Werte, die unter dem Lizenzumfang abgerufen wurden, der auch die eigenen Systeme der Bank abdeckt, werden auch über die API und MCP ausgeliefert (
GET /v1/licensed-data/facts, das Werkzeuglicensed_facts). Werte unter den übrigen Umfängen bleiben im Dashboard. - Der Demonstrationsarbeitsbereich antwortet mit dem veröffentlichten Beispiel des Anbieters und ruft nie einen Anbieter ab.
Was nie geschieht
- Keine Anmeldung für Sie bei einem Portal oder auf der Website eines Anbieters und kein Lesen ihrer Webseiten.
- Keine Bekanntmachung aus einem Portal und kein lizenzierter Wert in der gemeinsamen Recherchegrundlage, im Arbeitsbereich einer anderen Bank oder in einem öffentlichen Kurzbericht.
- Keine Adresse, kein Schlüssel und kein Zugangsdetail über die API oder MCP.