XML WEBSERVICE ANCDWS

Transcrição

1 Objetivo: Fornecer acesso, aos nossos clientes, das vendas efetuadas e faturadas junto a Ancoradouro, para que possam integrar com seu Back-Office, confrontando com o que está em seu sistema ou simplesmente dando entrada nas vendas à partir da consulta ao nosso XML WebService. Data: 15/09/2012 Versão 3.1r1 RUA DR. LIRÁUCIO GOMES, 55 CAMBUÍ CAMPINAS SP

2 Índice XML WEBSERVICE ANCDWS 1.Versões WebServices disponíveis AncdWS Modelo Ancoradouro AncdWSAgi Modelo STur AGI Sistemas AppsWS Modelo Apps Sistemas Vendas e usuário para testes Aplicação para teste Como obter seu acesso ao WebService Dúvidas, sugestões e suporte FAQ Perguntas frequentes PÁGINA 2

3 1. Versões Versão Data da liberação Tarefas realizadas /01/ Criado o WebService e liberado para acesso de testes /01/ Correção: Valores eram retornados no formato americano. - Liberado um WebService específico para a AGI, com possibilidade de criação de outros modelos. - Adaptado o WebService da AGI para ser possível ver consultar vendas por período: ConsultarVenda e ConsultarVendas /01/ Correção: Vendas com trechos OPEN retornavam falta de dados no objeto. - Correção: Vendas múltiplas formas não retornavam os dados separadamente. - Inclusão das tags: repassedu, taxacartaodu e tarifacheia. - Criação de uma rotina de testes, em que seja preciso ter um usuário válido no sistema. - Liberação de bilhetes específicos para os testes. - Inseridas as tags obrigatórias: formrec e vencrec, mas os retornos serão sempre vazios /02/ Alterado o tipo de produto (tag tipoproduto). Quando for bilhete físico retornará Aereo, quando for e- ticket retornará Etkt. - A palavra Ancoradouro na TAG origem foi colocada em maiúsculas. - As tags comisrecforvalor, descpagclivalor e observacao foram mudadas de bilhetes/bilhete para o aereorodoviario. - O número do vôo de trechos/segmento não traz mais o código da companhia. Agora existem dois campos: - ciaaerea Código de 2 ou 3 letras da cia aérea - vôo Número do vôo /03/ Não é mais obrigatório informar a data de emissão ou o período de emissão. Será considerada a data atual como período ou como data de emissão. - STUR: As vendas com múltiplas formas estão sendo retornadas em duas tags venda complementares, pois a AGI ainda não tem um padrão para este tipo de venda. - STUR: As vendas GR (Requisição Governamental)

4 estavam sendo retornadas sem forma de pagamento, agora estão sendo retornadas como faturadas. - Foi criado um WebService no padrão da APPS e disponibilizado. - Foi criado um WebService em um padrão próprio da Ancoradouro para atender às outras empresas interessadas na integração. - Esta versão já está com a descrição dos 3 modelos criados /05/2009 AncdWS - Alterado o cabeçalho do retorno do XML em string de utf-16 para utf-8. - Incluídas 2 tags no AncdWS MoedaDaTarifaPublicada TarifaPublicada - Mudada a ordem de retorno das tags Cambio e Moeda que passa a ser retornada antes da Tarifa - A tag Descontos em Bilhetes foi alterada para Incentivo. AncdWSAgi - Alterado o cabeçalho do retorno do XML em string de utf-16 para utf-8. AncdWSApps - Alterado o cabeçalho do retorno do XML em string de utf-16 para utf-8. AncdWSFaturamento - Disponibilizado novo WebService para possibilitar a conciliação automática de faturas /08/2009 AncdWS - Tratado o erro de retorno quando informados dados nulos. - Incluída a possibilidade de se filtras as vendas por centro de custo. AncdWSAgi - Tratado o erro de retorno quando informados dados nulos. AncdWSApps - Descontinuado.

5 AncdWSFaturamento - Tratado o erro de retorno quando informados dados nulos. Manual - Aplicações Delphi não passam os dados sem o registro de uma chamada. Colocado isto no manual /10/2009 AncdWS - Alterado o endereço dos WebServices para: - Alterada a tag Descontos para Incentivos - Alterada a tag TaxasDeEmbarque para TaxasDeEmbarqueEPenalidades - Retirada a tag DataFinal no período da consulta. Agora só retornam as vendas dos últimos 10 dias. - Retirada a necessidade de se informar a tag DataInicial da consulta por período. Caso ela não seja informada, serão retornadas somente as vendas que ainda não foram integradas. Esta tag continua sendo obrigatória quando a consulta for para venda específica. - Retirada a tag Bilhete da consulta, agora só poderão ser feitas consultas de vendas utilizando-se os localizadores. - Alterado o usuário de teste para: teste@ancoradouro.com.br, senha teste.ws. Ainda não é possível testar todas as situações de vendas, elas serão disponibilizadas breve, mas é possível consultar vendas com as tags alteradas. - As tags Taxas nos pagamentos e nos Totais foram alteradas para TaxasDeEmbarqueEPenalidades - Foram inseridas as tags TaxaDU e TaxaDoCartaoSobreDU nas formas de pagamento. AncdWSAgi - Alterados os endereços dos webservices para: - A tag taxasembarque agora trará adicionada as taxas da cia por alteração. - Retirada a tag datafinal no período da consulta. Agora só retornam as vendas dos últimos 10 dias. - Retirada a necessidade de se informar a tag datainicial da consulta por período. Caso ela não seja

6 informada, serão retornadas somente as vendas que ainda não foram integradas. Esta tag continua sendo obrigatória quando a consulta for para venda específica. - Retirada a tag bilhete da consulta, agora só poderão ser feitas consultas de vendas utilizando-se os localizadores. - Alterado o usuário de teste para: teste@ancoradouro.com.br, senha teste.ws. Ainda não é possível testar todas as situações de vendas, elas serão disponibilizadas breve, mas é possível consultar vendas com as tags alteradas /02/2009 AncdWS - Corrigida falha no manual onde dizia que o câmbio sempre viria como 1,00. A partir das mudanças ocorridas no WebService em Maio (versão 1.5) o câmbio já começou a vir conforme desejado, correspondendo à cotação do dólar do dia da emissão para bilhetes internacionais e 1,00 para bilhetes nacionais. - Alterados os endereços dos serviços. AncdWSAgi - Alterados os endereços dos serviços /05/2010 AppsWS - Disponibilizado o XML neste formato. - Este XML é preferencial, por conectar-se diretamente ao BackOffice, sem um servidor de tradução intermediário. - Os WebServices AncdWS e AncdWSAgi consultam as vendas a partir deste WebService e o traduzem. - Criada a descrição do XMl de envio e retorno. AncdWS - Retirado o usuário de teste, que não será mais disponibilizado. AncdWSAgi - Retirado o usuário de teste, que não será mais disponibilizado /07/2010 AppsWS - Adicionada informação de que a tag tottarifas trás o valor em moeda de venda e que deve ser convertido

7 pelo câmbio. - Corrigido o problema da importação sem data inicial, que traz somente as vendas não-importadas, gerar erro de conversão de data. - Colocada a versão no nome do serviço. 2.3 Rev. 1 15/07/2010 AppsWS - Corrigido o endereço do WebService que estava incorreto /10/2010 AppsWS - Liberadas as informações EBTA e Corporativas AncdWS - Liberadas as informações EBTA e Corporativas AgiWS - Colocadas as informações corporativas nas observações, separadas por e ; /11/2010 AncdWS - Alterado o modo de retorno dos dados EBTA e dos dados Corporativos. Agora retorna estruturado em XML fora das observações. - Criadas tags para retorno da RAV. - Criadas tags para os dados do cartão de crédito caso a RAV seja paga através dele. IMPORTANTE: Quando for apenas um lançamento para cobrança de RAV somente a tag DadosDoCartaoRAV será retornada. IMPORTANTE: Os dados dos cartões passaram a ser retornados em criptografados em Base r1 03/12/2010 AppsWS - O retorno do valor da devolução da DU, quando cartão não estava sendo retornado. Agora quando é faturado não há RepasseDu, mas quando é cartão haverá o RepasseDU, já descontada a taxa da administradora. - Todo cartão de crédito retornará dentro das observações a informação AUT: contendo o código de autorização do cartão. AncdWS - Adicionada tag CodigoDeAutorizacao em todo retorno de cartão de crédito. AgiWS - Todo cartão de crédito retornará dentro das observações a informação AUT: contendo o código de autorização do cartão. 2.5r2 08/12/2010 AncdWS

8 - Corrigido problema de retorno do usuário emissor padrão AGRT. Quando a agência não tiver IdBackOffice cadastrado no usuário não será retornado nada. 2.5r3 13/12/2010 AncdWS - Corrigido retorno errado na tag TaxaDoCartaoSobreDU. 2.5r4 29/04/2011 AncdWS - Corrigido o retorno do caractér & para o compatível com o xml &. - Corrigido o formato do xml de UTF-8 para o correto: ISO AncdWSAgi - Corrigido o formato do xml de UTF-8 para o correto: ISO r5 20/05/2011 AncdWS - Corrigida importação dos dados corporativos com,. - As emissões agora retorna pela data de entrada no sistema, não mais pela data de emissão. - O sistema passa a permitir a consulta dos últimos 15 dias de vendas. AncdWSAgi - Corrigida importação dos dados corporativos com,. - As emissões agora retorna pela data de entrada no sistema, não mais pela data de emissão. - O sistema passa a permitir a consulta dos últimos 15 dias de vendas. 2.5r5 03/06/2011 Apenas alterado o logotipo da Ancoradouro no manual. A versão do XML não sofreu alterações. 3.0r0 18/09/2011 AncdWS - Corrigidas as informações dos voos OPEN que estavam erradas. - O ID do emissor dentro do sistema passa a ser informado se não tiver ID configurado no usuário. Para ignorá-lo deve ser cadastrado AGRT. - Foram corrigidos rateios errados dos valores por passageiro. - Cartões Amex passam a retornar só 15 dígitos. - Alterada a estrutura do sistema para facilitar correções futuras. AncdWSAgi - Corrigidas as informações dos voos OPEN que estavam erradas. - O ID do emissor dentro do sistema passa a ser

9 informado se não tiver ID configurado no usuário. Para ignorá-lo deve ser cadastrado AGRT. - Foram corrigidos rateios errados dos valores por passageiro. - Cartões Amex passam a retornar só 15 dígitos. - Alterada a estrutura do sistema para facilitar correções futuras. - Dados corporativos passaram a ser separados por,. 3.1r0 26/01/2012 AncdWS - O campo emissor estava localizado dentro dos dados corporativos e for transferido para a venda. A tag Venda->DadosCorporativos->Emissor foi retirada e a tag Venda->CodigoDoEmissorNaAgencia foi criada. 3.1r0 08/02/2012 Transferida para o HelpDesk a liberação de usuários. 3.1r1 15/09/2012 Não serão mais aceitos desenvolvimentos no modelo antigo Ancoradouro, apenas no modelo Apps. Este modelo serve para integrar a qualquer fornecedor que possua BackOffice Apps.

10 2. WebServices disponíveis clientes. Haverá vários WebServices disponíveis de acordo com a necessidade as Ancoradouro e de seus Atualmente, está sendo liberado o WebService específico para o padrão do STur, da AGI Sistemas. Apesar do padrão, é um WebService aberto à utilização de qualquer cliente. Posteriormente, será criado um WebService da própria Ancoradouro. A vantagem é que se for solicitada alguma alteração ao WebService, os outros clientes não terão que efetuar alterações que não concordem e que prejudiquem sua integração, pois as mudanças serão feitas de modo a precisar do mínimo de alterações possíveis. Mesmo assim, a possibilidade de alteração dos WebServices específicos é remota, devido às poucas mudanças que podem ocorrer. WebService: Padrão: Endereço HTTP: Endereço HTTPS: WSDL HTTP: WebService: Padrão: Endereço HTTP: WSDL HTTP: WebService: Padrão: Endereço HTTP: Endereço HTTPS: WSDL HTTP: AncdWS Ancoradouro AppsWS Apps AncdWSAgi STur

11 3. [Descontinuado] AncdWS Modelo Ancoradouro [[[ESTE MODELO NÃO DEVE SER IMPLEMENTADO, ele será mantido e atualizado apenas para manter compatibilidade com integrações antigas]]] Ao utilizar uma data inicial na solicitação, ele trará todas as vendas existentes, mas se uma data inicial não for informada serão retornadas todas as vendas no sistema que não foram retornadas antes. Métodos disponíveis ConsultarVenda Traz todos os bilhetes referentes a um localizador ou o bilhete especificado. ConsultarVendaXML Traz todos os bilhetes referentes a um localizador ou o bilhete especificado em formato string. ConsultarVendas Traz todos os bilhetes referentes do período especificado. O período máximo é de 15 dias. Entretanto, recomenda-se consultar apenas de um dia, pois a consulta de muitos bilhetes é mais demorada. ConsultarVendasXML Traz todos os bilhetes referentes do período especificado, mas numa string em formato XML. O período máximo é de 15 dias. Entretanto, recomenda-se consultar apenas de um dia, pois a consulta de muitos bilhetes é mais demorada.

12 Método: ConsultarVenda Consulta: <ConsultarVenda>(1) <DataDeEmissao>Data[dd/MM ou dd/mm/yy ou dd/mm/yyyy]{5,8,10}</datadeemissao>(1) <Localizador>String[A]{0-10}</Localizador> <Senha>String[X]{6-30}</Senha>(1) </ConsultarVenda> dd Dia MM Mês yyyy ou yy - Ano A - {0,2} Zero ou 2 caracteres {3-5} De 3 a 5 caracteres, não pode vir vazio (1) Deve aparecer uma vez Descrição da consulta: <ConsultarVenda>. <DataDeEmissao> Data de emissão do bilhete ou do localizador. Se não for preenchido é considerada a data atual.. <Localizador> Localizador da reserva. <Usuario> de usuário para login. <Senha> Senha do usuário. Cada ponto corresponde a um nível dentro da tag raiz Resposta: <ConsultarVendaResponse>(1) <Vendas>(0-1) <Venda>(0+) <FilialAncoradouro>String[A]{1-10}</FilialAncoradouro>(1) <Codigo>String[X]{1-20}</Codigo>(1) <Localizador>String[A]{1-15}</Localizador>(1) <LoginDoEmissor>String[X]{0-100}</LoginDoEmissor>(1) <CodigoDoEmissorNaAgencia>String[X]{0-50}</CodigoDoEmissorNaAgencia>(1) <DataDeEmissao>Data[dd/MM/yyyy]{10}</DataDeEmissao>(1) <ModoDeEntrada>String[A]{1-50}</ModoDeEntrada>(1) <Observacao>String[X]{0-200}</Observacao>(1) <CentroDeCusto>String[X]{0-50}</CentroDeCusto>(1) <DadosCorporativos>(0-1) <Atividade>String[X]{0-50}</Atividade>(1) <Cliente>String[X]{0-50}</Cliente>(1) <CentroDeCusto>String[X]{0-50}</CentroDeCusto>(1) <ContaContabil>String[X]{0-50}</ContaContabil>(1) <ClasseDeValor>String[X]{0-50}</ClasseDeValor>(1) <Departamento>String[X]{0-50}</Departamento>(1) <Empenho>String[X]{0-50}</Empenho>(1) <InformacaoDeControle>String[X]{0-50}</InformacaoDeControle>(1) <Matricula>String[X]{0-50}</Matricula>(1) <Motivo>String[X]{0-50}</Motivo>(1) <Projeto>String[X]{0-50}</Projeto>(1) <Evento>String[X]{0-50}</Evento>(1)

13 <Referencia>String[X]{0-50}</Referencia>(1) <ReferenciaAdicional>String[X]{0-50}</ReferenciaAdicional>(1) <Requisicao>String[X]{0-50}</Requisicao>(1) <Solicitante>String[X]{0-50}</Solicitante>(1) <UnidadeDeNegocios>String[X]{0-50}</UnidadeDeNegocios>(1) </DadosCorporativos> <Bilhetes>(1) <Bilhete>(0+) <Codigo>Int[#]{1-20}</Codigo>(1) <Numero>Int[#]{1-15}</Numero>(1) <BilhetesConjugados>(0-1) <BilheteConjugado>Int[#]{0-15}</BilheteConjugado>(0+) </BilhetesConjugados> <TipoDeRota>String[A]{1}</TipoDeRota>(1) <Fornecedor>String[A]{2,3}</Fornecedor>(1) <MoedaDaTarifaPublicada>String[A]{3}</MoedaDaTarifaPublicada>(1) <TarifaPublicada>Moeda[###.###.##0,00]{4-15}</TarifaPublicada>(1) <Cambio>Moeda[## ]{0,11}</Cambio>(1) <Moeda>String[A]{3}</Moeda>(1) <Tarifa>Moeda[###.###.##0,00]{4-15}</Tarifa>(1) <TaxasDeEmbarqueEPenalidades>Moeda[###.###.##0,00]{4-15}</TaxasDeEmbarqueEPenalidades>(1) <TaxaDeServico>Moeda[###.###.##0,00]{4-15}</TaxaDeServico>(1) <TaxaDU>Moeda[###.###.##0,00]{4-15}</TaxaDU>(1) <TaxaDoCartaoSobreDU>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreDU>(1) <RAV>Moeda[###.###.##0,00]{4-15}</RAV>(1) <TaxaDoCartaoSobreRAV>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreRAV>(1) <Comissao>Moeda[###.###.##0,00]{4-15}</Comissao>(1) <Incentivo>Moeda[###.###.##0,00]{4-15}</Incentivo>(1) <DataDoCambio>Data[dd/MM/yyyy]{10}</DataDoCambio>(1) <DataHoraDosCalculos>DataHora[dd/MM/yyyy HH:MM:SS]{10}</DataHoraDosCalculos>(1) <TipoDeFaturamento>String[A]{3,5}</TipoDeFaturamento>(1) <TipoDeBilhete>String[A]{3,5}</TipoDeBilhete>(1) <Pagamentos><Pagamentos>(0-1) <Pagamento><Pagamento>(0+) <FormaDePagamento>String[A]{1-15}</FormaDePagamento>(1) <Tarifa>Moeda[###.###.##0,00]{4-15}</Tarifa>(1) <TaxasDeEmbarqueEPenalidades>Moeda[###.###.##0,00]{4-15}</TaxasDeEmbarqueEPenalidades>(1) <TaxaDeServico>Moeda[###.###.##0,00]{4-15}</TaxaDeServico>(1) <TaxaDU>Moeda[###.###.##0,00]{4-15}</TaxaDU>(1) <TaxaDoCartaoSobreDU>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreDU>(1) <RAV>Moeda[###.###.##0,00]{4-15}</RAV>(1) <TaxaDoCartaoSobreRAV>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreRAV>(1) <DadosDoCartao>(0-1) <Administradora>String[A]{0-30}</Administradora>(1) <Numero>StringBase64[X]{0-16}</Numero>(1) <Validade>Data[MM/yyyy]{0,7}</Validade>(1) <CodigoDeSeguranca>Int[#]{0-10}</CodigoDeSeguranca>(1) <Titular>String[A]{0-100}</Titular>(1) <CodigoDeAutorizacao>String[A]{20}</CodigoDeAutorizacao> <EBTA>String[A]{4-5}</EBTA>(1) <DadosEBTA> <Autorizacao>String[A]{50}</Autorizacao> <CentroDeCusto>String[A]{50}</CentroDeCusto> <Departamento>String[A]{50}</Departamento> <Matricula>String[A]{50}</Matricula> <Requisicao>String[A]{50}</Requisicao> </DadosEBTA> </DadosDoCartao> <DadosDoCartaoRAV>(0-1) <Administradora>String[A]{0-30}</Administradora>(1) <Numero>StringBase64[X]{0-16}</Numero>(1) <Validade>Data[MM/yyyy]{0,7}</Validade>(1) <CodigoDeSeguranca>Int[#]{0-10}</CodigoDeSeguranca>(1) <Titular>String[A]{0-100}</Titular>(1) <CodigoDeAutorizacao>String[A]{20}</CodigoDeAutorizacao> <EBTA>String[A]{4-5}</EBTA>(1) <DadosEBTA>

14 <Autorizacao>String[A]{50}</Autorizacao> <CentroDeCusto>String[A]{50}</CentroDeCusto> <Departamento>String[A]{50}</Departamento> <Matricula>String[A]{50}</Matricula> <Requisicao>String[A]{50}</Requisicao> </DadosEBTA> </DadosDoCartaoRAV> </Pagamento> </Pagamentos> <Passageiros>(1) <Passageiro>(0+) <Nome>String[A]{1-100}</Nome>(1) <Tipo>String[A]{0,3}</Tipo>(1) </Passageiro> </Passageiros> <Segmentos>(0-1) <Segmento>(0+) <Origem>String[A]{0,3}</Origem>(1) <Destino>String[A]{0,3}</Destino>(1) <DataDeSaida>Data[dd/MM/yyyy]{0,10}</DataDeSaida>(1) <HorarioDeSaida>Hora[HH:MM]{0,5}HorarioDeSaida>(1) <HorarioDeChegada>Hora[HH:MM]{0,5}</HorarioDeChegada>(1) <CompanhiaAerea>String[A]{2,3}</CompanhiaAerea>(1) <NumeroDoVoo>String[A]{1-4}</NumeroDoVoo>(1) <ClasseDeReserva>String[A]{0-2}</ClasseDeReserva>(1) <Situacao>String[A]{0,2}</Situacao>(1) <BaseTarifaria>String[A]{0-20}</BaseTarifaria>(1) </Segmento> </Segmentos> </Bilhete> </Bilhetes> <Totais>(1) <Tarifa>Moeda[###.###.##0,00]{4-15}<Tarifa>(1) <TaxasDeEmbarqueEPenalidades>Moeda[###.###.##0,00]{4-15}</TaxasDeEmbarqueEPenalidades>(1) <TaxaDeServico>Moeda[###.###.##0,00]{4-15}</TaxaDeServico>(1) <TaxaDU>Moeda[###.###.##0,00]{4-15}</TaxaDU>(1) <TaxaDoCartaoSobreDU>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreDU>(1) <RAV>Moeda[###.###.##0,00]{4-15}</RAV>(1) <TaxaDoCartaoSobreRAV>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreRAV>(1) <Comissao>Moeda[###.###.##0,00]{4-15}</Comissao>(1) <Incentivo>Moeda[###.###.##0,00]{4-15}</Incentivo>(1) <Pagamentos>(0-1) <Pagamento>(0+) <FormaDePagamento>String[A]{1-15}</FormaDePagamento>(1) <Tarifa>Moeda[###.###.##0,00]{4-15}</Tarifa>(1) <TaxasDeEmbarqueEPenalidades>Moeda[###.###.##0,00]{4-15}</TaxasDeEmbarqueEPenalidades>(1) <TaxaDeServico>Moeda[###.###.##0,00]{4-15}</TaxaDeServico>(1) <TaxaDU>Moeda[###.###.##0,00]{4-15}</TaxaDU>(1) <TaxaDoCartaoSobreDU>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreDU>(1) <RAV>Moeda[###.###.##0,00]{4-15}</RAV>(1) <TaxaDoCartaoSobreRAV>Moeda[###.###.##0,00]{4-15}</TaxaDoCartaoSobreRAV>(1) </Pagamento> </Pagamentos> </Totais> </Venda> <Erros>(0-1) <Numero>Int[#]{1-*}</Numero>(1) <Descricao>String[A]{*}</D/escricao>(1) <Local>String[A]{*}</Local>(1) <Observacao>String[A]{*}</Observacao>(1) </Erros> </ConsultarVendaResponse> dd/mm/yy dd/mm/yyyy Dia, mês e ano HH:MM:SS Hora, minuto e segundo A Alfanumérico X Qualquer caractere

15 # - Número {*} Zero ou mais caracteres {1-*} Pelo menos um caractere será retornados {0,2} Zero ou 2 caracteres {3-5} De 3 a 5 caracteres, não pode vir vazio {3} Sempre retornará 3 cracteres (0-2) Poderá aparecer a quantidade de vezes mostrada, neste caso de 0 a 2 vezes (0+) Poderá aparecer mais de 1 vez, podendo não ser retornada (1+) Poderá aparecer mais de 1 vez, mas pelo menos na quantidade mostrada Descrição da resposta: <ConsultarVendaResponse>. <Vendas> Tag principal. Não se repete. Dentro virá uma array Venda. XML WEBSERVICE ANCDWS.. <Venda> Cada localizador vem dentro de uma venda. Se não vier esta tag foi porque deu erro. Neste caso, virá a tag erros... <FilialAncoradouro> Código da filial da Ancoradouro onde o bilhete foi adquirido. Normalmente virá CPQ, RAO, BAU ou SJK... <Codigo> Id da venda em nosso sistema... <Localizador> Localizador da venda... <LoginDoEmissor> Login do emissor quando a venda vier do portal da Ancoradouro... <CodigoDoEmissorNaAgencia> Emissor do bilhete. Será retornado o código do emissor no BackOffice da agência caso configurado no cadastro do usuário... <DataDeEmissao>Data de emissão dos bilhetes da venda... <ModoDeEntrada> Informa se a venda foi digitada manualmente ou se veio de uma fonte automatizada: MANUAL ou AUTOMATICO.. <Observacao> Se veio do PORTAL, mostra o sistema utilizado e o IP público do usuário que efetuou a emissão... <CentroDeCusto> Centro de custo da agência na Ancoradouro... <DadosCorporativos>... <Atividade> Atividade.... <Cliente> Código do cliente da agência no seu BackOffice, conforme configurado no cadastro do cliente.... <CentroDeCusto> Centro de custo do cliente da agência.... <ContaContabil> Conta contábil.... <ClasseDeValor> Classe de valor.... <Departamento> Departamento.... <Empenho> Empenho.... <InformacaoDeControle> Informação.... <Matricula> Matrícula.

16 ... <Motivo> Motivo.... <Projeto> Código do projeto.... <Evento> Evento.... <Referencia> Código de referência.... <ReferenciaAdicional> Código de referência adicional.... <Requisicao> Requisição.... <Solicitante> Solicitante corporativo da emissão.... <UnidadeDeNegocios> Unidade de negócios... <Bilhetes>Lista de bilhetes da venda. Não se repete.... <Bilhete>Cada bilhete virá numa tag Bilhete..... <Codigo>Id único do bilhete em nosso sistema..... <Numero> Número do bilhete. Exceção: AZUL ou GOL Virá vazio, pois não possuem número de bilhete..... <BilhetesConjugados>Lista de bilhetes conjugados. Não se repete <BilheteConjugado>Cada bilhete conjugado virá numa tag BilheteConjugado..... <TipoDeRota> I Internacional N Nacional.... <Fornecedor> Código da empresa aérea fornecedora dos bilhetes.... <MoedaDaTarifaPublicada> Será retornado BRL para rotas nacionais e USD para rotas internacionais..... <TarifaPublicada> Será retornado o valor da tarifa em BRL para rotas nacionais e o valor da tarifa em USD para rotas internacionais..... <Cambio> Câmbio para conversão para reais..... <Moeda> Moeda local de pagamento do bilhete. Sempre será retornado em BRL. Todos os valores restantes virão nesta moeda..... <Tarifa> Tarifa do bilhete..... <TaxasDeEmbarqueEPenalidades> Taxas de embarque do bilhete..... <TaxaDeServico> Taxas de serviço (Fee)..... <TaxaDU> Repassa a terceiros (Taxa DU)..... <TaxaDoCartaoSobreDU> Taxa cobrada pelo cartão de crédito sobre os valores da taxa DU que foram cobrados no cartão..... <RAV> RAV Remuneração do Agende de Viagens (Repasse a terceiros)..... <TaxaDoCartaoSobreRAV> Taxa cobrada pelo cartão de crédito sobre os valores da RAV que foram cobrados no cartão.

17 .... <Comissao> Comissão do bilhete..... <Incentivo> Incentivos concedidos..... <DataDoCambio> Sempre virá a data de emissão, pois o câmbio sempre deve ser o do dia corrente..... <DataHoraDosCalculos> Data em que os cálculos dos descontos foram gerados..... <TipoDeFaturamento> COPET ou BSP..... <TipoDeBilhete> E TKT, PAPEL ou MCO..... <Pagamentos> Lista de pagamentos do bilhete <Pagamento> Cada pagamento virá numa tag Pagamento <FormaDePagamento> Forma de pagamento: CASH, FATURADO, GOVERNO ou CARTAO <Tarifa> Parte da tarifa nesta forma de pagamento <TaxasDeEmbarqueEPenalidades> Taxas e penalidades <TaxaDeServico> Taxa de serviço (Fee) <TaxaDU> Repassa a terceiros (Taxa DU) <TaxaDoCartaoSobreDU> Taxa cobrada pelo cartão de crédito sobre os valores da taxa DU que foram cobrados no cartão <RAV> RAV Remuneração do Agende de Viagens (Repasse a terceiros) <TaxaDoCartaoSobreRAV> Taxa cobrada pelo cartão de crédito sobre os valores da RAV que foram cobrados no cartão <DadosDoCartao> Caso seja cartão de crédito, virá com os dados do cartão. Caso contrário, não virá esta tag <Administradora> Administradora do cartão de crédito. AX Amex, CA Credicard, MC Mastercard, VI Visa HC Hypercard, DC - Diners Club <Numero> Número do cartão de crédito. Só serão visíveis os últimos números. Os primeiros aparecerão escondidos. Criptografado em Base <Validade> Data de validade do cartão <CodigoDeSeguranca> Código de segurança do cartão de crédito <Titular> Nome do titular do cartão <CodigoDeAutorizacao> Código de autorização para a cobrança <EBTA> Informa se é EBTA: true ou false <DadosEBTA> Caso seja EBTA, retorna os dados que serão enviados ao AMEX <Autorizacao> Autorização do cartão de crédito.

18 <CentroDeCusto> Centro de custo da empresa <Departamento> Departamento <Matricula> Matrícula <Requisicao> Requisição <DadosDoCartaoRAV> Caso seja cartão de crédito, virá com os dados do cartão. Caso contrário, não virá esta tag <Administradora> Administradora do cartão de crédito. AX Amex, CA Credicard, MC Mastercard, VI Visa HC Hypercard, DC - Diners Club <Numero> Número do cartão de crédito. Só serão visíveis os últimos números. Os primeiros aparecerão escondidos. Criptografado em Base <Validade> Data de validade do cartão <CodigoDeSeguranca> Código de segurança do cartão de crédito <Titular> Nome do titular do cartão <CodigoDeAutorizacao> Código de autorização para a cobrança <EBTA> Informa se é EBTA: true ou false <DadosEBTA> Caso seja EBTA, retorna os dados que serão enviados ao AMEX <Autorizacao> Autorização do cartão de crédito <CentroDeCusto> Centro de custo da empresa <Departamento> Departamento <Matricula> Matrícula <Requisicao> Requisição <Passageiros> Lista de passageiros do bilhete. Não se repete. Em caso de MCOs e de bilhetes da Azul e da Gol, podem ser feitos lançamentos para vários passageiros. Normalmente, virá apenas um passageiro na lista <Passageiro> Cada passageiro será retornado numa tag Passageiro <Nome> Exemplo: SILVA/JOAOMR ou SILVA/JOSE MR ou SILVA/J MR <Tipo> ADT Adulto, CHD Criança, INF Colo <Segmentos> Lista de segmentos do bilhete <Segmento> Cada segmento de vôo virá numa tag Segmento <Origem> Cidade de origem do vôo <Destino> Cidade de destino do vôo

19 <DataDeSaida> Data de saída do vôo. Não virá preenchido se for OPEN. XML WEBSERVICE ANCDWS <HorarioDeSaida> Horário de partida do vôo. Não virá preenchido se for OPEN <HorarioDeChegada> Horário de chegada do vôo. Não virá preenchido se for OPEN <CompanhiaAerea> Companhia aérea que vendeu o vôo. Caso seja codeshare, virá o da companhia que vendeu, não o da que opera <NumeroDoVoo> Número do vôo. Caso seja OPEN virá escrito OPEN <ClasseDeReserva> Classe da reserva <Situacao> Situação da reserva. Exemplo: HK. Caso seja OPEN virá escrito OPEN <BaseTarifaria> Base tarifária do segmento de voo.... <Totais> Mostra os totais da venda e dos pagamentos..... <Tarifa> Total de tarifas..... <TaxasDeEmbarqueEPenalidades> Total de taxas e penalidades.... <TaxaDeServico> Total das taxas de serviço (Fees)..... <TaxaDU> Total das taxas DU (Repasse a terceiros)..... <TaxaDoCartaoSobreDU> Total das taxas cobradas pela administradora de cartão de crédito sobre os valores das taxas DU cobradas no cartão..... <RAV> Total da RAV cobrada na venda (Repasse a terceiros)..... <TaxaDoCartaoSobreRAV> Total das taxas cobradas pela administradora de cartão de crédito sobre o valor da RAV cobrada no cartão..... <Comissao> Total das comissões..... <Incentivo> Total dos incentivos concedidos..... <Pagamentos> Lista os totais por pagamento <Pagamento> Cada pagamento virá numa tag Pagamento <FormaDePagamento> Forma de pagamento: CASH, FATURADO, GOVERNO ou CARTAO <Tarifa> Total das tarifas desta forma de pagamento <TaxasDeEmbarqueEPenalidades> Total das taxas desta forma de pagamento <TaxaDeServico> Total das taxas de serviço (Fees) desta forma de pagamento <TaxaDU> Total das taxas DU desta forma de pagamento (Repasse a terceiros) <TaxaDoCartaoSobreDU> Total das taxas cobradas pela administradora de cartão de crédito sobre os valores das taxas DU cobradas nesta forma de pagamento <RAV> Total da RAV cobrada na venda nesta forma de pagamento (Repasse a terceiros).

20 <TaxaDoCartaoSobreRAV> Total das taxas cobradas pela administradora de cartão de crédito sobre o valor da RAV cobrada nesta forma de pagamento... <Venda> Lista os erros que foram gerados. Se vier algum erro, não virá a tag Venda, ou seja, caso dê erro nenhuma venda será retornada... <Erros> Cada erro encontrado e que motive a venda não ser mostrada será colocado aqui.... <Numero> Ordem do erro na lista de erros.... <Descricao> Descrição do erro. Não há um tamanho definido, pois o erro de sistema vem completo.... <Local> Em qual processo o erro ocorreu.. Cada ponto corresponde a um nível dentro da tag raiz

21 Método: ConsultarVendaXML Consulta: Descrição da consulta: Resposta: Igual a do método ConsultarVenda. Igual a do método ConsultarVenda. <ConsultarVendaXMLResponse>(1) <ConsultarVendaXMLResult>String[XML]{*}</ConsultarVendaXMLResult>(1) </ConsultarVendaXMLResponse> XML String em formato xml {*} Zero ou mais caracteres (1) Deve aparecer uma vez Descrição da resposta: <ConsultarVendaXMLResponse>. <ConsultarVendaXMLResult> Conteúdo igual ao do método ConsultarVenda, só que serializado.. Cada ponto corresponde a um nível dentro da tag raiz Estrutura do conteúdo XML retornado: Igual a do método ConsultarVenda. Descrição do conteúdo XML retornado:: Igual a do método ConsultarVenda.

22 Método: ConsultarVendas Consulta: <ConsultarVendas>(1) <DataInicial>Data[dd/MM ou dd/mm/yy ou dd/mm/yyyy]{5,8,10}</datainicial>(1) <CentroDeCusto>String[A]{0-30}</CentroDeCusto>(0-1) <Senha>String[X]{6-30}</Senha>(1) </ConsultarVendas> dd Dia MM Mês yyyy ou yy - Ano A - {0,2} Zero ou 2 caracteres {3-5} De 3 a 5 caracteres, não pode vir vazio (1) Deve aparecer uma vez Descrição da consulta: <ConsultarVendas>. <DataInicial> Data inicial para emissão do resumo de vendas do período. Se informada: Trará todas as vendas. Máximo 15 dias atrás. Se não informada: Trará apenas as vendas não retornadas anteriormente.. <CentroDeCusto> Caso o cliente possua sua fatura dividida por centro de custo, pode solicitar os dados selecionando um centro de custo específico.. <Usuario> de usuário para login. <Senha> Senha do usuário. Cada ponto corresponde a um nível dentro da tag raiz Resposta: Descrição da resposta: Igual a do método ConsultarVenda. Apenas tag principal mudará para ConsultarVendasResponse. Igual a do método ConsultarVenda. Apenas tag principal mudará para ConsultarVendasResponse. Estrutura do conteúdo XML retornado: Igual a do método ConsultarVenda. Descrição do conteúdo XML retornado:: Igual a do método ConsultarVenda.

23 Método: ConsultarVendasXML Consulta: Descrição da consulta: Resposta: Igual a do método ConsultarVendas. Igual a do método ConsultarVendas. <ConsultarVendasXMLResponse>(1) <ConsultarVendasXMLResult>String[XML]{*}</ConsultarVendasXMLResult>(1) </ConsultarVendasXMLResponse> XML String em formato xml {*} Zero ou mais caracteres (1) Deve aparecer uma vez Descrição da resposta: <ConsultarVendasXMLResponse>. <ConsultarVendasXMLResult> Conteúdo igual ao do método ConsultarVendas, só que serializado.. Cada ponto corresponde a um nível dentro da tag raiz Estrutura do conteúdo XML retornado: Igual a do método ConsultarVenda. Descrição do conteúdo XML retornado:: Igual a do método ConsultarVenda.

24 4. [Exclusivo Agi] AncdWSAgi Modelo STur AGI Sistemas [[[ESTE MODELO NÃO DEVE SER IMPLEMENTADO, ele será mantido e atualizado apenas para manter compatibilidade com o BackOffice da Agi Sistemas]]] Ao utilizar uma data inicial na solicitação, ele trará todas as vendas existentes, mas se uma data inicial não for informada serão retornadas todas as vendas no sistema que não foram retornadas antes. Métodos disponíveis ConsultarVenda Traz todos os bilhetes referentes a um localizador ou o bilhete especificado. ConsultarVendaXML Traz todos os bilhetes referentes a um localizador ou o bilhete especificado em formato string. ConsultarVendas Traz todos os bilhetes referentes do período especificado. O período máximo é de 15 dias. Entretanto, recomenda-se consultar apenas de um dia, pois a consulta de muitos bilhetes é mais demorada. ConsultarVendasXML Traz todos os bilhetes referentes do período especificado, mas numa string em formato XML. O período máximo é de 15 dias. Entretanto, recomenda-se consultar apenas de um dia, pois a consulta de muitos bilhetes é mais demorada.

25 Método: ConsultarVenda Consulta: <ConsultarVenda xmlns=" <dataemissao>string</dataemissao> <localizador>string</localizador> <usuario>string</usuario> <senha>string</senha> </ConsultarVenda> Tag Tamanho Formato Descrição dataemissao 10 String dd/mm/yyyy Data de emissão do bilhete ou do localizador. Se não for preenchido é considerada a data atual. localizador 0-7 String Localizador da reserva usuario String senha 6-30 String Resposta: <ConsultarVendaResponse xmlns=" <vendas> <venda> <origem>string</origem> <idvenda>string</idvenda> <tipoproduto>string</tipoproduto> <clasproduto>string</clasproduto> <idemissor>string</idemissor> <dtemissao>string</dtemissao> <idcliente>string</idcliente> <idoperador>string</idoperador> <idfornecedor>string</idfornecedor> <formrec>string</formrec> <vencrec>string</vencrec> <formpagto>string</formpagto> <vencpagto>string</vencpagto> <cartaocia>string</cartaocia> <cartaonumero>string</cartaonumero> <cartaovalidade>string</cartaovalidade> <cartaocodseguranca>string</cartaocodseguranca> <titularcartao>string</titularcartao> <movimentos> <aereorodoviario> <pax>string</pax> <tipo>string</tipo> <basetarifaria>string<basetarifaria> <tarifa>string</tarifa> <tarifacheia>string</tarifacheia> <moeda>string</moeda> <cambio>string</cambio> <datacambio>string</datacambio> <taxaembarque>string</taxaembarque> <taxaservico>string</taxaservico> <repassedu>string</repassedu> <taxacartaodu>string</taxacartaodu> <bilhetes> <bilhete>

26 <numero>string</numero> </bilhete> <bilhete>...</bilhete> </bilhetes> <comisrecforvalor>string</comisrecforvalor> <descpagclivalor>string</descpagclivalor> <observacao>string</observacao> </aereorodoviario> <trechos> <segmento> <de>string</de> <para>string</para> <datasaida>string</datasaida> <horasaida>string</horasaida> <datachegada>string</datachegada> <horachegada>string<horachegada> <ciaaerea>string</ciaaerea> <voo>string</voo> <classe>string</classe> <localizador>string</localizador> <status>string</status> </segmento> <segmento>...</segmento> </trechos> </movimentos> </venda> <venda>...</venda> <erros> <erro> <numero>int</numero> <descricao>string</descricao> <local>string</local> </erro> <erro>...</erro> <observacao>string</observacao> </erros> </vendas> </ConsultarVendaResponse> Tag Tamanho Formato Descrição vendas - - Tag principal. Não se repete. Dentro virá uma array venda venda - Array Cada localizador ou forma de pagamento vem dentro de uma venda. Se não vier esta tag foi porque deu erro. Neste caso, virá a tag erros. origem 11 String Sempre virá ANCORADOURO idvenda 1-20 String Id da reserva em nosso sistema tipoproduto - String Aereo Bilhere físico Etkt Bilhete eletrônico clasproduto - String N Nacional I - Internacional idemissor 1-10 String Código do emissor ou do digitador dtemissao 10 String dd/mm/yyyy idcliente - String Sempre virá em branco, pois não temos o código do cliente da agência. idoperador 13 String Virá sempre Consolidadora

27 idfornecedor 2-3 String Código da empresa aérea formrec 0-1 String Somente será preenchido se for cartão de crédito. 3 - Cartão de crédito vencrec - String Virá sempre vazio, pois não temos a informação de como o cliente pagou ao cliente. formpagto - String 1 - Cash/À vista 2 - Faturado Vencpagto 0 String Dia do vencimento da fatura desta venda. Será retornado sempre vazio. cartaocia - String VI Visa MC Mastercard DC Diners Club AM Amex HC Hypercard Obs: Nosso sistema não diferencia as bandeiras Mastercard ou cartões corporativos e cartões pessoas físicas. Somente será preenchido se for cartão de crédito. 3 - Cartão de crédito cartaonumero 0-20 String Número do cartão de crédito, se a venda o contiver. cartaovalidade 0,7 String MM/yyyy Somente será preenchido se for cartão de crédito. 3 - Cartão de crédito Validade do cartão de crédito, se a venda o contiver. Somente será preenchido se for cartão de crédito. 3 - Cartão de crédito cartaocodseguranca 0 String Sempre será retornado vazio. titularcartao 0-50 String Nome do titular, se a venda o contiver. Somente será preenchido se for cartão de crédito. 3 - Cartão de crédito movimentos - - Não se repete. Dentro virão vários bilhetes em tags aereorodoviario aereorodoviario - Array Cada bilhete vem dentro de uma tag aereorodoviario. Se o passageiro possuir mais de um bilhete, virão duas tags com o mesmo passageiro. pax 3-40 String Nome e sobrenome do passageiro. Exemplo: SILVA/JOAOMR ou SILVA/JOSE MR ou SILVA/J MR tipo - String ADT - Adulto CHD - Criança

28 basetarifaria 8 String tarifa 4-15 String ###.###.##0,00 tarifacheia 4-15 String ###.###.##0,00 INF Colo Tarifa em reais. XML WEBSERVICE ANCDWS Tarifa normal da rota sem desconto ou repetição da tarifa aplicada. Em reais. moeda - String Sempre será retornado R$ cambio 4-10 String Sempre será retornado 1,00. Em reais. ###.##0,00 datacambio 10 String Sempre será retornado o dia da emissão. dd/mm/yyyy taxaembarque 4-15 String Taxas de embarque e penalidade. Em reais. ###.###.##0,00 taxaservico 4-15 String ###.###.##0,00 repassedu 4-15 String ###.###.##0,00 taxacartaodu 4-15 String ###.###.##0,00 Taxa por serviços prestados pela Ancoradouro. Em reais. Exemplo: emissão de bilhetes sem comissão ao consolidador. Repasse a terceiros. Em reais. Fatura: Se cartão, será creditado em fatura. Se outra forma de pagamento, não constará na fatura. Taxa cobrada pela administradora do cartão sobre o repasse a terceiros. Em reais. Fatura: Será descontado na fatura. bilhetes - - Dentro virão os números dos bilhetes e comissões. bilhete - Array Bilhetes referentes à este passageiro ou forma de pagamento. Apesar de ser uma array, normalmente virá apenas um. numero 1-10 String AZUL ou GOL: Virá o localizador da reserva OUTRA: Virá o número do bilhete comisrecforvalor 4-15 String ###.###.##0,00 descpagclivalor 4-15 String ###.###.##0,00 Comissão da venda do bilhete. Não inclui a DU. Em reais. Pertence à tag aereorodoviario. Será retornado sempre 0,00, pois a Ancoradouro não controla o desconto que a agência passa ao cliente final. Pertence à tag aereorodoviario. observacao 0-70 String Caso o bilhete tenha algum desconto além da comissão será retornada aqui. Exemplo: Desconto de R$100,00. Pertence à tag aereorodoviario. trechos - - Serão retornados os vôos do itinerário em tags segmento. segmento - Array Cada tag corresponde a um vôo que compõe o itinerário. de 3 String Código da cidade de origem. para 3 String Código da cidade de destino. Data de saída do vôo. Data de embarque. datasaida 10 String dd/mm/yyyy

29 horasaida 5 String HH:MM datachegada 10 String dd/mm/yyyy XML WEBSERVICE ANCDWS Horário de saída do vôo. Horário de embarque. Data de chegada do vôo. Data de desembarque. Não será retornada, pois a Ancoradouro não guarda a data de desembarque. horachegada 5 String HH:MM Horário de chegada do vôo. Horário de desembarque. ciaaerea 2-3 String Código da companhia aérea do vôo. Se for codeshare, virá o código da companhia que vendeu o vôo, não a que opera. Exemplos: DL, se for DL operado por DL, DL, se for DL operado por LX e AMG se for Air Minas. voo 4 String #### ou OPEN Número do vôo. Retornará a palavra OPEN se o trecho for um trecho em aberto. Exemplos: 0001 e classe 1-2 String Classe de reserva. localizador 1-7 String Localizador da reserva. Caso o vôo contenha o localizador direto da companhia aérea, ele será retornado. status 0-10 String Situação do vôo. Exemplo: HK ou HL erros - - Só virá se houver algum erro. Neste caso, não virá a tag venda, só os erros. erro - Array Cada erro encontrado e que motive a venda não ser mostrada será colocado aqui. Caso dê erro nenhuma venda será retornada. numero 1-3 String Ordem do erro na lista de erros. ##0 descricao - String Descrição do erro. Não há um tamanho definido, pois o erro de sistema vem completo. local - String Em qual processo o erro ocorreu. Detalhamento da tag observações Além das observações gerais que podem ser inseridas na venda e que são retornadas há dois tipos de observações que poderão ser de interesse da agência. AUTORIZAÇÃO DO CARTÃO DE CRÉDITO As vendas no cartão de crédito poderão vir com o código de autorização. Normalmente, as que são emitidas no portal conterão estes códigos. AUT:AUTORIZACAODOCARTAO INFORMAÇÕES REFERENTES AO CARTÃO CORPORATIVO EBTA Quaisquer dos campos de observação, seja nas tags obsreserva ou nas tags obsvenda, podem retornar um destes valores: CC:CENTRODECUSTO

30 MAT:MATRICULA REQ:REQUISICAO DPTO:DEPARTAMENTO AUT:AUTORIZACAODOCARTAO Cada valor virá numa tag observacao diferente. Exemplo: <observacoes>dpto:vendas</observacoes> INFORMAÇÕES INSERIDAS NO PORTAL ANCORADOURO (Em fase de implementação) Serão retornadas 3 tags observacao sequenciais que deverão ser montadas, formando uma única linha com os valores. AGT1:EMISSOR,CLIENTE;SOLICITANTE,CENTRODECUSTO,UN.NEG, AGT2:DEPTO,PROJETO,ATIVIDADE,MOTIVO,CTA.CONT.,CLS.VALO AGT3:R,REQ,MATR,EMPENHO,EVENTO,REF1,REF2,INF.CT.,LOGIN Linha montada: EMISSOR;CLIENTE;SOLICITANTE;CENTRODECUSTO;UN.NEG;DEPTO;PROJETO;ATIVIDADE;MOTIVO;CT A.CONT.;CLS.VALOR;REQ;MATR;EMPENHO;EVENTO;REF1;REF2;INF.CONTROLE Após montada a linha, os campos terão os seguintes significados, nesta ordem: 1º - Emissor do bilhete. Retornará o código do emissor no BackOffice da agência se este for configurado no cadastro de usuários (EMISSOR) 2º - Código do cliente da agência no seu BackOffice, configurado no cadastro do cliente (CLIENTE) 3º - Solicitante corporativo da emissão (SOLICITANTE) 4º - Centro de custo do cliente da agência (CENTRODECUSTO) 5º - Unidade de negócio (UN.NEG) 6º - Departamento (DEPTO ) 7º - Código do projeto (PROJETO) 8º - Atividade (ATIVIDADE) 9º - Motivo (MOTIVO) 10º - Conta contábil (CTA.CONT) 11º - Classe de valor (CLS.VALOR) 12º - Requisição (REQ) 13º - Matrícula (MATR) 14º - Empenho (EMPENHO) 15º - Evento (EVENTO) 16º - Código de referência (REF1) 17º - Código de referência adicional (REF2) 18º - Informação de controle (INF.CONTROLE) 19º - Login do usuário (LOGIN) Estes códigos não têm sentido sem uma necessidade corporativa. Por isso, Caso não exista algum destes valores na venda o campo virá simplesmente vazio.

31 Exemplo: <observacoes>agt1:100,1234,,,,,,,,,,a129, ,,,,,</observacoes> Todos os dados couberam numa única linha, portanto não foram retornadas 3. Se ultrapassar de 3 linhas, o que não deve ocorrer, os últimos dados não serão retornados.

32 Método: ConsultarVendaXML Consulta: <ConsultarVendaXML xmlns=" <dataemissao>string</dataemissao> <localizador>string</localizador> <usuario>string</usuario> <senha>string</senha> </ConsultarVendaXML> Tag Tamanho Formato Descrição dataemissao 10 String dd/mm/yyyy Data de emissão do bilhete ou do localizador Se não for preenchido é considerada a data atual. localizador 0-7 String Localizador da reserva bilhete 0-10 String Formulário e série do bilhete de passagem sem o número da companhia usuario String senha 6-30 String Resposta: <ConsultarVendaXMLResponse xmlns=" <ConsultarVendaXMLResult>string</ConsultarVendaXMLResult> </ConsultarVendaXMLResponse> Tag Tamanho Formato Descrição ConsultarVendaXMLResult - String É uma tag contendo o XML de vendas. Dentro dela será retornado: <?xml version="1.0" encoding="utf-8"?> <vendas> <venda/> <venda/> </vendas> Todas as outras tags vêm na mesma estrutura do método ConsultarVenda, só que serializado.

33 Método: ConsultarVendas Consulta: <ConsultarVendas xmlns=" <datainicial>string</datainicial> <usuario>string</usuario> <senha>string</senha> </ConsultarVendas> Tag Tamanho Formato Descrição datainicial 10 String dd/mm/yyyy datafinal 10 String dd/mm/yyyy usuario String senha 6-30 String Data inicial do período de vendas. Máximo 15 dias no período. Se não for informada será utilizada a mesma data do final do período. Se nenhuma das duas for preenchida é considerada a data atual. Data final do período de vendas. Máximo 15 dias no período. Se não for informada será utilizada a mesma data do início do período. Se nenhuma das duas for preenchida é considerada a data atual. Resposta: Mesmo conteúdo do método ConsultarVenda Tag Tamanho Formato Descrição vendas - - Mesmo conteúdo do método ConsultarVenda, só que permite que seja consultado um período de vendas.

34 Método: ConsultarVendasXML Consulta: <ConsultarVendasXML xmlns=" <datainicial>string</datainicial> <usuario>string</usuario> <senha>string</senha> </ConsultarVendasXML> Tag Tamanho Formato Descrição data inicial 10 String dd/mm/yyyy datafinal 10 String dd/mm/yyyy usuario String senha 6-30 String Data inicial do período de vendas. Máximo 15 dias no período. Se não for informada será utilizada a mesma data do final do período. Data final do período de vendas. Máximo 15 dias no período. Se não for informada será utilizada a mesma data do início do período. Resposta: <ConsultarVendasXMLResponse xmlns=" <ConsultarVendasXMLResult>string</ConsultarVendasXMLResult> </ConsultarVendasXMLResponse> Tag Tamanho Formato Descrição string - String É uma tag string contendo o XML de vendas. <?xml version="1.0" encoding="utf-8"?> <vendas> <venda/> <venda/> </vendas> Todas as outras tags vêm na mesma estrutura do método ConsultarVendas, só que serializado.

35 5. [Atual] AppsWS Modelo Apps Sistemas [[[ESTE É O MODELO ATUAL PARA NOVAS IMPLEMENTAÇÕES, ele se conecta diretamente à base de dados da Ancoradouro, sem ter outro WebService tradutor intermediário]]] Este modelo mais novo e é o que deve ser utilizado, pois ele se conecta diretamente ao BackOffice. Os métodos antigos são apenas WebServices intermediários que traduzem o XML de retorno para manter a compatibilidade nas integrações antigas. AppsWS BackOffice Ancoradouro AppsWS AncdWS AppsWS BackOffice Ancoradouro AppsWS AncdWS AncdWSAgi AppsWS BackOffice Ancoradouro AppsWS AncdWSAgi Para o serviço AppsWS as vendas podem ser consultadas sem restrição, entretanto, utilizar um período acima de 15 dias pode ultrapassar o limite de tempo da requisição, o que é extremamente desaconselhável. Ao utilizar uma data inicial na solicitação, ele trará todas as vendas existentes (já integradas e não integradas), mas se uma data inicial não for informada serão retornadas todas as vendas no sistema que não foram retornadas antes (vendas não integradas). Métodos disponíveis: resumovendas Traz todos os bilhetes de acordo com as opções preenchidas. Existem outros métodos, mas são restritos e por isso não podem e não devem ser utilizados. Eles não terão respostas nas suas requisições a partir de um usuário de integração de agências de viagens.

36 Método: resumovendas Consulta: <resumovendas>(1) <diretorio>string(aaa)</diretorio>(1) <usuario>(1) <senha>string</senha>(1) </usuario> <dtinicial>string(ddmmyy)</dtinicial>(1) </resumovendas> DDMMYY Dia, mês e ano A Alfanumérico # - - (1) Só pode aparecer uma vez Descrição da Consulta: <resumovendas> Tag principal. <diretorio> Deve sempre ser preenchido com ANC... <usuario> Dados do usuário de integração. (Ver capítulo Como obter seu acesso ao WebService ).. < > de usuário... <senha> Senha do usuário... <dtinicial> Data inicial. Se não for preenchida trará todas as vendas ainda não retornadas (status=n) nas consultas anteriores, possivelmente ainda não integradas. Se preenchida (máximo 15 dias passados) trará todas as vendas da agência existentes do período.. Cada ponto corresponde a um nível dentro da tag raiz Resposta: <saidaresumovendas>(1) <retorno>string(xml)</retorno>(1) <mensagem>string</mensagem>(1) <horario>datahora(dd/mm/yyyy-hh:mm)</horario>(1) </saidaresumovendas> DD/MM/YYYY-HH:MM Dia, mês, ano, hora e minuto A Alfanumérico # - Número (1) Só aparecerá uma vez Descrição da Resposta: <saidaresumovendas>. <retorno> Aqui dentro será retornado outro XML, com as vendas (Ver descrição deste XML interno mais abaixo)... <mensagem> Status da consulta. Se houver erro, virá a mensagem de erro, se não virá OK... <horario> Horário da resposta da consulta.. Cada ponto corresponde a um nível dentro da tag raiz

37 Ajustes pós-importação no XML contido na tag retorno: <?xml version=\"1.0\" encoding=\"utf-8\"?><xml>< O texto do retorno vem conforme acima, pois um XML dentro do outro deve ter um tratamento diferenciado para caracteres especiais. Estes devem ser manipulados para sucesso da importação. Alguns recursos já o fazem automaticamente dependendo da plataforma utilizada. < < > > Após feito o ajuste o XML estará conforme descrito abaixo. XML contido na tag retorno: <?xml version="1.0" encoding="utf-8"?> <xml>(1+) <vendas>(1+) <venda>(0+) <status>string</status>(0-1) <codint>inteiro</codint>(0-1) <loc>string</loc>(0-1) <unidade>string(##/aaa)</unidade>(0-1) <cliente/>(0-1) <ccusto>string</ccusto>(0-1) <contato/>(0-1) <emissor>string</emissor>(0-1) <requisicao/>(0-1) <produto>string</produto>(0-1) <emissao>data(dd/mm/yyyy)</emissao>(0-1) <vencimento>data(dd/mm/yyyy)</vencimento>(0-1) <tpbil>string</tpbil>(0-1) <cia>string</cia>(0-1) <bastarif>string</bastarif>(0-1) <tourcode>string</tourcode>(0-1) <tottarifas>moeda(###.###,##)</tottarifas>(0-1) <tottaxas>moeda(###.###,##)</tottaxas>(0-1) <acrescia>moeda(###.###,##)</acrescia>(0-1) <outrosacresc>moeda(###.###,##)</outrosacresc>(0-1) <outrosdescontos>moeda(###.###,##)</outrosdescontos>(0-1) <comissao>moeda(###.###,##)</comissao>(0-1) <incentivo>moeda(###.###,##)</incentivo>(0-1) <abatimento>moeda(###.###,##)</abatimento>(0-1) <fee>moeda(###.###,##)</fee>(0-1) <du>moeda(###.###,##)</du>(0-1) <repassedu>moeda(###.###,##)</repassedu>(0-1) <cambio>moeda(#,#####)</cambio/>(0-1) <fpgto>inteiro</fpgto>(0-1) <cartao>inteiro<cartao>(0-1) <sinal>moeda(#,#####)</sinal>(0-1) <saldo>moeda(#,#####)</saldo>(0-1) <paxes>(0-1) <pax>(0+) <nome>string</nome>(0-1) <tipo>string</tipo>(0-1) <tarifausd>moeda(###.###,##)</</tarifausd>(0-1) <tarifabrl>moeda(###.###,##)</</tarifabrl>(0-1) <taxa>moeda(###.###,##)</</taxa>(0-1) <bilhete>inteiro(##########)</bilhete>(0-1) <conjugados>(0-1) <conjugado>numero(##########)</conjugado>(0+)

38 </conjugados> </pax> </paxes> <rota>(0-1) <origem>string(aaa)</origem>(0-1) <destino>string(aaa)</destino>(0-1) <rtow>string</rtow>(0-1) <trechos>(0-1) <trecho>(0+) <ciaaerea>string(aaa)</ciaaerea>(0-1) <origem>string(aaa)</origem>(0-1) <destino>string(aaa)</destino>(0-1) <numvoo>inteiro(####)</numvoo>(0-1) <classe>string<classe>(0-1) <dtsaida>data(dd/mm/yyyy)</dtsaida>(0-1) <horasaida>hora(hh:mm)</horasaida>(0-1) <dtchegada>data(dd/mm/yyyy)</dtchegada>(0-1) <horachegada>hora(hh:mm)</horachegada>(0-1) </trecho> </trechos> </rota> <observacoes>(0-1) <obsreserva>(0-1) <observacoes>string</observacoes>(0-4) </obsreserva> <obsvenda> <observacoes>string</observacoes>(0-4) </obsvenda> </observacoes> </venda> </vendas> </xml> DD/MM/YYYY Dia, mês e ano HH:MM Hora e minuto A Alfanumérico X Qualquer caractere # - Número (0-2) Poderá aparecer a quantidade de vezes mostrada, neste caso de 0 a 2 vezes (0+) Poderá aparecer mais de 1 vez, podendo não ser retornada (1+) Poderá aparecer mais de 1 vez, mas pelo menos na quantidade mostrada Descrição do XML contido na tag retorno: <xml>. <vendas> Retorna uma lista de tags venda... <venda> Cada tag vem com os dados de uma venda no sistema, com um ou mais passageiros e com um ou mais bilhetes de passagem.... <status> I=Vendas já retornadas pelo menos uma vez N=Primeira vez que a venda é retornada... <codint> Id da venda em nosso sistema (também chamado de LI)... <loc> Localizador da reserva.... <unidade> O número corresponde ao escritório da Ancoradouro onde a venda foi adquirida. O código da cidade é o IATA de emissão da passagem. Escritórios: - 01 Campinas - 02 Ribeirão Preto - 03 São José dos Campos - 04 Bauru... <cliente> Sempre retornará vazia.

39 ... <ccusto> Centro de custo da agência, caso esta utilize a fatura separada por centro de custo. (Não confundir com centro de custo corporativo)... <contato/> Sempre retornará vazia... <emissor> Usuário ou funcionário da Ancoradouro que deu entrada da venda no sistema.... <requisicao/> Sempre retornará vazia.... <produto> Tipo de venda. Três valores são possíveis: EBTA, RAV ou vazio para E-TKT.... <emissao> Data de emissão da passagem.... <vencimento> Data de previsão de vencimento da fatura da venda.... <tpbil> N=Nacional R=Regional I=Internacional... <cia> Código de 2 ou 3 letras da companhia aérea.... <bastarif> Base tarifária principal da rota.... <tourcode> Código de comissionamento e desconto interno utilizado.... <tottarifas> Total das tarifas de todos os passageiros da venda. Se for internacional trará o valor em dólares, que deve ser convertido para reais pelo câmbio da tag cambio.... <tottaxas> Total de taxas de todos os passageiros da venda.... <acrescia> Total de taxas extras de todos os passageiros da venda. Quando tiver pagamento no cartão, a taxa DU será repetida aqui para evitar devolução duplicada.... <outrosacresc> Total de taxas adicionais cobradas pela Ancoradouro de todos os passageiros da venda.... <outrosdescontos> Total de descontos concedidos a todos os passageiros da venda.... <comissao> Total de comissão de todos os passageiros da venda. Quando tiver pagamento no cartão, a taxa DU virá neste campo, deduzido o valor da taxa administrativa do cartão.... <incentivo> Total de incentivos de todos os passageiros da venda.... <abatimento> Total de descontos adicionais de todos os passageiros da venda.... <fee> Total de taxas de serviços cobradas pela Ancoradouro de todos os de todos os passageiros da venda.... <du> Taxa de repasse à terceiros de todos os passageiros da venda.... <repassedu> Retorna o valor que será creditado em fatura referente à taxa DU, normalmente só são são devolvidas DU no cartão de crédito. Quando faturado, já são descontadas em fatura e não há o que devolver. Este é valor da DU menos a taxa administrativa do cartão.... <cambio> Câmbio de emissão quando a venda for internacional.... <fpgto> Forma de pagamento : 1=Faturado e 3=Cartão de crédito. Quando for múltiplas formas incluindo cartão virá como 3. Neste caso, o valor do cartão será explicitamente indicado nos dados do cartão.... <cartao> Virá vazia se não contiver pagamento no cartão.

40 .... <bandeira> Sempre retornará vazia..... <numero> Número do cartão de crédito..... <validade> Sempre retornará vazia..... <titular> Sempre retornará vazia..... <parcelas> Sempre virá 1, mesmo que pago em mais parcelas..... <entrada> Sempre retornará vazia..... <juros> Sempre retornará vazia..... <valorcartao> Valor pago através do cartão de crédito. O restante será faturado ou cash..... <sinal> Valor pago cash. Obs: O valor faturado sempre será: (tottarifas+tottaxas+acrescia+outrosacresc+fee+du)-(valorcartao)-(sinal).... <saldo> Valor líquido. (+) A agência tem este valor a pagar. (-) A agência tem este valor a receber..... <paxes> Cada passageiro virá numa tag pax <pax> Lista de passageiros da venda <nome> Nome do passageiro <tipo> ADT=Adulto, CHD=Criança e INF=Colo <tarifausd> Valor em dólar da tarifa do passageiro, quando internacional <tarifabrl> Valor em reais da tarifa do passageiro. Quando internacional, é a tarifausd convertida pelo cambio <taxa> Taxa de embarque e penalidades do pagamento. Acréscimos e descontos não serão discriminados por passageiro <bilhete> Número do bilhete <conjugados> Lista de bilhetes conjugados. Não inclui o primeiro bilhete <conjugado> Bilhete conjugado..... <rota> Itinerário da passagem <origem> Cidade de origem da rota inteira. Código de 3 letras <destino> Cidade de origem da rota inteira. Código de 3 letras <rtow> OW=One Way (Somente ida) e RT=Round Trip (Ida e volta) <trechos> Cada trecho virá numa tag trecho <trecho> Lista de trechos da rota <ciaaerea> Código de 2 ou 3 letras da companhia aérea <origem> Cidade de origem do trecho. Código de 3 letras <destino> Cidade de origem do trecho. Código de 3 letras <numvoo> Número do voo. Desconsiderar quando Open <classe> Classe de reserva.

41 <dtsaida> Data de saída. Virá nas as 4 primeiras posições a palavra OPEN quando for Open <horasaida> Horario de saída. Desconsiderar quando Open <dtchegada> Data de chegada. Desconsiderar quando Open <horachegada> Horário de chegada. Desconsiderar quando Open..... <observacoes> Lista de observações da venda <obsreserva> Observações referentes à reserva. Ver detalhamento Abaixo <observacoes> Observação referente à reserva <obsvenda> Observações referentes à venda. Ver detalhamento Abaixo <observacoes> Observação referente à venda.. Cada ponto corresponde a um nível dentro da tag raiz; Detalhamento da tag observações Além das observações gerais que podem ser inseridas na venda e que são retornadas há dois tipos de observações que poderão ser de interesse da agência. AUTORIZAÇÃO DO CARTÃO DE CRÉDITO As vendas no cartão de crédito poderão vir com o código de autorização. Normalmente, as que são emitidas no portal conterão estes códigos. AUT:AUTORIZACAODOCARTAO INFORMAÇÕES REFERENTES AO CARTÃO CORPORATIVO EBTA Quaisquer dos campos de observação, seja nas tags obsreserva ou nas tags obsvenda, podem retornar um destes valores: CC:CENTRODECUSTO MAT:MATRICULA REQ:REQUISICAO DPTO:DEPARTAMENTO AUT:AUTORIZACAODOCARTAO Cada valor virá numa tag observacao diferente. Exemplo: <observacoes>dpto:vendas</observacoes> INFORMAÇÕES INSERIDAS NO PORTAL ANCORADOURO (Em fase de implementação) Serão retornadas 3 tags observacao sequenciais que deverão ser montadas, formando uma única linha com os valores. AGT1:EMISSOR,CLIENTE,SOLICITANTE,CENTRODECUSTO,UN.NEG, AGT2:DEPTO,PROJETO,ATIVIDADE,MOTIVO,CTA.CONT.,CLS.VALO

42 AGT3:R,REQ,MATR,EMPENHO,EVENTO,REF1,REF2,INF.CT.,LOGIN XML WEBSERVICE ANCDWS Linha montada: EMISSOR,CLIENTE,SOLICITANTE,CENTRODECUSTO,UN.NEG,DEPTO,PROJETO,ATIVIDADE,MOTIVO,CT A.CONT.,CLS.VALOR,REQ,MATR,EMPENHO,EVENTO,REF1,REF2,INF.CONTROLE,LOGIN Após montada a linha, os campos terão os seguintes significados, nesta ordem: 1º - Emissor do bilhete. Retornará o código do emissor no BackOffice da agência se este for configurado no cadastro de usuários (EMISSOR) 2º - Código do cliente da agência no seu BackOffice, configurado no cadastro do cliente (CLIENTE) 3º - Solicitante corporativo da emissão (SOLICITANTE) 4º - Centro de custo do cliente da agência (CENTRODECUSTO) 5º - Unidade de negócio (UN.NEG) 6º - Departamento (DEPTO ) 7º - Código do projeto (PROJETO) 8º - Atividade (ATIVIDADE) 9º - Motivo (MOTIVO) 10º - Conta contábil (CTA.CONT) 11º - Classe de valor (CLS.VALOR) 12º - Requisição (REQ) 13º - Matrícula (MATR) 14º - Empenho (EMPENHO) 15º - Evento (EVENTO) 16º - Código de referência (REF1) 17º - Código de referência adicional (REF2) 18º - Informação de controle (INF.CONTROLE) 19º - Login do Emissor (LOGIN) Estes códigos não têm sentido sem uma necessidade corporativa. Por isso, Caso não exista algum destes valores na venda o campo virá simplesmente vazio. Exemplo: <observacoes>agt1:100,1234,,,,,,,,,,a129, ,,,,,,</observacoes> Todos os dados couberam numa única linha, portanto não foram retornadas 3. Se ultrapassar de 3 linhas, o que não deve ocorrer, os últimos dados não serão retornados.

43 6. Vendas e usuário para testes XML WEBSERVICE ANCDWS A Ancoradouro não tem como disponibilizar um usuário para testes, visto que só existe o sistema em produção em vigor. Pedimos utilizar como data inicial para os testes apenas o dia corrente, para evitar que muitas vendas sejam retornadas desnecessariamente, a não ser que um determinado tipo de venda seja procurado. Lembramos que ao não informar uma data, todas as vendas não retornadas antes serão agora retornadas e marcadas como já retornadas, para que não sejam mais retornadas neste caso.

44 7. Aplicação para teste No nosso site é possível obter, além deste manual em formato PDF, uma aplicação de testes que pode ser rodada em qualquer máquina que possua acesso aos links: Baixar o manual em PDF: Baixar a aplicação: A aplicação de testes contém todo o código de integração em C#. Também contém uma versão compilada. Basta executar o atalho TesteAncdWS dentro da pasta Executar Teste. Preencha os dados de entrada. Escolha o modelo que quer consultar. E marque se quer diretamente o XML estruturado ou se quer apenas uma string com o XML dentro dele. Algumas aplicações permitem a leitura direta do XML, transformando em objetos, mas outras exigem que o XML seja apenas um arquivo de texto que será manipulado posteriormente. Após a escolha clique em Executar Teste e o XML será exibido diretamente ou dentro de uma string na área logo abaixo das opções.