Upload
ciroufvjm
View
399
Download
0
Embed Size (px)
DESCRIPTION
manual para cadastro de foto
Citation preview
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 3 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 4 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 5 de 17
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é
Formato: JPG Resolução: 72 DPI Largura: 980 pixels Altura: 45 a 60 pixels
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 6 de 17
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
Formato: JPG Resolução: 72 DPI Largura: 980 pixels Altura: 120 a 160 pixels
TELA DE DADOS CADASTRAIS: Imagem do rodapé
Formato: JPG Resolução: 72 DPI Largura: 980 pixels Altura: 45 a 60 pixels
POPUP DE CAPTURA E VISUALIZAÇÃO DA FOTO: Imagem do cabeçalho
Formato: JPG Resolução: 72 DPI Largura: 620 pixels Altura: 120 a 160 pixels
POPUP DE CAPTURA E VISUALIZAÇÃO DA FOTO: Imagem do rodapé
Formato: JPG Resolução: 72 DPI Largura: 620 pixels Altura: 45 a 60 pixels
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 7 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 8 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 9 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 10 de 17
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>
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 11 de 17
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 />
<descricao_retorno />
</retorno>
AlterarFilial(string sChave, string sNovoCodFilial) string
O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.
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 />
<descricao_retorno />
</retorno>
EnviarFoto(string sChave, byte[] imgFoto) string
Este método permite enviar uma foto para o portal.
O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.
O parâmetro imgFoto é um “array de bytes” a imagem “JPG”.
Retorno XML:
<retorno>
<cod_retorno />
<descricao_retorno />
</retorno>
SolicitarNovaVia(string sChave, int iCodigoMotivo) string
Este método permite enviar uma foto para o portal.
O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.
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 />
<descricao_retorno />
</retorno>
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 12 de 17
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.
O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.
Retorno XML:
<retorno>
<cod_retorno />
<descricao_retorno />
</retorno>
ObterStatusPedido(string sChave) string
Este método obtém o status atual do ultimo pedido.
O parâmetro sChave é uma “string” deverá receber a chave retornada do Método ObterChave.
Retorno XML:
<retorno>
<cod_retorno />
<descricao_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
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 13 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 14 de 17
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.
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 15 de 17
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
Portal TUI
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 16 de 17
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
Portal TUI - Manual de Procedimentos (Ver. 1.3).docx Better Solutions Página 17 de 17
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
SUPORTE / DESENVOLVIMENTO
(11) 4185-7516
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