Desenvolupadors

Una crida. El document oficial.

Govreader funciona sobre l'API de Wealthreader: HTTPS, paràmetres de formulari i resposta JSON. Si ja integra Wealthreader, ja sap integrar Govreader.

  1. Iniciï la consulta

    Enviï la seva clau d'API i el codi del document. La resposta inclou la sessió i el codi QR que el titular ha d'aprovar amb Cl@ve.

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

  2. El titular aprova

    El seu client escaneja el codi amb l'aplicació Cl@ve i confirma. Vostè repeteix la crida amb la sessió per recollir el resultat.

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

  3. Rebi la resposta

    Dades normalitzades i document original codificat en Base64, a punt per al seu expedient.

    Exemple amb la declaració de la renda. Els valors són il·lustratius.

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

Pensada per a producció

Un mateix contracte

Els mateixos paràmetres i la mateixa estructura de resposta per a tots els organismes.

Errors amb significat

Codis documentats que distingeixen un accés no aprovat, un organisme en manteniment o un informe que s'emet en diferit.

Informes en diferit

Alguns organismes, com el Banco de España, no lliuren l'informe a l'instant. L'API ho indica i vostè el recull quan és a punt.

Documentació pública

Referència completa de l'API, amb els esquemes de resposta i els codis d'error.

Obrir la referència de l'API Sol·licitar accés

Vegi Govreader amb els documents del seu sector

Li mostrem el flux complet —identificació, consulta i resposta— amb els casos que més l'interessen.

Sol·licitar una demo