Datenmodell

Ein Datensatz je Ausschreibung ist das Ziel, keine Garantie. Erscheint eine Bekanntmachung auf mehreren Portalen, führt procuris sie zu einem Datensatz zusammen. Erkennt procuris eine Dublette erst später, archiviert es den jüngeren Datensatz mit archiveReason gleich merged und nennt in mergedInto die id des Datensatzes, der bestehen bleibt.

Berichtigungen ändern den bestehenden Datensatz, statt einen neuen anzulegen. Berichtigungen und Änderungsbekanntmachungen behalten die id und bekommen ein neues lastModified. procuris löscht keine Datensätze, sondern archiviert sie. Abgelaufene, aufgehobene, vergebene oder zusammengeführte Ausschreibungen bekommen den Status archived.

Liste, Einzelabruf und Webhooks liefern dieselben vollständigen Datensätze. Die Schlüssel sind in camelCase geschrieben (Wortanfänge ab dem zweiten Wort groß, zum Beispiel lastModified).

Vollständiges Beispiel

Das Beispiel zeigt den Musterdatensatz dieser Doku mit Stand 1. Oktober 2026. Die Vergabestelle veröffentlichte die Bekanntmachung am 17. September ohne Auftragswert. Bis zum 22. September stand darum eine Schätzung im Datensatz. Am 22. September nannte die Vergabestelle den Auftragswert von 351.000 Euro, und am 24. September verschob sie die Angebotsfrist.

{
  "id": "e9da30eb-50e6-47f1-887f-434016267b2f",
  "status": "open",
  "archiveReason": null,
  "mergedInto": null,
  "title": "Nordhausen - Sanierung Rolandbrunnen, Erneuerung Brunnentechnik",
  "description": "Erneuerung der Brunnentechnik des Rolandbrunnens in Nordhausen. Los 1 umfasst Pumpen und Steuerung, Los 2 die Beckenabdichtung.",
  "tenderNumber": "33/61/2026",
  "url": "https://www.procuris.eu/notices/nordhausen-sanierung-rolandbrunnen-erneuerung-brunnentechnik-e9da30eb",
  "publicationDate": "2026-09-17T13:32:56.000Z",
  "submissionDate": "2026-10-14T08:00:00.000Z",
  "participationDeadline": null,
  "lastModified": "2026-09-24T09:10:00.000Z",
  "checkedAt": "2026-10-01T06:00:00.000Z",
  "contractAmount": {
    "value": 351000,
    "currency": "EUR",
    "estimated": false
  },
  "procedureType": "open",
  "contractNature": "works",
  "legislation": null,
  "organizations": [
    {
      "id": "7c2a9e41-3d8b-4f6a-b1e2-5a0c9d4e8f17",
      "name": "Stadtverwaltung Nordhausen - Vergabestelle",
      "role": "contractingParty",
      "contactName": "Vergabestelle",
      "email": "vergabe@example.org",
      "phone": "+49 3631 000000",
      "address": {
        "street": "Musterstraße 1",
        "postalCode": "99734",
        "city": "Nordhausen",
        "countryCode": "DE"
      }
    }
  ],
  "cpvClassifications": [
    {
      "cpvCode": "45000000",
      "title": "Bauarbeiten"
    },
    {
      "cpvCode": "71000000",
      "title": "Architektur & Ingenieurwesen"
    }
  ],
  "regionCodes": ["DEG"],
  "realizedLocation": "Nordhausen",
  "lots": [
    {
      "lotNumber": "1",
      "title": "Pumpen und Steuerung",
      "description": "Lieferung und Einbau der Umwälzpumpen und der Brunnensteuerung.",
      "contractAmount": {
        "value": 212000,
        "currency": "EUR",
        "estimated": true
      },
      "submissionDate": null,
      "cpvClassifications": [
        {
          "cpvCode": "45232150",
          "title": "Arbeiten an Wasserleitungen"
        }
      ]
    },
    {
      "lotNumber": "2",
      "title": "Beckenabdichtung",
      "description": null,
      "contractAmount": null,
      "submissionDate": null,
      "cpvClassifications": []
    }
  ],
  "sources": [
    {
      "name": "TED",
      "url": "https://ted.europa.eu/de/notice/-/detail/000000-2026",
      "publishedAt": "2026-09-17T13:32:56.000Z"
    }
  ]
}

Titel, Vergabenummer, Termine und CPV-Codes stammen aus einer echten Bekanntmachung. Kontakt, Lose, Region und Quelle sind zur Veranschaulichung ergänzt. Die Kontaktdaten sind Platzhalter.

Grundregeln

• Fehlende Werte stehen als null, nicht als fehlender Schlüssel. „oder null“ in den Tabellen heißt: der Schlüssel steht im Datensatz, ohne Wert. Bei Angaben aus der Bekanntmachung hat die Vergabestelle den Wert meist nicht veröffentlicht. Bei archiveReason, mergedInto, contractAmount und den Feldern der Lose sagt die Tabelle, was null dort bedeutet. Eine leere Liste [] heißt dasselbe für Listen.
• Zeitpunkte stehen in UTC nach ISO 8601, zum Beispiel 2026-10-14T08:00:00.000Z.
• lastModified ist der Zeitpunkt der letzten inhaltlichen Änderung bei procuris. Gemeint ist nicht der Zeitpunkt bei der Vergabestelle. Der Wert steigt nur.
• checkedAt ist der Datenstand, also wann procuris den Datensatz zuletzt geprüft hat. Ein neues checkedAt allein ist keine inhaltliche Änderung. Es ändert lastModified nicht und löst kein Ereignis aus.
• Unbekannte Felder und Werte übergehen. Neue Felder und Werte können dazukommen, zum Beispiel ein neuer Wert für archiveReason. Lassen Sie Ihr System beides übergehen, statt abzubrechen, weil ein Abbruch den Abgleich bis zur nächsten Anpassung anhält.

Felder der Ausschreibung

eForms ist das EU-Format für Bekanntmachungen. Die Codelisten veröffentlicht das Amt für Veröffentlichungen der EU.

Auftragswert

Geschätzt sein kann nur der Auftragswert. Das gilt für die Ausschreibung und für die Lose. Gibt es weder einen veröffentlichten noch einen geschätzten Wert, ist contractAmount gleich null.

Organisationen

address hat diese Felder:

Lose

Lose sind Teile einer Ausschreibung, auf die Sie einzeln bieten können.

Quellen

Erscheint eine Ausschreibung auf mehreren Portalen, hat sie mehrere Einträge in sources.

So verarbeiten Sie die Felder

• Legen Sie Datensätze über id an und aktualisieren Sie sie über dieselbe id. So entsteht in Ihrem System je id ein Eintrag. Dubletten, die procuris erst später erkennt, lösen Sie über merged auf (übernächster Punkt).
• Überschreiben Sie einen Datensatz nur, wenn das neue lastModified größer ist als das gespeicherte. Sonst überschreibt eine verspätet zugestellte Webhook-Nachricht einen neueren Stand.
• Kommt ein Datensatz mit archiveReason gleich merged, führen Sie ihn in Ihrem System mit dem Datensatz aus mergedInto zusammen. Fehlt der bleibende Datensatz in Ihrem System, holen Sie ihn mit API-Zugang per GET /v1/tenders/{mergedInto}. Ohne API-Zugang, wenn Ihr System nur Webhooks empfängt (Variante B unter CRM und ERP), schließen Sie den alten Eintrag und vermerken mergedInto an ihm. Die bleibende Ausschreibung kommt erst in Ihr System, wenn ein Ereignis zu ihr kommt. In Variante B ist das der Fall, wenn sie Treffer eines gewählten Suchauftrags ist oder als früherer Treffer ein Änderungsereignis bekommt.
• Zeigen Sie bei estimated: true den Auftragswert als Schätzung an, damit niemand mit dem Betrag rechnet, als wäre er veröffentlicht.

Verwandte Seiten

• API
• Filter und Takt
• Webhooks: Ereignisse