Páginas filhas
  • DI_Integracao_SIGAPCO_X_Reserve

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 .

Informações
titleNota
  • A inclusão manual de pedido de viagem originado do Protheus não será contemplada;
  • O processo de contingência do PCO 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.

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

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:

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 Protheus realize o bloqueio orçamentário dos dados recebidos do Reserve, é necessário configurar conforme necessidade os pontos de bloqueio abaixo:

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 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:

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 a 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 Protheus, esse campo poderá conter os dados de cliente

e loja caso o cadastro de cliente esteja integrado (MV_RESCAD).

FO6_LOJA<Projeto>

Na integração com o Protheus, esse campo poderá conter os dados de cliente

e loja caso 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 checkin
FO6_DTCOAC<Checkout>Acomodação - Data de checkout
FO6_DTIVSE<InicioValidade>Seguro - Data de início da viagem/validade do seguro
FO6_DTFVSE<FimValidade>Seguro - Data de fim 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ário - Data/Hora de saída da viagem
FO6_DTCHPR<Chegada>Passagem Rodoviário - Data/Hora de chegada da viagem
FO6_DTSAPA<Saida>Passagem Aéreo - Data/Hora de saída do voo
FO6_DTCHPA<Chegada>Passagem Aéreo - Data/Hora de chegada do voo


   

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:
  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.