Programadores

Uma chamada. O documento oficial.

A Govreader funciona sobre a API da Wealthreader: HTTPS, parâmetros de formulário e resposta JSON. Se já integra a Wealthreader, já sabe integrar a Govreader.

  1. Inicie a consulta

    Envie a sua chave de API e o código do documento. A resposta inclui a sessão e o código QR que o titular deve aprovar com Cl@ve.

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

  2. O titular aprova

    O seu cliente lê o código com a aplicação Cl@ve e confirma. Repita a chamada com a sessão para recolher o resultado.

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

  3. Receba a resposta

    Dados normalizados e documento original codificado em Base64, prontos para o seu processo.

    Exemplo com a declaração de rendimentos. Os valores são 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 produção

Um mesmo contrato

Os mesmos parâmetros e a mesma estrutura de resposta para todos os organismos.

Erros com significado

Códigos documentados que distinguem um acesso não aprovado, um organismo em manutenção ou um relatório emitido em diferido.

Relatórios em diferido

Alguns organismos, como o Banco de España, não entregam o relatório de imediato. A API indica-o e o utilizador recolhe-o quando estiver pronto.

Documentação pública

Referência completa da API, com os esquemas de resposta e os códigos de erro.

Abrir a referência da API Pedir acesso

Veja a Govreader com os documentos do seu setor

Mostramos-lhe o fluxo completo — identificação, consulta e resposta — com os casos que mais lhe interessam.

Pedir uma demonstração