Integração SIGAPCO X Reserve

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

A integração oferece mais controle orçamentário para a empresa de acordo com os seguintes critérios:

• Registrar o valor movimentado nas diferentes etapas do processo do pedido de viagem (notificação, aprovação, emissão e cancelamento) com atualização dos saldos orçamentários conforme regra de negócio (exemplo: saldo previsto, saldo realizado etc). O SIGAPCO tem 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 (exemplo: aprovação de pedido de viagem) de acordo com a regra de bloqueio, definida no SIGAPCO. Estão 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.

O ponto de entrada WSRGProc (DT_WSRGProc_Tratamento_Integração_Reserve) está disponível e permite o controle orçamentário de forma própria. Ao utiliza-lo, é necessário realizar os seguintes procedimentos:

• 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 dispõe da tabela de Pedido Reserve X PCO (FO6) para registro das notificações de status dos pedidos de viagem provenientes do Reserve e, também, permite a elaboração da regra de lançamento no SIGAPCO e rastreabilidade dos dados

Requisitos

• Ter o Protheus na versão 12.1.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 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 o Protheus registre os dados recebidos do Reserve, é necessário configurar conforme necessidade os pontos de lançamentos abaixo:

2. Para que 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 a elaboração da regra de lançamento nos pontos de Lançamento e/ou Bloqueio, segue abaixo os campos da tabela FO6 e as respectivas tags obtidas no manual do ReserveGet:

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 Lançamentos / Bloqueios esta ativa (1=Sim/ 2=Não).

Instalação/Atualização

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

   • [JOB_WEBSERVICE]

     ENVIROMENT=[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 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, hospedagem etc., tem ganho a preferência no mercado. O site Reserve é o líder neste 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 Web Services do Protheus. O Reserve é responsável por acessar o Web Services Protheus e realizar a transmissão dos dados, onde para alguns casos, considera a resposta do Back Office para bloquear o processo.

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

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 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. Configuração do parâmetro de integração do SIGAPCO;
4. 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. 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, 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) .

Fluxo das Informações

Checklist

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

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

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

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