Histórico da Página
Integração SIGAPCO x Reserve
Introdução
Este manual foi elaborado para auxiliar 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 para determinados eventos, possibilitando o uso do sejam registrados para o uso no controle e bloqueio orçamentário do SIGAPCO.
A integração oferece maior controle orçamentário para a empresa, possibilitando:
- Registrar o valor movimentado nas diferentes etapas do processo de pedido de viagem (notificação, aprovação, emissão e cancelamento), atualizando os saldos orçamentários conforme regra de negócio (ex: saldo previsto, saldo realizado, etc.). O O SIGAPCO passa a ter 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 (ex. aprovação de pedido de viagem) de acordo com o regra de bloqueio, definida no SIGAPCO. Foram 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.
Foi disponibilizado o ponto de entrada WSRGProc (DT_WSRGProc_Tratamento_Integração_Reserve) para permitir que o cliente realize o controle orçamentário de forma própria. Ao utiliza-lo, ficará a cargo do cliente:
- 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 tabela Pedido Reserve x PCO (FO6) para registro das notificações de status dos pedidos de viagem vindos provenientes do Reserve, permitindo a elaboração da regra de lançamento no SIGAPCO e possível rastreabilidade dos dados.
Considerações:
- 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, por não haver interação com interface gráfica.
A Especificação de Requisito desta integração pode ser acessada no seguinte link: ER_PCREQ-9170_-_Integração SIGAPCO e Reserve.
Foi utilizado para consulta o seguinte manual do Reserve ReserveGet - V1.2.1_20160404 (fornecido por um representante da empresa Reserve).
Requisitos
- Ter o 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 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 a 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 a 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 e a elaboração da regra de lançamento nos pontos de Lançamento e/ou Bloqueio, segue abaixo a tabela com 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:
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 Lancamentos de Lançamentos / Bloqueios esta ativa (1=Sim/ 2=Não).
Instalação/Atualização
- Nas configurações do job do Web ServiceServices, presente no arquivo appserver.ini, a propriedade ONCONNECT deve receber o valor PCOReserve, conforme exemplo abaixo:
[JOB_WEBSERVICE]
ENVIROMENT=XXXXX[NOME DO AMBIENTE]
ONSTART=__WSSTART
ONCONNECT=PCOReserve
Essa alteração possibilita o envio do arquivo XML no formato esperado pelo aplicativo ReserveGet.
- É necessário informar para o representante Reserve a URL do serviço do Protheus:
- Um exemplo da URL a ser enviada: http://172.168.0.1:8081/RESERVEGET.apw
- Para testar se o serviço está disponível, utilize o navegador de internet, inserindo o endereço com a instrução para exibir detalhar a estrutura (exemplo: http://172.168.0.1:8081/RESERVEGET.apw?WSDL). Será exibida uma tela semelhante ao print abaixo:
- O representante do Reserve deve testar se consegue acessar o serviço Protheus, identificando assim possíveis bloqueios de firewall;
- 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 etc., é tem ganho a preferência no mercado, sendo que o . O site Reserve é o líder neste setor, por 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 webservice Web Services do Protheus. O Reserve é responsável por acessar o webservice o Web Services Protheus e realizar a transmissão dos dados, onde para alguns casos, considera a resposta do Protheus Back Office para bloquear o processo.
A integração ocorre de forma forma online, ocorrendo e é iniciada quando determinados eventos são acionados no site Reserve (Notificação, Autorização, Emissão ou Cancelamento).
Cadastro
O que a integração faz:
O que a integração não faz: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
- Disponibilização do WebService Web Services Protheus (incluindo a configuração especifica no appserver.ini);
- Liberação pelo representante do Reserve da opção ReserveGet para o licenciado cadastrado;
- Preencha o Configuração do parâmetro de integração do SIGAPCO;
- Cadastre as 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;
- 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;
- A partir do site Reserve, efetue os 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
Pergunta:
Resposta:
Fluxo das Informações
Checklist
Informações As informações não foram importadas para o Protheus., verifique:
- Se o O Protheus é versão 12.1.11 7 expedição Junho/16 ou superior?;
- Se o Web Services O WebService Protheus está disponível?;
- No Se no arquivo appserver.ini, nas na seção das configurações do webservice Web Services 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 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 O processo não sofreu o 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 Se a etapa que se está executando é uma das passiveis de bloqueio?.