Pular para o conteúdo principal

Cadastrar vida

📌 Endpoint

POST /api/v2/avaliacao-saude/vida

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v2/avaliacao-saude/vida

🔹 Produção

https://integracao.medsenior.com.br/api/v2/avaliacao-saude/vida

🔐 Autenticação

Este endpoint requer um token de autorização.

Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO

🔽 Cabeçalhos

NomeValor
acceptapplication/json
content-typemultipart/form-data

🔽 Parâmetros de Entrada

O corpo da requisição deve ser enviado como multipart/form-data e conter os seguintes campos:

NomeTipoObrigatórioDescrição
Idstring (uuid)SimIdentificador da vida
DataProspeccaostring (date-time)SimData da prospecção em UTC no formato "YYYY-MM-DD HH:mm:ss"
NumeroContratointeger (int64)SimNúmero do contrato
NomestringSimNome do beneficiário
DataNascimentostring (date-time)SimData de nascimento do beneficiário no formato "YYYY-MM-DD"
CPFstringSimCPF do beneficiário
NomeMaestringSimNome da mãe do beneficiário
SexostringSimSexo do beneficiário

Possíveis valores:
  • Masculino
  • Feminino
  • Outro
EstadoCivilstringSimEstado civil do beneficiário

Possíveis valores:
  • Solteiro
  • Casado
  • Divorciado
  • Viuvo
  • Separado
  • UniaoEstavel
  • SeparadoJudicialmente
  • Outros
  • Companheiro
  • Amasiado
TelefoneResidencialstringNãoTelefone residencial do beneficiário
CelularstringSimCelular do beneficiário, apenas DDD e NUMERO
EmailstringSimE-mail do beneficiário
PropostaPlanoSaude.NomestringSimNome do plano de saúde
PropostaPlanoSaude.DescricaoLegalstringSimDescrição legal do plano de saúde
PropostaPlanoSaude.Valornumber (double)SimValor do plano de saúde
PropostaPlanoSaude.UFstringSimUF da unidade do plano de saúde
PropostaPlanoSaude.CodigoUnidadestringSimCódigo da unidade do plano de saúde
PropostaPlanoSaude.CodigoPlanostringNãoCódigo do plano de saúde (opcional)
Corretor.NomestringSimNome do corretor
Corretor.CpfstringSimCPF do corretor
Corretor.TelefonestringSimTelefone do corretor, apenas DDD e NUMERO
Corretor.Concessionaria.CNPJstringSimCNPJ da concessionária
Corretor.Concessionaria.NomeFantasiastringSimNome fantasia da concessionária
Corretor.Concessionaria.RazaoSocialstringSimRazão social da concessionária
Corretor.Concessionaria.CodigostringNãoCódigo da concessionária (opcional)
Corretor.EmailstringSimE-mail do corretor
TipoPropostastringSimTipo da proposta

Possíveis valores:
  • PF
  • PJ
  • PME
  • PFVendaAdministrativa
  • ColetivoPorAdesao
SelfieBeneficiariobinarySimImagem selfie do beneficiário

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'POST' \
'https://integracao.hml.cloud.medsenior.com.br/api/v2/avaliacao-saude/vida' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: multipart/form-data' \
-F 'Id=UUID_DA_VIDA' \
-F 'DataProspeccao=2024-06-01T10:00:00Z' \
-F 'NumeroContrato=123456' \
-F 'Nome=Fulano de Tal' \
-F 'DataNascimento=1990-01-01T00:00:00Z' \
-F 'CPF=12345678901' \
-F 'NomeMae=Maria de Tal' \
-F 'Sexo=M' \
-F 'EstadoCivil=Solteiro' \
-F 'Celular=11999999999' \
-F 'Email=fulano@email.com' \
-F 'propostaPlanoSaude.Nome=Plano Saúde' \
-F 'propostaPlanoSaude.DescricaoLegal=Plano Legal' \
-F 'propostaPlanoSaude.Valor=299.99' \
-F 'propostaPlanoSaude.UF=SP' \
-F 'propostaPlanoSaude.CodigoUnidade=UNIDADE123' \
-F 'propostaPlanoSaude.CodigoPlano=PLANO123' \
-F 'Corretor.Nome=Corretor Fulano' \
-F 'Corretor.Cpf=98765432100' \
-F 'Corretor.Telefone=11988887777' \
-F 'Corretor.Concessionaria.CNPJ=12345678000199' \
-F 'Corretor.Concessionaria.NomeFantasia=Concessionária Fantasia' \
-F 'Corretor.Concessionaria.RazaoSocial=Concessionária RS' \
-F 'Corretor.Concessionaria.Codigo=CONC123' \
-F 'Corretor.Email=corretor@email.com' \
-F 'TipoProposta=Individual' \
-F 'SelfieBeneficiario=@/caminho/para/selfie.jpg'

🔹 Ambiente de produção

curl -X 'POST' \
'https://integracao.medsenior.com.br/api/v2/avaliacao-saude/vida' \
-H 'accept: application/json' \
-H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
-H 'content-type: multipart/form-data' \
-F 'Id=UUID_DA_VIDA' \
... (demais campos conforme exemplo acima)

✅ Resposta de Sucesso

  • Status Code: 200 OK

❌ Códigos de Erro

Status CodeSignificadoDescrição
400Bad RequestParâmetros inválidos ou ausentes.
401UnauthorizedFalha na autenticação do token.
500Server ErrorErro interno ao criar a vida a ser avaliada.