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. Data: 03/06/2011 RUA DR. LIRÁUCIO GOMES, 55 – CAMBUÍ – CAMPINAS – SP TABELAS PARA CRIAÇÃO DO WEBSERVICE 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 2 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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 Exemplo de tela do portal, com o logotipo da agência ao lado: PÁGINA 3 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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. Ao clicar nele se abrirá o portal de reservas separadamente. PÁGINA 4 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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 iframe. PÁGINA 5 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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 6 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO Ao clicar em “Pesquisar” na resposta virá como abaixo. PÁGINA 7 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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 8 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO Ao clicar em “Pesquisar” na resposta virá como abaixo. Dentro da mesma página. PÁGINA 9 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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 10 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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. PÁGINA 11 TABELAS PARA CRIAÇÃO DO WEBSERVICE DA ANCORADOURO 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. PÁGINA 12 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. 12. Dúvidas Em caso de dúvidas enviar um e-mail para [email protected] (TI), com cópia para [email protected] (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. PÁGINA 15 Ancoradouro É a Ancoradouro sempre procurando oferecer cada vez mais serviços para facilitar a vida do Agente de Viagens