Integração SIGAPCO x Reserve

Introdução

Este manual foi elaborado para auxiliar na implantação e suporte da integração entre o site Reserve e o módulo de Planejamento e Controle Orçamentário (SIGAPCO), recebendo do site para que os eventos ocorridos com os pedidos de viagem e para determinados eventos, possibilitando o uso do sejam registrados para  o uso no controle e bloqueio orçamentário do SIGAPCO.

A integração oferece maior controle orçamentário para a empresa, possibilitando:

• Registrar o valor movimentado nas diferentes etapas do processo de pedido de viagem (notificação, aprovação, emissão e cancelamento), atualizando os saldos orçamentários conforme regra de negócio (ex: saldo previsto, saldo realizado, etc.).  O O SIGAPCO passa a ter novos pontos de lançamento orçamentário para contemplar cada etapa integrável do processo de viagem:
  • Antes do autorizador ser notificado;
  • Após o autorizador ser notificado;
  • Antes da autorização do pedido;
  • Após a autorização do pedido;
  • Antes da emissão do pedido;
  • Após a emissão do pedido;
  • Após o cancelamento do pedido.
• Bloquear determinados processos no Reserve (ex. aprovação de pedido de viagem) de acordo com o regra de bloqueio, definida no SIGAPCO. Foram disponibilizados pontos de bloqueio orçamentário para contemplar as etapas do processo de viagem que podem ser bloqueadas:
  • Antes do autorizador ser notificado;
  • Antes da autorização do pedido;
  • Antes da emissão do pedido.

Foi disponibilizado o ponto de entrada WSRGProc (DT_WSRGProc_Tratamento_Integração_Reserve) para permitir que o cliente realize o controle orçamentário de forma própria. Ao utiliza-lo, ficará a cargo do cliente:

• Inclusão do lançamento (AKD);
• Atualização do saldo dos cubos;
• Bloqueio orçamentário;
• Estorno de saldos orçamentários (provenientes de cancelamentos no Reserve);
• Retorno indicando se o processo deve ou não ser continuado no Reserve.

O processo conta com a tabela Pedido Reserve x PCO (FO6) para registro das notificações de status dos pedidos de viagem vindos provenientes do Reserve, permitindo a elaboração da regra de lançamento no SIGAPCO e possível rastreabilidade dos dados.

Considerações:

• A inclusão manual de pedido de viagem originado do Protheus não será contemplada;
• O processo de contingência do PCO não será disponibilizado, por não haver interação com interface gráfica.
  
  

A Especificação de Requisito desta integração pode ser acessada no seguinte link: ER_PCREQ-9170_-_Integração SIGAPCO e Reserve.

Foi utilizado para consulta o seguinte manual do Reserve ReserveGet - V1.2.1_20160404 (fornecido por um representante da empresa Reserve).

Requisitos

• Ter o Protheus na versão 12.1.11 7 expedição Junho/16 ou superior;
• Ter seguido o processo de integração base DI_Integracao_Protheus_x_Reserve;
• Consistência do dicionário de dados;
• Parâmetros envolvidos;
• Web Service Services Protheus configurado (ver o detalhe especifico para esta integração na seção Instalação/Atualização);
• Módulo SIGAPCO configurado (cadastros básicos e configuração dos novos pontos de lançamento e/ou bloqueio);
• ReserveGet habilitado para o licenciado em uso (habilitado por algum representante da empresa Reserve).

Dicionário de Dados

1. Para que a o Protheus registre os dados recebidos do Reserve, é necessário configurar conforme necessidade os pontos de lançamentos abaixo:

2. Para que a o Protheus realize o bloqueio orçamentário dos dados recebidos do Reserve, é necessário configurar conforme necessidade os pontos de bloqueio abaixo:

3. Para e a elaboração da regra de lançamento nos pontos de Lançamento e/ou Bloqueio, segue abaixo a tabela com os campos da tabela FO6 , com a respectiva tag obtida e as respectivas tags obtidas no manual do ReserveGet e a descrição da informação:

Parâmetros

É necessário configurar o parâmetro abaixo:

• MV_PCOINTE: Indica se a integração dos processos do Planejamento e Controle Orçamentário com os processos de Lancamentos de Lançamentos / Bloqueios esta ativa (1=Sim/ 2=Não).

Instalação/Atualização

1. Nas configurações do job do Web ServiceServices, presente no arquivo appserver.ini, a propriedade ONCONNECT deve receber o valor PCOReserve, conforme exemplo abaixo:

   • [JOB_WEBSERVICE]

     ENVIROMENT=XXXXX[NOME DO AMBIENTE]

     ONSTART=__WSSTART

     ONCONNECT=PCOReserve

   • Essa alteração possibilita o envio do arquivo XML no formato esperado pelo aplicativo ReserveGet.

2. É necessário informar para o representante Reserve a URL do serviço do Protheus:
   • Um exemplo da URL a ser enviada: http://172.168.0.1:8081/RESERVEGET.apw
   • Para testar se o serviço está disponível, utilize o navegador de internet, inserindo o endereço com a instrução para exibir detalhar a estrutura (exemplo: http://172.168.0.1:8081/RESERVEGET.apw?WSDL). Será exibida uma tela semelhante ao print abaixo:
   • 
3. O representante do Reserve deve testar se consegue acessar o serviço Protheus, identificando assim possíveis bloqueios de firewall;
4. O representante do Reserve deve liberar o ReserveGet para o licenciado.

Contexto de negócio

Com a crescente demanda por redução de custos a opção de Self Booking, em que o passageiro escolhe o voo e , hospedagem etc., é tem ganho a preferência no mercado, sendo que o . O site Reserve é o líder neste setor, por setor por causa das ferramentas que permitem a busca por menores tarifas e o controle da política de viagens da empresa, enquanto o Protheus mantém o controle financeiro, contábil e orçamentário das viagens.

Escopo e Finalidade

Essa integração é realizada por meio de webservice Web Services do Protheus. O Reserve é responsável por acessar  o webservice o Web Services Protheus e realizar a transmissão dos dados, onde para alguns casos, considera a resposta do Protheus Back Office para bloquear o processo.

A integração ocorre de forma forma online, ocorrendo e é iniciada quando determinados eventos são acionados no site Reserve (Notificação, Autorização, Emissão ou Cancelamento).

Cadastro

O que a integração faz:

Com os dados importados para o Protheus, é possível utilizar o controle orçamentário do SIGAPCO para não permitir gastos além dos planejados pela empresa.

Como Fazer

1. Disponibilização do WebService Web Services Protheus (incluindo a configuração especifica no appserver.ini);
2. Liberação pelo representante do Reserve da opção ReserveGet para o licenciado cadastrado;
3. Preencha o Configuração do parâmetro de integração do SIGAPCO;
4. Cadastre as Cadastro das empresas na FL2. O BKO da agência vai depender do cadastro realizado pela agencia de viagens, tenha um cuidado especial em ambientes com múltiplas empresas e filiais;
5. Configure os Configuração dos pontos de lançamento orçamentário e os de bloqueio (se necessários) específicos para integração com o Reserve;
6. A partir do site Reserve, efetue os execução dos processos que envolvem um pedido de viagem até que seja executada uma ação integrável (notificação, aprovação, emissão ou cancelamento) .

FAQ

Pergunta: 
Resposta: 

Fluxo das Informações

Checklist

Informações As informações não foram importadas para o Protheus., verifique:

• Se o O Protheus é versão 12.1.11 7 expedição Junho/16 ou superior?;
• Se o Web Services O WebService Protheus está disponível?;
• No Se no arquivo appserver.ini, nas na seção das configurações do webservice Web Services foi alterado o valor da propriedade ONCONNECT para PCOReserve?;
• O Se o representante da empresa Reserve consegue acessar o link da estrutura do serviço?;
• O Se o parâmetro de integração do SIGAPCO esta ativo?;
• O Se o representante da empresa Reserve ativou o ReserveGet para o licenciado em uso?;
• Os Se os pontos de lançamentos do SIGAPCO estão ativos e referenciando os campos corretos da tabela FO6?;
• Foi Se foi executada alguma ação das integráveis no site Reserve?.

Processo O processo não sofreu o bloqueio orçamentário., verifique:

• Se os Os pontos de bloqueio do SIGAPCO estão ativos e referenciando os campos corretos da tabela FO6?;
• Os Se os saldos comparados foram consultados para constatar a aplicação do bloqueio?;
• A Se a etapa que se está executando é uma das passiveis de bloqueio?.