Portal TUI

Gerenciador de Pedidos de Carto Universidade

Verso 1.3

Portal TUI

Sumrio
1. O PORTAL ................................................................................................................................... 4 FUNCIONALIDADES ADMINISTRATIVAS DO PORTAL ..................................................................... 4 INTEGRAES ............................................................................................................................. 4 EQUIPE DE MARKETING DISPONIBILIZAO DAS IMAGENS ....................................................... 5 PORTAL ADMINISTRATIVO ................................................................................................ 5 PORTAL DE ACESSO DOS ALUNOS, PROFESSORES E FUNCIONRIOS ................................ 6 EQUIPE DE TECNOLOGIA ............................................................................................................. 7 DEFINIO DE NMERO DA MATRCULA ........................................................................... 7 INTEGRAO COM PORTAL ............................................................................................... 7 TRANSMISSO DE ARQUIVOS ............................................................................................ 7 REGULARIZAO DE CARTES REJEITADOS ..................................................................... 8 BANCO DE DADOS ....................................................................................................................... 9 MTODOS DISPONVEIS .................................................................................................. 10 DIRECIONAMENTO PARA PGINAS DO PORTAL ............................................................... 12 1.1 1.2 2. 2.1

IMPLANTAO E CONFIGURAO DO PORTAL .................................................................................... 5

2.2

3.

INTEGRAO ............................................................................................................................... 9

3.1

4.

CONTATOS ................................................................................................................................ 17

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 2 de 17

Portal TUI

Controle de Verses
Atualizaes na verso 1.2 a) Implantao de motivo para solicitao de novas vias no mtodo SolicitarNovaVia.

b) Novo mtodo para listar motivos de pedido de novas vias (ListarMotivoSegundaVia). c) Alterao do arquivo de validao XSD para envio de dados, permitindo o envio somente dos campos bsicos necessrios para gerao do carto.

d) Informaes adicionais para transferncia de dados via webservice e arquivos.

Atualizaes na verso 1.3 a) Alterao dos campos obrigatrios para envio de arquivos de dados.

b) Novo telefone para contato: (11) 4185-7516. c) Novo endereo para envio de fotos 3x4 via transportadora/correios: Novo endereo: Av. Tamara, 105 - 1 andar - Centro - Carapicuba/SP - CEP 06320-020.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 3 de 17

Portal TUI

O PORTAL

O Portal TUI um sistema totalmente web, desenvolvido pela empresa Better Solutions, que permite Instituio obter um melhor controle sobre os pedidos de cartes universidade do Banco Santander (TUI).

1.1 FUNCIONALIDADES ADMINISTRATIVAS DO PORTAL

Cadastro de alunos, professores e funcionrios; Mdulo 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; Solicitao de novas vias de TUI, cartes de visitante, temporrio e provisrio; Mdulo de baixa na entrega de TUI; Gerador de arquivos para envio via Internet Banking; Mdulo de leitura de arquivos de retorno do Internet Banking; Mdulo de analise dos dados para validar se o registro est apto ou no a ser enviado para produo da TUI; Consulta de pedidos, com visualizao de todo o processo, desde o cadastro at a entrega individual da TUI; Relatrios gerenciais; Cadastro de usurios com possibilidade de restringir o acesso funes especficas e configuradas pelo gestor da conta; Configurao dinmica de banners e rodaps das telas acessadas pelos alunos, professores e funcionrios.

1.2 INTEGRAES
Praticamente todas as funcionalidades disponveis no portal podem ser acessadas atravs de integraes j disponveis via webservices. Veja mais no tpico 3. INTEGRAO.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 4 de 17

Portal TUI

2. IMPLANTAO E CONFIGURAO DO PORTAL

Durante a implantao e configurao do Portal, vrias equipes da IES sero envolvidas, cada uma em seu devido tempo e com as seguintes atribuies: Equipe de Marketing Responsvel pela disponibilizao das imagens dinmicas do portal, logotipo de cada campus da IES e divulgao do Portal dentro dos diversos canais de comunicao dentro dos campus (por exemplo, nas pginas da internet e intranet da IES); Equipe de Tecnologia Responsvel pelas integraes entre o sistema da IES e o Portal; Equipe de Operaes Responsvel pelo envio e recebimento de arquivos de solicitao de cartes via Internet Banking. Esta equipe ser responsvel pelo dia-a-dia do produto dentro da IES e manter comunicao constante com a equipe de Operaes da Better Solutions.

Portanto, a correta definio dos responsveis e das equipes envolvidas dever proporcionar um processo de implantao evitando possveis impactos garantindo que o produto seja entregue conforme esperado, atendendo as expectativas da IES e dos universitrios.

2.1 EQUIPE DE MARKETING DISPONIBILIZAO DAS IMAGENS

Disponibilizamos IES a possibilidade de deixar o Portal TUI de acordo com a sua identidade visual, para que, quando seus funcionrios, professores e alunos entrarem no sistema, sejam impactados de forma positiva, dando eles a certeza que se trata de um portal da prpria Instituio. Segue os locais de aplicao dessas imagens e como devero ser disponibilizadas:

PORTAL ADMINISTRATIVO

Na rea administrativa do portal, podero ser alteradas as imagens do cabealho e do rodap, que sero visualizadas por todos os usurios que possurem senha administrativos.

Imagem do cabealho

Formato: JPG

Resoluo: 72 DPI

Largura: 980 pixels

Altura: 120 a 160 pixels

Imagem do rodap

Formato: JPG

Resoluo: 72 DPI

Largura: 980 pixels

Altura: 45 a 60 pixels

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 5 de 17

Portal TUI

PORTAL DE ACESSO DOS ALUNOS, PROFESSORES E FUNCIONRIOS

Nesta tela, poder ser definido um cabealho e rodap para cada campus e ser visualizada de acordo com o cadastro das pessoas vinculadas sua unidade.

TELA DE DADOS CADASTRAIS: Imagem do cabealho

Formato: JPG

Resoluo: 72 DPI

Largura: 980 pixels

Altura: 120 a 160 pixels

TELA DE DADOS CADASTRAIS: Imagem do rodap

Formato: JPG

Resoluo: 72 DPI

Largura: 980 pixels

Altura: 45 a 60 pixels

POPUP DE CAPTURA E VISUALIZAO DA FOTO: Imagem do cabealho

Formato: JPG

Resoluo: 72 DPI

Largura: 620 pixels

Altura: 120 a 160 pixels

POPUP DE CAPTURA E VISUALIZAO DA FOTO: Imagem do rodap

Formato: JPG

Resoluo: 72 DPI

Largura: 620 pixels

Altura: 45 a 60 pixels

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 6 de 17

Portal TUI

2.2 EQUIPE DE TECNOLOGIA

DEFINIO DE NMERO DA MATRCULA

A IES dever ter em sua base de dados um nmero nico de matrcula para todos os cartes, incluindo os cartes visitantes, temporrios ou provisrios, independente de campus. Esta definio necessria para o cruzamento do registro das fotos enviadas com os dados do carto. Cada matrcula define um registro nico dentro do sistema do Banco. Caso haja uma mesma matrcula para dois ou mais cartes, as fotos sero sobrepostas e os cartes sero gerados incorretamente.

INTEGRAO COM PORTAL

Toda a comunicao entre a IES e o Portal ser realizada atravs de WebService. O portal criar internamente uma chave nica para cada registro, que ser vinculado ao nmero de matricula informado pela IES. Caso o nmero de matrcula seja o mesmo para campus diferentes, a IES dever informar essa situao durante o processo de implantao e configurao no Portal. Caso o nmero de matrcula seja o mesmo no mesmo campus, o sistema assumir o ltimo registro enviado pela IES.

TRANSMISSO DE ARQUIVOS
Internet Banking

O processo de transmisso de arquivos de gerao de cartes entre Banco e IES ocorre atravs do Internet Banking.

Acesso
Antes de iniciar o processo de transmisso de arquivos, necessrio dirigir-se at a agncia do Banco vinculado IES e assinar um contrato para utilizao do servio.

Gerao do Arquivo
A gerao do arquivo dever ser realizada atravs da rea administrativa do portal, pelo menu Transf. Arquivos, Internet Banking, Gerao de Arquivo de Remessa. Ser gerado um arquivo para cada filial da IES. Os arquivos gerados sero zipados automaticamente e disponibilizados para download.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 7 de 17

Portal TUI

Transferir o Arquivo
A transferncia de arquivos deve ser iniciada atravs da opo Transf. Arquivos, Remessa, Transmitir no Internet Banking do Banco Santander. Escolher o arquivo a ser enviado e clicar em Enviar. Aps enviado o arquivo, pode-se consultar o retorno da consistncia aps aproximadamente 10 minutos, atravs do menu Transf. Arquivos, Retorno, Consultar. Abre-se a caixa com os arquivos disponveis para recebimento, que podem ser visualizados, atravs do cone Abrir, ou salvos no computador, atravs 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.

REGULARIZAO DE CARTES REJEITADOS

Ao processar o arquivo retorno o Portal identificar todos os registros inconsistentes e tentar tratar automaticamente, e caso necessrio enviar avisos e emitir relatrios para tomada de aes corretivas para o reenvio.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 8 de 17

Portal TUI

3. INTEGRAO
Todas as integraes entre a IES e o Portal so realizadas atravs de Webservice. A Better Solutions disponibilizar IES o endereo do Webservice e uma chave de acesso, que a identificar durante as transaes.

3.1 BANCO DE DADOS

Este captulo visa facilitar o entendimento a respeito da troca de registros para gerao de Cartes Universidade entre a IES e a Better Solutions. A transferncia dos dados podem ser realizados de trs formas: a) Atravs do webservice do Portal (recomendada);

b) Atravs da criao de um webservice na IES, onde o portal buscar os dados; c) Atravs de cargas de arquivos TXT ou XLS/XLSX.

3.1.1.

Webservice do Portal

Os webservices disponibilizados podero ser atualizados, porm as verses anteriores continuaro funcionando normalmente. Mantenha sempre seu cadastro com a Better Solutions atualizado para receber as notas de alteraes.

Aplicaes:
O envio dos dados para o Portal poder ser realizado de forma on-line ou off-line. On-line: As informaes so enviadas no momento em que os dados do aluno ou colaborador so salvos no sistema de gesto da IES. Off-line: As informaes so enviadas atravs de rotinas, que selecionaro os dados no sistema de gesto da IES e enviaro para o Portal gradativamente.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 9 de 17

Portal TUI

O padro de comunicao utilizado no webservice SOAP. No cabealho dever ser informado a chave da empresa, usurio e senha. Utilizar conforme exemplo abaixo:

URL do Webservice de TESTES (PortalTUI.NET):

http://www.portaltui.net/webservices/PortalTUI.asmx
URL do Webservice de PRODUO (PortalTUI.COM):

http://www.portaltui.com/webservices/PortalTUI.asmx
Dados para autenticao SOAP do Webservice sero disponibilizados aps o cadastro da IES no sistema

MTODOS DISPONVEIS
EnviarDados(string sXML) string
Este mtodo atualiza os dados na base do portal. O parmetro 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 mtodo retorna a chave criptografada do registro no Portal. o mtodo mais importante e ser utilizado em praticamente todos os prximos mtodos. O parmetro sMatricula uma string dever receber o nmero da matrcula. O parmetro sCodFilial uma string dever receber o cdigo da Filial da IES com 3 dgitos. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> <chave /> </retorno>
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Pgina 10 de 17

Portal TUI

AlterarMatricula(string sChave, string sNovaMatricula) string

O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. O parmetro sNovaMatricula uma string dever receber o nmero da nova matrcula com 15 dgitos. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

AlterarFilial(string sChave, string sNovoCodFilial) string

O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. O parmetro sNovoCodFilial uma string dever receber o cdigo da nova Filial da IES com 3 dgitos. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

EnviarFoto(string sChave, byte[] imgFoto) string

Este mtodo permite enviar uma foto para o portal. O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. O parmetro imgFoto um array de bytes a imagem JPG. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

SolicitarNovaVia(string sChave, int iCodigoMotivo) string

Este mtodo permite enviar uma foto para o portal. O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. O parmetro iCodigoMotivo um inteiro, que dever corresponder a um cdigo vlido obtido atravs da lista de motivos. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 11 de 17

Portal TUI

ListarMotivoSegundaVia() string
Este mtodo lista os motivos disponveis para solicitao de novas vias.

ExecutarEntregaIndividual(string sChave) string

Este mtodo permite dar baixa na entrega individual de uma TUI. O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

ObterStatusPedido(string sChave) string

Este mtodo obtm o status atual do ultimo pedido. O parmetro sChave uma string dever receber a chave retornada do Mtodo ObterChave. Retorno XML: <retorno> <cod_retorno /> <descricao_retorno /> </retorno>

DIRECIONAMENTO PARA PGINAS DO PORTAL

Algumas pginas do portal administrativo tambm podero ser acessadas diretamente pelo aluno. A pgina de redirecionamento : http://www.portaltui.com/Redirect.aspx Esta pgina recebe parmetros via QueryString ou via Post. Os parmetros recebidos so: CHAVE Recebe a chave do aluno, obtida atravs do mtodo ObterChave do webservice. PAGINA Recebe cdigo da pgina para direcionamento: 0 = Direciona para uma URL Externa (que estejam integradas ao portal) 1 = Direciona para pgina de DADOS CADASTRAIS
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Pgina 12 de 17

Portal TUI

2 = Abre popup da tela de UPLOAD DE FOTO 3 = Abre popup da tela de VISUALIZAO DA FOTO 4 = Direciona para pgina de STATUS DO LTIMO PEDIDO DA TUI Por exemplo, para abrir a tela de dados cadastrais o processo : 1) Obter chave atravs do webservice. 2) Abrir a pgina http://www.portaltui.com/Redirect.aspx?PAGINA=1&CHAVE=[Chave obtida] * No caso do cdigo 0, dever ser utilizado o parmetro URL na QueryString.

3.1.2.

Webservice da IES

A Instituio poder desenvolver um webservice para que o portal busque os dados em seus servidores. O mtodo de busca de dados dever respeitar a mesma estrutura do webservice do portal. No ANEXO 1 esto todas as especificaes para criao do webservice.

Aplicaes:
O Portal busca os dados na IES no momento em que uma matrcula requisitada pelo usurio no Portal. importante ressaltar que caso o webservice esteja indisponvel no momento em que os dados forem acessados no Portal.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 13 de 17

Portal TUI

3.1.3.

Carga de dados

A Instituio gera um arquivo TXT, CSV ou XLS/XLSX e envia para a Better Solutions por e-mail. Em at dois dias teis os dados so importados para o Portal. O arquivo dever possuir o cabealho de acordo com as especificaes contidas no ANEXO 1. Os dados que no se enquadrarem nas especificaes sero ignorados durante a importao. O e-mail para recebimento dos dados para importao suporte@portaltui.com.

Exemplo de um envio do arquivo:

Este somente um exemplo. Os dados acima no representam necessariamente as informaes que devero constar, principalmente nos campos cod_barras e linha_4. importante atentar-se no cabealho e nas especificaes do ANEXO 1 para que no existam rejeies de registros.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 14 de 17

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 atualizao de dados no Portal. Para receber os dados atualizados, basta a IES disponibilizar um webservice recebendo essa estrutura. Este recurso opcional. Para no enviar os campos opcionais, basta remover a TAG correspondente. A estrutura do XML validada atravs de um arquivo XSD. Faa o download do arquivo padro no endereo: http://www.portaltui.com/webservices/xsd/dados.xsd

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 15 de 17

Portal TUI

ANEXO 1
Campos obrigatrios:
Campo cod_filial Tipo Numrico Qtde. Mx. de Caracteres 3 Observao Cdigo da Filial (Campus da IES). Dever corresponder ao mesmo cdigo cadastrado no Santander. Matrcula ou RA. Caso existam matrculas iguais em filiais diferentes, o tamanho mximo deste campo dever ser de 10 dgitos. Nome Completo. Nmero do CPF. Linha 4 do carto. A Instituio poder definir qual informao ser impressa nesta linha. Pode ser o curso do aluno, o departamento do funcionrio, a matrcula, etc., desde que no ultrapasse 33 caracteres. Cdigo de Barras que ser impresso no carto. 1 = Aluno; 2 = Professor; 3 = Funcionrio; 4 = Ps-Graduao (Outros) Somente ser aceito um dos quatro nmeros acima. Enviar somente o nmero, sem a descrio, conforme exemplo. 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. Curso do aluno. Ms e ano em que o aluno terminar o curso. Formato 'MMAAAA', onde MM o ms com 2 dgitos e AAAA o ano com 4 dgitos. Exemplo 001

matricula

Numrico

15

12345

nome cpf_numero linha_4

Alfanumrico Numrico Alfanumrico

80 11 33

JOAQUIM JOSE DA SILVA XAVIER 01234567899 ADM EMPRESAS

cod_barras tipo_vinculo

Numrico Numrico

14 1

12345 1

ano_em_curso

Numrico

01

curso data_termino_curso

Alfanumrico Numrico

80 6

ADMINISTRAO DE EMPRESAS 122011

Todos os campos acima so obrigatrios. O nome impresso no carto poder contar no mximo 20 caracteres. Caso possua essa informao, envie na tag <nome_resumido>. Caso no 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. Atravs do portal, possvel alterar todos os dados, desde que o usurio esteja habilitado a faze-lo.

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 16 de 17

Portal TUI

4. CONTATOS
A Better Solutions possui uma equipe exclusiva e especializada disponvel para assessorar e ajudar nas atividades operacionais de implantao e ps-implantao, e eventuais dvidas que possam surgir por parte da IES.

REA

TELEFONE

E-MAIL

COMERCIAL / TCNICO

(11) 4185-7516 (11) 9488-2023

carlos@bettersolutions.com.br

SUPORTE / DESENVOLVIMENTO

(11) 4185-7516

suporte@portaltui.com

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 Carapicuba/SP CEP 06320-020

Portal TUI - Manual de Procedimentos (Ver. 1.3).docx

Better Solutions Pgina 17 de 17