portal tui - manual de procedimentos (ver. 1.3)

Portal TUI

Gerenciador de Pedidos de Cartão Universidade

Versão 1.3

Portal TUI

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 2 de 17

Sumário

1. O PORTAL ................................................................................................................................... 4

1.1 FUNCIONALIDADES ADMINISTRATIVAS DO PORTAL ..................................................................... 4

1.2 INTEGRAÇÕES ............................................................................................................................. 4

2. IMPLANTAÇÃO E CONFIGURAÇÃO DO PORTAL .................................................................................... 5

2.1 EQUIPE DE MARKETING – DISPONIBILIZAÇÃO DAS IMAGENS ....................................................... 5 PORTAL ADMINISTRATIVO ................................................................................................ 5 PORTAL DE ACESSO DOS ALUNOS, PROFESSORES E FUNCIONÁRIOS ................................ 6

2.2 EQUIPE DE TECNOLOGIA ............................................................................................................. 7 DEFINIÇÃO DE NÚMERO DA MATRÍCULA ........................................................................... 7 INTEGRAÇÃO COM PORTAL ............................................................................................... 7 TRANSMISSÃO DE ARQUIVOS ............................................................................................ 7 REGULARIZAÇÃO DE CARTÕES REJEITADOS ..................................................................... 8

3. INTEGRAÇÃO ............................................................................................................................... 9

3.1 BANCO DE DADOS ....................................................................................................................... 9 MÉTODOS DISPONÍVEIS .................................................................................................. 10 DIRECIONAMENTO PARA PÁGINAS DO PORTAL ............................................................... 12

4. CONTATOS ................................................................................................................................ 17

Portal TUI


Controle de Versões

Atualizações na versão 1.2

a) Implantação de motivo para solicitação de novas vias no método “SolicitarNovaVia”.

b) Novo método para listar motivos de pedido de novas vias (ListarMotivoSegundaVia).

c) Alteração do arquivo de validação XSD para envio de dados, permitindo o envio somente

dos campos básicos necessários para geração do cartão.

d) Informações adicionais para transferência de dados via webservice e arquivos.

Atualizações na versão 1.3

a) Alteração dos campos obrigatórios para envio de arquivos de dados.

b) Novo telefone para contato: (11) 4185-7516.

c) Novo endereço para envio de fotos 3x4 via transportadora/correios:

Novo endereço: Av. Tamara, 105 - 1º andar - Centro - Carapicuíba/SP - CEP 06320-020.

Portal TUI


O PORTAL

O Portal TUI é um sistema totalmente web, desenvolvido pela empresa Better Solutions, que permite à

Instituição obter um melhor controle sobre os pedidos de cartões universidade do Banco Santander (TUI).

1.1 FUNCIONALIDADES ADMINISTRATIVAS DO PORTAL

Cadastro de alunos, professores e funcionários;

Módulo de envio de fotos (webcam ou do computador) diretamente para os servidores da Better

Solutions, possibilitando o tratamento e a disponibilidade das fotos com maior agilidade;

Solicitação de novas vias de TUI, cartões de visitante, temporário e provisório;

Módulo de baixa na entrega de TUI;

Gerador de arquivos para envio via Internet Banking;

Módulo de leitura de arquivos de retorno do Internet Banking;

Módulo de analise dos dados para validar se o registro está apto ou não a ser enviado para produção da

TUI;

Consulta de pedidos, com visualização de todo o processo, desde o cadastro até a entrega individual da

TUI;

Relatórios gerenciais;

Cadastro de usuários com possibilidade de restringir o acesso à funções específicas e configuradas pelo

gestor da conta;

Configuração dinâmica de banners e rodapés das telas acessadas pelos alunos, professores e

funcionários.

1.2 INTEGRAÇÕES

Praticamente todas as funcionalidades disponíveis no portal podem ser acessadas através de integrações já

disponíveis via webservices. Veja mais no tópico 3. INTEGRAÇÃO.

Portal TUI


2. IMPLANTAÇÃO E CONFIGURAÇÃO DO PORTAL

Durante a implantação e configuração do Portal, várias equipes da IES serão envolvidas, cada uma em seu devido

tempo e com as seguintes atribuições:

Equipe de Marketing – Responsável pela disponibilização das imagens dinâmicas do portal, logotipo de cada campus da IES e divulgação do Portal dentro dos diversos canais de comunicação dentro dos campus (por exemplo, nas páginas da internet e intranet da IES);

Equipe de Tecnologia – Responsável pelas integrações entre o sistema da IES e o Portal;

Equipe de Operações – Responsável pelo envio e recebimento de arquivos de solicitação de cartões via Internet Banking. Esta equipe será responsável pelo dia-a-dia do produto dentro da IES e manterá comunicação constante com a equipe de Operações da Better Solutions.

Portanto, a correta definição dos responsáveis e das equipes envolvidas deverá proporcionar um processo de

implantação evitando possíveis impactos garantindo que o produto seja entregue conforme esperado,

atendendo as expectativas da IES e dos universitários.

2.1 EQUIPE DE MARKETING – DISPONIBILIZAÇÃO DAS IMAGENS

Disponibilizamos à IES a possibilidade de deixar o Portal TUI de acordo com a sua identidade visual, para que,

quando seus funcionários, professores e alunos entrarem no sistema, sejam impactados de forma positiva,

dando à eles a certeza que se trata de um portal da própria Instituição.

Segue os locais de aplicação dessas imagens e como deverão ser disponibilizadas:

PORTAL ADMINISTRATIVO

Na área administrativa do portal, poderão ser alteradas as imagens do cabeçalho e do rodapé, que serão

visualizadas por todos os usuários que possuírem senha administrativos.

Imagem do cabeçalho

Formato: JPG Resolução: 72 DPI Largura: 980 pixels Altura: 120 a 160 pixels

Imagem do rodapé


Portal TUI


PORTAL DE ACESSO DOS ALUNOS, PROFESSORES E FUNCIONÁRIOS

Nesta tela, poderá ser definido um cabeçalho e rodapé para cada campus e será visualizada de acordo com o

cadastro das pessoas vinculadas à sua unidade.

TELA DE DADOS CADASTRAIS: Imagem do cabeçalho


TELA DE DADOS CADASTRAIS: Imagem do rodapé


POPUP DE CAPTURA E VISUALIZAÇÃO DA FOTO: Imagem do cabeçalho


POPUP DE CAPTURA E VISUALIZAÇÃO DA FOTO: Imagem do rodapé


Portal TUI


2.2 EQUIPE DE TECNOLOGIA

DEFINIÇÃO DE NÚMERO DA MATRÍCULA

A IES deverá ter em sua base de dados um número único de matrícula para todos os cartões, incluindo os cartões

visitantes, temporários ou provisórios, independente de campus. Esta definição é necessária para o cruzamento

do registro das fotos enviadas com os dados do cartão.

Cada matrícula define um registro único dentro do sistema do Banco. Caso haja uma mesma matrícula para dois

ou mais cartões, as fotos serão sobrepostas e os cartões serão gerados incorretamente.

INTEGRAÇÃO COM PORTAL

Toda a comunicação entre a IES e o Portal será realizada através de WebService. O portal criará internamente

uma chave única para cada registro, que será vinculado ao número de matricula informado pela IES.

Caso o número de matrícula seja o mesmo para campus diferentes, a IES deverá informar essa situação durante

o processo de implantação e configuração no Portal.

Caso o número de matrícula seja o mesmo no mesmo campus, o sistema assumirá o último registro enviado pela

IES.

TRANSMISSÃO DE ARQUIVOS

Internet Banking

O processo de transmissão de arquivos de geração de cartões entre Banco e IES ocorre através do Internet

Banking.

Acesso

Antes de iniciar o processo de transmissão de arquivos, é necessário dirigir-se até a agência do Banco vinculado à

IES e assinar um contrato para utilização do serviço.

Geração do Arquivo

A geração do arquivo deverá ser realizada através da área administrativa do portal, pelo menu “Transf.

Arquivos”, “Internet Banking”, “Geração de Arquivo de Remessa”.

Será gerado um arquivo para cada filial da IES. Os arquivos gerados serão zipados automaticamente e

disponibilizados para download.

Portal TUI


Transferir o Arquivo

A transferência de arquivos deve ser iniciada através da opção “Transf. Arquivos”, “Remessa”, “Transmitir” no

Internet Banking do Banco Santander. Escolher o arquivo a ser enviado e clicar em “Enviar”.

Após enviado o arquivo, pode-se consultar o retorno da consistência após aproximadamente 10 minutos, através

do menu “Transf. Arquivos”, “Retorno”, “Consultar”. Abre-se a caixa com os arquivos disponíveis para

recebimento, que podem ser visualizados, através do ícone Abrir, ou salvos no computador, através do ícone

“Salvar”.

Retorno do Arquivo

Para ler os arquivos de retorno, volte ao portal e vá até o menu “Transf. Arquivos”, “Internet Banking”, “Leitura

de Arquivo de Retorno”.

REGULARIZAÇÃO DE CARTÕES REJEITADOS

Ao processar o arquivo retorno o Portal identificará todos os registros inconsistentes e tentará tratar

automaticamente, e caso necessário enviará avisos e emitirá relatórios para tomada de ações corretivas para o

reenvio.

Portal TUI


3. INTEGRAÇÃO Todas as integrações entre a IES e o Portal são realizadas através de Webservice. A Better Solutions

disponibilizará à IES o endereço do Webservice e uma chave de acesso, que a identificará durante as transações.

3.1 BANCO DE DADOS

Este capítulo visa facilitar o entendimento a respeito da troca de registros para geração de Cartões Universidade

entre a IES e a Better Solutions.

A transferência dos dados podem ser realizados de três formas:

a) Através do webservice do Portal (recomendada);

b) Através da criação de um webservice na IES, onde o portal buscará os dados;

c) Através de cargas de arquivos TXT ou XLS/XLSX.

3.1.1. Webservice do Portal

Os webservices disponibilizados poderão ser atualizados, porém as versões anteriores continuarão funcionando

normalmente. Mantenha sempre seu cadastro com a Better Solutions atualizado para receber as notas de

alterações.

Aplicações:

O envio dos dados para o Portal poderá ser realizado de forma on-line ou off-line.

On-line: As informações são enviadas no momento em que os dados do aluno ou colaborador são salvos

no sistema de gestão da IES.

Off-line: As informações são enviadas através de rotinas, que selecionarão os dados no sistema de

gestão da IES e enviarão para o Portal gradativamente.

Portal TUI


O padrão de comunicação utilizado no webservice é SOAP. No cabeçalho deverá ser informado a chave da

empresa, usuário e senha. Utilizar conforme exemplo abaixo:

URL do Webservice de TESTES (PortalTUI.NET):

http://www.portaltui.net/webservices/PortalTUI.asmx

URL do Webservice de PRODUÇÃO (PortalTUI.COM):

http://www.portaltui.com/webservices/PortalTUI.asmx

Dados para autenticação SOAP do Webservice serão disponibilizados após o cadastro da IES no sistema

MÉTODOS DISPONÍVEIS

EnviarDados(string sXML) string

Este método atualiza os dados na base do portal.

O parâmetro sXML é uma “string” deverá receber um XML, de acordo com os campos do

ANEXO 1.

Retorno XML:

<retorno>

<cod_retorno></cod_retorno>

<descricao_retorno></descricao_retorno>

</retorno>

ObterChave(string sMatricula, string sCodFilial) string

Este método retorna a chave criptografada do registro no Portal. É o método mais importante e

será utilizado em praticamente todos os próximos métodos.

O parâmetro sMatricula é uma “string” deverá receber o número da matrícula.

O parâmetro sCodFilial é uma “string” deverá receber o código da Filial da IES com 3 dígitos.

Retorno XML:

<retorno>

<cod_retorno />

<descricao_retorno />

<chave />

</retorno>

http://www.portaltui.net/webservices/PortalTUI.asmx

http://www.portaltui.com/webservices/PortalTUI.asmx

Portal TUI


AlterarMatricula(string sChave, string sNovaMatricula) string

O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.

O parâmetro sNovaMatricula é uma “string” deverá receber o número da nova matrícula com

15 dígitos.

Retorno XML:

<retorno>

<cod_retorno />


</retorno>

AlterarFilial(string sChave, string sNovoCodFilial) string


O parâmetro sNovoCodFilial é uma “string” deverá receber o código da nova Filial da IES com 3

dígitos.

Retorno XML:

<retorno>

<cod_retorno />


</retorno>

EnviarFoto(string sChave, byte[] imgFoto) string

Este método permite enviar uma foto para o portal.


O parâmetro imgFoto é um “array de bytes” a imagem “JPG”.

Retorno XML:

<retorno>

<cod_retorno />


</retorno>

SolicitarNovaVia(string sChave, int iCodigoMotivo) string

Este método permite enviar uma foto para o portal.


O parâmetro iCodigoMotivo é um inteiro, que deverá corresponder a um código válido obtido

através da lista de motivos.

Retorno XML:

<retorno>

<cod_retorno />


</retorno>

Portal TUI


ListarMotivoSegundaVia() string

Este método lista os motivos disponíveis para solicitação de novas vias.

ExecutarEntregaIndividual(string sChave) string

Este método permite dar baixa na entrega individual de uma TUI.


Retorno XML:

<retorno>

<cod_retorno />


</retorno>

ObterStatusPedido(string sChave) string

Este método obtém o status atual do ultimo pedido.


Retorno XML:

<retorno>

<cod_retorno />


</retorno>

DIRECIONAMENTO PARA PÁGINAS DO PORTAL

Algumas páginas do portal administrativo também poderão ser acessadas diretamente pelo aluno.

A página de redirecionamento é: http://www.portaltui.com/Redirect.aspx

Esta página recebe parâmetros via QueryString ou via Post.

Os parâmetros recebidos são:

CHAVE

Recebe a chave do aluno, obtida através do método ObterChave do webservice.

PAGINA

Recebe código da página para direcionamento:

0 = Direciona para uma URL Externa (que estejam integradas ao portal)

1 = Direciona para página de DADOS CADASTRAIS

http://www.portaltui.com/Redirect.aspx

Portal TUI


2 = Abre popup da tela de UPLOAD DE FOTO

3 = Abre popup da tela de VISUALIZAÇÃO DA FOTO

4 = Direciona para página de STATUS DO ÚLTIMO PEDIDO DA TUI

Por exemplo, para abrir a tela de dados cadastrais o processo é:

1) Obter chave através do webservice.

2) Abrir a página http://www.portaltui.com/Redirect.aspx?PAGINA=1&CHAVE=[Chave obtida]

* No caso do código “0”, deverá ser utilizado o parâmetro “URL” na QueryString.

3.1.2. Webservice da IES

A Instituição poderá desenvolver um webservice para que o portal busque os dados em seus servidores.

O método de busca de dados deverá respeitar a mesma estrutura do webservice do portal.

No ANEXO 1 estão todas as especificações para criação do webservice.

Aplicações:

O Portal busca os dados na IES no momento em que uma matrícula é requisitada pelo usuário no Portal.

É importante ressaltar que caso o webservice esteja indisponível no momento em que os dados forem acessados

no Portal.

Portal TUI


3.1.3. Carga de dados

A Instituição gera um arquivo TXT, CSV ou XLS/XLSX e envia para a Better Solutions por e-mail.

Em até dois dias úteis os dados são importados para o Portal.

O arquivo deverá possuir o cabeçalho de acordo com as especificações contidas no ANEXO 1.

Os dados que não se enquadrarem nas especificações serão ignorados durante a importação.

O e-mail para recebimento dos dados para importação é [email protected].

Exemplo de um envio do arquivo:

Este é somente um exemplo. Os dados acima não representam necessariamente as informações que deverão

constar, principalmente nos campos “cod_barras” e “linha_4”.

É importante atentar-se no cabeçalho e nas especificações do ANEXO 1 para que não existam rejeições de

registros.

mailto:[email protected]

Portal TUI


ANEXO 1

Estrutura do arquivo XML para envio dos Dados: <?xml version="1.0" encoding="utf-8" ?> <dados xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <cod_filial /> <matricula /> <tipo_vinculo /> <nome /> <nome_resumido /> <nome_mae /> <cpf_numero /> <estado_civil /> <nacionalidade /> <flag_cpf_titular /> <documento_tipo /> <documento_numero /> <documento_data_emissao /> <documento_orgao_expedidor /> <documento_uf /> <data_nascimento /> <sexo /> <raca /> <email /> <cod_barras /> <numero_dependentes /> <renda_mensal /> <numero_conta_corrente /> <ano_em_curso /> <data_termino_curso /> <curso /> <meio_de_transporte /> <ano_conclusao_ensino_medio /> <linha_4 /> <status /> <telefones> <telefone> <tipo_telefone /> <ddd /> <numero /> <ramal /> </telefone > </telefones > <enderecos> <endereco> <tipo_endereco /> <cep /> <logradouro /> <numero /> <complemento /> <bairro /> <municipio /> <uf /> <pais /> </endereco> </enderecos > </dados>

A mesma estrutura XML é gerada pelo sistema durante a atualização de dados no Portal. Para receber os dados atualizados, basta a IES disponibilizar um webservice recebendo essa estrutura. Este recurso é opcional. Para não enviar os campos opcionais, basta remover a TAG correspondente. A estrutura do XML é validada através de um arquivo XSD. Faça o download do arquivo padrão no endereço: http://www.portaltui.com/webservices/xsd/dados.xsd

http://www.w3.org/2001/XMLSchema-instance

http://www.w3.org/2001/XMLSchema

http://www.portaltui.com/webservices/xsd/dados.xsd

Portal TUI


ANEXO 1

Campos obrigatórios:

Campo Tipo Qtde. Máx. de

Caracteres Observação Exemplo

cod_filial Numérico 3 Código da Filial (Campus da IES). Deverá corresponder ao mesmo código cadastrado no Santander.

001

matricula Numérico 15 Matrícula ou RA. Caso existam matrículas iguais em filiais diferentes, o tamanho máximo deste campo deverá ser de 10 dígitos.

12345

nome Alfanumérico 80 Nome Completo. JOAQUIM JOSE DA SILVA XAVIER

cpf_numero Numérico 11 Número do CPF. 01234567899

linha_4 Alfanumérico 33 Linha 4 do cartão. A Instituição poderá definir qual informação será impressa nesta linha. Pode ser o curso do aluno, o departamento do funcionário, a matrícula, etc., desde que não ultrapasse 33 caracteres.

ADM EMPRESAS

cod_barras Numérico 14 Código de Barras que será impresso no cartão.

12345

tipo_vinculo Numérico 1 1 = Aluno; 2 = Professor; 3 = Funcionário; 4 = Pós-Graduação (Outros) Somente será aceito um dos quatro números acima. Enviar somente o número, sem a descrição, conforme exemplo.

1

ano_em_curso Numérico 2 Ano atual do curso do aluno. Exemplo: se o aluno está no segundo semestre, enviar o ano “01”. Se estiver no 5º semestre, enviar “03”.

01

curso Alfanumérico 80 Curso do aluno. ADMINISTRAÇÃO DE EMPRESAS

data_termino_curso Numérico 6 Mês e ano em que o aluno terminará o curso. Formato 'MMAAAA', onde MM é o mês com 2 dígitos e AAAA é o ano com 4 dígitos.

122011

Todos os campos acima são obrigatórios. O nome impresso no cartão poderá contar no máximo 20 caracteres. Caso possua essa informação, envie na tag <nome_resumido>. Caso não possua, o sistema abreviará automaticamente o nome enviado, seguindo as seguintes regras até que o nome resumido possua 20 caracteres ou menos:

1) Manter nome completo; 2) Manter o primeiro nome e o sobrenome, abreviar os nomes do meio; 3) Manter o primeiro nome e o sobrenome, remover os nomes do meio; 4) Abreviar todos os nomes e manter o sobrenome; 5) Manter os primeiros 20 caracteres do nome e sobrenome.

Através do portal, é possível alterar todos os dados, desde que o usuário esteja habilitado a faze-lo.

Portal TUI


4. CONTATOS

A Better Solutions possui uma equipe exclusiva e especializada disponível para assessorar e ajudar nas atividades

operacionais de implantação e pós-implantação, e eventuais dúvidas que possam surgir por parte da IES.

ÁREA TELEFONE E-MAIL

COMERCIAL / TÉCNICO

(11) 4185-7516

(11) 9488-2023

[email protected]

SUPORTE / DESENVOLVIMENTO

(11) 4185-7516

[email protected]

Atendimento de segunda a quinta das 08:00h as 18:00h e as sextas das 08:00h as 17:00h

BETTER SOLUTIONS

Avenida Tamara, 105 – 1º andar

Centro – Carapicuíba/SP

CEP 06320-020



portal tui - manual de procedimentos (ver. 1.3)

Documents