Páginas filhas
  • DI_Integracao_SIGAPCO_X_Reserve

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

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 do pedido de viagem originado do Microsiga Protheus não será contemplada;
  • O processo de contingência do PCO 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.

Foi utilizado para consulta o O manual do Reserve 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 Services 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

dados

1. Para que o Microsiga Protheus registre os dados recebidos do Reserve, é necessário configurar, conforme necessidade, os seguintes pontos de lançamentos abaixo:

AKB_PROCESS

000401

AKB_ITEM

01

AKB_DESCRI

Pedido de Viagem viagem - Antes do autorizador ser notificado.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

02

AKB_DESCRI

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

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

03

AKB_DESCRI

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

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

04

AKB_DESCRI

Pedido de Viagem 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 viagem Antes da emissão do pedido.

AKB_ENTIDA

FO6

AKB_INDICE

1

 

AKB_PROCESS

000401

AKB_ITEM

06

AKB_DESCRI

Pedido de Viagem 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 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 abaixo:

AKA_PROCESS

000401

AKA_ITEM

01

AKA_DESCRI

Pedido de Viagem 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 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 viagem Antes da emissão do pedido.

AKA_CHAVE

XFilial(“FO6”)+M->FO6_IDRESERV

AKB_ENTIDA

FO6

 

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

FO6_CODIGO

-

Código para controle interno.

FO6_IDRESE

<IDPedido>

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

FO6_CC

<CCusto>

Centro de Custo 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, esse este campo poderá conter os dados de cliente e loja caso , desde que, o cadastro de cliente esteja integrado (MV_RESCAD).

FO6_LOJA<Projeto>

Na integração com o Microsiga Protheus, esse este campo poderá conter os dados de cliente e loja caso 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 checkindata de check-in.
FO6_DTCOAC<Checkout>Acomodação - Data de checkoutdata de check-out.
FO6_DTIVSE<InicioValidade>Seguro - Data de início data inicial da viagem/validade do seguro.
FO6_DTFVSE<FimValidade>Seguro - Data de fim data final da viagem/validade do seguro.
FO6_DTRELC<DataRetirada>Locação Carro - Data data de retirada do veículo.
FO6_DTDELC<DataDevolucao>Locação Carro - Data data de devolução do veículo.
FO6_DTSAPR<Saida>Passagem Rodoviário Rodoviária - Datadata/Hora hora de saída da viagem.
FO6_DTCHPR<Chegada>Passagem Rodoviário Rodoviária - Datadata/Hora hora de chegada da viagem.
FO6_DTSAPA<Saida>Passagem Aéreo Aérea - Datadata/Hora hora de saída do voo.
FO6_DTCHPA<Chegada>Passagem Aéreo Aérea - Datadata/Hora hora de chegada do voo.


   

Parâmetros

É necessário configurar o parâmetro abaixo:MV_PCOINTE

: Indica

, pois, ele indica se a integração dos processos do Planejamento e Controle Orçamentário com os processos de Lançamentos/Bloqueios

esta

está ativa (1=Sim / 2=Não).

 

Instalação/

Atualização

Atualização 
Âncora
instalacaoeatualizacao
instalacaoeatualizacao
 

  1. Nas configurações do de job do Web ServicesService, 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:

Um exemplo da URL a , inserindo abaixo
    • :

Image Modified

3. O representante do Reserve deve testar

se consegue acessar

o acesso para o serviço

Protheus, identificando assim

do Microsiga Protheus e identificar possíveis bloqueios de firewall

;

.

4. O representante do Reserve

deve liberar

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

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, sendo que, onde 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

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

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.