Sviluppatori

Una chiamata. Il documento ufficiale.

Govreader opera sull’API di Wealthreader: HTTPS, parametri di modulo e risposta JSON. Se integra già Wealthreader, sa già integrare Govreader.

  1. Avvii la consultazione

    Invii la Sua chiave API e il codice del documento. La risposta include la sessione e il codice QR che il titolare deve approvare con Cl@ve.

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

  2. Il titolare approva

    Il Suo cliente scansiona il codice con l’app Cl@ve e conferma. Lei ripete la chiamata con la sessione per ritirare il risultato.

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

  3. Riceva la risposta

    Dati normalizzati e documento originale codificato in Base64, pronti per il Suo fascicolo.

    Esempio con la dichiarazione dei redditi. I valori sono illustrativi.

    {
  "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…"
      }
    ]
  }
}

Pensata per la produzione

Un unico contratto

Gli stessi parametri e la stessa struttura di risposta per tutti gli enti.

Errori con un significato

Codici documentati che distinguono un accesso non approvato, un ente in manutenzione o un rapporto emesso in differita.

Rapporti in differita

Alcuni enti, come il Banco de España, non consegnano il rapporto all’istante. L’API Le segnala la situazione e Lei lo ritira quando è pronto.

Documentazione pubblica

Riferimento completo dell’API, con gli schemi di risposta e i codici di errore.

Apri il riferimento dell’API Richieda l’accesso

Veda Govreader con i documenti del Suo settore

Le mostriamo il flusso completo — identificazione, consultazione e risposta — con i casi che La interessano di più.

Richieda una demo