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 

Âncora
instalacaoeatualizacao instalacaoeatualizacao

 

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, em que o (passageiro escolhe o voo, hospedagem etc., ) tem ganho conquistado a preferência no mercado. O site Reserve é o líder neste setor por causa das 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 mantém mantem o controle financeiro, contábil e orçamentário das viagens.

Escopo e

finalidade

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

A integração ocorre de forma forma online, on-line e é iniciada quando determinados eventos são acionados no site Reserve (Notificaçãonotificação, Autorizaçãoautorização, Emissão emissão ou Cancelamentocancelamento).

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 Services Web Service Microsiga Protheus (incluindo a configuração especifica no appserver.ini);.
2. Liberação da opção ReserveGet (feita 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 agência de viagens, tenha . É 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

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

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