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:
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:
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.
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). |
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 |
É necessário configurar o parâmetro 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.
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.
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.
As informações não foram importadas para o Protheus, verifique:
O processo não sofreu o bloqueio orçamentário, verifique: