Zum Hauptinhalt springen

Webhooks · Auf Anfrage

Ihr System erfährt es,ohne nachzufragen.

Webhooks melden Ereignisse an eine Adresse Ihres Systems: eine neue passende Ausschreibung, eine verschobene Frist, einen neuen Treffer Ihrer Suchaufträge. Den regelmäßigen Abruf braucht Ihr System dafür nicht. Webhooks erhalten Sie über ein individuelles Angebot.

Anfrage stellenDokumentation lesen

Ereignisse

Sechs Ereignisse.Sie wählen, welche kommen.

Je Zieladresse legen Sie Ereignisse, Filter und Suchaufträge fest. Jede Nachricht trägt den vollständigen Datensatz der Ausschreibung, ein zweiter Abruf entfällt.

Ausschreibungs-Ereignisse kommen bis zu eine Stunde, nachdem procuris die Änderung übernommen hat. Treffer kommen einmal am Morgen mit dem Lauf des Suchauftrags.

Neue Ausschreibung
tender.published
Eine Ausschreibung passt zu Ihren Filtern, weil sie neu ist oder eine Änderung sie passend gemacht hat.
Geänderte Ausschreibung
tender.updated
Ein Feld ändert sich, zum Beispiel Beschreibung, Lose oder Auftragswert. Die Nachricht nennt die geänderten Felder und ihre alten Werte.
Verschobene Frist
tender.deadline_changed
Die Angebots- oder Teilnahmefrist der Ausschreibung oder eines ihrer Lose ändert sich.
Ausschreibung beendet
tender.archived
Abgelaufen, aufgehoben, vergeben oder mit einem anderen Datensatz zusammengeführt.
Neuer Treffer
search.hit
Ein Suchauftrag findet einen neuen Treffer ab seiner Schwelle. Die Nachricht trägt die Passung von 0 bis 100.
Testnachricht
webhook.test
Lösen Sie in procuris selbst aus, um den Empfang zu prüfen.

So kommt es an

Ein POST mit JSONan Ihre Adresse.

Die Zustellung folgt der offenen Spezifikation Standard Webhooks. Für die Prüfung der Signatur gibt es fertige Bibliotheken.

  1. 01Adresse bereitstellenIhre IT stellt eine HTTPS-Adresse bereit, die aus dem Internet erreichbar ist und POST-Anfragen annimmt.
  2. 02Echtheit prüfenJede Nachricht ist mit HMAC-SHA256 signiert. Ihr System prüft die Signatur, bevor es die Nachricht verarbeitet.
  3. 03AntwortenIhr System antwortet innerhalb von 15 Sekunden mit Status 2xx. Gelingt das nicht, versucht procuris eine Nachricht bis zu zehnmal, über gut drei Tage.
  4. 04Selbst verwaltenZieladressen, Ereignisse und Secret verwaltet die Person mit der Rolle Inhaber in procuris. Verpasste Nachrichten der letzten 7 Tage sendet sie erneut.
{
  "type": "search.hit",
  "timestamp": "2026-09-18T05:00:00.000Z",
  "data": {
    "search": {
      "id": "3b1f6c2e-8f0a-4d7e-9a51-2c4e7d9b0f13",
      "name": "Brunnen und Wasserspiele Thüringen"
    },
    "fit": 82,
    "tender": {
      "id": "e9da30eb-50e6-47f1-887f-434016267b2f",
      "title": "Nordhausen - Sanierung Rolandbrunnen, Erneuerung Brunnentechnik",
      "submissionDate": "2026-10-07T08:00:00.000Z",
      "lastModified": "2026-09-17T14:05:12.000Z",
      "url": "https://www.procuris.eu/notices/nordhausen-sanierung-rolandbrunnen-erneuerung-brunnentechnik-e9da30eb"
    }
  }
}
Eine Nachricht zum Ereignis search.hit. Hier ist data.tender gekürzt, die echte Nachricht trägt den vollständigen Datensatz.

Webhook oder API

Webhooks melden,die API liefert den Bestand.

Webhooks passen, wenn Ihr System erreichbar ist und reagieren soll. Die API passt, wenn Ihr System nach eigenem Zeitplan abruft oder den vorhandenen Bestand braucht.

Webhooks passen für

  • neue Treffer an das zuständige Team geben
  • Verkaufschancen im CRM anlegen und nachziehen
  • verschobene Fristen in einen Kalender übernehmen

Die API passt für

  • Systeme hinter einer Firewall ohne eingehende Verbindungen
  • das einmalige Laden des vorhandenen Bestands
  • nächtliche Ladeläufe ins BI-Werkzeug
Zu API & Daten

Webhooks melden nur, was ab der Einrichtung passiert. Soll Ihr CRM alle Ausschreibungen zu Ihren Filtern führen, braucht es beides: die API für den Bestand, Webhooks für die Änderungen dazwischen.

Auf Anfrage

Ein Angebotfür Ihren Umfang.

API, Webhooks und individuelle Workflows erhalten Sie über ein individuelles Angebot. So kommen Sie dorthin.

  1. 01Anfrage stellenÜber das Kontaktformular. Nennen Sie, was Sie anbinden möchten, zum Beispiel neue Treffer ins CRM oder eine Nachricht in Teams.
  2. 02Gespräch über den UmfangWir klären, welche Leistungen Sie brauchen, welche Systeme Sie anbinden und wie oft Ihr System abruft.
  3. 03Individuelles AngebotZugeschnitten auf diesen Umfang. Soll procuris die Anbindung bauen, steht das im Angebot.
  4. 04EinrichtungNach Vertragsschluss richten wir den Zugang für Ihre Organisation ein. Danach verwaltet die Person mit der Rolle Inhaber Tokens und Zieladressen selbst in procuris.

Auf Anfrage

Ereignisse stattAbruf.

Nennen Sie uns das System, das reagieren soll. Wir klären den Umfang mit Ihnen und machen Ihnen ein individuelles Angebot.

Anfrage stellenDokumentation lesen