Entwickler

Ein Aufruf. Das amtliche Dokument.

Govreader läuft auf der API von Wealthreader: HTTPS, Formularparameter und JSON-Antwort. Wer Wealthreader schon integriert, kann auch Govreader integrieren.

  1. Abfrage starten

    Senden Sie Ihren API-Schlüssel und den Dokumentcode. Die Antwort enthält die Sitzung und den QR-Code, den die betroffene Person mit Cl@ve bestätigen muss.

    curl https://api.wealthreader.com/entities/ \
  -d api_key=$API_KEY \
  -d code=declaracion_renta

  2. Die Person bestätigt

    Ihr Kunde scannt den Code mit der Cl@ve-App und bestätigt. Sie wiederholen den Aufruf mit der Sitzung, um das Ergebnis abzuholen.

    curl https://api.wealthreader.com/entities/ \
  -d api_key=$API_KEY \
  -d code=declaracion_renta \
  -d session=$SESSION \
  -d otp=PUSH

  3. Antwort erhalten

    Normalisierte Daten und das Originaldokument als Base64, bereit für Ihre Akte.

    Beispiel mit der Einkommensteuererklärung. Die Werte sind illustrativ.

    {
  "success": true,
  "payload": {
    "tax_returns": [
      {
        "model": "100",
        "fiscal_year": 2025,
        "filing_date": "2026-05-14",
        "filing_type": "individual",
        "result_amount": -1284.36,
        "secure_verification_code": "QJ7M4KXT9PLD2WHV",
        "xml_file": "PD94bWwgdmVyc2lvbj0i…",
        "pdf_file": "JVBERi0xLjcK…"
      }
    ]
  }
}

Für den Produktivbetrieb gebaut

Ein einheitlicher Vertrag

Dieselben Parameter und dieselbe Antwortstruktur für alle Behörden.

Fehler mit Aussagekraft

Dokumentierte Codes, die einen nicht bestätigten Zugriff, eine Behörde in Wartung oder einen zeitversetzt erstellten Bericht unterscheiden.

Zeitversetzte Berichte

Einige Behörden, etwa der Banco de España, liefern den Bericht nicht sofort. Die API teilt es Ihnen mit, und Sie holen ihn ab, sobald er bereit ist.

Öffentliche Dokumentation

Vollständige API-Referenz mit den Antwortschemata und den Fehlercodes.

API-Referenz öffnen Zugang anfragen

Erleben Sie Govreader mit den Dokumenten Ihrer Branche

Wir zeigen Ihnen den vollständigen Ablauf – Identifikation, Abfrage und Antwort – anhand der Fälle, die Sie am meisten interessieren.

Demo anfragen