{
  "openapi": "3.1.0",
  "info": {
    "title": "ZertLotse: Anfrage-Schnittstelle und Daten-Abrufe",
    "version": "1.2.0",
    "summary": "Anfrage zur ISO-9001- oder ISO-14001-Zertifizierung stellen, auch durch KI-Assistenten im Auftrag einer Person.",
    "description": "Über diese Schnittstelle stellen Interessenten oder KI-Assistenten (z. B. ChatGPT, Claude, Gemini) in ihrem Auftrag eine Anfrage an ZertLotse. Jede Anfrage wird gespeichert und per E-Mail an das Beratungsteam weitergeleitet. Werktags antworten wir in der Regel innerhalb einer Stunde, am liebsten mit einem Anruf, um das weitere Vorgehen zu besprechen.\n\nRegeln: Nur im Auftrag und mit Einverständnis der anfragenden Person senden. Echte, erreichbare Kontaktdaten dieser Person angeben (E-Mail-Adresse, ersatzweise Telefonnummer). Keine Werbung, keine Probe-Anfragen; Beispieldaten (z. B. @example.com) werden abgelehnt. Preise vorab ohne Anfrage: https://www.zertlotse.de/daten/iso-9001-preise.json\n\nDaten-Abrufe (nur lesen, ohne Anmeldung): Alle Dateien der Website sind statisch und per GET abrufbar. Der Katalog https://www.zertlotse.de/daten/index.json nennt jede Datei mit Feldern, Stand, Quelle, Lizenz und Größe. Zu Reinigungs-Ausschreibungen gibt es offene Verfahren, Verträge je Auftraggeber und Vertragsenden je Bundesland.",
    "contact": {
      "name": "ZertLotse",
      "email": "beratung@zertlotse.de",
      "url": "https://www.zertlotse.de/kontakt"
    }
  },
  "servers": [
    {
      "url": "https://www.zertlotse.de"
    }
  ],
  "paths": {
    "/api/anfrage": {
      "get": {
        "operationId": "anfrageBeschreibung",
        "summary": "Kurzbeschreibung der Schnittstelle (Felder, Beispiel, Regeln)",
        "responses": {
          "200": {
            "description": "Beschreibung als JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "anfrageStellen",
        "summary": "Anfrage stellen",
        "description": "Stellt eine Anfrage im Auftrag einer Person. Pflicht: E-Mail (email) oder Telefon (telefon) der Person; Firma (firma) und Ansprechpartner (name) bitte immer mitschicken. Kopf Content-Type: application/json setzen. Antwort enthält eine Bestätigung zum Weitergeben.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Anfrage"
              },
              "example": {
                "firma": "Muster Reinigung GmbH",
                "name": "Erika Muster",
                "email": "erika.muster@example.com",
                "telefon": "040 123456",
                "nachricht": "ISO 9001 für unsere Gebäudereinigung, 12 Mitarbeiter (Vollzeit), öffentliche Ausschreibung mit Abgabefrist 15.12.",
                "interesse": "ISO 9001",
                "agent": "Claude"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Anfrage"
              }
            },
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Anfrage"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Anfrage eingegangen: gespeichert und per E-Mail weitergeleitet (bzw. vorgemerkt).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erfolg"
                }
              }
            }
          },
          "303": {
            "description": "Nur für normale Formular-Absendungen aus dem Browser (Accept: text/html): Weiterleitung auf /danke bzw. /anfrage-nicht-gesendet."
          },
          "403": {
            "description": "Browser-Absendung von einer fremden Website (Origin). Gespeichert und gesichtet, aber nicht sofort weitergeleitet. KI-Assistenten senden serverseitig ohne Origin-Kopf.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          },
          "413": {
            "description": "Anfrage größer als 1 MB. Der Anfang ist gespeichert; bitte kürzen.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          },
          "422": {
            "description": "Kein gültiger Kontaktweg (fehler unvollstaendig), Beispieldaten (beispieldaten) oder nicht lesbar (unlesbar). Gespeichert, aber nicht weitergeleitet; bitte korrigieren und erneut senden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen in kurzer Zeit (je Anschluss). Meist trotzdem gespeichert (Feld gespeichert).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          },
          "500": {
            "description": "Unerwarteter Fehler bei der Verarbeitung (fehler technik). Die Rohdaten werden nach Möglichkeit gespeichert (Feld gespeichert); bitte erneut senden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          },
          "503": {
            "description": "Technische Störung: weder gespeichert noch weitergeleitet (fehler technik). Bitte später erneut senden oder an beratung@zertlotse.de schreiben.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fehler"
                }
              }
            }
          }
        }
      }
    },
    "/daten/index.json": {
      "get": {
        "operationId": "datenKatalog",
        "tags": [
          "Daten"
        ],
        "summary": "Katalog aller Daten-Abrufe",
        "description": "Alle Dateien der Website mit Beschreibung, Feldern, Stand, Quelle, Lizenz, Adressen und Größe. Einstieg für alle weiteren Lese-Adressen.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/offen.json": {
      "get": {
        "operationId": "reinigungOffenJson",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Reinigungs-Ausschreibungen in Deutschland (JSON)",
        "description": "Je offenem Verfahren, EU-weit und national: Nummer, Frist, Titel, Auftraggeber, Ort, Bundesland, ISO 9001 erwähnt, Seite, amtliche Bekanntmachung. EU-weit dazu Satz mit ISO 9001, Veröffentlichung, Laufzeit, Verlängerung, Teil-Aufträge, geschätzter Wert, Frist für Fragen; national: in der Liste seit.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/offen.csv": {
      "get": {
        "operationId": "reinigungOffenCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Reinigungs-Ausschreibungen in Deutschland (CSV)",
        "description": "Dieselben Zeilen wie offen.json als Tabelle. Trennzeichen Semikolon, UTF-8. Je Zeile Stand, Quelle und Lizenz. Die bisherigen Spalten behalten ihre Reihenfolge, neue stehen dahinter. schaetzwert nur als Zahl; schaetzwert_je_teil_auftrag „ja“: Werte nur je Teil-Auftrag.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/offen.md": {
      "get": {
        "operationId": "reinigungOffenMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Reinigungs-Ausschreibungen in Deutschland (Markdown)",
        "description": "Dieselben Zeilen zum Lesen: Antwort oben, dann je Bundesland eine Tabelle. Ausgelegt auf weniger als 100.000 Zeichen; Laufzeit, Teil-Aufträge und geschätzter Wert stehen deshalb in den Dateien je Bundesland, in offen.csv und offen.json.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/offen-{land}.md": {
      "get": {
        "operationId": "reinigungOffenLandMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Reinigungs-Ausschreibungen eines Bundeslands (Markdown)",
        "description": "Kurze Datei mit den offenen Reinigungs-Ausschreibungen eines Bundeslands, EU-weit und national, die nächste Frist zuerst. Mit Laufzeit, Zahl der Teil-Aufträge und geschätztem Wert laut Bekanntmachung.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/offen-{land}.csv": {
      "get": {
        "operationId": "reinigungOffenLandCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Reinigungs-Ausschreibungen eines Bundeslands (CSV)",
        "description": "Dieselben Spalten wie offen.csv, nur die Zeilen eines Bundeslands, EU-weit und national. Trennzeichen Semikolon, UTF-8. Je Zeile Stand, Quelle und Lizenz.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/auftraggeber.json": {
      "get": {
        "operationId": "reinigungAuftraggeberVerzeichnisJson",
        "tags": [
          "Daten"
        ],
        "summary": "Verzeichnis der öffentlichen Auftraggeber für Gebäudereinigung (JSON)",
        "description": "Alle Auftraggeber mit Name, Sitz, Bundesland, Zahl der Verfahren und der vergebenen Aufträge, dazu Kurzname, Seite und Datei, wenn es sie gibt.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/auftraggeber.csv": {
      "get": {
        "operationId": "reinigungAuftraggeberVerzeichnisCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Verzeichnis der öffentlichen Auftraggeber für Gebäudereinigung (CSV)",
        "description": "Dasselbe Verzeichnis als Tabelle. Trennzeichen Semikolon, UTF-8.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/auftraggeber.md": {
      "get": {
        "operationId": "reinigungAuftraggeberKurznamenMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Kurznamen der Auftraggeber mit eigener Seite (Markdown, kurz)",
        "description": "Kurze Nachschlage-Datei: nur die Auftraggeber mit eigener Seite, nach Name, mit Sitz, Bundesland und Kurzname. Mit dem Kurznamen ergeben sich Seite und Datei des Auftraggebers.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/auftraggeber/{kurzname}.json": {
      "get": {
        "operationId": "reinigungAuftraggeber",
        "tags": [
          "Daten"
        ],
        "summary": "Reinigungsaufträge eines Auftraggebers",
        "description": "Wer laut Bekanntmachung für diesen Auftraggeber reinigt und wann die Laufzeit endet: je Vertrag Objekt, Ort, Auftragnehmer, Wert, Angebote, Beginn, Ende, Verlängerung im Wortlaut, Nummer und Link. Dazu offene Ausschreibungen.",
        "parameters": [
          {
            "name": "kurzname",
            "in": "path",
            "required": true,
            "description": "Kurzname des Auftraggebers aus der kurzen Datei /daten/gebaeudereinigung/auftraggeber.md oder aus dem Verzeichnis /daten/gebaeudereinigung/auftraggeber.json, zum Beispiel landeshauptstadt-hannover.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]*$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/{land}.json": {
      "get": {
        "operationId": "reinigungLandJson",
        "tags": [
          "Daten"
        ],
        "summary": "Gebäudereinigung in einem Bundesland: Vertragsenden und offene Ausschreibungen (JSON)",
        "description": "Die vergebenen Reinigungsaufträge, deren Laufzeit laut Bekanntmachung in den nächsten 24 Monaten endet, eine Zeile je Vertrag, und die offenen EU-weiten Ausschreibungen des Landes.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/{land}.csv": {
      "get": {
        "operationId": "reinigungLandCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Gebäudereinigung in einem Bundesland: Vertragsenden (CSV)",
        "description": "Die Verträge des Landes mit Ende der Laufzeit in den nächsten 24 Monaten als Tabelle, eine Zeile je Vertrag. Trennzeichen Semikolon, UTF-8.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/unterlagen.json": {
      "get": {
        "operationId": "reinigungUnterlagenJson",
        "tags": [
          "Daten"
        ],
        "summary": "Fundstellen in Vergabeunterlagen offener Reinigungs-Ausschreibungen (JSON)",
        "description": "Je Ausschreibung mit automatisch gelesenen Unterlagen: Zustand, Lesedatum, Fassung, Dateien und die Fundstellen zu ISO 9001 und Qualitätsmanagement im Wortlaut mit Datei und Seite; dazu eingeschaltete weitere Angaben (Feld angaben) und Dateinamen (Feld dateienNachNamen). Keine Einstufung.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Hinweis, Quelle und Nutzung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/unterlagen.md": {
      "get": {
        "operationId": "reinigungUnterlagenMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Fundstellen in Vergabeunterlagen offener Reinigungs-Ausschreibungen (Markdown)",
        "description": "Dieselben Ausschreibungen zum Lesen: je Ausschreibung die erste Fundstelle zu ISO 9001 und zum Qualitätsmanagement mit Datei und die Zahl der weiteren. Unter 98.000 Zeichen; alle Fundstellen in unterlagen.json.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Hinweis, Quelle und Nutzung.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/gebaeudereinigung/unterlagen-angaben.md": {
      "get": {
        "operationId": "reinigungUnterlagenAngabenMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Weitere Angaben aus Vergabeunterlagen offener Reinigungs-Ausschreibungen (Markdown)",
        "description": "Je Ausschreibung mit mindestens einer Stelle: je eingeschalteter Angabe ein ganzer Satz im Wortlaut bis 240 Zeichen mit Datei und Seite, zur Besichtigung auch ein Satz mit Datum, und die Zahl aller Stellen. Unter 98.000 Zeichen; alle Stellen in unterlagen.json.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Hinweis, Quelle und Nutzung.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen.json": {
      "get": {
        "operationId": "bewachungOffenJson",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen in Deutschland (JSON)",
        "description": "Je offenem Verfahren, EU-weit und national: Nummer, Frist, Titel, Auftraggeber, Ort, Art der Bewachung. EU-weit dazu, was die Bekanntmachung nennt (zum Beispiel DIN 77200, § 34a GewO), je mit Rubrik und Satz im Wortlaut, ohne Einstufung, ob es verlangt ist.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen.csv": {
      "get": {
        "operationId": "bewachungOffenCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen in Deutschland (CSV)",
        "description": "Dieselben Zeilen als CSV mit Semikolon und BOM. Am Ende die Spalten merkmale (Kennwörter) und merkmale_ausgewertet (ja, nein, bei nationalen Verfahren leer).",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen.md": {
      "get": {
        "operationId": "bewachungOffenMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen in Deutschland (Markdown)",
        "description": "Alle offenen Bewachungs-Ausschreibungen in einer Datei zum Lesen, nach Bundesland gegliedert, mit der Spalte „Die Bekanntmachung nennt“.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen-{land}.json": {
      "get": {
        "operationId": "bewachungOffenLandJson",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen eines Bundeslands (JSON)",
        "description": "Dieselben Felder wie offen.json, nur die Verfahren mit Ort der Leistung in diesem Bundesland.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue. Die Datei gibt es nur für Bundesländer mit offenen Verfahren.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen-{land}.csv": {
      "get": {
        "operationId": "bewachungOffenLandCsv",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen eines Bundeslands (CSV)",
        "description": "Dieselben Spalten wie offen.csv, nur die Verfahren mit Ort der Leistung in diesem Bundesland.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue. Die Datei gibt es nur für Bundesländer mit offenen Verfahren.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/sicherheitsdienst/offen-{land}.md": {
      "get": {
        "operationId": "bewachungOffenLandMarkdown",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Bewachungs-Ausschreibungen eines Bundeslands (Markdown)",
        "description": "Kurze Datei mit den offenen Bewachungs-Ausschreibungen eines Bundeslands, EU-weit und national, die nächste Frist zuerst, mit Laufzeit, Teil-Aufträgen und geschätztem Wert.",
        "parameters": [
          {
            "name": "land",
            "in": "path",
            "required": true,
            "description": "Bundesland in Kleinbuchstaben mit Bindestrich und ae, oe, ue. Die Datei gibt es nur für Bundesländer mit offenen Verfahren.",
            "schema": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/zuschlaege-{branche}.json": {
      "get": {
        "operationId": "zuschlaegeBranche",
        "tags": [
          "Daten"
        ],
        "summary": "Zuschläge einer Branche",
        "description": "Kennzahlen aus bis zu zwölf Monaten und alle bekanntgemachten Zuschläge des jüngsten vollständigen Monats, mit Link zur Bekanntmachung.",
        "parameters": [
          {
            "name": "branche",
            "in": "path",
            "required": true,
            "description": "Kurzname der Branche, zum Beispiel gebaeudereinigung oder it. Alle Branchen nennt /daten/index.json.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/iso-9001-gefordert.json": {
      "get": {
        "operationId": "iso9001Einzelliste",
        "tags": [
          "Daten"
        ],
        "summary": "Offene Verfahren mit ISO-9001-Nennung",
        "description": "Einzelliste der offenen Verfahren, deren Bekanntmachung ISO 9001 ausdrücklich nennt, alle Branchen. Eine Nennung belegt keine Pflicht zum Zertifikat.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/iso-9001-ausschreibungen.json": {
      "get": {
        "operationId": "iso9001Datenreport",
        "tags": [
          "Daten"
        ],
        "summary": "ISO-9001-Nennungen in TED-Bekanntmachungen je Branche",
        "description": "Je Branche die Zahl der Bekanntmachungen und der Anteil mit ISO-9001-Nennung. Eine Nennung belegt keine Pflicht zum Zertifikat.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/branchen-barometer.json": {
      "get": {
        "operationId": "branchenBarometer",
        "tags": [
          "Daten"
        ],
        "summary": "Branchen-Barometer öffentliche Ausschreibungen",
        "description": "Je Branche: offene Verfahren, neue in sieben Tagen, ISO-9001-Nennungen, mittlerer Vorlauf bis zur Abgabefrist.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/ausschreibungen-zahlen.json": {
      "get": {
        "operationId": "ausschreibungenZahlen",
        "tags": [
          "Daten"
        ],
        "summary": "ISO 9001 in Reinigungs-Ausschreibungen: Zahlen aus Bekanntmachungen und Vergabeunterlagen",
        "description": "Wie viele offene Reinigungs-Ausschreibungen ISO 9001 in der Bekanntmachung und in den gelesenen Vergabeunterlagen nennen, dazu Qualitätsmanagement ohne ISO 9001 und Sicherheitsdienste. Je Zahl Nenner und Stand.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    },
    "/daten/iso-9001-preise.json": {
      "get": {
        "operationId": "preise",
        "tags": [
          "Daten"
        ],
        "summary": "Preise von ZertLotse",
        "description": "Festpreise für die Zertifizierung nach ISO 9001 und ISO 14001 je Betriebsgröße und Branche.",
        "responses": {
          "200": {
            "description": "Die Datei. Sie nennt Stand, Quelle und Lizenz.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Diese Datei gibt es nicht."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Anfrage": {
        "type": "object",
        "properties": {
          "firma": {
            "type": "string",
            "maxLength": 200,
            "description": "Firma der anfragenden Person (bitte immer angeben)"
          },
          "name": {
            "type": "string",
            "maxLength": 160,
            "description": "Ansprechpartner, Vor- und Nachname (bitte immer angeben)"
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 200,
            "description": "E-Mail-Adresse der anfragenden Person für die Antwort (Pflicht, ersatzweise telefon)"
          },
          "telefon": {
            "type": "string",
            "maxLength": 60,
            "description": "Telefonnummer für den Rückruf (optional, ersetzt notfalls die E-Mail-Adresse)"
          },
          "nachricht": {
            "type": "string",
            "maxLength": 20000,
            "description": "Anliegen in eigenen Worten: Branche, Mitarbeiterzahl (Vollzeit ganz, Teilzeit halb, ohne Minijobber), gewünschte Norm, Anlass (Ausschreibung, Kundenanforderung, Wechsel) und ggf. Abgabefrist"
          },
          "interesse": {
            "type": "string",
            "maxLength": 200,
            "description": "Thema in Stichworten, z. B. „ISO 9001“, „ISO 14001“, „Wechsel der Zertifizierungsstelle“"
          },
          "agent": {
            "type": "string",
            "maxLength": 160,
            "description": "Name des KI-Assistenten, der im Auftrag sendet (z. B. „ChatGPT“, „Claude“, „Gemini“)"
          }
        },
        "additionalProperties": true,
        "description": "Eine Anfrage. Nötig ist ein Kontaktweg der anfragenden Person: email oder telefon. Firma und Ansprechpartner sollten immer dabei sein. Gängige andere Feldnamen (company, email_address, phone_number, contact.email …) werden ebenfalls verstanden.",
        "anyOf": [
          {
            "required": [
              "email"
            ]
          },
          {
            "required": [
              "telefon"
            ]
          }
        ]
      },
      "Erfolg": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "const": true
          },
          "id": {
            "type": "string",
            "description": "Kennung der gespeicherten Anfrage"
          },
          "vorgang": {
            "type": "string",
            "description": "Kurzform der Kennung für Rückfragen"
          },
          "gespeichert": {
            "type": "boolean",
            "description": "true: die Anfrage liegt im Anfrage-Speicher"
          },
          "benachrichtigung": {
            "type": "string",
            "enum": [
              "gesendet",
              "laeuft",
              "ausstehend",
              "doppelt",
              "aus (Test-Modus)"
            ],
            "description": "Stand der E-Mail an das Beratungsteam: gesendet; laeuft (wird gerade zugestellt); ausstehend (gespeichert, Zustellung wird automatisch wiederholt); doppelt (dieselbe Anfrage kam schon an)"
          },
          "nachricht": {
            "type": "string",
            "description": "Bestätigung auf Deutsch, zum Weitergeben an die anfragende Person"
          },
          "hinweise": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "test": {
            "type": "boolean",
            "description": "true nur im internen Test-Modus (dann keine Mail)"
          }
        },
        "required": [
          "success",
          "id"
        ]
      },
      "Fehler": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "const": false
          },
          "gespeichert": {
            "type": "boolean",
            "description": "true: die Anfrage ist trotzdem gespeichert"
          },
          "id": {
            "type": "string"
          },
          "fehler": {
            "type": "string",
            "enum": [
              "unvollstaendig",
              "beispieldaten",
              "unlesbar",
              "herkunft",
              "zu_viele",
              "zu_gross",
              "technik"
            ],
            "description": "Kürzel des Fehlers"
          },
          "fehlend": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "nachricht": {
            "type": "string",
            "description": "Erklärung auf Deutsch"
          },
          "vorgang": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "fehler",
          "nachricht"
        ]
      }
    }
  },
  "security": [],
  "tags": [
    {
      "name": "Anfrage",
      "description": "Eine Anfrage an ZertLotse stellen."
    },
    {
      "name": "Daten",
      "description": "Statische Dateien zum Lesen: Ausschreibungen, Auftraggeber, Zuschläge. Katalog: /daten/index.json"
    }
  ]
}
