Download informe IR

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/integracao/imposto-renda/{{cpf_beneficiario}}/downloads/base64

🔹 Produção

https://integracao.medsenior.com.br/api/v1/beneficiario/integracao/imposto-renda/{{cpf_beneficiario}}/downloads/base64

📌 Endpoint

GET /api/v1/beneficiario/integracao/imposto-renda/{{cpf_beneficiario}}/downloads/base64

🔐 Autenticação

Este endpoint requer um token de autorização.

Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO

🔽 Cabeçalhos

Nome	Valor
accept	application/json
content-type	application/json

🔽 Parâmetros de Entrada

Nome	Tipo	Obrigatório	Descrição
cpfBenficiario	string	Sim	Parametro a ser enviado junto à url

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'GET' \
'https://integracao.hml.cloud.medsenior.com.br/api/v1/beneficiario/integracao/imposto-renda/{{cpf_beneficiario}}/downloads/base64' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json' 

🔹 Ambiente de produção

curl -X 'GET' \
'https://integracao.medsenior.com.br/api/v1/beneficiario/integracao/imposto-renda/{{cpf_beneficiario}}/downloads/base64' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: application/json'

✅ Resposta de Sucesso

• Status Code: 200 OK
• Exemplo de Resposta:

{
    "data": {
        "nomeArquivo": "nome-do-informe-ir.pdf",
        "base64": "base64 do pdf do informe IR"
    },
    "success": true,
    "failure": false,
    "messages": []
}

❌ Códigos de Erro

Status Code	Significado	Descrição
400	Bad Request	Parâmetros inválidos ou ausentes.
401	Unauthorized	Falha na autenticação do token.
500	Server Error	Erro interno ao obter o beneficiário