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. Este WebService não deve ser utilizado para novas implementações. Utilize preferencialmente o AppsWS. Data: 24/11/2014 Versão 3.1r4 RUA DR. LIRÁUCIO GOMES, 55 CAMBUÍ CAMPINAS SP

2 Índice XML WEBSERVICE ANCDWS Índice Versões Introdução AncdWS Modelo Ancoradouro Vendas e usuário para testes Aplicação para teste Como obter seu acesso ao WebService Dúvidas, sugestões e suporte técnico 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. 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 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. 3.1r2 06/11/2012 Separados os manuais AncdWS, AgiWS e AppsWS. Corrigida a falha de retorno da RAV, que estava vindo como se fosse DU, agora vem nas tags ValorRAV e RAV e os dados do cartão estavam sobrepondo os dados do cartão da venda. Agora veem numa tag separada DadosCartaoRAV.

4 3.1r4 24/11/ Atualizados links e s do portal XML WEBSERVICE ANCDWS

5 2. Introdução Este WebService foi criado com a finalidade de integrar as vendas das agências com nosso sistema antigo. No entanto, ele foi mantido em nosso sistema novo (Apps) para manter a compatibilidade entre os sistemas. Em novos desenvolvimentos, ele não deve ser utilizado, por conta do custo (em velocidade) envolvido. É feita uma consulta ao AppsWS, traduzido para o AncdWS e devolvido para o BackOffice da agência. Ao realizar as consultas utilizando diretamente o AppsWS as consultas das vendas serão mais rápidas. Entretanto, dependendo do volume de vendas isto é quase imperceptível, por isto a migração não é obrigatória. WebService: Padrão: Endereço HTTP: Endereço HTTPS: WSDL HTTP: AncdWS Ancoradouro

6 3. AncdWS Modelo Ancoradouro XML WEBSERVICE ANCDWS 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.

7 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)

8 <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>

9 <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

10 # - 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.

11 ... <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.

12 .... <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.

13 <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

14 <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).

15 <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 RAV Remuneração do agente de viagem Com a retirada das comissões das companhias, as agências são obrigadas a cobrar um fee (taxa de serviço). Há 3 modos de cobrança de fees: DU, RAV e TASF. Veja abaixo como o sistema trata cada uma delas: DU Vem discriminada nas tags <du/> e <repassedu/>. A tag <repassedu/> só existe quando cartão, e é a DU menos a taxa administrativa do cartão. A DU é uma cobrança da companhia ao passageiro. RAV Somente são lançadas as RAVs no cartão, uma vez que a DU é uma cobrança da agência ao passageiro. O lançamento tem como objetivo apenas repassar o valor do cartão à agência, que utilizou a maquineta da Ancoradouro para a cobrança. Elas são lançadas numa venda totalmente separada da venda original, pois nem sempre o cartão da cobrança é o mesmo da venda. Vem discriminada nas tags <du/> e <repassedu/>. A tag <repassedu/> só existe quando cartão, e é a DU menos a taxa administrativa do cartão. TASF São cobrados pelo BSP utilizando as maquinetas da Ancoradouro. A Ancoradouro não utiliza TASF, por isto seus campos nem estão descritos neste manual. 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

16 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 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,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)

17 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.

18 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.

19 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.

20 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.

21 4. 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.

22 5. 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.

23 6. Como obter seu acesso ao WebService XML WEBSERVICE ANCDWS Para o acesso à integração via XML WebService fornecida pela Ancoradouro é preciso ter um usuário e uma senha. Para solicitar um usuário com acesso ao WebService ou a regularização de um usuário existente envie um para: Help Desk help@efacilplus.com.br Importante: somente será criado um usuário para integração, uma vez que ele retornará todas as vendas. Este usuário deve ser cadastrado em todos da agência que farão a integração. Basta informar que precisa de um usuário para acesso à integração via XML WebService. Caso não seja informado um (único) específico para a integração, será criado em nome do do solicitante. Caso o usuário possua acesso ao nosso portal de vendas, ele deve evitar utilizar a mesma senha, uma vez que esta será de uso geral somente para integração de vendas BackOffice-BackOffice. A agência pode também optar por criar um específico para a integração, vinculada a outro e- mail existente. Isto evita o inconveniente de conflitar com usuário do portal e o risco de se utilizar a mesma senha.

24 7. Dúvidas, sugestões e suporte técnico XML WEBSERVICE ANCDWS Enviar para help@efacilplus.com.br Telefone: Atenção, o suporte técnico é somente para desenvolvedores. O suporte para as agências se dará pelo financeiro@efacilplus.com.br. Este suporte inclui: - Falta de vendas a serem integradas - Vendas que não são da agência aparecendo na integração - Erros nos dados de lançamento gerado. Qualquer problema técnico deverá ser feito pelo desenvolvedor, com a descrição do problema