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 Microsiga 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 Service do Microsiga Protheus configurado (detalhamento no tópico 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 Microsiga Protheus registre os dados recebidos do Reserve é necessário configurar, conforme necessidade, os seguintes pontos de lançamentos:

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

3. Para elaborar a regra de lançamento nos pontos de Lançamento e/ou Bloqueio, é necessário considerar os campos da tabela FO6 e as respectivas tags obtidas no manual do ReserveGet:

Parâmetros

É necessário configurar o parâmetro MV_PCOINTE, pois, ele indica se a integração dos processos do Planejamento e Controle Orçamentário com os processos de Lançamentos/Bloqueios está ativa (1=Sim / 2=Não).

Instalação/Atualização  

1. Nas configurações de job do Web Service, presente no arquivo appserver.ini, a propriedade ONCONNECT deve receber o valor PCOReserve, de acordo com o seguinte exemplo: 

[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 Microsiga Protheus:

• • Exemplo de URL que deve ser enviada: http://172.168.0.1:8081/RESERVEGET.apw
  • Para testar se o serviço está disponível, utilize o navegador de internet e insira 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 seguinte print:

3. O representante do Reserve deve testar o acesso para o serviço do Microsiga Protheus e identificar 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 (passageiro escolhe o voo, hospedagem etc) tem conquistado a preferência no mercado. O site Reserve é o líder neste setor, pois, disponibiliza ferramentas que permitem a busca por menores tarifas e o controle da política de viagens da empresa, enquanto que, o Microsiga Protheus mantem o controle financeiro, contábil e orçamentário das viagens.

Escopo e finalidade

Essa integração é realizada por meio de Web Service do Microsiga Protheus e o Reserve é responsável por acessá-lo e realizar a transmissão dos dados, sendo que, para alguns casos, considera a resposta do back office para bloquear o processo.

A integração ocorre de forma on-line 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 Microsiga 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 Service Microsiga Protheus (incluindo a configuração especifica no appserver.ini).
2. Liberação da opção ReserveGet (feita pelo representante do Reserve) 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 agência de viagens. É importante ter 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 ocorre a 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

Informações não importadas para o Microsiga Protheus, verifique:

• Se o Microsiga Protheus é versão 12.1.7 expedição Junho/16 ou superior;
• Se o Web Service do Microsiga Protheus está disponível;
• Se no arquivo appserver.ini, na seção das configurações do Web Service, 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 está 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.

Processo sem 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 em execução é uma das passiveis de bloqueio.