Tipos de integração

Nós do time TripApi queremos oferecer uma API que seja fácil de consumir e adequada para todos os tipos e tamanhos de empresas e equipes, por isso o TripApi oferece 2 tipos de integração. Os dois tipos de integração utilizam o mesmo modelo de objetos e o fluxo de chamadas também é quase idêntico, a principal diferença entre os dois tipos é a passagem de parametros.

Para ilustrar as diferenças vamos utilizar esta estrutura hipotética de filiais e clientes corporativos de um cliente TripApi:

Padrão

A integração padrão funciona como é explicado no QuickStart, o desenvolvedor simplesmente precisa enviar as informações específicas de uma busca por exemplo, no entanto existe algumas coisas acontecendo "por baixo dos panos" que dependendo do tipo de integração o desenvolvedor poderia gostar de mudar.

Em cada chamada de método na integração padrão algumas coisas acontecem:

1. As credenciais de todas as cias aéreas são resolvidas para realização da busca, conforme o que esta cadastrado na área de administração
2. Os acordos comerciais possíveis de serem aplicados também são resolvidos de acordo com o que esta cadastrado.
3. Além de outras regras de negócio que o TripApi poderá aplicar dependendo da versão sendo utilizada:
   1. Carregamento de Fees
   2. Carregamento de Markups
   3. Carregamento de parcelamentos

Na integração padrão as chamadas utilizam as informações armazenadaas na estrutura de contas criadas no sistema, como na imagem de exemplo acima. Desta forma em cada chamada o desenvolvedor precisa informar qual conta esta utilizando, de forma que o sistema possa carregar todas as informações daquela conta.

A integração padrão é então direcionada a quem deseja usufruir de todos os sistemas integrados ao TripApi e de toda a estrutura de configurações, settings e regras de negócios que o TripApi oferece.

Direct

A interação direta ou direct, conforme explicado em Direct Mode, da ao desenvolvedor mais flexibilidade e não exige que o mesmo utilize a estrutura de cadastros que o TripApi oferece. Desta forma algumas funcionalidades ficam disponíveis e outras não.

Para ilustrar a diferença em um exemplo simples, suponha a estrutura de contas exemplo, nela um cliente poderia carregar toda essa estrutura no TripApi e carregar as informações de credenciais e acordos comerciais por exemplo, em cada conta específica.

Uma outra opção, via Direct Mode, é simplesmente criar uma conta padrão no TripApi, sem carregar todas as outras estruturas no sistema e deixar esta administração na responsabilidade do sistema do desenvolvedor fazendo a integração.

Neste caso, a cada chamada do TripApi, em Direct Mode, todas as particularidades de credenciais de todas as cias aéreas e códigos de acordos comerciais devem ser informadas em cada chamada. Lembrando que algumas funcionalidades não ficam disponíveis em Direct Mode, como: Aplicação de fees, markups, etc...

A integração no modo Direct, assume que o desenvolvedor deseja apenas usufruir da integração e padronização aos múltiplos supplier systems conectados a ferramenta e que o restante das regras de negócio, o sistema do desenvolvedor contratante irá aplicar.