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:
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:
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. O manual do ReserveGet - V1.2.1_20160404 (disponibilizado por um representante da empresa Reserve) foi utilizado para consulta. |
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. |
É 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).
[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.
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.
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.
Informações não importadas para o Microsiga Protheus, verifique:
Processo sem bloqueio orçamentário, verifique: