Valorizza API Docs

Deverá ser enviado os dados de todos os alunos, cadastrados a partir do período que foi definido no projeto de implantação.

Importante:_ O cadastro de alunos é um cadastro único que identifica o aluno, caso a instituição trabalhe com número de matrícula diferente para o mesmo aluno, a mesma deverá ser informada na integração de Aluno X Cursos.

Utilização: É uma informação obrigatória para todos os módulos do sistema.

Detalhamento dos campos do serviço - dados de entrada:

Campo	Tipo	Obrig.	Descrição / Regras
`ESIAL_IDENTIFICACAO`	Varchar(50)	Sim	Identificação única do aluno no sistema acadêmico. É utilizado para garantir a singularidade e a integridade dos registros enviados, sendo considerado a chave primária. O Sistema Valorizza utiliza esse identificador para evitar registros duplicados e o rastreamento das informações integradas no sistema.
`ESIAL_ALUNO`	Varchar(120)	Sim	Nome civil do aluno. Nome civil: é o nome atribuído à pessoa física, que consta no documento de nascimento.
`ESIAL_MATRICULA`	Varchar(40)	Não	Refere-se à matrícula do aluno, também reconhecida como Registro Acadêmico (RA). Este campo deve ser fornecido em Instituições de Ensino em que o RA do aluno permanece inalterado, independentemente dos cursos aos quais está associado.
`ESIAL_CPF`	Varchar(14)	Sim	O CPF (Cadastro de Pessoa Física) do aluno é um campo obrigatório e deve ser enviado sem pontuação, contendo os 11 dígitos. Esta informação é crucial para a identificação única dos alunos no Sistema Valorizza. É importante destacar que o sistema não aceita CPFs duplicados, garantindo a integridade e unicidade das informações. Certifique-se de fornecer corretamente o CPF para evitar problemas de identificação e processamento no Sistema Valorizza. Para os alunos estrangeiros que não possuam CPF, orienta-se deixar este campo em branco, sendo necessário informar o documento de identificação correspondente no campo ESIAL_DOCUMENTO.
`ESIAL_DOCUMENTO`	Varchar(40)	Não	Refere-se ao documento de identificação do aluno estrangeiro, como o número do passaporte. Este campo deve ser obrigatoriamente enviado se o aluno possuir nacionalidade estrangeira e não possuir CPF, sendo crucial para fins de identificação. Ao preencher o ESIAL_DOCUMENTO, certifique-se de fornecer com precisão as informações relativas ao documento de identificação do aluno estrangeiro. Esses dados são fundamentais para assegurar a correta identificação e registro no Sistema Valorizza, garantindo uma gestão eficiente e precisa dos alunos estrangeiros.
`ESIAL_RG`	Varchar(50)	Não	Refere-se ao Número do Registro Geral (RG), ou documento de identidade utilizado no Brasil, do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria. Se a instituição de ensino não demandar tal informação nos contratos mencionados, a inclusão do número do RG não se torna obrigatória durante o processo de integração. Recomenda-se avaliar minuciosamente as exigências específicas da Área de Negócio em relação aos documentos necessários para os contratos antes de tomar a decisão de enviar ou não o número do RG.
`ESIAL_LOGIN`	Varchar(100)	Sim	É essencial para a integração no Single Sign-On (SSO) e representa o login único do aluno no sistema. Este login é utilizado para proporcionar ao aluno um acesso simplificado e seguro, pois integra com o sistema sem a necessidade de autenticação múltipla. Certifique-se de fornecer o login do aluno corretamente, pois ele desempenha um papel central na experiência de acesso unificado. Qualquer variação ou erro no login pode impactar negativamente a integração com o SSO no Sistema Valorizza.
`ESIAL_SENHA`	Varchar(100)	Não	Senha do aluno para login no Sistema Valorizza. Essa informação é destinada a instituições de ensino que não possuem mecanismos de Single Sign-On (SSO) e mantêm a informação de senha em banco de dados.
`ESIAL_SEXO`	Varchar(1)	Não	Refere-se ao Sexo ou Gênero do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria. Caso opte por enviar essa informação, certifique-se de fornecer dados corretos e de acordo com os valores previamente configurados no Sistema Valorizza. Sexo: é frequentemente considerado uma característica biológica objetiva. • No contexto de informações acadêmicas, pode se referir às características físicas e biológicas associadas ao sistema reprodutivo de uma pessoa, como masculino ou feminino. • Geralmente, as informações de sexo são usadas para questões administrativas ou legais, como inclusão em contratos de estágios ou monitorias. Gênero: é mais subjetivo e pode variar de acordo com as experiências e identidade pessoal de alguém. • No contexto acadêmico, a inclusão do gênero pode ser opcional, indicando uma compreensão da natureza subjetiva dessa informação. • A identidade de gênero pode ser relevante para refletir a diversidade e inclusão, especialmente em situações específicas, como estágios ou monitorias, onde a composição de gênero pode ser considerada.
`ESIAL_ESTADO_CIVIL`	Varchar(1)	Não	Refere-se ao estado civil do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria. Caso opte por enviar essa informação, certifique-se de fornecer dados corretos e de acordo com os valores previamente configurados no Sistema Valorizza. S - Solteiro C - Casado V - Viúvo P - Separado D - Divorciado U - União Estável O - Outros N - Não Desejo Informar
`ESIAL_EMAIL`	Varchar(100)	Não	Refere-se ao endereço de e-mail do aluno. Sugerimos o envio desta informação, uma vez que o sistema a utiliza para encaminhar notificações relativas a estágios, processos de recrutamento e seleção, entre outros. É importante destacar que o sistema não aceita endereços de e-mail duplicados, garantindo a integridade e unicidade das informações.
`ESIAL_TELEFONE1`	Varchar(16)	Não	Refere-se ao número de telefone secundário do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa, ficando a critério da instituição de ensino decidir se deseja enviar ou não.
`ESIAL_TELEFONE2`	Varchar(16)	Não	Refere-se ao número de telefone principal do aluno, e sua inclusão é obrigatória na integração. Apesar de conter o número 2, representa o telefone principal no cadastro do currículo. Esse campo é utilizado para fornecer informações de contato essenciais do aluno e, mesmo que contenha o número 2, representa o telefone principal no contexto do cadastro. Esclarecemos que, anteriormente, era comum diferenciar entre telefone fixo e celular usando os números 1 e 2, respectivamente. Contudo, em conformidade com as práticas atuais, o número 2 é designado para o telefone principal, que pode ser tanto fixo quanto celular.
`ESIAL_ENDERECO`	Varchar(140)	Sim	Refere-se ao logradouro do endereço do aluno. A inclusão deste dado é obrigatória, pois é necessária para a elaboração de contratos de estágios e de monitorias, que possuem caráter empregatício e exigem dados detalhados do endereço do aluno.
`ESIAL_NUMERO`	Varchar(8)	Não	Refere-se ao número do endereço do aluno. A inclusão deste dado é obrigatória, quando existir no sistema acadêmico.
`ESIAL_COMPLEMENTO`	Varchar(100)	Não	Refere-se ao complemento do endereço do aluno. A inclusão deste dado é obrigatória, quando existir no sistema acadêmico.
`ESIAL_BAIRRO`	Varchar(100)	Não	Refere-se ao bairro do endereço do aluno. A inclusão deste dado é obrigatória, quando existir no sistema acadêmico.
`ESIAL_CIDADE`	Varchar(100)	Sim	Refere-se à cidade do endereço do aluno. A inclusão deste dado é obrigatória, pois é necessária para a elaboração de contratos de estágios e de monitorias, que possuem caráter empregatício e exigem dados detalhados do endereço do aluno.
`ESIAL_UF`	Varchar(2)	Sim	Refere-se à sigla da Unidade Federativa do endereço do aluno. A inclusão deste dado é obrigatória, pois é necessária para a elaboração de contratos de estágios e de monitorias, que possuem caráter empregatício e exigem dados detalhados do endereço do aluno.
`ESIAL_CEP`	Numeric(8)	Sim	Refere-se ao CEP do endereço do aluno. A inclusão deste dado é obrigatória, pois é necessária para a elaboração de contratos de estágios e de monitorias, que possuem caráter empregatício e exigem dados detalhados do endereço do aluno.
`ESIAL_NOME_MAE`	Varchar(100)	Não	Refere-se ao nome da mãe do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria.
`ESIAL_NACIONALIDADE`	Varchar(50)	Não	Refere-se à nacionalidade do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria.
`ESIAL_NATURALIDADE`	Varchar(50)	Não	Refere-se à naturalidade do aluno (é atualizado em uma pergunta do currículo, quando existir). A inclusão deste dado é facultativa e deve ser enviada somente se a instituição de ensino precisar incorporar essa informação em contratos de estágios ou de monitoria.
`ESIAL_BANCO`	Varchar(5)	Não	A inclusão deste dado é facultativa e pode ser incluído caso esteja disponível no sistema acadêmico. Esta informação é relevante quando há o pagamento de bolsa auxílio para os alunos. Ao incluir o nome do banco, o Sistema Valorizza poderá utilizá-lo nos contratos de estágio ou monitoria, quando aplicável.
`ESIAL_AGENCIA`	Varchar(10)	Não	A inclusão deste dado é facultativa e pode ser incluído caso esteja disponível no sistema acadêmico. Esta informação é relevante quando há o pagamento de bolsa auxílio para os alunos. Ao incluir a agência, o Sistema Valorizza poderá utilizá-la nos contratos de estágio ou monitoria, quando aplicável.
`ESIAL_CONTA`	Varchar(15)	Não	A inclusão deste dado é facultativa e pode ser incluído caso esteja disponível no sistema acadêmico. Esta informação é relevante quando há o pagamento de bolsa auxílio para os alunos. Ao incluir o número da conta bancária, o Sistema Valorizza poderá utilizá-lo nos contratos de estágio ou monitoria, quando aplicável.
`ESIAL_BOLSA_INI_CIENTIFICA`	Varchar(1)	Não	Refere-se à condição de bolsista de iniciação científica do aluno. Em algumas instituições de ensino, essa informação pode ser considerada como critério no processo de seleção de monitoria. Ser bolsista de iniciação científica pode indicar que o aluno já possui uma carga horária significativa em atividades extracurriculares. Recomendamos verificar junto à Área de Negócio da instituição de ensino se essa informação é relevante para o processo de seleção de monitoria. Caso seja relevante, incluir o indicador pode auxiliar na tomada de decisões sobre a alocação de alunos em atividades extracurriculares.
`ESIAL_VALIDADE`	Date	Não	É utilizado exclusivamente para a finalidade de invalidar o registro do aluno. Caso ocorra o envio de informações do aluno por engano, ou seja, necessário desativar o registro, a data de validade deve ser informada. Essa data marca o ponto em que o registro do aluno deixa de ser considerado ativo no Sistema Valorizza. É crucial usar esse campo com cautela, uma vez que a inserção de uma data de validade resultará na desativação do registro correspondente. Certifique-se de compreender plenamente o impacto dessa ação e utilize-o apenas quando necessário, evitando a inserção indevida de datas de validade que possam comprometer a integridade dos dados.
`ESIAL_NOME_SOCIAL`	Varchar(100)	Não	Nome social: é o nome pelo qual as pessoas (transgêneros ou outras) preferem ser identificadas no meio social e que reflete a sua identidade de gênero. Essa é uma possibilidade importante para garantir a inclusão e respeitar a identidade de gênero do aluno. É essencial observar que o nome social será apresentado em todas as consultas do sistema, proporcionando uma experiência personalizada ao usuário. No entanto, é fundamental destacar que, em conformidade com a legislação, nos contratos de estágios, o que constará obrigatoriamente é o nome civil do aluno. Nesse contexto, o nome social pode ser incluído como um complemento, oferecendo uma abordagem inclusiva e respeitosa.
`ESIAL_DT_BLOQUEIO_ACESSO`	Date	Não	A data fornecida nesse campo tem a finalidade de bloquear o acesso do aluno ao sistema acadêmico. Quando forncedida fica bloqueado o login do aluno até a data informada.

RecebeAlunos

Request

Responses