RUA DR. LIRÁUCIO GOMES, 55 – CAMBUÍ – CAMPINAS – SP
COMO DISPONIBILIZAR A CONSULTA DE
DISPONIBILIDADE E OS LOGINS PARA OS
PORTAIS DA ANCORADOURO NO SITE DA
AGÊNCIA DE VIAGENS
Objetivo:
Integrar a página inicial do site da agência de viagens ao portal de
reservas da Ancoradouro para que o cliente da agência possa utilizar o
eFácil em suas consultas. Permitir que os logins sejam feitos diretamente
do site da agência, sem precisar abrir os portais da Ancoradouro.
1. Definição
Esta integração permite o uso do eFácil Cliente, uma área de consultas voltada ao cliente final atendido pela agência de viagens, ao site da agência de viagens.
Ela pode ser feita de várias formar, as principais são:
Link na página inicial do site da agência que abre o eFácil Cliente numa página externa (exemplo: pop-up);
Link na página inicial do site da agência que abre o eFácil Cliente dentro do site da agência, com menus e cabeçalhos personalizados;
Site da agência com uma consulta personalizada que abre o eFácil Cliente numa página externa (exemplo: pop-up) já com a consulta efetuada;
Site da agência com uma consulta personalizada que abre o eFácil Cliente na mesma página com menus e cabeçalhos personalizados.
A abertura do eFácil Cliente na mesma página tem como ideia principal colocar um cabeçalho personalizado ou abri-lo dentro da própria página da agência, com os menus da agência. Entretanto, vale lembrar que isto se vale de um componente iframe, considerando inseguro por muitos navegados, ou de uma página de frames, considerada ultrapassada pelos navegadores atuais.
A ideia de se abrir o eFácil Cliente em uma página separada é manter uma interface limpa, uma vez que o logotipo da agência já aparece no topo dele. O logotipo da agência não pode ser retirado da tela de consultas.
Outra facilidade importante que também é possível é a inserção de campos de login e senha no site da agência e ao clicar em, por exemplo, “Entrar”, o usuário já é encaminhado logado para um dos portais da Ancoradouro.
Nos próximos itens estão descritos como implementar cada caso. Baixe também os arquivos de exemplo, que complementam este manual.
PÁGINA 3
2. eFácil Cliente: Como obter o link de acesso
Contate seu executivo de contas e lhe peça o link para vincular seu site ao portal de reservas da Ancoradouro (eFácil Cliente).
Ele te passará um link parecido com o abaixo:
http://efacil.tur.br/cliente/Produtos/Easy/easyLoad.aspx?Agencia=2881
Seu código de cliente no sistema
3. eFácil Cliente: Link na página inicial do site da agência que
abre o portal numa página externa
Arquivo de exemplo: integracao-portal-e-site-agencia-exemplo1.htm Colocar o link recebido no código fonte da página.
Baixar arquivo de exemplo no site da Ancoradouro (integracao-portal-e-site-agencia-exemplo1.htm). O link na tela ficará como na figura abaixo.
PÁGINA 5
4. eFácil Cliente: Link na página inicial do site da agência que
abre o portal dentro do site da agência, com menus e
cabeçalhos personalizados
Arquivo de exemplo: integracao-portal-e-site-agencia-exemplo2.htm Colocar o link recebido no código fonte da página, dentro de um iframe. Baixar arquivo de exemplo no site da Ancoradouro (integracao-portal-e-site-agencia-exemplo2.htm).
A página ficará como na figura abaixo. As respostas virão sempre dentro da área do
5. eFácil Cliente: Site da agência com uma consulta
personalizada que abre o portal numa página externa já com
a consulta efetuada
Arquivo de exemplo: integracao-portal-e-site-agencia-exemplo3.htm
Colocar as opções de pesquisa diretamente na página da agência e enviado junto ao link recebido, conforme exemplo abaixo.
http://efacil.tur.br/cliente/Produtos/Easy/easyLoad.aspx?Agencia=2881&Dados=CPQ*Brasilia*10/4/2011*15 /4/2011*2*1*0
ou
http://efacil.tur.br/cliente/Produtos/Easy/easyLoad.aspx?Agencia=2881&Dados=CPQ*Brasilia*10/4/2011** 2*1*0
Cidade de origem: pode ser o código Iata ou parte do nome sem acentos* Cidade de destino: pode ser o código Iata ou parte do nome sem acentos* Data de ida: data no formato D/M/YYYY ou DD/MM/YYYY
Data de volta: data no formato D/M/YYYY ou DD/MM/YYYY Quantidade de pasageiros: pela ordem, adultos, crianças e colos
Todos os campos devem ser separados por “*” conforme o exemplo acima.
* Procure enviar sempre o código da cidade, para evitar que diferenças entre os nomes das cidades em nosso banco conflitem com os nomes em seu banco.
Exemplo de código fonte com a consulta implementada.
Baixar arquivo de exemplo no site da Ancoradouro (integracao-portal-e-site-agencia-exemplo3.htm). A pesquisa na página ficará conforme abaixo.
PÁGINA 7
6. eFácil Cliente: Site da agência com uma consulta
personalizada que abre o portal na mesma página com
menus e cabeçalhos personalizados já com a consulta
efetuada
Arquivo de exemplo: integracao-portal-e-site-agencia-exemplo4.htm
Colocar as opções de pesquisa diretamente na página da agência e enviado junto ao link recebido, conforme exemplo abaixo.
http://efacil.tur.br/cliente/Produtos/Easy/easyLoad.aspx?Agencia=2881&Dados=CPQ*Brasilia*10/4/2011*15 /4/2011*2*1*0
Cidade de origem: pode ser o código Iata ou parte do nome sem acentos* Cidade de destino: pode ser o código Iata ou parte do nome sem acentos* Data de ida: data no formato D/M/YYYY ou DD/MM/YYYY
Data de volta: data no formato D/M/YYYY ou DD/MM/YYYY Quantidade de pasageiros: pela ordem, adultos, crianças e colos
Todos os campos devem ser separados por “*” conforme o exemplo acima.
* Procure enviar sempre o código da cidade, para evitar que diferenças entre os nomes das cidades entre seu banco e o nosso entrem em conflito.
Exemplo de código fonte com a consulta implementada.
Baixar arquivo de exemplo no site da Ancoradouro (integracao-portal-e-site-agencia-exemplo4.htm). A pesquisa na página ficará conforme abaixo.
PÁGINA 9
7. Efácil Cliente: Cidades
Como a pesquisa é feita diretamente na página da agência, não há como sugerir as cidades, como ocorre dentro de nosso portal, onde há um cadastro das cidades utilizado pelo eFácil.
Para que isto seja feito a agência deve ter a lista de cidades e montar seu próprio menu dropdown sugerindo-as cidades.
Normalmente, os desenvolvedores já têm a lista de cidades para importação, mas caso não tenha, podemos oferecer a lista de cidades conforme cadastradas em nosso sistema, para que possam ser importadas.
PÁGINA 11
8. Efácil Cliente: Arquivos de exemplo
Na nossa página na internet você encontra arquivos de exemplo de como implementar cada um dos modelos descritos acima.
Entre nele (ancoradouro.com.br) e clique no link “eFácil no seu site” e baixe-o. Se você pegou este manual do nosso site, você encontrará o pacote em formato zip com estes arquivos de exemplo disponíveis para download no mesmo lugar.
9. eFácil Corporate: Como obter o link de acesso
O objetivo deste link é possibilitar ao usuário da empresa entrar no próprio site da agência, digitar seu e-mail e senha e logar-se no portal Corporate, como se estivesse logando no site da própria agência.
O link deve ser montado conforme abaixo:
http://efacil.tur.br/cliente/produtos/corporate/Default.aspx?Criptografado=S&WoobaLogin=XXX&WoobaSenha=YYY
Usuário digitado criptografado em Base64 Senha do usuário criptografada em Base64 Exemplo de tela com usuário e senha:
Abaixo, tela a qual o usuário será enviado após o login. Preferencialmente, um pop-up, uma página nova ou na mesma página. Seu desenvolvedor escolherá a melhor maneira.
10. eFácil Agência: Como obter o link de acesso
O objetivo deste link é possibilitar ao usuário da empresa entrar no próprio site da agência, digitar seu e-mail e senha e logar-se no portal Corporate, como se estivesse logando no site da própria agência.
O link deve ser montado conforme abaixo:
http://efacil.tur.br/cliente/guiautenticador.aspx?Criptografado=S&WoobaLogin=XXX&WoobaSenha=YYY
Usuário digitado criptografado em Base64 Senha do usuário criptografada em Base64 Exemplo de tela com usuário e senha:
Abaixo, tela a qual o usuário será enviado após o login. Preferencialmente, um pop-up, uma página nova ou na mesma página. Seu desenvolvedor escolherá a melhor maneira.
11. OperadoraOnLine: Como obter o link de acesso
O objetivo deste link é possibilitar ao usuário da empresa entrar no próprio site da agência, digitar seu e-mail e senha e logar-se no portal Corporate, como se estivesse logando no site da própria agência.
O link deve ser montado conforme abaixo:
http://operadoraonline.tur.br/1/default.aspx?Criptografado=S&WoobaLogin=XXX&WoobaSenha=YYY
Usuário digitado criptografado em Base64 Senha do usuário criptografada em Base64 Exemplo de tela com usuário e senha:
Tela ao qual o usuário será enviado após o login. Preferencialmente, um pop-up, uma página nova ou na mesma página. Seu desenvolvedor escolherá a melhor maneira.
PÁGINA 15
12.
Dúvidas
Em caso de dúvidas enviar um e-mail para vander@ancoradouro.com.br (TI), com cópia para roberto@ancoradouro.com.br (Comercial).
FAQs:
Para que servem os link do OperadoraOnLine e do eFácil Agência (portal)?
Apenas para facilitar o acesso a estas ferramentas pelo funcionário da agência de viagens. Os links mais úteis realmente são (1) Corporate, que permite que os funcionários da empresa loguem-se a partir do seu site e (2) eFácil Cliente, que permite a primeira consulta de voos pelo cliente direto também através do seu site.