Integração SIGAPCO

X Reserve

Introdução

Este manual foi elaborado para auxiliar auxilia 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 sejam registrados para determinados eventos, possibilitando o uso do uso, controle e bloqueio orçamentário do SIGAPCO.

A integração oferece maior mais controle orçamentário para a empresa , possibilitandode 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

Foi disponibilizado o ponto de entrada WSRGProc (DT_WSRGProc_Tratamento_Integração_Reserve) para permitir que o cliente realize o  está disponível e permite o controle orçamentário de forma própria. Ao utiliza-lo, ficará a cargo do clienteé 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 conta com a dispõe da tabela de Pedido Reserve x X PCO (FO6) para registro das notificações de status dos pedidos de viagem vindos provenientes do Reserve e, também, permitindo permite a elaboração da regra de lançamento no SIGAPCO e possível rastreabilidade dos dados.

Requisitos

• Ter o Microsiga 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 do Microsiga Protheus configurado (ver o detalhe especifico para esta integração na seção 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 a o Microsiga Protheus registre os dados recebidos do Reserve, é necessário configurar, conforme necessidade, os seguintes pontos de lançamentos abaixo:

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

3. Para e elaboração da elaborar a regra de lançamento nos pontos de Lançamento e/ou Bloqueio, segue abaixo a tabela com é necessário considerar 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

, 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 do de job do Web Service, presente no arquivo appserver.ini, a propriedade ONCONNECT deve receber o valor PCOReserve, conforme de acordo com o seguinte 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 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

• • :

Image Modified

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 e hospedagem, é , hospedagem etc) tem conquistado a preferência no mercado, sendo que o . O site Reserve é o líder neste setor, pois, por causa das 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 webservice Web Service do Microsiga Protheus. O e o Reserve é responsável por acessar  o webservice Protheus acessá-lo e realizar a transmissão dos dados, sendo que, onde para alguns casos, considera a resposta do Protheus back office para bloquear o processo.

A integração ocorre de forma forma online, ocorrendo 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).

Cadastro

O que a integração faz:

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 WebService 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. 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 agência de viagens, tenha . É importante ter 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  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).

FAQ

Fluxo das

informações

Checklist

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

• Se o Microsiga O Protheus é versão 12.1.11 7 expedição Junho/16 ou superior?;
• Se o Web Service do Microsiga O WebService Protheus está disponível?;
• No Se no arquivo appserver.ini, nas na seção das configurações do webservice Web Service, 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 está 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 não sofreu o sem 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 etapa que se está executando Se a etapa em execução é uma das passiveis de bloqueio?.