Desarrolladores

Una llamada. El documento oficial.

Govreader funciona sobre la API de Wealthreader: HTTPS, parámetros de formulario y respuesta JSON. Si ya integra Wealthreader, ya sabe integrar Govreader.

  1. Inicie la consulta

    Envíe su clave de API y el código del documento. La respuesta incluye la sesión y el código QR que el titular debe aprobar con Cl@ve.

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

  2. El titular aprueba

    Su cliente escanea el código con la aplicación Cl@ve y confirma. Usted repite la llamada con la sesión para recoger el resultado.

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

  3. Reciba la respuesta

    Datos normalizados y documento original codificado en Base64, listos para su expediente.

    Ejemplo con la declaración de la renta. Los valores son ilustrativos.

    {
  "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 para producción

Un mismo contrato

Los mismos parámetros y la misma estructura de respuesta para todos los organismos.

Errores con significado

Códigos documentados que distinguen un acceso no aprobado, un organismo en mantenimiento o un informe que se emite en diferido.

Informes en diferido

Algunos organismos, como el Banco de España, no entregan el informe al instante. La API se lo indica y usted lo recoge cuando está listo.

Documentación pública

Referencia completa de la API, con los esquemas de respuesta y los códigos de error.

Abrir la referencia de la API Solicitar acceso

Vea Govreader con los documentos de su sector

Le enseñamos el flujo completo —identificación, consulta y respuesta— con los casos que más le interesan.

Solicitar una demo