Child pages
  • DI_Integracao_SIGAPCO_X_Reserve
Skip to end of metadata
Go to start of metadata

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.

Nota

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

A Especificação de Requisito desta integração pode ser acessada na página ER_PCREQ-9170_-_Integração SIGAPCO e Reserve.

O manual do ReserveGet - V1.2.1_20160404 (disponibilizado por um representante da empresa Reserve) foi utilizado para consulta.

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:

AKB_PROCESS

000401

AKB_ITEM

01

AKB_DESCRI

Pedido de viagem - Antes do autorizador ser notificado.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

02

AKB_DESCRI

Pedido de viagem - Após o autorizador ser notificado.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

03

AKB_DESCRI

Pedido de viagem - Antes da autorização do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

04

AKB_DESCRI

Pedido de viagem - Após a autorização do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

05

AKB_DESCRI

Pedido de viagem - Antes da emissão do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

06

AKB_DESCRI

Pedido de viagem - Após a emissão do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

07

AKB_DESCRI

Pedido de viagem - Após o cancelamento do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

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:

AKA_PROCESS

000401

AKA_ITEM

01

AKA_DESCRI

Pedido de viagem - Antes do autorizador ser notificado.

AKA_CHAVE

XFilial(“FO6”)+M->FO6_IDRESERV

AKB_ENTIDA

FO6

 

AKA_PROCESS

000401

AKA_ITEM

03

AKA_DESCRI

Pedido de viagem - Antes da autorização do pedido.

AKA_CHAVE

XFilial(“FO6”)+M->FO6_IDRESERV

AKB_ENTIDA

FO6

 

AKA_PROCESS

000401

AKA_ITEM

05

AKA_DESCRI

Pedido de viagem - Antes da emissão do pedido.

AKA_CHAVE

XFilial(“FO6”)+M->FO6_IDRESERV

AKB_ENTIDA

FO6

 

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:

Campo FO6

Tag Reserve

Descrição

FO6_FILIAL

-

Filial do sistema.

FO6_CODIGO

-

Código para controle interno.

FO6_IDRESE

<IDPedido>

Código do pedido no Reserve.
FO6_ACAO<Acao>Tipo de processamento que deve ser executado.
FO6_TIPO<Tipo>Tipo de serviço do pedido.

FO6_CC

<CCusto>

Centro de custo da viagem.

FO6_TOTAL

<Total>

Valor total da reserva (tarifas + taxas + multa).
FO6_TOTFEE<TotalFee>Valor total de Transaction Fee do pedido.
FO6_MOTIVO<Motivo>Motivo da viagem.
FO6_CLIENT<Projeto>

Na integração com o Microsiga Protheus, este campo poderá conter os dados de cliente e loja, desde que, o cadastro de cliente esteja integrado (MV_RESCAD).

FO6_LOJA<Projeto>

Na integração com o Microsiga Protheus, este campo poderá conter os dados de cliente e loja, desde que, o cadastro de cliente esteja integrado (MV_RESCAD).

FO6_ATIVI<Atividade>Atividade relacionada a viagem.
FO6_EXTRA1<CampoExtra1>Adiantamento.
FO6_EXTRA2<CampoExtra2>Informação extra do pedido.
FO6_EXTRA3<CampoExtra3>Informação extra do pedido.
FO6_DTCRIA<DataCriacao>Data de criação do pedido.
FO6_DTCANC<DataExclusao>Data de cancelamento do pedido (caso tenha sido cancelado).

FO6_DTEMIS

<DataEmissao>Data de emissão do pedido (caso tenha sido emitido).
FO6_DTAUTO<DataAutorizacao>Data de autorização do pedido (caso tenha sido autorizado).
FO6_DTMIGR<DataMigracao>Data de migração do pedido.
FO6_DTRESE<DataReserva>Data de criação da reserva.
FO6_DTCIAC<Checkin>Acomodação - data de check-in.
FO6_DTCOAC<Checkout>Acomodação - data de check-out.
FO6_DTIVSE<InicioValidade>Seguro - data inicial da viagem/validade do seguro.
FO6_DTFVSE<FimValidade>Seguro - data final da viagem/validade do seguro.
FO6_DTRELC<DataRetirada>Locação Carro - data de retirada do veículo.
FO6_DTDELC<DataDevolucao>Locação Carro - data de devolução do veículo.
FO6_DTSAPR<Saida>Passagem Rodoviária - data/hora de saída da viagem.
FO6_DTCHPR<Chegada>Passagem Rodoviária - data/hora de chegada da viagem.
FO6_DTSAPA<Saida>Passagem Aérea - data/hora de saída do voo.
FO6_DTCHPA<Chegada>Passagem Aérea - data/hora de chegada do voo.


   

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:

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.